Ir al contenido

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.


  • Webhooks de tickets — ticket.created, ticket.state_changed y ticket.resolved incluyen ahora ticket_id; ticket.resolved suma result (motivo de cierre). Estados nuevos: INCOMPLETO y RECHAZADO. lead_id puede ser null.
  • Límites de protocolos — POST /partner/tenants/{id}/kb/protocols admite hasta 12 protocolos activos por tenant, 120 caracteres de situación y 800 de procedimiento. Si uno no cumple, no se carga ninguno (400).
  • Reintentos de webhook: son 4 intentos en total (10 s, 30 s, 2 min), no 4 reintentos con espera de 10 minutos.
  • tenant.limit_warning se envía al 90% y al 95%.
  • POST /partner/tenants/{id}/kb/documents responde { message, file_name }; no devuelve source_id.
  • GET /partner/webhooks responde { webhook_url, key_prefix, configured }; no lista los eventos suscritos.
  • GET /partner/webhooks/logs no incluye tiempo de entrega.
  • bot_name en POST /partner/tenants crea la configuración inicial del bot, pero el nombre no se guarda.

  • 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.

  • 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) y tenant.limit_reached (100%) al webhook del partner automáticamente.
  • 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).

  • 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.

  • 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.

Lanzamiento inicial de la Partner API.

  • 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)

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

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

No hemos deprecado ningún endpoint hasta la fecha.


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