Conceptos

Antes de integrar, conviene entender qué resuelve la Partner API —y qué no— para no diseñar tu integración sobre supuestos equivocados.

Qué es

La Partner API es una API de aprovisionamiento y administración. Te permite operar, desde tu propia plataforma y de forma programática, el ciclo de vida de los agentes IA de tus clientes:

Crear y administrar tenants (cada cliente tuyo es un tenant aislado).
Configurar el agente de cada tenant: personalidad, rol, modelo, tono.
Cargar conocimiento: FAQs, protocolos y documentos.
Consultar estado y facturación: health del agente, uso y consumo por tenant.
Recibir eventos vía webhooks firmados (mensajes, leads, límites de uso).

Qué NO es (todavía)

Para evitar sorpresas, estos son los límites reales hoy:

Límite	Detalle
No conecta canales por API	WhatsApp, Instagram y Messenger se conectan manualmente en el panel de cada tenant. Ver Conectar un canal.
No expone conversaciones	No accedes al contenido de los chats ni a los leads de tus clientes. Solo recibes previews por webhook.
No hay sandbox	Todas las llamadas van a producción con tu key `sk_live_`. Crear tenants de prueba crea tenants reales.
No es self-serve	Tu cuenta debe tener acceso Partner habilitado por el equipo de Overtaker antes de empezar.

Modelo de datos

Partner (tu cuenta)
 └── Tenant (tu cliente)         ← aislamiento físico de datos
      ├── Bot Config             ← personalidad, modelo, rol del agente
      ├── Knowledge Base         ← FAQs, protocolos, documentos
      ├── Canal (manual)         ← WhatsApp / Instagram / Messenger / Webchat
      └── Plan                   ← límites de conversaciones y usuarios

Partner: tu cuenta de reseller. Una API key sk_live_ cuelga de ella.
Tenant: cada cliente que das de alta. Tiene su propio schema de base de datos, su agente y su conocimiento, completamente aislado de los demás.
Bot Config / Knowledge Base: lo que define cómo responde el agente del tenant.
Canal: por dónde tus clientes finales hablan con el agente. Se conecta aparte (ver más abajo).

Flujo de integración típico

Creás el tenant del cliente → Quickstart
Configurás su agente (rol, tono, modelo) → Completar Prompt builder
Cargás su conocimiento (FAQs, documentos) → Cargar conocimiento
Conectás un canal en el panel del tenant → Conectar un canal
Verificás con GET /tenants/{id}/health que ready: true
Te suscribís a webhooks para reaccionar en tu sistema

Los pasos 1-3 y 6 son por API. El paso 4 es manual hoy.

Límites operativos

Concepto	Valor
Rate limit	120 requests/minuto por API key (responde `429` al exceder)
Formato de API key	`sk_live_xxxxxxxxxxxxxxxx` (solo producción)
Base URL	`https://api.overtaker.online/api/v1`
Autenticación	Header `Authorization: Bearer sk_live_xxx`

Herramientas

Especificación OpenAPI: descargá el spec en /openapi/partner.json. Es la fuente de verdad de la Referencia de API.
Postman / Insomnia: importá ese mismo archivo (Import → Link y pegá la URL del spec, o el archivo descargado) para obtener una colección con los 25 endpoints lista para probar.
Generar un cliente: con el spec podés generar un cliente tipado en tu lenguaje usando openapi-generator.

¿Listo para empezar? Continuá con la guía de autenticación.