Chat vía API te da un endpoint REST único, firmado con HMAC SHA-256, para integrar el agente IA de tu negocio en cualquier sistema externo: tu chat propio, una app móvil, un IVR, un asistente interno. La respuesta del agente llega en el mismo HTTP request (latencia menor a 15 segundos). Disponible solo en plan Premium.

Cómo funciona

Ve a Conexiones → Chat vía API
Click Crear endpoint — el modal muestra tu endpoint_id y secret
Guarda el secret ahora — solo se muestra UNA vez. Si lo pierdes deberás rotar.
Copia el snippet en cURL, Node.js, Python o PHP que el panel te da personalizado
Pégalo en tu backend, reemplaza YOUR_SECRET con el valor real
Cada mensaje del usuario recibe respuesta del agente en ~1 segundo

Cuándo usarlo

Tienes un chat propio en tu sitio y quieres sumar IA sin reemplazarlo (caso típico: mimotord.com)
Quieres integrar el agente en una app móvil nativa
Tienes un IVR, kiosko o cualquier interfaz custom que necesita respuestas automáticas
Quieres conectar el agente a un workflow interno (n8n, Make, Zapier vía webhook)

Autenticación HMAC

Cada request debe llevar el header X-AA-Signature: sha256=<hex>. La firma se calcula como HMAC-SHA256 del body crudo usando tu secret. Nunca expongas el secret en código de cliente (browser, app) — firma solo desde tu servidor.

Handover humano

Si el bot detecta urgencia o tú tomas la conversación desde el panel, el endpoint devuelve status: "queued". Tu sistema entonces polea GET /messages/poll cada 3 segundos hasta recibir la respuesta del humano. Las respuestas del agente humano llegan con role: "agent" o role: "admin".

Operaciones del panel

Rotar secret: genera uno nuevo, invalida el anterior inmediatamente
Desactivar: el endpoint deja de responder (403 ENDPOINT_INACTIVE). Puedes crear uno nuevo después
Ver uso 7 días: contador de requests procesadas en la última semana
Último uso: timestamp del último request exitoso

Rate limits

Default 60 requests por minuto por endpoint, con sliding window. Headers de respuesta: X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After (solo en 429). Cada endpoint tiene su propio bucket.

Códigos de error

401 SIGNATURE_REQUIRED/INVALID: falta o no coincide el header X-AA-Signature
403 ENDPOINT_INACTIVE: el endpoint fue desactivado en el panel
404 ENDPOINT_NOT_FOUND: endpoint_id no existe o formato inválido
429 RATE_LIMITED: superaste 60 req/min, espera lo indicado en Retry-After

Documentación completa

Las docs públicas con quickstart paso a paso, referencia de cada endpoint, ejemplos de request/response, idempotencia y mejores prácticas están en /docs/chat-api — accesibles sin login, listas para compartir con tus desarrolladores.