Types de messages WhatsApp non pris en charge
Certains messages fonctionnent dans l'application WhatsApp mais ne peuvent pas être lus via API. Bird les enregistre comme des messages reçus avec un champ unsupported. Vous pouvez voir qui a envoyé le message et quand, mais vous ne pouvez pas lire son contenu dans le tableau de bord ni via API. Demandez à l'expéditeur de renvoyer l'information sous forme de texte ou d'un autre type de message pris en charge.
Pourquoi un message reçu peut contenir une erreur
Meta peut inclure l'erreur 131051 dans une notification de message entrant lorsque WhatsApp Cloud API ne prend pas en charge ce contenu. Une fonctionnalité peut être disponible dans l'application WhatsApp tout en restant indisponible via Cloud API.
Bird enregistre cette notification avec direction: inbound et status: received. Le champ last_error du message peut contenir meta_error_code: "131051", même si Bird n'a pas tenté de l'envoyer. Dans ce cas, l'erreur décrit le contenu entrant indisponible. Elle n'indique pas un échec d'envoi sortant.
Le champ normalisé last_error.code peut avoir la valeur undeliverable dans cet enregistrement reçu. Vérifiez direction, status et last_error.meta_error_code ensemble avant de considérer un enregistrement comme un échec de livraison.
Meta utilise aussi 131060 pour un message actuellement indisponible. Cela peut se produire lorsqu'une personne envoie un premier message à une entreprise via un numéro d'application WhatsApp Business connecté. Ce cas a une signification différente de l'erreur de contenu non pris en charge 131051. Consultez la référence Meta sur les messages non pris en charge pour ces notifications.
Lire le type de message
Le champ unsupported.type identifie le contenu aussi précisément que la notification le permet :
- Lorsque Meta fournit
unsupported.type, Bird conserve sa valeur, par exemplepoll_creation,pinouedit. - Lorsque Meta omet
unsupported.type, Bird conserve le type de niveau supérieur du message dans ce champ. Une valeur telle queunsupportedouunknownn'identifie pas l'action effectuée par l'expéditeur. - Lorsque Meta fournit un contenu que API de Bird ne modélise pas, Bird enregistre aussi son type ici, par exemple
orderousystem.
Le nom du type n'inclut pas le contenu manquant. Par exemple, poll_creation ne vous donne ni la question ni les choix, et edit ne vous donne pas le texte de remplacement. Conservez les valeurs de type non reconnues lors du stockage des messages afin que votre intégration puisse accepter de nouveaux types.
Bird prend en charge les images, les réponses par bouton, les réponses par liste et les réactions. Une notification non prise en charge portant l'un de ces noms décrit cette notification particulière ; cela ne signifie pas que la fonctionnalité entière est non prise en charge. Voir réception d'images, réponses interactives et webhooks de réaction.
Traiter le webhook reçu
Un message non pris en charge émet whatsapp.received avec data.unsupported.type. Le webhook reçu n'inclut pas le last_error de l'enregistrement du message ; récupérez le message via API lorsque vous avez besoin de ce diagnostic.
Traitez unsupported explicitement avant de traiter le contenu. Indiquez que le contenu est indisponible, stockez le type et accusez réception du webhook avec une réponse 2xx une fois le traitement effectué. Réessayer la même notification ne récupère pas le contenu manquant. Voir livraison des webhooks pour le comportement d'accusé de réception et de nouvelle tentative.
L'enregistrement reste visible dans le journal WhatsApp. Bird le traite comme un message entrant pour la fenêtre de service client.
Exemples à essayer
Voici des exemples de valeurs de unsupported.type. Si votre application WhatsApp propose l'action correspondante dans la conversation que vous testez, vous pouvez l'essayer et inspecter l'enregistrement résultant :
| Message ou action | unsupported.type |
|---|---|
| Créer un sondage | poll_creation |
| Voter dans un sondage | poll_update |
| Épingler un message | pin |
| Modifier un message envoyé | edit |
| Conserver un message éphémère dans la conversation | keep_in_chat |
| Envoyer une invitation de groupe | group_invite |
| Message non identifié | unknown |
La disponibilité dépend de l'application, de la conversation et du compte. Vous pouvez recevoir un type générique, ou aucune notification de message entrant pour une action. Comparez l'expéditeur, l'horodatage et unsupported.type avec l'action que vous avez effectuée. Si le type est générique, vous ne pouvez pas identifier l'action à partir de cet enregistrement seul.
Étapes suivantes
- Fonctionnement de la réception : messages entrants, médias et webhooks
- Réception des réponses interactives : appuis sur les boutons et sélections dans les listes
- Journal WhatsApp : inspecter les messages dans le tableau de bord ou API
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet.