Documentación de IxiChat

IxiChat es una plataforma de chatbots multi-canal (WhatsApp, Instagram, Messenger, web widget) con RAG, voz y un flow builder visual. Esta documentación es para desarrolladores que quieren integrar IxiChat con su propia app, ERP o producto SaaS.

Casos de uso típicos

• Un ERP que quiere agregar inbox de WhatsApp a sus clientes sin construir uno propio.
• Una app de pagos/agendas que necesita disparar mensajes a clientes (recordatorios, comprobantes).
• Un CRM que quiere sincronizar conversaciones y contactos de IxiChat con su pipeline.
• Un portal de afiliados que provisiona workspaces de IxiChat para cada cliente que firma.

Las 3 piezas que tenés que conocer

1. Connect Apps + OAuth

Registrá tu app en /app/developers para obtener un client_id + client_secret. Después rediriges a tus usuarios a /connect/<tu-slug> y recibís un api_key por cada workspace que te autorice. Detalle del flujo OAuth →

2. API REST v1

Con el api_key en mano, llamás a /api/v1/* para gestionar contactos, enviar mensajes, leer conversaciones, disparar flujos. Lista de endpoints →

3. Webhooks o Embed

Dos formas (no excluyentes) de mostrar actividad en tu app:

• Webhooks — recibís eventos (message.received, conversation.resolved, …) en una URL tuya y los procesás como quieras. Cómo configurarlos →
• Embed — empotrás el inbox de IxiChat dentro de tu UI vía iframe firmado. Tus usuarios responden mensajes sin salir de tu app. Guía de embed + SDK →

Quickstart en 5 minutos

1. Registra tu app en /app/developers/new y guarda el client_secret (se muestra una sola vez).
2. Un admin de IxiChat la aprueba (queda en estado draft hasta entonces).
3. Redirige a tu usuario a /connect/<slug>?redirect_uri=...&state=....
4. Intercambiá el code por un api_key:

curl -X POST https://ixichat.com/api/connect/exchange \
  -H "Content-Type: application/json" \
  -d '{
    "code": "cnct_<el-code>",
    "redirect_uri": "https://miapp.com/api/integrations/ixichat/callback",
    "client_id": "cid_...",
    "client_secret": "ixc_sec_..."
  }'

La respuesta incluye un api_key (formato ixc_live_...) y un webhook_secret. Guardalos por workspace.

Convenciones

• Todos los endpoints son HTTPS. La base default es https://ixichat.com.
• Errors devuelven JSON { "error": "<code>", "detail"?: "..." } y status HTTP semántico (4xx = tu input, 5xx = nuestro problema).
• Rate limit: 200 req/min por api_key + 800 req/min agregado por tenant.
• IDs son UUIDs. Timestamps son ISO 8601 UTC.