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 enviás un mensaje obtenés un 200 inmediato confirmando que se encoló — no la respuesta del bot. La respuesta llega segundos después a tu webhook (o, si usás 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 obligatorio:
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 generás vos mismo desde el panel del tenant, en la pestaña Canal API:
- Iniciá sesión en el panel del tenant:
https://{subdomain}.overtaker.online(ohttps://app.overtaker.online). - Andá a la pestaña Canal API del menú lateral.
- Hacé clic en Nueva API Key, ponele un nombre y (opcional) la URL de tu webhook.
- Copiá y guardá la raw key (
sk_live_...) y el webhook secret — solo se muestran una vez y no se pueden recuperar después.