Saltar al contenido principal

Glosario

Glosario bilingüe de los términos que aparecen en la documentación. Útil para alinear vocabulario interno cuando integras Neuroon en una tienda multilingüe o cuando hablas con nuestro Soporte.

Términos

EspañolInglésDefinición corta
Asistente IAAI assistantCapa conversacional que reformula la consulta, sugiere filtros y produce insights. Activable según el plan
Backend de NeuroonNeuroon backendServicios desplegados en api.neuroon.ai y su pareja de Desarrollo dev-api.neuroon.ai
Búsqueda léxicaLexical searchBúsqueda basada en tokens (LIKE, full-text); lo que sustituye Neuroon
Búsqueda semánticaSemantic searchBúsqueda basada en embeddings vectoriales; comprende intención y sinónimos
Búsqueda visualVisual searchBúsqueda por imagen vía POST /api/widget/search/visual
Búsqueda por vozVoice searchBúsqueda por audio vía POST /api/widget/search/audio
Cabecera de autenticaciónAuthentication headerX-Widget-Token o X-Shop-API-Key según el endpoint
Cart cross-sellCart cross-sellRecomendaciones para el carrito vía POST /api/widget/cart/cross-sell
CatálogoCatalogConjunto de productos sincronizados de tu tienda
CDN del widgetWidget CDNhttps://cdn.neuroon.ai/widget@<version>/widget.js (versionado, immutable). El alias https://cdn.neuroon.ai/widget.js apunta a la última estable con cache corto.
Clave API de tiendaShop API keysk_<32hex>, server-only. Cabecera X-Shop-API-Key
ConversiónConversionCompra atribuida a una búsqueda. Reportada vía POST /api/plugin/shops/{id}/track/conversion
CuotaQuotaLímite de productos por plan (ver respuesta productsCount / remainingProducts)
Embebido (widget)EmbedInserción del widget mediante <script> con data-token
Eventos del carritoCart eventsCustomEvent neuroon:cart-update que el widget escucha
Eventual consistencyEventual consistencyVentana de 2–5 s entre 200 OK del sync y disponibilidad en Neuroon
Filtros guiadosGuided filtersFiltros propuestos por la IA en función de la consulta
Filtros del usuarioUser filtersFiltros explícitos pasados en el body de POST /api/widget/search
Integridad SRISRI integrityHash SHA-* publicado en el manifiesto del CDN para verificar widget.js
OrigenOriginHeader HTTP que el navegador envía. Validado contra shop.url por ApiKeyAuthenticationFilter
PlanPlanTier de suscripción (Free, Starter, Pro, Enterprise). Determina rate limit y cuota
Plugin (de tienda)Shop pluginIntegraciones oficiales: WordPress, DNN, custom
ProducciónProductionEntorno en api.neuroon.ai
Producto externoExternal productProducto identificado por externalId (tu ID), no por el ID interno de Neuroon
Rate limitRate limitLímite de requests por minuto. Headers X-RateLimit-* y 429 con Retry-After
RecipeRecipeGuía paso a paso para integrar Neuroon en un stack concreto
Search logSearch logRegistro de una búsqueda. Su ID (searchLogId) se usa para atribuir conversiones
Sincronización incrementalIncremental syncsyncType: INCREMENTAL — upsert por externalId, recomendado
Sincronización totalFull syncsyncType: FULL — borra catálogo en Neuroon y reinserta. Reservado a reconstrucciones
TenantTenantTu organización en Neuroon. Una organización puede tener varias tiendas
TiendaShopUnidad lógica con su propio catálogo, claves y dominio. shopId la identifica
Token de widgetWidget tokenCadena opaca, TTL 24 h. Cabecera X-Widget-Token
TrendingTrendingProductos con tracción alta. GET /api/widget/trending
Verificación de dominioDomain verificationPOST /api/plugin/shops/{id}/verify con un dominio que confirme la propiedad
Webhook salienteOutbound webhookNo existe aún. En roadmap, sin fechas
WidgetWidgetComponente Preact embebido en el navegador. Versión actual 0.9.10

Acrónimos

AcrónimoSignificado
APIApplication Programming Interface
CDNContent Delivery Network
CTACall To Action
DNNDotNetNuke
DTOData Transfer Object
HMACHash-based Message Authentication Code
HTTP/HTTPSHypertext Transfer Protocol (Secure)
JSONJavaScript Object Notation
JWTJSON Web Token
PIIPersonally Identifiable Information
SDKSoftware Development Kit
SLAService Level Agreement
SRISubresource Integrity
SSRServer-Side Rendering
TTLTime To Live

Convenciones de la documentación

  • Cada afirmación técnica enlaza a path:line del repositorio (api/src/main/...,).
  • Frontmatter verified_at indica la fecha en que la página fue revisada contra el código fuente.
  • Términos en monoespaciado se refieren a identificadores literales del código (cabeceras HTTP, nombres de campo, valores de enum).