AccediInizia la prova gratuita
Meta Tech Provider

Crea template WhatsApp con la tua AI e correggi i rifiuti

Un'AI collegata al tuo numero WhatsApp Business tramite MCP può preparare un template, inviarlo a Meta con create_template e seguire la revisione con get_template_status. Ogni template richiede una categoria (utility, marketing o authentication), variabili numerate come {{1}} con un valore di esempio per ciascuna e l'approvazione di Meta, che può richiedere fino a 24 ore. Un template rifiutato viene corretto e inviato di nuovo con un nuovo nome.

easyCoexistence collega il tuo numero WhatsApp Business alla Cloud API ufficiale di Meta tramite Coexistence e dà alla tua AI gli strumenti per i template, list_templates, create_template, get_template_status e send_template, oltre alle automazioni che inviano da sole i template approvati.

24 hours

Il tempo massimo che Meta indica per una decisione di approvazione di un template.

30 days

Per quanto tempo il nome di un template approvato eliminato resta inutilizzabile per un nuovo template.

512

Numero massimo di caratteri in un nome di template, che accetta solo lettere minuscole, cifre e trattini bassi.

250

Template per account WhatsApp Business su un portfolio non verificato; quelli verificati con un nome visualizzato approvato arrivano a 6.000.

April 9, 2025

Da questa data, un template inviato come utility che Meta considera promozionale viene approvato come marketing.

10 per 30 days

Modifiche consentite a un template approvato, non più di una ogni 24 ore.

Come crea un template WhatsApp la tua AI?

In poche chiamate agli strumenti, dopo che descrivi il messaggio con parole semplici. L'AI controlla cosa esiste già con list_templates, così non duplica un template approvato. Poi chiama create_template con un nome in lettere minuscole, cifre e trattini bassi, un codice lingua come en_US, pt_BR o es_ES, una categoria e i componenti: un'intestazione facoltativa, il corpo, un piè di pagina facoltativo e i pulsanti. Meta esamina l'invio e get_template_status indica APPROVED, PENDING o REJECTED per ogni lingua sotto quel nome. Una volta approvato, send_template lo invia, oppure lo fa il passaggio Invia un template di un'automazione.

1You describe itPurpose, language, the customer's name, any code
2create_templateName, language, category, components with examples
3Meta reviewsUp to 24 hours, with the decision sent by webhook and email
4get_template_statusAPPROVED, PENDING or REJECTED
5send_templateOr the Send a template step of an automation

Com'è una richiesta di template?

Questo è ciò che un'AI invia dopo una richiesta come: "Crea un template di marketing in inglese che saluti il cliente per nome e gli dia il codice WELCOME10 per il 10% di sconto sul primo ordine." Il corpo usa una sola variabile posizionale, {{1}}, con un valore di esempio, così il revisore vede un messaggio reale. Il testo segue la variabile, perché Meta rifiuta un corpo che inizia o finisce con una variabile, e il piè di pagina spiega come interrompere le offerte. Il codice promo sta nel testo del corpo, dove può inviarlo anche un'automazione.

create_template arguments for a welcome coupon
{
  "connection_id": "<from list_numbers>",
  "name": "welcome_coupon",
  "language": "en_US",
  "category": "MARKETING",
  "components": [
    {
      "type": "BODY",
      "text": "Hi {{1}}, welcome to Bloom Café! Use code WELCOME10 for 10% off your first order.",
      "example": { "body_text": [["Ana"]] }
    },
    { "type": "FOOTER", "text": "Reply STOP to stop offers" }
  ]
}

Quale categoria deve avere il template?

Quella che corrisponde a ciò che fa il messaggio, perché Meta verifica il contenuto rispetto alla categoria. Dal 9 aprile 2025, un invio come utility che sembra promozionale viene approvato come marketing. Meta può anche cambiare in seguito la categoria di un template approvato, con un webhook template_category_update e 60 giorni per fare ricorso in Business Support Home. I template di marketing richiedono un metodo di pagamento sul tuo account WhatsApp Business prima di poter essere inviati, e Meta addebita ogni categoria con le proprie tariffe, per paese.

UTILITYFollows up on something the customer did or asked for: an order update, a booking confirmation, a delivery notice
MARKETINGAwareness, sales and retargeting: coupons, discounts, promo codes, offers, and any mix with a promotion
AUTHENTICATIONVerifies identity with a one-time code, in a strict fixed format

Come funzionano variabili ed esempi?

Le variabili posizionali sono numerate da 1 nell'ordine in cui compaiono, {{1}}, {{2}}, e Meta richiede un valore di esempio per ciascuna alla creazione del template, come in "example": {"body_text": [["Ana"]]}. Al momento dell'invio i valori vanno nello stesso ordine. La tua AI li compila tramite components di send_template, che può contenere anche media dell'intestazione e valori dei pulsanti, come il codice di un pulsante copia-codice.

Le automazioni sono oggi più limitate: il passaggio Invia un template compila le variabili del corpo per posizione, ad esempio "params": ["{{first_name}}"], che mette il nome del cliente in {{1}}. I template con variabili con nome, con un'immagine di intestazione variabile, o con un pulsante che contiene una variabile non possono ancora essere inviati da un'automazione. Quindi metti un coupon che un'automazione invierà nel corpo, non in un pulsante copia-codice.

Perché Meta rifiuta i template?

La revisione di Meta è in parte automatica e in parte manuale, e la sua documentazione elenca le cause più comuni. La maggior parte si può vedere prima dell'invio, ed è per questo che conviene chiedere all'AI di controllare prima la bozza con questo elenco:

  • Formattazione delle variabili: parentesi graffe mancanti o non corrispondenti, caratteri speciali come #, $ o % dentro una variabile, numeri fuori sequenza, oppure un corpo che inizia o finisce con una variabile.
  • Troppe variabili per la lunghezza del testo che le circonda.
  • Politica: contenuti che violano la WhatsApp Business Policy o la Commerce Policy, contenuti offensivi o minacciosi, oppure la richiesta di identificativi sensibili completi; quelli parziali sono consentiti.
  • Duplicazione: testo del corpo o del piè di pagina uguale a quello di un template esistente, un controllo da cui sono esentati i template di autenticazione.
  • Una categoria non adatta, respinta con il motivo INCORRECT_CATEGORY, oppure un testo oltre il limite di lunghezza di un componente.

Come correggi un rifiuto con la tua AI?

Parti dal motivo di Meta. Compare in WhatsApp Manager, nell'email di Meta agli amministratori di Business Suite e nel webhook dello stato del template, mentre get_template_status mostra lo stato REJECTED. Incolla il motivo nella chat e chiedi all'AI di riscrivere il template secondo l'elenco di Meta: aggiungi testo dopo una variabile finale, aggiungi valori di esempio, rinumera le variabili o sposta una promozione fuori da un template utility. Poi chiedile di inviare la versione corretta con un nome nuovo, come welcome_coupon_v2, perché lo stesso nome nella stessa lingua viene rifiutato come duplicato (errore 100, sottocodice 2388024).

Il connettore non modifica né elimina i template. Puoi invece modificare il template rifiutato in WhatsApp Manager e inviarlo di nuovo con esempi, cosa che vale anche come ricorso. Se elimini un template approvato, il suo nome non può essere riutilizzato per 30 giorni.

I template possono essere inviati dall'app WhatsApp Business su un numero Coexistence?

No. Su un numero collegato tramite Coexistence il team continua a chattare dall'app, ma i template esistono solo lato API, quindi partono tramite send_template, il passaggio Invia un template di un'automazione o il tuo codice. Per questo i template sono il modo per raggiungere chi ha inviato l'ultimo messaggio più di 24 ore fa: da quel momento Meta accetta solo template pre-approvati, mentre una risposta scritta funziona solo entro la finestra. I messaggi template sono fatturati da Meta al tuo account WhatsApp Business, per categoria e paese, e easyCoexistence non applica mai un ricarico.

Errori comuni

  • Inviare un template subito dopo averlo sottoposto. Finché Meta non lo approva, l'invio fallisce con l'errore 132001, l'errore per un template che non esiste in quella lingua o non è approvato.
  • Terminare il corpo con la variabile, come in "Il tuo codice è {{1}}". Meta rifiuta un corpo che inizia o finisce con una variabile, quindi aggiungi una frase di chiusura dopo di essa.
  • Mettere un coupon in un template utility. Meta lo approva come marketing o lo rifiuta, e in entrambi i casi non partirà come utility.
  • Usare un pulsante copia-codice per un coupon che un'automazione invierà. Le automazioni non possono ancora compilare le variabili dei pulsanti, quindi metti il codice nel testo del corpo.
Farlo con EasyCoexistence

L'app resta sul tuo telefono e ogni numero è monitorato 24/7. Da US$ 9 fino a US$ 0,75 per numero al mese, in calo man mano che aggiungi numeri, con i primi 3 giorni di prova gratuita.

Domande frequenti

Quanti template può avere un account?

Meta consente 250 template per account WhatsApp Business su un portfolio aziendale non verificato, e fino a 6.000 su un portfolio verificato con un nome visualizzato approvato. Limita anche la creazione a 100 template per account all'ora.

Posso modificare un template approvato?

Sì, in WhatsApp Manager o tramite l'API di Meta, fino a 10 volte in 30 giorni e una volta ogni 24 ore. Una modifica può cambiare i componenti e il time-to-live, ma non la categoria di un template approvato, e torna in revisione. Il connettore non modifica, quindi la tua AI invia invece una nuova versione.

Un template copre più lingue?

No. Il nome e la lingua insieme identificano un template, quindi ogni traduzione è un invio a sé con la propria revisione, sotto lo stesso nome. Chiedi all'AI di inviare insieme le versioni en_US, pt_BR ed es_ES; eliminare un template per nome rimuove tutte le sue lingue.

Perché un template è stato messo in pausa dopo l'approvazione?

L'approvazione non è permanente. Meta mette in pausa un template il cui punteggio di qualità scende al livello più basso dopo feedback negativi o scarso coinvolgimento: per 3 ore la prima volta, 6 ore la seconda, e la terza volta viene disattivato. list_templates restituisce il punteggio di qualità di ogni template, così la tua AI può segnalare un calo prima che gli invii inizino a fallire.

Continua a leggere

Pronto per iniziare?

Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.

Inizia la prova gratuita

Verificato il