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.
Octubre 2026
Sección titulada «Octubre 2026»Cambios
Sección titulada «Cambios»- Webhooks de tickets —
ticket.created,ticket.state_changedyticket.resolvedincluyen ahoraticket_id;ticket.resolvedsumaresult(motivo de cierre). Estados nuevos:INCOMPLETOyRECHAZADO.lead_idpuede sernull. - Límites de protocolos —
POST /partner/tenants/{id}/kb/protocolsadmite hasta 12 protocolos activos por tenant, 120 caracteres de situación y 800 de procedimiento. Si uno no cumple, no se carga ninguno (400).
Correcciones de esta documentación
Sección titulada «Correcciones de esta documentación»- Reintentos de webhook: son 4 intentos en total (10 s, 30 s, 2 min), no 4 reintentos con espera de 10 minutos.
tenant.limit_warningse envía al 90% y al 95%.POST /partner/tenants/{id}/kb/documentsresponde{ message, file_name }; no devuelvesource_id.GET /partner/webhooksresponde{ webhook_url, key_prefix, configured }; no lista los eventos suscritos.GET /partner/webhooks/logsno incluye tiempo de entrega.bot_nameenPOST /partner/tenantscrea la configuración inicial del bot, pero el nombre no se guarda.
v1.4.0 — 2026-05-27
Sección titulada «v1.4.0 — 2026-05-27»Nuevas funciones
Sección titulada «Nuevas funciones»- Rate limiting por API key — Cada API key tiene un límite de 120 requests/minuto. Al excederlo recibirás
HTTP 429con headersX-RateLimit-LimityRetry-After: 60.
v1.3.0 — 2026-05-21
Sección titulada «v1.3.0 — 2026-05-21»Nuevas funciones
Sección titulada «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% y 95% de consumo) ytenant.limit_reached(100%) al webhook del partner automáticamente.
Mejoras
Sección titulada «Mejoras»- El log de webhooks (
GET /partner/webhooks/logs) ahora incluye el HTTP status de respuesta y el tiempo de entrega. GET /partner/billingsoporta filtrado por período (?period=2026-05).
v1.2.0 — 2026-04-10
Sección titulada «v1.2.0 — 2026-04-10»Nuevas funciones
Sección titulada «Nuevas funciones»POST /partner/tenants/{id}/kb/documents— Carga de archivos (PDF, DOCX, TXT) al Knowledge Base del bot. Retornasource_idpara gestión posterior.GET /partner/tenants/{id}/kbyDELETE /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
Sección titulada «v1.1.0 — 2026-03-15»Nuevas funciones
Sección titulada «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 50 por defecto; hasta 200 con?limit=).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
Sección titulada «v1.0.0 — 2026-02-01»Lanzamiento inicial de la Partner API.
Funciones incluidas
Sección titulada «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
Sección titulada «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: trueySunset: <fecha>. - Transcurrido el período, el endpoint responde
HTTP 410 Gone.
No hemos deprecado ningún endpoint hasta la fecha.
Soporte
Sección titulada «Soporte»¿Preguntas sobre la integración? Escríbenos a contacto@overtaker.online.