# Messaggi sticker su WhatsApp

Un messaggio sticker contiene un URL WebP pubblico che WhatsApp recupera al momento dell'invio. È il tipo di media più semplice: nessuna didascalia, nessun altro campo opzionale in fase di invio.

## Inviare uno sticker

Imposta `sticker.url`; non c'è altro da aggiungere:

**TypeScript**

```typescript
const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  sticker: { url: "https://cdn.example.com/stickers/thumbs-up.webp" },
});
console.log(msg.id, msg.status);
```

Examples: [TypeScript](/it-it/documentazione/guides/whatsapp/message-types/stickers.ts.md) · [Python](/it-it/documentazione/guides/whatsapp/message-types/stickers.py.md) · [Go](/it-it/documentazione/guides/whatsapp/message-types/stickers.go.md) · [PHP](/it-it/documentazione/guides/whatsapp/message-types/stickers.php.md) · [CLI](/it-it/documentazione/guides/whatsapp/message-types/stickers.cli.md) · [MCP](/it-it/documentazione/guides/whatsapp/message-types/stickers.mcp.md) · [cURL](/it-it/documentazione/guides/whatsapp/message-types/stickers.curl.md)

`sticker` non ha il campo `caption` e `animated` non è un valore da impostare in fase di invio; Bird lo riporta solo su uno sticker in entrata. `from` è obbligatorio su ogni messaggio di servizio: un numero di proprietà del tuo spazio di lavoro, non uno gestito da Bird.

## Limiti

| Campo                    | Limite                                          | Applicato da                                         |
| ------------------------ | ----------------------------------------------- | ---------------------------------------------------- |
| Dimensione file, statico | 100 KB                                          | Solo WhatsApp, al fetch (asincrono)                  |
| Dimensione file, animato | 500 KB                                          | Solo WhatsApp, al fetch (asincrono)                  |
| Tipo di file             | Solo WebP                                       | Solo WhatsApp, al fetch (asincrono)                  |
| `caption`                | campo non valido                                | Bird, all'accettazione (`422`, rifiuto dello schema) |
| `url`                    | assoluto, `https`, con host, senza spazi grezzi | Bird, all'accettazione (`422`)                       |

Bird controlla la forma dell'URL prima che qualsiasi cosa venga accodata; non verifica la dimensione effettiva del file, il formato o se è statico o animato. Solo il fetch di WhatsApp al momento dell'invio può farlo. Inviare un `caption` non è un errore di lunghezza: il campo non esiste nello schema di questo tipo, quindi viene rifiutato come proprietà non riconosciuta. Vedi nell'hub [invio di media tramite URL](/docs/guides/whatsapp/message-types#sending-media-by-url) e [quando un media fallisce](/docs/guides/whatsapp/message-types#when-media-fails).

## Leggere uno sticker in entrata

Uno sticker in entrata contiene un `id`, `mime_type` e `animated` che Bird ha ricavato recuperando il file. Tutti e tre sono assenti nella rilettura di un messaggio in uscita, perché Bird non ha mai recuperato né ispezionato il file inviato. Vedi [Ricezione degli sticker WhatsApp](/docs/guides/whatsapp/receiving-whatsapp/stickers) per la lettura completa in entrata, il payload `whatsapp.received` e gli aspetti a cui prestare attenzione.

## Limiti e modalità di errore

- **La finestra del servizio clienti deve essere aperta.** Gli sticker sono messaggi di servizio, recapitabili solo all'interno di una finestra aperta; vedi nell'hub la [finestra del servizio clienti](/docs/guides/whatsapp/message-types#the-customer-service-window).
- **Bird rifiuta `http`; WhatsApp stesso lo recupererebbe.** Vedi nell'hub [invio di media tramite URL](/docs/guides/whatsapp/message-types#sending-media-by-url) per il controllo completo della forma.
- **Un fetch rifiutato viene comunque addebitato.** Vedi nell'hub [quando un media fallisce](/docs/guides/whatsapp/message-types#when-media-fails). Il testo di rifiuto specifico per gli sticker da parte di WhatsApp non è stato misurato in modo indipendente: considera la mappatura come dedotta per simmetria anziché confermata per singola causa.
- **`animated` è in sola lettura ed è presente solo su uno sticker in entrata o recuperato.** È il verdetto di WhatsApp sul file, non qualcosa che puoi dichiarare. Il fatto che uno sticker sia statico o animato cambia solo il limite di dimensione; WebP è obbligatorio in entrambi i casi.
- **WhatsApp memorizza in cache un URL recuperato per circa 10 minuti.** Reinviare lo stesso URL entro quella finestra ripropone il primo fetch; varia l'URL per forzarne uno nuovo.

## Passaggi successivi

- [Messaggi di servizio WhatsApp](/docs/guides/whatsapp/message-types): la finestra del servizio clienti e il modello condiviso da ogni messaggio di servizio
- [Audio](/docs/guides/whatsapp/message-types/audio): un altro tipo di media senza campo didascalia
- [Immagini](/docs/guides/whatsapp/message-types/images): per una foto o un elemento grafico con didascalia
- [Invio di messaggi WhatsApp](/docs/guides/whatsapp/sending-whatsapp): la struttura della richiesta, il modello `202` e i tentativi sicuri

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