# Ricevere sticker WhatsApp

Uno sticker che un contatto seleziona dal proprio pannello arriva come messaggio in entrata con `sticker`: un riferimento a un file WebP, più un flag `animated`.

## Cosa contiene uno sticker in entrata

```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"
}
```

| Campo       | Cosa contiene                                                       |
| ----------- | ------------------------------------------------------------------- |
| `id`        | Il file archiviato, da passare come `media_id` per scaricare i byte |
| `url`       | Un URL Bird, da richiamare con la tua chiave API                    |
| `mime_type` | Il media type riportato da WhatsApp, `image/webp` per uno sticker   |
| `animated`  | Se lo sticker è animato; presente solo su uno sticker in entrata    |

L'arm non trasporta didascalie in nessuna delle due direzioni, né il nome dello sticker o del pack di provenienza. Uno sticker è l'intero messaggio.

`animated` distingue un WebP animato da uno statico, cosa che conta quando renderizzi il file tu stesso: uno sticker animato è un WebP multi-frame che un renderer di immagini statiche appiattisce al primo frame.

## Scaricare i byte

Passa l'ID del messaggio e il `id` del media al metodo media del canale. La guida dell'hub [scaricare media in entrata](/docs/guides/whatsapp/receiving-whatsapp#fetching-inbound-media) riporta quella chiamata in ogni linguaggio, insieme alle regole di redirect e header che segue, e definisce la finestra di conservazione in cui il file risiede.

La maggior parte delle integrazioni non scarica mai uno sticker. Di solito trasporta un sentimento più che un'informazione, quindi una inbox per agenti può mostrare un segnaposto e un flusso automatizzato può trattare il messaggio come una conferma che riapre la finestra, senza scaricare nulla.

## Il payload del webhook

`whatsapp.received` trasporta l'arm `sticker` nell'envelope dell'evento:

```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
  }
}
```

## Aspetti da tenere d'occhio

- **Uno sticker riapre comunque la finestra di servizio.** È un messaggio in entrata come qualsiasi altro, quindi garantisce altre 24 ore di risposte libere anche se non contiene testo su cui agire.
- **Uno sticker non è una reazione.** Una reazione emoji che un contatto aggiunge a un tuo messaggio non è affatto un messaggio in entrata: viene registrata nel log delle reazioni di quel messaggio, e la sua lettura è trattata in [eventi WhatsApp](/docs/guides/whatsapp/events#reaction-events).

## Passi successivi

- [Come funziona la ricezione](/docs/guides/whatsapp/receiving-whatsapp): l'envelope in entrata, lo scaricamento dei media e il webhook `whatsapp.received`
- [Messaggi sticker WhatsApp](/docs/guides/whatsapp/message-types/stickers): il lato invio dello stesso arm
- [Tipi di messaggio non supportati](/docs/guides/whatsapp/receiving-whatsapp/unsupported): ordini, avvisi di sistema e il resto di ciò che arriva senza modello
- [Eventi WhatsApp](/docs/guides/whatsapp/events): l'elenco completo degli eventi, tramite API o webhook

## 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)