API pública: enviar mensajes desde tu sistema

Desde Configuración → API (/configuracion/api) puedes crear una API key para que tus propios sistemas envíen mensajes de WhatsApp a través de Bongga, sin pasar por el panel.

Crear una API key

Ponle un nombre (por ejemplo, el sistema que la va a usar) y créala. La clave completa se muestra una sola vez — cópiala y guárdala en un lugar seguro, porque después solo verás los primeros caracteres.

Enviar un mensaje

Una petición POST autenticada con la API key en el encabezado Authorization:

curl -X POST https://app.bongga.dev/api/v1/messages \
  -H "Authorization: Bearer bga_live_..." \
  -H "Content-Type: application/json" \
  -d '{"to": "573001234567", "text": "Hola desde mi sistema"}'

Si el contacto no existía todavía, Bongga lo crea automáticamente (igual que cuando alguien te escribe por primera vez). El mensaje aparece en tu Bandeja como cualquier otro.

Texto libre solo funciona dentro de la ventana de 24 horas con ese contacto. Si nunca te ha escrito (o hace más de 24h que no lo hace), usa una plantilla aprobada en su lugar — ver abajo.

Enviar una plantilla aprobada

Para abrir una conversación nueva (o recontactar fuera de la ventana de 24h), envía una plantilla en vez de texto libre — igual que en Campañas, pero desde tu propio sistema. Las variables van en orden, como una lista ({{1}}, {{2}}…):

curl -X POST https://app.bongga.dev/api/v1/messages \
  -H "Authorization: Bearer bga_live_..." \
  -H "Content-Type: application/json" \
  -d '{"to": "573001234567", "templateId": "tpl_...", "variables": ["Juan", "mañana 3pm"]}'

Disparar una campaña

Un segundo endpoint envía una plantilla a todo un segmento de contactos (por etiqueta o etapa del embudo), igual que Campañas en el panel — pero se lanza de inmediato, sin quedar en borrador:

curl -X POST https://app.bongga.dev/api/v1/campaigns \
  -H "Authorization: Bearer bga_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Recontacto de julio",
    "templateId": "tpl_...",
    "segment": {"labelIds": ["lbl_..."]},
    "variableMapping": {"1": {"kind": "field", "value": "name"}}
  }'

La bandeja de la campaña es siempre la misma de la plantilla elegida — no hace falta indicarla aparte. Puedes ver el progreso y las métricas de la campaña como cualquier otra, desde Campañas en el panel.

Límites de la versión actual

• 60 solicitudes por minuto por organización (aplica a ambos endpoints).
• Puedes revocar una API key en cualquier momento; los sistemas que la usen dejan de funcionar de inmediato.