Panoramica
L'API dei modelli WhatsApp ti permette di inviare modelli WhatsApp approvati tramite codice. È utile per inviare conferme, promemoria e notifiche automatiche da sistemi esterni. Per autenticarti ti serve una chiave API.
Autenticazione
Includi la tua chiave API in ogni richiesta:
X-API-Key: bg_live_your_key_hereAuthorization: Bearer bg_live_your_key_here
Inviare un modello
POST https://app.bugalou.com/api/templates/send
Authorization: Bearer bg_live_your_api_key_here
Content-Type: application/json
{
"template": "order_bevestiging",
"phone": "31612345678",
"variables": { "name": "Jan", "order": "12345" }
}
Parametri
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
template | string | Sì | Nome del modello (per esempio order_bevestiging) |
phone | string | Sì | Numero di telefono con prefisso internazionale, senza + (per esempio 31612345678) |
variables | object | No | Coppie chiave-valore per i segnaposto del modello |
Elencare i modelli disponibili
GET https://app.bugalou.com/api/templates/send Authorization: Bearer bg_live_your_api_key_here
Restituisce un array con tutti i modelli approvati, con i loro nomi e le variabili previste.
Esempi di modelli
verificatie_code— invia un codice di verificaorder_bevestiging— conferma d'ordine con numero d'ordineorder_verzonden— notifica di spedizione con informazioni di tracciamentoafspraak_herinnering— promemoria di un appuntamentofactuur_herinnering— promemoria di pagamento di una fattura
La REST API è disponibile con il piano Enterprise.
Formato della risposta
Successo: {"success": true, "messageId": "..."}
Errore: {"error": "Invalid or expired API key"} (401) oppure {"error": "Template not found"} (404)
Casi d'uso
- E-commerce: invia conferme d'ordine e aggiornamenti di spedizione dal tuo negozio online
- Aziende di servizi: invia promemoria di appuntamenti e notifiche sulle fatture
- App personalizzate: avvia messaggi WhatsApp da qualsiasi sistema tramite HTTP