Skip to main content

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. Con status=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.
Con status=all compaiono anche template come questo:

Campi del template

Campi della variabile

Le variabili si riempiono con le chiavi key esattamente come le restituisce questo elenco: {"body.1": "Mario", "body.2": "30 aprile"}. Un template creato fuori dall’API (per esempio nel pannello di Meta) può avere variabili con nome invece che con numero. In quel caso la chiave è body.nome.

Template che l’API non può inviare

usable è false, e l’invio risponde template_not_usable, quando il template:
  • non è approvato (status diverso da APPROVED);
  • 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.
Questi template si inviano dal pannello di MyFlow.

Errori

400 - number_required

L’account ha più numeri e manca from. 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.