Saltar al contenido principal

Changelog

Este changelog combina cambios relevantes para integradores en la API HTTP (api.neuroon.ai) y en el widget (cdn.neuroon.ai/widget/widget.js).

Formato: las versiones del widget siguen SemVer. La API HTTP no tiene versionado en la URL; los cambios breaking se anuncian explícitamente aquí con la marca BREAKING.

2026-05-06 — Documentación​

  • Corrección: rate limits son por endpoint (no por plan). Documentación actualizada con valores exactos del backend.
  • Corrección: plugin WordPress real es neuroon-search v0.8.4 (la documentación previa decía v1.0.6).
  • Corrección: la API no emite el header X-RateLimit-Reset. Sólo se setean X-RateLimit-Limit, X-RateLimit-Remaining y Retry-After (en 429).
  • Corrección: el cuerpo de error 429 tiene la forma { error, message, retryAfter, limit, remaining, timestamp }, no la envoltura estándar { timestamp, status, error, message, path }.
  • Adición: documentado la lista de dominios "trusted" (localhost, 127.0.0.1, neuroon.ai con coincidencia por suffix) y aclarado que sólo aplica al widget token, no a la API Key.
  • Adición: clarificada la diferencia entre rate limit (throttling por endpoint) y cuotas de plan (maxProducts, maxSearchesPerMonth retornadas por GET /api/integrations/v1/shop).
  • Plugin separado neuroon-agentic-commerce v0.1.0 (UCP / AI agents, checkout para agentes) tendrá su propia sección en próxima iteración.

Documentación reescrita — 6 mayo 2026​

Reescritura completa de docs.neuroon.ai. Esta es la primera versión de la documentación verificada frase a frase contra el código fuente.

Widget​

0.9.27 — vigente​

  • Corrige que tracking.clicks: false no siempre se respetaba al guardar la cookie de atribución neuroon_clicks.
  • Versión actual desplegada en https://cdn.neuroon.ai/widget@0.9.27/widget.js.

Versión confirmada.

0.9.23 – 0.9.26​

  • Añade fallbackApiUrl — fallback automático de búsqueda a una API secundaria si la principal falla.
  • Añade ui.overlayContainer — confina el overlay del chat a un contenedor propio en vez de a pantalla completa. Las versiones 0.9.24–0.9.26 corrigen bugs de aislamiento del overlay confinado hasta estabilizarlo.

0.9.20 – 0.9.22​

  • Mejoras internas de UI (recorte visual del blur en el estado vacío) y del dashboard interno (Replay Mode de conversaciones). Sin cambios de configuración para integradores.

0.9.19​

  • Añade soporte real a data-api-url en el auto-init por <script> — antes solo era alcanzable vía init() programático.

0.9.18​

  • Añade modo de búsqueda rápida junto al agente conversacional existente.
  • Corrige el backlog completo de auditoría P0-P3: seguridad, accesibilidad, arquitectura y cobertura de tests.

0.9.17​

  • Preact + Shadow DOM aislado.
  • 9 idiomas: es, en eager; fr, de, it, pt, ca, eu, gl lazy.
  • 30+ CSS variables --nrn-* en formato RGB-triplet (--nrn-primary: 6 182 212).
  • CustomEvents: emite neuroon-theme-change; escucha neuroon:cart-update.
  • postMessage: recibe neuroon:setStyles y neuroon:setTheme desde el frame contenedor.
  • Configuración exclusivamente vía atributos data-* (data-token, data-container, data-theme, data-locale, data-api-url).

API HTTP​

Estado actual — primera documentación rigurosa​

Es la primera vez que documentamos la API con el rigor adecuado. La API ya estaba en producción; lo que cambia es la documentación. Endpoints estables que cubrimos:

  • /api/widget/* — auth X-Widget-Token. Search (GET y POST), search audio, search visual, suggestions, suggest, trending, compare, cart cross-sell, tracking de clic, tracking de conversión, eventos de analytics individuales y batch.
  • /api/integrations/v1/FULL`, máximo 500/lote), CRUD de productos, verificación de dominio, tracking de conversión, info de la tienda.

Convenciones​

  • Sin versionado en URL (/v1/).
  • Errores con estructura unificada { timestamp, status, error, message, path }.
  • Headers de rate limit X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After (este último sólo en 429).
  • Eventual consistency en sync: 2–5 segundos entre 200 OK y disponibilidad en Neuroon.

Política de cambios​

  • Breaking changes en la API HTTP se anuncian aquí con un mínimo de 30 días de antelación, salvo correcciones de seguridad críticas.
  • Cambios menores (campos opcionales nuevos, headers nuevos, mejoras de errores) son aditivos y no requieren acción del integrador.
  • Versiones del widget siguen SemVer estricto. Las publicadas siempre tienen su SRI hash en el manifiesto del CDN.

Cómo seguir cambios​

  • Suscríbete al canal de notificaciones desde el Dashboard.
  • Sigue status.neuroon.ai para incidentes.
  • Para cambios urgentes contactamos directamente a los integradores activos por email.

Próximas lecturas​

Última actualización en