Recevoir des stickers WhatsApp
Un sticker qu'un contact sélectionne depuis son clavier arrive comme un message entrant portant sticker : une référence à un fichier WebP, plus un indicateur animated.
Ce que contient un sticker entrant
Exemple de code
{
"id": "wam_01kye7t1rgyw9u5l8p2zaf7sid",
"direction": "inbound",
"from": { "phone_number": "+14155550100" },
"to": { "phone_number": "+13124495569" },
"status": "received",
"sticker": {
"id": "waf_01kye6r7as0zkv3g1q6suy9whc",
"url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kye7t1rgyw9u5l8p2zaf7sid/media/waf_01kye6r7as0zkv3g1q6suy9whc",
"mime_type": "image/webp",
"animated": false
},
"created_at": "2026-08-25T09:19:37Z"
}| Champ | Ce qu'il contient |
|---|---|
| id | Le fichier stocké, à transmettre comme media_id lors de la récupération des octets |
| url | Une URL Bird, à récupérer avec votre clé API |
| mime_type | Le type de média signalé par WhatsApp, image/webp pour un sticker |
| animated | Indique si le sticker est animé ; présent uniquement sur un sticker entrant |
Le bras ne porte aucune légende dans aucune des deux directions, ni aucun nom pour le sticker ou le pack dont il provient. Un sticker constitue l'intégralité du message.
animated distingue un WebP animé d'un WebP statique, ce qui compte lorsque vous affichez le fichier vous-même : un sticker animé est un WebP multi-images qu'un moteur de rendu d'image fixe réduit à sa première image.
Récupérer les octets
Transmettez l'identifiant du message et le id du média à la méthode media du canal. La page récupérer un média entrant du hub présente cet appel dans chaque langage, ainsi que les règles de redirection et d'en-tête qu'il suit, et définit la fenêtre de rétention dans laquelle le fichier est conservé.
La plupart des intégrations ne récupèrent jamais un sticker. Il exprime généralement un sentiment plutôt qu'une information : une boîte de réception agent peut donc afficher un espace réservé, et un flux automatisé peut traiter le message comme un accusé de réception réinitialisant la fenêtre sans rien télécharger.
Le payload du webhook
whatsapp.received porte le bras sticker sur l'enveloppe de l'événement :
Exemple de code
{
"type": "whatsapp.received",
"timestamp": "2026-08-25T09:19:37.882Z",
"data": {
"whatsapp_id": "wam_01kye7t1rgyw9u5l8p2zaf7sid",
"workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
"direction": "inbound",
"from": { "phone_number": "+14155550100" },
"to": { "phone_number": "+13124495569" },
"sticker": {
"id": "waf_01kye6r7as0zkv3g1q6suy9whc",
"url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kye7t1rgyw9u5l8p2zaf7sid/media/waf_01kye6r7as0zkv3g1q6suy9whc",
"mime_type": "image/webp",
"animated": false
},
"tags": null,
"metadata": null
}
}Points de vigilance
- Un sticker réinitialise quand même la fenêtre de service. C'est un message entrant comme un autre : il accorde 24 heures supplémentaires de réponses libres, même s'il ne contient aucun texte exploitable.
- Un sticker n'est pas une réaction. Une réaction emoji qu'un contact ajoute à l'un de vos messages n'est pas du tout un message entrant : elle est enregistrée dans le journal de réactions de ce message, et sa lecture est traitée dans événements WhatsApp.
Étapes suivantes
- Fonctionnement de la réception : l'enveloppe entrante, la récupération des médias et le webhook whatsapp.received
- Messages sticker WhatsApp : le côté envoi du même bras
- Types de messages non pris en charge : commandes, notifications système et le reste de ce qui arrive sans modèle
- Événements WhatsApp : la liste complète des événements, via le API ou les webhooks
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.
Regarder le guideConnecting WhatsApp to Bird: from buying a number to a live channelComprendre le conceptWhat is the 24-hour customer service window on WhatsApp?Utiliser l'outilWhatsApp message builderExplorer la fonctionnalitéWhatsApp
Essayez la pratique et obtenez un guide d'implémentation