GET /v1/whatsapp/templates
Restituisce i template WhatsApp di un numero. Un template è un messaggio già approvato da Meta. Serve a scrivere a un cliente che non ti ha scritto nelle ultime 24 ore: fuori da quella finestra WhatsApp non accetta testo libero. Per ogni template l’elenco dice quali variabili riempire e se l’API può inviarlo. Senza parametri restituisce solo i template approvati, cioè quelli che si possono inviare. Constatus=all restituisce tutti, compresi quelli in revisione o rifiutati, con il motivo del rifiuto. Serve a seguire l’esito dei template creati con POST /v1/whatsapp/templates.
I template appartengono all’account WhatsApp Business del numero, non al singolo numero. Se due numeri sono sullo stesso account WhatsApp Business, l’elenco è lo stesso.
Parametri
Nell’indirizzo il
+ va codificato come %2B: ?from=%2B390212345678.
Richiesta
Risposta
200 OK. I template sono in ordine di nome, poi di lingua.
status=all compaiono anche template come questo:
Campi del template
Campi della variabile
Template che l’API non può inviare
usable è false, e l’invio risponde template_not_usable, quando il template:
- non è approvato (
statusdiverso daAPPROVED); - ha un’intestazione con un file (immagine, video o documento): l’API per ora non allega file;
- è un carosello o un’offerta a tempo;
- ha un’intestazione con una posizione, oppure bottoni diversi da risposta rapida, link e telefono.
Errori
400 - number_required
L’account ha più numeri e mancafrom. In error.numbers c’è l’elenco dei numeri ammessi.
400 - invalid_from
from non è un numero di telefono valido.
404 - number_not_found
from è un numero valido, ma non è collegato a MyFlow su questo account.
400 - invalid_status
status ha un valore diverso da all.
Gli errori comuni a tutte le rotte sono nell’introduzione.