Champs webhook WhatsApp : lesquels vont où
Un compte WhatsApp Business transmet les événements sous forme de champs nommés. Deux transportent le contenu des conversations et sont routés vers votre endpoint. Six portent l’état opérationnel et servent au suivi. Savoir les distinguer détermine votre architecture.
- Deux champs de messages, six opérationnels
- Le routage se définit par compte
- Des champs nommés, pas un payload générique
Aucun frais pendant 7 jours. Annulez à tout moment.
Champs du parcours des messages : messages et smb_message_echoes.
Champs opérationnels conservés pour le suivi.
Remplacement par WhatsApp Business Account, ce qui les répartit.
Que contient chaque champ ?
messages contient tout ce qu’un client envoie au numéro : texte, références de médias, réponses et réactions. smb_message_echoes contient ce que votre équipe envoie depuis l’application WhatsApp Business. Ce champ n’existe que sur un numéro Coexistence et permet au logiciel de voir les réponses humaines.
account_update porte l’état de la connexion : PARTNER_REMOVED lorsque l’application est désinstallée du compte, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED, ainsi que les événements de restriction ou de violation. phone_number_quality_update porte les changements de qualité et de débit. account_alerts contient les alertes émises par Meta contre le compte, tandis que account_review_update contient le résultat d’une vérification.
business_capability_update porte les changements de limite et de capacité d’envoi, et phone_number_name_update porte les validations et refus du nom affiché.
Pourquoi cette répartition compte-t-elle pour l’architecture ?
Parce qu’elle détermine si le contenu des conversations atteint un fournisseur.
Le remplacement envoie directement les deux champs de messages à votre endpoint depuis Meta. Les six champs opérationnels continuent vers le fournisseur, ce qui permet d’utiliser un dashboard et des alertes sans que personne ne détienne un message.
C’est aussi pourquoi l’affirmation selon laquelle les messages ne sont pas stockés peut relever de la structure plutôt que d’une politique. Si les champs de messages sont livrés ailleurs, aucun chemin de code ne peut les stocker. Dans notre cas, un compte sans remplacement revient au callback par défaut, dont le gestionnaire ignore ces événements sans les conserver.
Quels champs votre gestionnaire doit-il attendre ?
Uniquement les deux champs de messages si le remplacement est défini. Il est préférable d’écrire le gestionnaire pour qu’il ignore tout le reste plutôt que de le faire échouer.
Meta ajoute des champs au fil du temps et la structure d’un payload peut recevoir de nouvelles clés sans préavis. Un gestionnaire qui examine le nom du champ et ignore ce qu’il ne reconnaît pas continue de fonctionner. Celui qui suppose une structure précise échoue au premier événement inconnu.
Il vaut également la peine de traiter explicitement smb_message_echoes plutôt que de le considérer comme du bruit. Sans ce champ, le logiciel ne sait pas qu’un humain a déjà répondu, et le client peut recevoir deux réponses à la même question.
Erreurs courantes
- Supposer un payload générique. Chaque événement nomme son champ et le gestionnaire doit l’examiner.
- Ignorer smb_message_echoes. Sans lui, le logiciel répond après un humain qui a déjà répondu.
- Faire échouer le gestionnaire sur les champs inconnus au lieu de les ignorer. Meta ajoute des champs sans demander.
EasyCoexistence s’abonne aux champs opérationnels pour le suivi et route les deux champs de messages vers votre endpoint, ou les ignore sans les conserver si vous n’en avez pas défini.
Questions fréquemment posées
Puis-je recevoir seulement certains champs ?
Le remplacement vous transfère le parcours des messages. La répartition opérationnelle est fixe, car le suivi repose dessus.
smb_message_echoes existe-t-il sur un numéro Cloud API classique ?
Non. Il existe parce qu’un numéro Coexistence permet à un humain d’envoyer des messages depuis l’application, en plus des envois logiciels via l’API.
Que deviennent les événements de messages si je ne définis aucune destination ?
Ils arrivent sur notre callback par défaut et sont ignorés sans être conservés.
Les noms des champs viennent-ils de Meta ou de vous ?
De Meta. Nous n’avons inventé aucun de ces noms, ce qui explique pourquoi il vaut la peine de les apprendre une fois.
Poursuivre la lecture
Prêt à commencer ?
Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.
Commencer l'essai gratuitAucun frais pendant 7 jours. Annulez à tout moment.Vérifié le