Comment récupérer la configuration d'envoi de courrier dans Zoho

La récupération de votre configuration d'envoi de courrier dans Zoho CRM est simple grâce à un unique point de terminaison API de paramètres qui retourne la configuration des e-mails sortants pour votre organisation.

Pourquoi c'est important

Lorsque vous devez auditer, dépanner ou inspecter par programmation la façon dont les e-mails sortants sont configurés dans Zoho CRM, vous avez besoin d'un moyen fiable d'extraire ces données sans naviguer à travers plusieurs écrans de l'interface. C'est particulièrement utile pour les consultants qui intègrent un nouveau client, les développeurs qui créent des intégrations, ou les administrateurs qui vérifient que la bonne identité d'expéditeur est en place. Comprendre l'appel API vous permet également d'automatiser les vérifications de configuration dans le cadre d'un workflow de contrôle de santé plus large.

Étape par étape

Étape 1. Assurez-vous que votre connexion Zoho CRM est authentifiée et que votre jeton d'accès est valide. Le flux OAuth nécessite une session connectée avant qu'un point de terminaison de paramètres puisse être atteint — si la connexion est manquante ou expirée, l'API rejettera la requête. ^[3]

Étape 2. Confirmez que vos scopes OAuth incluent les autorisations nécessaires au niveau de l'organisation CRM. L'ensemble de scopes utilisé pour Zoho CRM doit couvrir ZohoCRM.org.ALL (ou au minimum un accès en lecture aux paramètres de l'organisation) afin que les points de terminaison de paramètres soient accessibles à votre jeton. ^[7]

Étape 3. Envoyez une requête GET au point de terminaison /settings/sendmailconfig. Il s'agit de l'opération dédiée — intitulée getsendmail_config — dans la catégorie de paramètres Mail & Social de l'API Zoho CRM. ^[5]

GET /settings/send_mail_config

En Python, en utilisant le wrapper client CRM, l'appel ressemble à ceci : ^[5]

def get_send_mail_config(self):
    return self.c.request("GET", "/settings/send_mail_config")

Étape 4. Analysez l'objet de réponse retourné par le point de terminaison. Le résultat contiendra les paramètres d'e-mails sortants de votre organisation. Stockez ou journalisez ces données selon vos besoins pour votre audit ou votre logique d'intégration. ^[5]

Étape 5. Si vous travaillez dans un environnement multi-applications (CRM + Desk), assurez-vous de cibler spécifiquement le client API CRM — et non le client Desk — car /settings/sendmailconfig est un point de terminaison limité au périmètre CRM. Le paramètre app_type dans la couche de connexion contrôle quel client API est instancié. ^[1]

---

> Remarque : Beam Help est un support expert indépendant pour Zoho — nous ne sommes pas le support officiel de Zoho. Pour les problèmes de facturation ou de compte, contactez Zoho directement.

---

Erreurs courantes

• Aucune connexion active. Si l'enregistrement zoho_connections pour l'utilisateur actuel est manquant ou si le jeton a expiré, la couche API affichera une erreur telle que *« Zoho n'est pas connecté pour cette application. Veuillez vous reconnecter. »* Vérifiez toujours l'état de la connexion avant d'appeler les points de terminaison de paramètres. ^[1]
• Mauvais centre de données. Le jeton OAuth et le domaine API sont liés au centre de données (com, eu, in, etc.) enregistré au moment de l'échange de jeton. L'envoi d'une requête vers le mauvais domaine régional entraînera un échec d'authentification. Vérifiez la valeur api_domain retournée lors de l'échange de code OAuth. ^[3]
• Scopes insuffisants. Si ZohoCRM.org.ALL n'a pas été inclus lors de l'octroi du consentement OAuth, le point de terminaison de paramètres retournera une erreur de permissions. Vous devrez peut-être révoquer le jeton existant et vous réautoriser avec la liste de scopes correcte. ^[7]

Ce qu'il faut vérifier

• Validité du jeton : Confirmez que le jeton d'accès n'a pas expiré et qu'un jeton de rafraîchissement valide est disponible pour en obtenir un nouveau si nécessaire. ^[3]
• Couverture des scopes : Vérifiez que ZohoCRM.org.ALL est présent dans les scopes accordés lors de l'autorisation OAuth. ^[7]
• Client API correct : Assurez-vous que la requête est acheminée via le client API CRM (et non Desk), et que app_type est défini sur "crm" dans votre configuration de connexion. ^[1]