Modèles d'e-mails Zoho CRM non chargés ou envoyés via l'API

Les modèles d'e-mails Zoho CRM échouent à se charger ou les e-mails ne sont pas envoyés lorsqu'ils sont appelés depuis l'API lorsque le modèle est manquant, mal formé, ou que le contexte d'appel manque des étendues (scopes) ou des données de champ correctes. Cette erreur apparaît généralement comme une charge utile de modèle vide, un HTTP 200 sans contenu, ou des erreurs d'API faisant référence à une entrée ou des autorisations invalides.

Ce que cela signifie — explication concrète liée à la surface de l'API Zoho ^[2][3][6]

La fonctionnalité de modèles d'e-mails du CRM stocke des modèles HTML ou glisser-déposer auxquels l'interface utilisateur du CRM et l'API font référence lors de l'envoi de messages. Lorsqu'un appel d'API pour envoyer ou récupérer un modèle renvoie un corps vide, une erreur, ou ne parvient pas à joindre le modèle, l'une des situations suivantes se produit : l'enregistrement du modèle n'est pas trouvé ou publié, le HTML du modèle contient des éléments non pris en charge ou des champs de fusion, ou l'appelant ne présente pas les étendues OAuth ou les entrées au niveau de l'enregistrement requises par l'API d'envoi ou la fonction sendmail de Deluge ^[2][3][6].

Causes courantes

• Le modèle est toujours un brouillon, non publié, ou stocké dans un dossier/une organisation différent(e) de celui auquel l'appelant de l'API peut accéder ^[2][3].
• Le modèle utilise des champs de fusion ou des composants qui font référence à des champs CRM manquants ou à du HTML non pris en charge, de sorte que l'API renvoie un contenu vide ou supprime le corps ^[2][3].
• Le jeton OAuth manque des étendues CRM correctes (envoi d'e-mail / accès aux modèles) ou le jeton appartient à un utilisateur sans permission pour visualiser ce modèle ^[6][5].
• Les entrées Deluge ou Flow passent des types incorrects ou omettent des champs requis (par exemple, champs booléens/contacts), provoquant l'échec de l'appel d'envoi même si la récupération du modèle semble normale ^[4][6].
• Inadéquation du service ou du point de terminaison régional : appeler le mauvais point de terminaison du centre de données Zoho peut renvoyer 200 avec des détails vides pour des objets stockés dans une autre région ^[1].

Comment y remédier

1. Confirmez que le modèle est publié et visible : ouvrez CRM > Configuration > Modèles > Modèles d'e-mails et vérifiez que le modèle est publié et dans le dossier attendu ^[2][3].
2. Testez la récupération du modèle avec le point de terminaison d'API et le jeton corrects : appelez GET https://www.zohoapis.com/crm/v2/settings/templates ou le point de terminaison de modèle spécifique au module pour votre région et confirmez que le JSON inclut le corps du modèle. Si vous avez un compte régional, appelez le domaine correspondant (zoho.eu, zoho.in) ^[1].
3. Validez les champs de fusion et le HTML : supprimez ou remplacez les balises non prises en charge et assurez-vous que chaque champ de fusion correspond à un nom de champ CRM existant ; puis enregistrez et publiez à nouveau le modèle ^[2][3].
4. Vérifiez les étendues OAuth et les permissions utilisateur : assurez-vous que le jeton OAuth possède les étendues ZohoCRM.modules.* et d'envoi d'e-mails requises par votre code ou votre fonction Deluge et que l'utilisateur du jeton peut visualiser/envoyer ce modèle ^[6][5]. Ré-autorisez si les étendues sont manquantes.
5. Vérifiez les types de données et les entrées requises dans votre appel : pour les points de terminaison d'envoi sendmail de Deluge ou d'API, passez les identifiants d'enregistrement et les champs requis dans les types attendus (booléens comme true/false, pas "1" ou chaîne vide) et gérez les valeurs nulles avant d'appeler ^[4][6].
6. Réessayez depuis le point de terminaison régional correct si votre organisation se trouve en dehors du centre de données mondial ; confirmez que l'ID de l'organisation et le domaine correspondent à votre jeton. Si vous voyez HTTP 200 mais des champs vides, une inadéquation régionale est probable ^[1].

Quand escalader

Escaladez vers le support Zoho si vous confirmez que le modèle est publié, que votre jeton a les bonnes étendues et que le point de terminaison régional est correct, mais que l'API renvoie toujours un contenu vide ou des erreurs serveur ; incluez les en-têtes de requête/réponse de l'API, l'ID du modèle et l'ID du compte utilisateur afin que le support puisse tracer la requête.