REST API: modelli WhatsApp

Invia modello WhatsApp tramite codice con la REST API di Bugalou. Gestisci modelli e variabili.

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_here
  • Authorization: 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

CampoTipoObbligatorioDescrizione
templatestringSìNome del modello (per esempio order_bevestiging)
phonestringSìNumero di telefono con prefisso internazionale, senza + (per esempio 31612345678)
variablesobjectNoCoppie 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 verifica
  • order_bevestiging — conferma d'ordine con numero d'ordine
  • order_verzonden — notifica di spedizione con informazioni di tracciamento
  • afspraak_herinnering — promemoria di un appuntamento
  • factuur_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

Non trovi quello che cerchi?

Chiedi direttamente a noi e riceverai una risposta personale.

Fai la tua domanda