API REST: plantillas de WhatsApp

Visión general

La API de plantillas de WhatsApp te permite enviar de forma programática mensajes de plantilla de WhatsApp aprobados. Es útil para enviar confirmaciones, recordatorios y notificaciones automáticos desde sistemas externos. Necesitas una clave de API para autenticarte.

Autenticación

Incluye tu clave de API en cada solicitud:

• X-API-Key: bg_live_your_key_here
• Authorization: Bearer bg_live_your_key_here

Enviar un mensaje de plantilla

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" }
}

Parámetros

Campo	Tipo	Obligatorio	Descripción
template	string	Sí	Nombre de la plantilla (p. ej. order_bevestiging)
phone	string	Sí	Número de teléfono con prefijo de país, sin + (p. ej. 31612345678)
variables	object	No	Pares clave-valor para los marcadores de la plantilla

Listar las plantillas disponibles

GET https://app.bugalou.com/api/templates/send
Authorization: Bearer bg_live_your_api_key_here

Devuelve un array con todas las plantillas aprobadas, con sus nombres y las variables esperadas.

Plantillas de ejemplo

• verificatie_code — enviar un código de verificación
• order_bevestiging — confirmación de pedido con el número de pedido
• order_verzonden — notificación de envío con información de seguimiento
• afspraak_herinnering — recordatorio de cita
• factuur_herinnering — recordatorio de pago de factura

El número de llamadas a la API disponibles depende de tu plan.

Formato de la respuesta

Éxito: {"success": true, "messageId": "..."}

Error: {"error": "Invalid or expired API key"} (401) o {"error": "Template not found"} (404)

Casos de uso

• Comercio electrónico: envía confirmaciones de pedido y novedades de envío desde tu tienda online
• Empresas de servicios: envía recordatorios de citas y notificaciones de facturas
• Aplicaciones personalizadas: activa mensajes de WhatsApp desde cualquier sistema mediante HTTP