Skip to main content
Questa pagina è un riferimento per i blocchi costitutivi di un template WhatsApp — categorie, intestazioni, corpo, pulsanti, variabili, tipi di template avanzati e ciclo di vita dell’invio. Per la procedura passo-passo di creazione e test di un template, consulta Template. Per i limiti di formato dei media, consulta Intestazioni media.

​
Categorie

Ogni template ha esattamente una categoria, impostata al momento dell’invio a Meta. La categoria determina il prezzo e quali contenuti sono consentiti. Se Meta ritiene che il tuo template non corrisponda alla categoria scelta, verrà rifiutato o ricategorizzato — comune con contenuti Marketing inviati come Utility. La categoria può anche cambiare automaticamente man mano che Meta osserva i pattern di utilizzo, modificando di conseguenza la tariffa addebitata.

​
Formati delle intestazioni

L’intestazione di un template è opzionale. Quando presente, può essere una delle seguenti:
  • TEXT — stringa breve, può includere una variabile.
  • IMAGE — JPEG o PNG, max 5 MB. Vedi Intestazioni media.
  • VIDEO — MP4 o 3GPP con H.264/AAC, max 16 MB.
  • DOCUMENT — PDF (il più affidabile), formati Office o testo semplice. Max 100 MB. Il nome del file è visibile al destinatario.
  • LOCATION — latitudine, longitudine, nome e indirizzo. Utile per visite in negozio o conferme di consegna.
Le intestazioni media possono essere allegate come media handle (caricato una volta su Meta) o come URL HTTPS pubblico recuperato a ogni invio. Vedi Intestazioni media per i pro e contro.

​
Corpo e variabili

Il corpo è il testo principale del messaggio. Le variabili usano doppie parentesi graffe con un indice in base 1:
Regole:
  • I numeri devono essere sequenziali a partire da {{1}} — non puoi saltare indici.
  • Fornisci un valore di esempio per ogni variabile al momento dell’invio. Meta usa gli esempi per valutare il template.
  • Mantieni le variabili su valori brevi e prevedibili. Lunghi blocchi incollati sono un motivo comune di rifiuto.
La stessa sintassi {{n}} è utilizzata nelle intestazioni TEXT e nei pulsanti URL (vedi sotto).

​
Formattazione nel corpo

WhatsApp supporta un insieme limitato di formattazione in linea nei corpi dei template:
  • Grassetto con *asterischi*
  • Corsivo con _underscore_
  • Barrato con ~tilde~
  • Monospazio con triple backtick
Usa la formattazione con parsimonia. I template con formattazione eccessiva sono spesso rifiutati perché sembrano spam.

​
Piè di pagina

Testo semplice opzionale mostrato dopo il corpo. Nessuna variabile, nessuna formattazione.

​
Pulsanti

Un template può includere fino a 10 pulsanti in totale, raggruppati come risposte rapide o call-to-action. Le combinazioni consentite da Meta sono cambiate nelle versioni di Cloud API; i pattern più affidabili: I pulsanti di risposta rapida sono utili quando vuoi una risposta strutturata (utile per l’analytics). I pulsanti URL e telefono sono utili per indirizzare i destinatari fuori da WhatsApp verso il tuo stack. I pulsanti FLOW sono il punto d’ingresso ai Flow basati su moduli HubSpot in cui Flowella è specializzata.

​
Tipi di template specializzati

Meta ha diversi tipi di template di marketing specializzati che aggiungono funzionalità extra sopra la struttura base. Un template carousel mostra più schede in uno scorrimento orizzontale, ognuna con il proprio media, corpo e pulsanti. Utile per vetrine di catalogo, offerte multi-prodotto o confronti di funzionalità.
  • Fino a 10 schede per template.
  • Ogni scheda ha la propria intestazione immagine o video (un tipo di media per template — tutte immagini o tutti video, non miste).
  • Ogni scheda può avere fino a 2 pulsanti (Quick Reply, URL o Phone).
  • Il corpo di ogni scheda può avere fino a 3 variabili.
L’approvazione è per template (non per scheda), quindi tutte le schede devono essere conformi alla categoria scelta.

​
Template Limited-time offer (LTO)

I template LTO mostrano un timer di conto alla rovescia sotto il corpo. Una volta scaduto il timer, l’offerta viene mostrata come scaduta e toccare la CTA non fa nulla.
  • È richiesto un parametro codice offerta mostrato all’utente.
  • È richiesta un’epoch di scadenza (in secondi).
  • Il pulsante CTA è solitamente un Copy Code o URL.
Ideale per offerte autenticamente a tempo limitato — usare LTO per offerte che in realtà non scadono provoca lamentele degli utenti e ricategorizzazione da Marketing.

​
Template Coupon code

Come LTO ma senza conto alla rovescia — solo un codice che l’utente può copiare con un tap.
  • Il codice può essere fino a 20 caratteri (recentemente aumentato da 15).
  • Il pulsante Copy Code copia il valore fornito al momento dell’invio — il campo example del template è solo un segnaposto e non viene mai inviato.
  • In Template → scheda Invia e nella finestra di dialogo del template della inbox, i template coupon-code mostrano un campo dedicato Pulsanti codice coupon dove digiti i codici che vuoi effettivamente inviare (uno per riga di destinatario per invii in blocco). Le precedenti etichette “Copy code” / “Pulsanti copia codice coupon” sono state sostituite da questo termine unico e coerente.

​
Template Authentication

Template specializzati per la consegna di OTP. Tre sotto-tipi:
  • One-tap autofill — usa l’API di autofill di Android per popolare automaticamente l’OTP quando l’utente tocca il pulsante. UX migliore dove supportato.
  • Copy code — mostra un pulsante Copia; l’utente incolla il codice nella tua app. Funziona ovunque.
  • Zero-tap — per mittenti affidabili, l’OTP può essere consegnato senza alcun tap (una callback API automatica dal client WhatsApp alla tua app). Idoneità rigorosa.
I template di autenticazione hanno il prezzo per messaggio più basso ma le regole di contenuto più rigorose: nessun contenuto di marketing, nessun testo aggiuntivo oltre al codice stesso.

​
Template Location

Trasportano una posizione puntuale nell’intestazione, utile per visite in negozio, conferme di consegna o luoghi di eventi. L’utente può aprire la posizione nella propria app mappe con un tap. Intestazione di posizione come variabili L’intestazione LOCATION trasporta fino a quattro campi — latitudine, longitudine, nome e indirizzo — e Flowella tratta tutti e quattro come normali variabili del template.
  • I valori digitati nell’editor (sotto _flowellaEditor.headerLocationPreview) diventano il valore predefinito inviato se non viene fornito alcun override.
  • Le finestre di dialogo Test Template e di invio dalla inbox espongono i quattro campi come normali input di variabili.
  • L’azione Send WhatsApp Template di HubSpot passa i quattro valori tramite headerLocation in modo che un workflow possa personalizzare il pin per ogni destinatario.
Se ometti uno qualsiasi dei quattro al momento dell’invio, Flowella ricade sul valore di anteprima dell’editor per quel campo.

​
Ciclo di vita dell’invio

Quando invii un template da Flowella, attraversa questi stati:
1

DRAFT

Salvato in Flowella ma non ancora inviato a Meta.
2

PENDING

Inviato a Meta e in fase di revisione. La maggior parte dei template supera la revisione automatica di Meta in pochi minuti, ma alcuni vengono indirizzati alla revisione umana. L’editor di Flowella ti avvisa che l’approvazione può richiedere fino a 12 ore e ti invia un’email non appena lo stato cambia — non devi continuare ad aggiornare.
3

APPROVED

Attivo e utilizzabile. Puoi inviarlo dalla inbox, dall’API e dai workflow HubSpot.
4

REJECTED

Meta ha rifiutato il template. Il motivo del rifiuto appare nella pagina del template. Modifica e reinvia.
5

FLAGGED

Meta ha esaminato il feedback sulla qualità e ha contrassegnato il template. Solitamente un preludio a PAUSED.
6

PAUSED

Meta ha temporaneamente limitato l’invio del template, solitamente a causa del feedback dei destinatari o di una qualità bassa. Ritorna automaticamente se la qualità si riprende.
7

DISABLED

Meta ha limitato permanentemente il template. Deve essere reinviato come nuovo template (spesso ricategorizzato) se vuoi usare nuovamente il contenuto.

​
Valutazione di qualità

Una volta approvato, ogni template costruisce la propria valutazione di qualità — separata dalla valutazione di qualità del numero di telefono. La valutazione a livello di template usa la stessa scala Verde/Giallo/Rosso ed è guidata principalmente da:
  • Tasso di blocco tra i destinatari
  • Frequenza di azioni “Segnala” in WhatsApp
  • Bassa interazione prolungata (nessuna risposta, nessun clic sui link)
Le valutazioni Gialla e Rossa del template possono indurre Meta a sospendere il template anche se la valutazione del numero di telefono è Verde. Monitora la qualità del template in Flowella → Template insieme alla valutazione a livello di numero.

​
Time-to-live (TTL)

I template possono avere un time-to-live che controlla per quanto tempo Meta tenterà la consegna prima di rinunciare. Utile per invii sensibili al tempo come inviti a flash sale.
  • Predefinito: 30 giorni per la maggior parte dei template.
  • Template OTP / autenticazione: molto più breve (qualche minuto per impostazione predefinita), poiché i codici non hanno valore una volta obsoleti.
  • TTL personalizzato: può essere impostato per invio per alcuni tipi di template.
Se un template scade prima della consegna (telefono del destinatario offline, account sospeso, ecc.), conta come invio ai fini della fatturazione ma non raggiunge mai il cliente.

​
Motivi comuni di rifiuto

  • Contenuto promozionale inviato come Utility. Reinvia come Marketing.
  • Esempi di variabili che non corrispondono al corpo — ad esempio, esempi che contengono link che il corpo non giustifica.
  • Testo del corpo o dell’intestazione che sembra spam — uso eccessivo di maiuscole, “Clicca qui”, “Gratis!!!”, più punti esclamativi.
  • URL di intestazioni media interrotti o irraggiungibili.
  • Testo del piè di pagina che contraddice il corpo.
  • Template generici che potrebbero essere inviati da chiunque — Ciao {{1}}, offerta speciale per te senza dettagli è troppo generico per l’approvazione marketing.
  • Variabili nel contesto sbagliato — usare una variabile in un punto in cui Meta non la consente (ad esempio, alcuni tipi di pulsante).
  • Il nome visualizzato non corrisponde al brand del contenuto del template. Se il nome visualizzato del WABA è “Acme” e il template promuove “Beta Co”, verrà rifiutato.
Modifica una copia di un template APPROVED anziché l’originale, in modo da mantenere una versione funzionante mentre Meta revisiona le modifiche. Template → Duplica di Flowella lo fa per te.

​
Guide correlate

Ultima modifica il 27 giugno 2026