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

Esempio di codice

{
  "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 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:

Esempio di codice

{
  "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.

Passi successivi

Come funziona la ricezione: l'envelope in entrata, lo scaricamento dei media e il webhook whatsapp.received
Messaggi sticker WhatsApp: il lato invio dello stesso arm
Tipi di messaggio non supportati: ordini, avvisi di sistema e il resto di ciò che arriva senza modello
Eventi WhatsApp: l'elenco completo degli eventi, tramite API o webhook

Risorse correlate

Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.

Guarda la guidaConnecting WhatsApp to Bird: from buying a number to a live channel Comprendi il concettoWhat is the 24-hour customer service window on WhatsApp?Usa lo strumentoWhatsApp message builder Esplora la funzionalitàWhatsApp

Prova l'esercitazione e ottieni un brief di implementazione