# Linee guida per i template WhatsApp

Un template che crei deve superare i controlli di invio di Bird e la revisione di Meta prima di poter essere utilizzato. Questa pagina spiega i limiti di contenuto che Bird verifica, come fornire le variabili e come rispondere a una decisione di revisione. Superare la validazione locale non garantisce l'approvazione di Meta né la consegna successiva.

Bird fornisce anche template gestiti da catalogo. Consulta [Template WhatsApp](/docs/guides/whatsapp/templates) per verificare le lingue disponibili e l'attuale stato di invio, e [Creazione di template](/docs/guides/whatsapp/authoring-templates) per creare un template sul tuo account.

## Limiti di caratteri per componente

Bird verifica questi limiti quando invii contenuto creato da te:

| Componente                   | Limite          | Note                                                            |
| ---------------------------- | --------------- | --------------------------------------------------------------- |
| Intestazione testo           | 60 caratteri    | Un'intestazione per template, supporta al massimo una variabile |
| Corpo                        | 1.024 caratteri | Supporta più variabili                                          |
| Footer                       | 60 caratteri    | Nessuna variabile                                               |
| Etichetta pulsante           | 25 caratteri    | Si applica ai pulsanti di chiamata, URL e risposta rapida       |
| Destinazione pulsante URL    | 2.000 caratteri | Supporta una variabile, aggiunta alla fine dell'URL             |
| Valore pulsante copia-codice | 20 caratteri    | La stringa copiata negli appunti del dispositivo                |

Il corpo di una card carosello ha un limite separato di 160 caratteri. Si applicano anche le regole di categoria e componente: un template di autenticazione usa il testo generato da Meta, mentre le intestazioni GIF, i caroselli e i pulsanti copia-codice per coupon appartengono ai template di marketing nel flusso di creazione di Bird. Controlla la risposta di validazione per la lingua e il campo interessati.

## Variabili

Le variabili sono le parti di un template che compili al momento dell'invio. Rispetta il formato del componente che stai creando:

- Bird crea i template di autenticazione con parametri posizionali, scritti `{{1}}` e `{{2}}`. Il testo proviene dal formato di autenticazione di Meta. Il testo di primo livello nei template utility e marketing usa parametri con nome come `{{order_number}}`.
- I segnaposto posizionali sono numeri di indice a partire da `{{1}}`, e sia i valori di esempio sia quelli di invio vengono letti nell'ordine in cui appaiono i segnaposto. Un corpo che salta da `{{2}}` a `{{5}}` viene rifiutato.
- I segnaposto con nome usano lettere minuscole, numeri e underscore, come `{{order_number}}`, e nessun nome si ripete all'interno di una lingua. I loro valori vengono abbinati per nome anziché per posizione, quindi l'ordine in cui li fornisci non conta.
- Racchiudi ogni segnaposto in doppie parentesi graffe. Il testo delle card carosello usa parametri posizionali e valori di esempio posizionali. Un pulsante URL con variabile usa un singolo segnaposto posizionale terminale, come `https://example.com/orders/{{1}}`, anche quando il corpo del template usa parametri con nome.
- Tieni caratteri speciali come `#`, `$` e `%` fuori dal segnaposto stesso.
- Non iniziare né terminare mai un template con una variabile. Meta rifiuta i parametri pendenti, perché un messaggio che si apre o si chiude con testo sostituito non fornisce contesto al lettore.
- Circonda ogni segnaposto con testo fisso che indichi cosa rappresenta il valore sostituito. Meta rifiuta un template con troppi segnaposto e troppo poco contesto, perché un corpo composto prevalentemente da variabili appare come un modulo vuoto anziché un messaggio. Aggiungi testo oppure riduci il numero di valori.
- Invia valori di esempio insieme al template. La revisione avviene su un'anteprima renderizzata e un invio senza esempi non può essere valutato.

## Formattazione

WhatsApp supporta un piccolo set di formattazione inline nel corpo: grassetto, corsivo, barrato e monospazio. Le emoji sono consentite nel corpo e nei pulsanti, mentre il testo dell'intestazione non accetta alcun markup di formattazione.

Meta non accetta HTML, link formattati come anchor text né controllo della lunghezza delle righe oltre alle interruzioni di riga che inserisci tu. Un URL nel testo del corpo viene mostrato come link grezzo, ed è proprio questo che i pulsanti URL servono a evitare.

## Revisione e approvazione

L'invio di una nuova lingua o di una modifica avvia il processo di revisione applicabile. Controlla lo stato corrente in Bird e WhatsApp Manager anziché pianificare un lancio basandoti su un tempo di decisione garantito. Prima di inviare, verifica che la lingua richiesta sia disponibile, che il numero di invio appartenga all'account corretto e che il destinatario sia idoneo.

Approvazione e qualità sono aspetti separati. Meta aggiorna la qualità del template man mano che riceve dati di utilizzo e feedback dei destinatari. Una valutazione media o bassa richiede un'indagine; una lingua in pausa o disabilitata non è disponibile per l'invio. Segui lo stato corrente e l'azione indicata da Meta anziché presumere che un cambio di valutazione la ripristini automaticamente.

Bird mostra sia lo stato sia il verdetto per lingua sul template stesso. [Template WhatsApp](/docs/guides/whatsapp/templates) definisce ogni valore e il suo significato per un invio.

## Perché i template vengono rifiutati

Usa il motivo restituito per la lingua interessata. I problemi da verificare includono:

- **Formattazione delle variabili.** Parentesi non corrispondenti, segnaposto non sequenziali, una variabile all'inizio o alla fine, oppure più variabili che testo fisso.
- **Duplicazione.** Un template il cui corpo e footer corrispondono a un testo già registrato sul tuo account viene rifiutato come duplicato. Meta indica il template esistente nel rifiuto, così puoi inviare quello. I template di autenticazione sono esenti da questo controllo.
- **Policy.** Contenuti che violano la WhatsApp Business Messaging Policy o, per qualsiasi contenuto transazionale, la Commerce Policy. I beni vietati sono il caso più evidente, ma lo è anche un messaggio il cui scopo il lettore non riconoscerebbe come proveniente da te.
- **Categorizzazione errata.** Un messaggio di marketing inviato come utility, nella maggior parte dei casi. La categoria determina sia ciò che Meta consente sia il costo del messaggio, quindi Meta la corregge anziché lasciarla passare.

Leggi la decisione in WhatsApp Manager o Business Support Home e nelle notifiche fornite da Meta. Correggi il problema segnalato e reinvia. Se la decisione offre un ricorso e non sei d'accordo, fornisci il contesto richiesto e i valori di esempio. Monitora lo stato della revisione; l'approvazione e i tempi di completamento non sono garantiti.

## Passaggi successivi

- [Template WhatsApp](/docs/guides/whatsapp/templates): catalogo, stati e variabili in Bird
- [Invio di messaggi WhatsApp](/docs/guides/whatsapp/sending-whatsapp): compilare le variabili di un template al momento dell'invio
- [La finestra del servizio clienti WhatsApp](/docs/knowledge-base/whatsapp/customer-service-window): quando è necessario un template per contattare qualcuno

## Related resources

- [Building and submitting a WhatsApp template](/learn/whatsapp/building-and-submitting-a-whatsapp-template) (video)
- [What is a WhatsApp message template?](/explained/whatsapp/what-is-a-whatsapp-message-template) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp templates](/products/whatsapp/templates) (product)

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