Ir al contenido

Canal API

El Canal API te deja usar el agente de IA de un tenant como un canal de mensajería más, pero embebido en tu propio producto: un widget en tu sitio, el chat de tu app móvil, una bandeja dentro de tu CRM, o cualquier interfaz que controles. Tu aplicación envía los mensajes del usuario y recibe las respuestas del bot — sin WhatsApp, Instagram ni Messenger de por medio.

El Canal API es asíncrono. Cuando envías un mensaje obtienes un 200 inmediato confirmando que se encoló — no la respuesta del bot. La respuesta llega segundos después a tu webhook (o, si usas streaming SSE, por el propio stream).

// Tu app OvertakerAI
// │ │
// ├─ POST /channel/message ──────────▶│
// │◀─ {"status":"received"} ──────────┤ ← respuesta inmediata (mensaje encolado)
// │ │
// │ (bot procesa, ~1-3 seg) │
// │ │
// │◀─ POST {event:"message.response"} ┤ ← webhook a tu servidor
// │ │
// ├─ HTTP 200 ───────────────────────▶│ ← debes confirmar recepción

Todas las llamadas usan una API key sk_live_*, con el header de versión (si lo omites se asume 1; envíalo siempre para fijar el comportamiento):

Ventana de terminal
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx
X-Overtaker-Version: 1

Esta API key es exclusiva del Canal API: autoriza los endpoints /channel/* de este tenant y nada más. No es una credencial de Partner API (la Partner API, para crear y administrar tenants, usa una key OEM que provisiona Overtaker por separado).

La API key la generas tú mismo desde el panel del tenant, en la pestaña Canal API:

  1. Inicia sesión en el panel del tenant: https://{subdomain}.overtaker.online (o https://app.overtaker.online).
  2. Ve a la pestaña Canal API del menú lateral.
  3. Haz clic en Nueva API Key, ponle un nombre y la URL de tu webhook (obligatoria, HTTPS).
  4. Copia y guarda la raw key (sk_live_...) y el webhook secret — solo se muestran una vez y no se pueden recuperar después.