Conecta tu propio sistema a Wabbi

Autenticación

Cada negocio tiene su propia api_key. La encuentras (y la puedes regenerar) en tu portal, en Cuenta, junto con tu TU_CLIENTE_ID. Mándala en el header X-Api-Key de cada llamada. Tu llave solo da acceso a los datos de tu negocio.

Enviar mensajes

Mismo endpoint para los tres canales: cambia whatsapp_cloud por messenger o instagram. El destinatario va en la URL (el teléfono en WhatsApp; el ID del contacto en Messenger e Instagram).

curl -X POST /api/config/clientes/TU_CLIENTE_ID/chats/whatsapp_cloud/5215512345678/mensajes \
  -H "X-Api-Key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "text": "Hola, ¿en qué te ayudo?" }'

Botones de respuesta rápida (WhatsApp)

Hasta 3 botones (máx. 20 caracteres cada uno) para que tu cliente toque una opción en vez de escribir:

{ "text": "¿Te comparto el menú?", "botones": [{ "titulo": "Sí" }, { "titulo": "Ahora no" }] }

Recibir mensajes

Dos formas, y puedes usar las dos:

Consultar (pull)

Pregunta cuando quieras qué hay de nuevo. Guarda el nextAfter de la respuesta y mándalo como after en tu siguiente llamada para seguir donde te quedaste, sin repetidos.

curl "/api/config/clientes/TU_CLIENTE_ID/messages?after=0&direccion=inbound" \
  -H "X-Api-Key: TU_API_KEY"

# Respuesta
{ "mensajes": [ ... ], "nextAfter": "1542" }

Que Wabbi te avise (webhook)

Registra tu URL en tu portal (Cuenta → Webhook de mensajes entrantes) y Wabbi te manda cada mensaje nuevo en cuanto llega. Si una respuesta automática o Wabbi IA ya lo contestó, no se te reenvía.

{ "message": {
    "id": "wamid...",
    "from": "5215512345678",
    "text": { "body": "Hola" },
    "canal": "whatsapp_cloud",
    "wabbi": { "direction": "inbound" }
} }

Compatibilidad con la API de Meta

Si tu sistema ya usa la API de WhatsApp Cloud de Meta, puedes apuntarlo a Wabbi sin reescribirlo: mismo formato de envío y de respuesta. Manda por tu WhatsApp conectado en Wabbi.

curl -X POST /TU_PHONE_NUMBER_ID/messages \
  -H "X-Api-Key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "to": "5215512345678", "text": { "body": "Hola desde mi sistema" } }'

# Respuesta
{ "messaging_product": "whatsapp", "messages": [{ "id": "wamid..." }] }

Reglas y límites

• Ventana de 24 horas (regla de Meta): solo puedes mandar texto libre dentro de las 24 h siguientes al último mensaje del cliente.
• Máximo 4,096 caracteres por mensaje.
• Los botones solo están disponibles en WhatsApp.
• Sin el canal conectado, el envío responde 409 con "codigo": "NOT_CONFIGURED".
• Cada mensaje enviado o recibido cuenta para el límite de tu plan.

Referencia completa

En tu portal, en Guías de uso, está la lista completa de endpoints (canales, respuestas automáticas, IA, contactos, citas y más).