Lede: Lorsque Zoho CRM renvoie le code d'erreur crm.bm.msg.failed.undefined pour les messages sortants WhatsApp, la plateforme accepte les messages entrants mais ne parvient pas à délivrer les messages sortants depuis le CRM, produisant un état d'échec générique qui a commencé à apparaître pour certains clients le 14 octobre. Cela empêche l'envoi des notifications et messages WhatsApp déclenchés par le CRM, tandis que le chat entrant arrive toujours [1].
Ce que cela signifie — explication concrète liée à la surface de l'API Zoho
L'erreur crm.bm.msg.failed.undefined est un échec générique de livraison sortante provenant de la couche de pont/connecteur WhatsApp du CRM (le composant qui appelle l'API WhatsApp Business au nom du CRM). Elle indique que le CRM a tenté un envoi sortant mais que le canal en aval n'a renvoyé aucun code d'erreur mappé, le CRM a donc enregistré un statut générique "failed.undefined" au lieu d'une erreur d'API spécifique. Les clients signalent que les messages entrants arrivent toujours, ce qui montre que l'intégration WhatsApp et le chemin du webhook entrant restent sains, tandis que le chemin d'envoi sortant échoue au niveau de la passerelle CRM vers WhatsApp ou après celle-ci [1].
Causes courantes
- Un changement ou une panne chez le fournisseur de l'API WhatsApp Business ou dans le pont CRM qui mappe les erreurs du fournisseur en statuts CRM, produisant des échecs indéfinis lorsque la réponse du fournisseur change [1].
- Mauvaise configuration du canal WhatsApp dans le CRM après une mise à jour des identifiants, du numéro de téléphone ou du modèle, de sorte que les envois sortants sont rejetés mais que les hooks entrants fonctionnent toujours.
- Approbation du modèle ou non-concordance du texte du modèle pour les messages sortants : WhatsApp rejette l'envoi mais renvoie une réponse non mappée que le CRM enregistre comme indéfinie.
- Blocages régionaux ou au niveau du compte (vérification de l'entreprise, numéro de téléphone suspendu ou application des politiques) qui bloquent les envois sortants mais autorisent toujours la livraison ou les accusés de réception entrants.
Comment y remédier
- Vérifiez le statut de Zoho et les avis de la communauté : recherchez les incidents actifs ou les changements récents dans l'intégration WhatsApp de Zoho CRM (les rapports de la communauté ont commencé le 14 octobre) [1]. S'il y a un incident actif, attendez que Zoho le résolve.
- Dans Zoho CRM, ouvrez Configuration > Canaux > Messagerie > WhatsApp et vérifiez le statut du connecteur, la liaison du compte, le numéro de téléphone et la dernière heure de synchronisation. Ré-authentifiez le compte du fournisseur WhatsApp si les jetons ont expiré.
- Vérifiez le statut du fournisseur WhatsApp Business : connectez-vous à votre console Meta/fournisseur tiers et confirmez que le numéro est actif, que les modèles sont approuvés et que le compte est vérifié. Renvoez un modèle approuvé simple depuis la console du fournisseur pour isoler le CRM par rapport au fournisseur.
- Reproduisez avec une charge minimale : envoyez un modèle texte simple approuvé depuis le CRM vers un numéro de test et capturez les journaux du CRM et les journaux du fournisseur. Notez les horodatages et tous les codes d'erreur du fournisseur à partager avec le support.
- Si l'envoi sortant échoue mais que la console du fournisseur réussit, ouvrez un ticket auprès du support Zoho avec l'ID de requête/les horodatages, les numéros de destinataires exemples et les journaux de réponse du fournisseur. Incluez "crm.bm.msg.failed.undefined" et la preuve du succès des messages entrants.
Quand escalader
Escaladez vers le support Zoho lorsque vous avez des journaux montrant que les messages entrants arrivent, mais que chaque tentative d'envoi sortant renvoie crm.bm.msg.failed.undefined et que les journaux du fournisseur ne montrent aucune raison claire de rejet. Incluez les horodatages, les ID de requête et les captures d'écran de la console du fournisseur afin que le support puisse tracer la passerelle CRM vers fournisseur.
[1]: Rapport communautaire décrivant le fonctionnement des messages entrants alors que les messages sortants échouent avec crm.bm.msg.failed.undefined depuis le 14 octobre.