# 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

```json
{
  "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](/docs/guides/whatsapp/receiving-whatsapp#fetching-inbound-media) 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 :

```json
{
  "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](/docs/guides/whatsapp/events#reaction-events).

## Étapes suivantes

- [Fonctionnement de la réception](/docs/guides/whatsapp/receiving-whatsapp) : l'enveloppe entrante, la récupération des médias et le webhook `whatsapp.received`
- [Messages sticker WhatsApp](/docs/guides/whatsapp/message-types/stickers) : le côté envoi du même bras
- [Types de messages non pris en charge](/docs/guides/whatsapp/receiving-whatsapp/unsupported) : commandes, notifications système et le reste de ce qui arrive sans modèle
- [Événements WhatsApp](/docs/guides/whatsapp/events) : la liste complète des événements, via le API ou les webhooks

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)