--- title: "Anteprima e verifica dei template WhatsApp" description: "Create un template WhatsApp, vedetene l'anteprima su un telefono e verificatelo rispetto alle regole Meta: limiti di caratteri, variabili, pulsanti e categorie." canonical: "https://omnichannels.ai/it/tools/whatsapp-template-preview/" language: "it" updated: "2026-10-10" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" --- # Anteprima e verifica dei template WhatsApp Canonical: https://omnichannels.ai/it/tools/whatsapp-template-preview/ Language: it Publisher: OmniChannels.ai by BroadNet Technologies 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). ## Come vedere l'anteprima e verificare un template WhatsApp 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. **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. **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. **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 //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.