50% OFF with code BLACKFRIDAY5020% OFF with code BLACKFRIDAY20
Integrazioni e APIDa Growth / Pro in su

API: elencare e inviare modelli WhatsApp

Due endpoint permettono al tuo software di usare i tuoi modelli WhatsApp. GET /api/v1/whatsapp/templates elenca i tuoi modelli approvati e POST /api/v1/whatsapp/send-template ne invia uno a un cliente dal tuo numero predefinito. Entrambi richiedono una chiave con accesso WhatsApp.

Dove
Ask Menuthere support for a key
Piano
Richiede un numero WhatsApp Business collegato, disponibile dal piano Starter / Pro.
Aggiornato

Elenca i tuoi modelli

curl 'https://menuthere.com/api/v1/whatsapp/templates' -H 'Authorization: Bearer ck_live_YOUR_KEY'

Restituisce i modelli approvati sul tuo numero predefinito, così conosci il nome esatto e quanti valori richiede ciascuno.

CampoSignificato
name, languageIl nome del modello e il codice della lingua.
category, statusCategoria, ad esempio MARKETING o UTILITY. Lo stato è APPROVED.
body_variablesQuanti valori {{n}} richiede il corpo.
has_header, header_formatSe c'è un'intestazione, e TEXT, IMAGE, VIDEO o DOCUMENT.

Invia un modello

POST /api/v1/whatsapp/send-template con un corpo JSON. Il messaggio parte dal tuo mittente predefinito, impostato in Più numeri e numero principale. Non puoi scegliere il numero nella chiamata.

CampoObbligatorioCos'è
toSìIl numero del cliente con prefisso internazionale.
template_nameSìIl nome preso dalla chiamata dell'elenco.
languageNoSe lo ometti, viene ricavato dal modello approvato.
body_paramsNoElenco di valori per {{1}}, {{2}} e così via, in ordine.
header_paramsNoElenco di valori per un'intestazione di testo.
header_media_url, header_media_typeNoUn link e image, video o document per un'intestazione multimediale.
button_paramsNoElenco di valori per un pulsante con URL dinamico.
idempotency_keyNoUn riferimento che scegli tu. Funzionano anche id e un'intestazione Idempotency-Key.

Un invio riuscito restituisce ok: true, il message_id, il numero to e status: "sent". Se invii di nuovo la stessa chiave di idempotenza, ricevi il primo risultato con duplicate: true e nulla viene inviato due volte. Un invio fallito rilascia la chiave così puoi riprovare.

Errori e limiti

Stato`error`Significato
400missing_fields, invalid_json, invalid_number, template_errorManca un campo obbligatorio, il numero sembra sbagliato, oppure il modello non è adatto ai valori che hai inviato.
404template_not_foundNessun modello approvato con quel nome sul tuo numero predefinito.
409recipient_opted_outIl cliente ha risposto STOP. Non viene inviato alcun messaggio.
409in_progressUna richiesta con la stessa chiave di idempotenza è ancora in corso.
412no_whatsapp_numberNon è collegato alcun numero WhatsApp predefinito.
429daily_limit_reached, rate_limitedIl limite giornaliero WhatsApp del tuo numero è esaurito, oppure la chiave ha superato il suo limite di richieste.
502send_failedWhatsApp non è raggiungibile. Riprova.
Da sapereOgni invio tramite API è un normale messaggio WhatsApp, quindi Meta lo addebita come qualsiasi altro. Vedi Quanto costano i messaggi WhatsApp. Un modello deve essere approvato prima di poter essere inviato. Vedi Modelli di messaggio.

Domande

Posso inviare un normale messaggio di testo tramite l'API?
No. L'API invia solo modelli approvati, che raggiungono i clienti anche fuori dalla finestra di 24 ore.
Scriverà a chi ha rifiutato i messaggi?
No. Un cliente che ha risposto STOP viene saltato e la chiamata restituisce recipient_opted_out.

Non lo trovi? Scrivi a help@mail.menuthere.com o chatta con noi, dalle 9 alle 21.Centro assistenzaPrezzimenuthere.com