Vai al contenuto
OmniChannels.ai
Menu

Strumento gratuito

Anteprima e verifica dei template WhatsApp

Scrivete il vostro template, aggiungete variabili e pulsanti e vedete esattamente come arriva su WhatsApp. Una checklist in tempo reale segnala ciò che la revisione di Meta respingerebbe prima che lo inviate, poi esporta il payload API.

Gratis · senza registrazione · funziona nel vostro browser

Partite da un esempio

18/512

Solo lettere minuscole, numeri e trattini bassi.

Categoria

Aggiornamenti richiesti dal cliente: ordini, prenotazioni, account, avvisi. Nessun contenuto promozionale.

Intestazione
21/60
147/1024

Usate {{1}}, {{2}}… per le variabili. Formattazione: *grassetto*, _corsivo_, ~barrato~, ```monospazio```.

Valori di esempio

Meta richiede un esempio realistico per ogni variabile. I revisori li leggono.

22/60

Pulsanti · facoltativo

Fino a 10 in totale: 10 risposte rapide, 2 URL, 1 numero di telefono, 1 copia del codice.

  1. 1URL
    11/25

    Aggiungete {{1}} alla fine per un suffisso dinamico.

  2. 2Numero di telefono
    12/25
    15/20

Anteprima dal vivo

Nessun problema bloccante rilevato. Pronto per essere inviato in revisione.

Checklist di approvazione

  • Superato: Il formato del nome del template è valido.
  • Superato: Lunghezza del testo dell’intestazione 21/60.
  • Superato: Lunghezza del corpo 147/1024.
  • Superato: 4 variabili, numerate in sequenza.
  • Superato: Ogni variabile ha un valore di esempio.
  • Superato: Lunghezza del piè di pagina 22/60.
  • Superato: 2 pulsanti entro i limiti e le regole di raggruppamento di Meta.
  • Superato: Nessun linguaggio promozionale rilevato per un template di utilità.

Regole verificate sulla documentazione ufficiale di Meta sui template (pagine su componenti, revisione e categorizzazione dei template), controllata a ottobre 2026. Components · Template review · Categorization

JSON del template

Corpo della richiesta per POST /<WABA_ID>/message_templates della WhatsApp Business Management API.

{
  "name": "order_confirmation",
  "language": "en_US",
  "category": "UTILITY",
  "components": [
    {
      "type": "HEADER",
      "format": "TEXT",
      "text": "Order {{1}} confirmed",
      "example": {
        "header_text": [
          "#48213"
        ]
      }
    },
    {
      "type": "BODY",
      "text": "Hi {{1}}, thanks for your order!\n\nWe've received order *{{2}}* for {{3}} and will message you again as soon as it ships. Estimated delivery: {{4}}.",
      "example": {
        "body_text": [
          [
            "Sara",
            "#48213",
            "AED 349.00",
            "Thursday, 14 Nov"
          ]
        ]
      }
    },
    {
      "type": "FOOTER",
      "text": "Reply HELP for support"
    },
    {
      "type": "BUTTONS",
      "buttons": [
        {
          "type": "URL",
          "text": "Track order",
          "url": "https://shop.example.com/orders/{{1}}",
          "example": [
            "48213"
          ]
        },
        {
          "type": "PHONE_NUMBER",
          "text": "Call support",
          "phone_number": "+97140000000"
        }
      ]
    }
  ]
}
Inviatelo con l’API

Dovete inviare decine di template in più lingue? Il nostro team li crea, li invia e ne segue le approvazioni per voi. Parla con un esperto di WhatsApp

Nulla di ciò che scrivete qui viene inviato ai nostri server.

Risposta breve

Un modello di messaggio WhatsApp (template) è un messaggio pre-approvato che un'azienda invia fuori dalla finestra di assistenza clienti di 24 ore. Meta limita il corpo a 1.024 caratteri, l'intestazione e il piè di pagina a 60 e le etichette dei pulsanti a 25, con fino a 10 pulsanti. Le variabili come {{1}} devono essere numerate in sequenza, richiedono valori di esempio e non possono iniziare né terminare il corpo. Ogni template è classificato come marketing, utilità (utility) o autenticazione (authentication).

Infrastruttura affidabileMeta Business Solution Provider ufficialePartner Google RBMMembro GSMAISO/IEC 27001:2022ISO/IEC 27018ISO 9001:2015ISO 22301SOC 2 Type IIConforme al GDPR

Come vedere l'anteprima e verificare un template WhatsApp

  1. 1

    Scegliete categoria e lingua

    Scegliete marketing, utilità o autenticazione e la lingua del template. Oppure caricate uno degli esempi pronti, in inglese o arabo.

  2. 2

    Scrivete intestazione, corpo e piè di pagina

    Usate {{1}}, {{2}} per i dati personali. Per ogni variabile compare un campo per il valore di esempio, così l'anteprima si legge come un messaggio reale.

  3. 3

    Aggiungete i pulsanti

    Aggiungete risposte rapide, link a siti web con suffisso dinamico, un numero di telefono o un codice offerta da copiare. Lo strumento li mantiene entro i limiti di Meta.

  4. 4

    Correggete la checklist, poi esportate

    Risolvete ogni voce rossa, esaminate gli avvisi, poi copiate il payload JSON per la WhatsApp Business Management API.

Limiti di caratteri dei template WhatsApp

La documentazione di Meta sui componenti dei template fissa limiti rigidi per ogni parte di un template. Gli invii che li superano falliscono all'API prima che un revisore umano li veda, quindi conviene controllarli mentre scrivete.

I caratteri sono contati come li vedete: un'emoji o una lettera araba contano come uno. Contano anche le interruzioni di riga, e i caratteri di formattazione in stile Markdown come gli asterischi di *grassetto* rientrano nel conteggio.

Fonte: Meta, Template components, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/components (verificata a ottobre 2026).

  • Nome del template: fino a 512 caratteri, solo lettere minuscole, numeri e trattini bassi.
  • Intestazione di testo: fino a 60 caratteri e al massimo 1 variabile. Le intestazioni multimediali possono essere un'immagine, un video o un documento; le intestazioni di posizione sono consentite solo per utilità e marketing.
  • Corpo: fino a 1.024 caratteri, obbligatorio, con tutte le variabili che servono.
  • Piè di pagina: fino a 60 caratteri, senza variabili.
  • Pulsanti: fino a 10 in totale, compresi al massimo 10 risposte rapide, 2 pulsanti URL, 1 pulsante numero di telefono e 1 pulsante copia codice. Le etichette dei pulsanti sono limitate a 25 caratteri, gli URL a 2.000, i numeri di telefono a 20 e i codici da copiare a 20.

Regole sulle variabili che causano rifiuti

La maggior parte dei template respinti fallisce sui segnaposto, non sul testo. La guida alla revisione dei template di Meta elenca i problemi sulle variabili che respinge: parametri non sequenziali, con caratteri speciali come #, $ o %, con parentesi graffe non corrispondenti, o posti all'inizio o alla fine del messaggio (“dangling parameters”).

Meta respinge anche template con troppe variabili rispetto alla lunghezza. Non pubblica un rapporto esatto, quindi questo strumento avvisa quando ci sono meno di tre parole fisse per variabile. I revisori respingono comunemente anche due variabili affiancate, come {{1}} {{2}}; unitele in una sola oppure mettete delle parole in mezzo.

Ogni variabile richiede un valore di esempio realistico all'invio. I revisori leggono gli esempi per capire cosa dice davvero il messaggio, quindi “test” o “xxx” invitano a un rifiuto.

Fonte: Meta, Template review, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-review.

Template respinto? Decodificate il motivo di Meta

Passate alla scheda “Respinto? Incolla il motivo di Meta” e incollate il motivo da WhatsApp Manager, Business Support Home, dall'email di rifiuto o dal webhook message_template_status_update. Lo strumento riconosce i codici di motivo di Meta, come INVALID_FORMAT, INCORRECT_CATEGORY, TAG_CONTENT_MISMATCH, PROMOTIONAL, SCAM e ABUSIVE_CONTENT, e la formulazione delle cause comuni nella guida alla revisione dei template di Meta, poi mostra la probabile causa e la correzione.

Un template respinto può essere modificato e inviato di nuovo, oppure potete presentare ricorso in WhatsApp Manager dopo aver aggiunto i valori di esempio; Meta afferma che i ricorsi vengono decisi entro 24 ore. Un motivo NONE significa che il template è stato sospeso, non respinto.

Utilità, marketing e autenticazione

La categoria determina sia l'approvazione sia il prezzo. I template di utilità danno seguito a qualcosa che il cliente ha fatto o richiesto, come un ordine, una prenotazione, una modifica all'account o un avviso, e devono essere non promozionali. I template di autenticazione portano codici monouso e usano un testo fisso di Meta. Tutto il resto, compresi promemoria del carrello, offerte e riattivazione, è marketing.

Le linee guida di categorizzazione di Meta affermano che un template che mescola contenuti di utilità e promozionali è marketing. Codici sconto, offerte di vendita, upselling, promemoria del carrello e inviti a scaricare un'app spingono un template nel marketing. Meta ricontrolla periodicamente i template approvati e sposta nella categoria marketing quelli di utilità che sembrano promozionali, di solito con un giorno di preavviso.

Il verificatore analizza il vostro testo in inglese, arabo, francese, spagnolo, tedesco e portoghese alla ricerca di termini promozionali e vi avvisa prima che Meta ricategorizzi il template al posto vostro. Solo i template di autenticazione possono inviare codici monouso, quindi segnala anche diciture OTP in altre categorie.

Fonte: Meta, Template categorization, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization.

Pulsanti: raggruppamento, URL dinamici e cosa vedono i clienti

I pulsanti di risposta rapida e quelli di call-to-action devono essere raggruppati: tutte le risposte rapide prima degli altri pulsanti, oppure tutte dopo. Una risposta rapida inserita tra due link viene respinta dall'API.

Un pulsante URL può portare una variabile, e deve trovarsi alla fine dell'URL, ad esempio https://shop.example.com/orders/{{1}}. Codificate in percentuale il valore che inviate (uno spazio diventa %20). Evitate i servizi di accorciamento dei link: nascondono la destinazione e sembrano spam.

Quando un template ha più di tre pulsanti, WhatsApp ne mostra due e mette gli altri dietro “Vedi tutte le opzioni”. I template con quattro o più pulsanti, o con risposte rapide mescolate ad altri pulsanti, non possono essere visualizzati nei client desktop di WhatsApp, quindi mettete per prima l'azione più importante.

Dall'anteprima all'invio su larga scala

Il JSON esportato segue il corpo della richiesta di POST /<WABA_ID>/message_templates nella WhatsApp Business Management API, compresi i valori di esempio. Per le intestazioni multimediali, caricate un esempio con la Resumable Upload API e sostituite l'handle segnaposto.

Una volta approvato, inviate il template per nome e lingua con i valori reali di ciascuna variabile. OmniChannels.ai gestisce i template sugli account WhatsApp Business, monitora stato di revisione e qualità e invia i template approvati tramite un'unica API REST, campagne o la casella condivisa, con fallback SMS quando WhatsApp non è disponibile.

Domande sui template WhatsApp

Qual è il limite di caratteri di un template WhatsApp?

Il corpo può contenere fino a 1.024 caratteri. Un'intestazione di testo e il piè di pagina sono limitati a 60 caratteri ciascuno, e l'etichetta di ogni pulsante a 25. I template di autenticazione usano il testo fisso di Meta e il loro parametro del codice è limitato a 15 caratteri.

Perché il mio template WhatsApp è stato respinto?

I motivi più comuni sono problemi sulle variabili (non sequenziali, all'inizio o alla fine del corpo, caratteri speciali, troppe per la lunghezza del messaggio), valori di esempio mancanti o poco realistici, contenuto promozionale in un template di utilità, violazioni delle policy e duplicazione del testo di un template esistente.

Cosa significano INVALID_FORMAT e INCORRECT_CATEGORY?

Sono codici di motivo che Meta invia quando respinge un template. INVALID_FORMAT significa che la struttura viola una regola di formato, di solito nelle variabili, e arriva con un motivo dettagliato e una raccomandazione. INCORRECT_CATEGORY, come TAG_CONTENT_MISMATCH, significa che il contenuto non corrisponde alla categoria scelta. Incollate uno dei due nella scheda Respinto per vedere la correzione.

Qual è la differenza tra un template di utilità e uno di marketing?

I template di utilità confermano o aggiornano qualcosa che il cliente ha fatto o richiesto, come un ordine, un pagamento, una prenotazione o una modifica all'account, e non contengono promozioni. I template di marketing promuovono prodotti, offerte o riattivazione. Mescolare i due rende il template marketing, che ha un prezzo più alto.

Una variabile può trovarsi all'inizio o alla fine di un template?

No. Meta respinge i template il cui corpo inizia o termina con un parametro. Scrivete "Ciao {{1}}, l'ordine è pronto." anziché "{{1}}, l'ordine è pronto" o "Il numero d'ordine è {{1}}".

Quanti pulsanti può avere un template WhatsApp?

Fino a 10 pulsanti: al massimo 10 risposte rapide, 2 pulsanti URL, 1 pulsante numero di telefono e 1 pulsante copia codice. Le risposte rapide devono essere raggruppate, prima o dopo gli altri pulsanti.

Come aggiungo un link dinamico a un pulsante di un template?

Aggiungete una variabile proprio alla fine dell'URL, come https://example.com/track/{{1}}, e fornite un valore di esempio. Quando inviate il template, passate solo il suffisso, codificato in percentuale.

Posso inviare un template WhatsApp in arabo?

Sì. Create il template con il codice lingua ar e scrivete il testo in arabo. Meta non traduce i template, quindi ogni lingua è un template separato con lo stesso nome, e ciascuno conta per il vostro limite di template.

Quanto tempo richiede l'approvazione di un template WhatsApp?

La maggior parte dei template viene esaminata automaticamente in pochi minuti. Meta afferma che un template può restare in revisione fino a 24 ore. I template che superano questo verificatore evitano i rifiuti automatici più comuni.

Altri strumenti gratuiti