Skip to main content

POST /v1/whatsapp/templates

Crea un template WhatsApp sull’account WhatsApp Business del numero e lo manda a Meta per la revisione. È lo stesso template che si crea dal pannello, in MyFlow → Template, con le stesse regole. Un template appena creato non si può ancora inviare: nasce di norma in revisione (PENDING), e Meta decide dopo, di solito in pochi minuti, a volte in qualche ora. Per sapere com’è andata ci sono due strade: Solo con status APPROVED il template si può usare nell’invio.
Il template si crea sull’account WhatsApp Business del numero: vale per tutti i numeri di quell’account. Si possono creare solo template di testo, cioè senza immagini, video o documenti nell’intestazione, e solo nelle categorie UTILITY e MARKETING.

Request Body

I bottoni

Ogni elemento di buttons è un oggetto con type e text. Il text è l’etichetta del bottone: una riga da 1 a 25 caratteri, senza variabili.

Pulizia del testo

Prima dei controlli di lunghezza i caratteri di controllo vengono tolti e gli spazi in testa e in coda eliminati. Nel corpo restano gli a capo. Negli esempi, a capo e tabulazioni diventano spazi.

Richiesta

Un template promozionale con un bottone link:

Risposta

201 Created

Campi della risposta

Da sapere

  • Nome e lingua sono la chiave del template. Lo stesso nome si può usare in un’altra lingua. Con un nome e una lingua già presenti sull’account la creazione risponde 409 template_exists, in qualunque stato sia il template esistente, anche rifiutato. Per riprovare un template rifiutato, crealo con un nome nuovo oppure eliminalo prima dal pannello.
  • Non si modifica via API. Per cambiare un template esistente si usa il pannello, in MyFlow → Template.
  • C’è un tetto giornaliero di template nuovi per ogni account WhatsApp Business. Contano anche quelli creati lo stesso giorno dal pannello. Oltre il tetto la creazione risponde 429 daily_template_limit fino a mezzanotte, ora italiana. L’API serve a creare qualche template quando serve, non a crearne in serie.
  • I controlli di Meta restano di Meta. Questa rotta controlla la forma del template prima di mandarlo. Il contenuto lo valuta Meta: una richiesta corretta per l’API può essere respinta subito (422 meta_rejected) o rifiutata più tardi durante la revisione (status REJECTED).
  • Ogni creazione resta nel Log attività dell’account, con il nome della chiave API usata.

Errori

422 - invalid_name

Manca il nome, oppure non rispetta il formato: da 1 a 60 caratteri, solo lettere minuscole, numeri e _.

422 - invalid_language

Lingua diversa da it, en, es, fr, de.

422 - invalid_category

Categoria diversa da UTILITY o MARKETING.

422 - invalid_header

L’intestazione non è testo, va a capo, contiene {{ oppure, dopo la pulizia, è vuota o supera i 60 caratteri.

422 - invalid_body

Il corpo è vuoto o supera i 1024 caratteri, contiene variabili non numerate (es. {{nome}}), oppure le variabili hanno salti (es. {{1}} e {{3}} senza {{2}}).

422 - invalid_examples

Il corpo ha variabili ma examples manca, non è un elenco, ha un numero di elementi diverso dalle variabili, oppure un esempio è vuoto o supera i 200 caratteri. error.expected dice quanti esempi servono.
Il piè di pagina non è testo, va a capo, contiene {{ oppure, dopo la pulizia, è vuoto o supera i 60 caratteri.

422 - invalid_buttons

buttons non è un elenco o ha più di 3 elementi, oppure un bottone non è valido: tipo sconosciuto, testo vuoto, testo oltre i 25 caratteri o con variabili, più di 2 link, link non https o con variabili, più di 1 telefono, telefono non valido. Il messaggio dice quale bottone (da 1) e cosa non va. error.index è la sua posizione nell’elenco, da 0.

409 - template_exists

Esiste già un template con questo nome e questa lingua sull’account WhatsApp Business del numero.

429 - daily_template_limit

Raggiunto il tetto giornaliero di template nuovi sull’account WhatsApp Business del numero, contando anche quelli creati dal pannello. Riprova dopo mezzanotte, ora italiana.

422 - meta_rejected

Meta ha respinto la richiesta di creazione. Il messaggio riporta il motivo dato da Meta, es. «Meta non ha accettato il template: …». Correggi il contenuto e riprova.

400 - number_required / invalid_from · 404 - number_not_found

Come nell’elenco dei template: from manca con più numeri, non è valido o non è collegato all’account. Gli errori comuni a tutte le rotte sono nell’introduzione.