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.
Cómo funciona
Sección titulada «Cómo funciona»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ónAutenticación
Sección titulada «Autenticació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):
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxX-Overtaker-Version: 1Dónde obtener tu API key
Sección titulada «Dónde obtener tu API key»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:
- Inicia sesión en el panel del tenant:
https://{subdomain}.overtaker.online(ohttps://app.overtaker.online). - Ve a la pestaña Canal API del menú lateral.
- Haz clic en Nueva API Key, ponle un nombre y la URL de tu webhook (obligatoria, HTTPS).
- Copia y guarda la raw key (
sk_live_...) y el webhook secret — solo se muestran una vez y no se pueden recuperar después.