Changelog

Todos los cambios relevantes para integradores están documentados aquí. Seguimos Semantic Versioning: cambios incompatibles incrementan la versión mayor, nuevas funciones la menor, y correcciones la de parche.

La versión actual de la API es v1. No hay planes de deprecación a corto plazo.

v1.4.0 — 2026-05-27

Nuevas funciones

Rate limiting por API key — Cada API key tiene un límite de 120 requests/minuto. Al excederlo recibirás HTTP 429 con headers X-RateLimit-Limit y Retry-After: 60.

v1.3.0 — 2026-05-21

Nuevas funciones

GET /partner/tenants/{id}/health — Health check del agente: indica si está listo para producción con checks individuales (bot_config, role_assigned, knowledge_entries, channel_connected).
PATCH /partner/tenants/{id}/plan — Cambia el plan de un tenant sin intervención manual de Overtaker.
POST /partner/tenants/{id}/reset-admin-password — Resetea la contraseña del admin del tenant.
POST /partner/tenants/{id}/chat — Endpoint de prueba para enviar un mensaje al bot de un tenant y ver la respuesta.
Webhooks de límite de uso — Overtaker envía tenant.limit_warning (90% de consumo) y tenant.limit_reached (100%) al webhook del partner automáticamente.

Mejoras

El log de webhooks (GET /partner/webhooks/logs) ahora incluye el HTTP status de respuesta y el tiempo de entrega.
GET /partner/billing soporta filtrado por período (?period=2026-05).

v1.2.0 — 2026-04-10

Nuevas funciones

POST /partner/tenants/{id}/kb/documents — Carga de archivos (PDF, DOCX, TXT) al Knowledge Base del bot. Retorna source_id para gestión posterior.
GET /partner/tenants/{id}/kb y DELETE /partner/tenants/{id}/kb/{source_id} — Listar y eliminar entradas de conocimiento.
GET /partner/roles — Lista los BotRoles disponibles para asignar a bots.

v1.1.0 — 2026-03-15

Nuevas funciones

POST /partner/webhooks — Registra una URL HTTPS para recibir eventos en tiempo real.
GET /partner/webhooks — Consulta la URL y eventos suscritos actualmente.
GET /partner/webhooks/logs — Historial de entregas (últimas 100).
PUT /partner/tenants/{id}/bot-config/role — Asigna un BotRole preconfigurado al bot del tenant.
POST /partner/tenants/{id}/kb/protocols — Carga protocolos situacionales al bot.

v1.0.0 — 2026-02-01

Lanzamiento inicial de la Partner API.

Funciones incluidas

Autenticación con API key (sk_live_xxx)
Crear, listar, suspender y reactivar tenants
Configurar bot: nombre, tono, prompt, modelo LLM, timeout
Cargar FAQs al Knowledge Base (POST /partner/tenants/{id}/kb/answers)
Consultar estado del tenant (GET /partner/tenants/{id})
Dashboard de facturación por período (GET /partner/billing)

Política de deprecación

Cuando un endpoint o parámetro sea marcado para deprecación:

Se anuncia en este changelog con al menos 90 días de anticipación.
El endpoint sigue funcionando durante ese período pero retorna el header Deprecation: true y Sunset: <fecha>.
Transcurrido el período, el endpoint responde HTTP 410 Gone.

No hemos deprecado ningún endpoint hasta la fecha.

Soporte

¿Preguntas sobre la integración? Escríbenos a contacto@overtaker.online.