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:
- l’evento webhook
template.status, che arriva quando Meta approva o rifiuta; - GET /v1/whatsapp/templates?status=all, che mostra lo stato di ogni template e il motivo di un eventuale rifiuto.
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 dibuttons è 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
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
409template_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
429daily_template_limitfino 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 (
422meta_rejected) o rifiutata più tardi durante la revisione (statusREJECTED). - 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 dait, en, es, fr, de.
422 - invalid_category
Categoria diversa daUTILITY 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 maexamples 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.
422 - invalid_footer
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.