Glosario

Términos canónicos del producto. La documentación pública usa esta nomenclatura.

Producto y plataforma

WhatsUY / Whats UY: plataforma omnicanal de gestión de conversaciones con IA.
Referencia: cuenta de WhatsApp (sandbox o productiva) registrada en WhatsUY. Tiene costo y vigencia.
Sandbox: referencia de prueba, gratuita, limitada.
Línea / Channel: canal de comunicación asociado a una referencia (WhatsApp, Messenger, etc.).

BotV2: motor conversacional legacy basado en grafos de nodos. Estable, en mantenimiento.
AIFlows: nuevo motor conversacional con loops, switch, funciones reutilizables y asistente IA. Estado: ~85% implementado (septiembre 2026).
Flow / Flujo: grafo de nodos que define la lógica conversacional.
Node / Nodo: unidad de ejecución dentro de un flujo (acción, condición, llamada IA, etc.).
Wait: nodo que pausa la ejecución esperando entrada del usuario.
Loop: nodo que itera con cotas anti-runaway.
Switch: nodo condicional con múltiples casos.
Redirect: salto entre puntos del grafo.
Variable: dato con alcance (scope) en una ejecución.
Function / Función: subrutina reutilizable; puede actuar como herramienta para LLM.
Scope / Alcance: visibilidad de una variable o función según el punto del grafo.
Project / Proyecto: agrupación de flujos, configuraciones IA y funciones.
Draft / Published Graph: versión borrador vs versión publicada del flujo.
Run / AIFlowRun: ejecución persistida de un flujo con pausa/resume.
Simulador: herramienta de prueba que ejecuta un flujo sin producción.

Proveedor (Provider): servicio externo de IA. Soportados: OpenAI, DeepSeek, Anthropic, Groq, Mistral, custom (compatible OpenAI).
ProviderConfig: configuración reutilizable de proveedor + modelo + credencial + baseUrl.
Nodo IA: nodo que invoca un modelo de IA (texto, JSON, imagen, audio, clasificación).
LLM: modelo de lenguaje grande.
Reasoning tokens: tokens de razonamiento (modelos como o1).
Cache tokens: tokens leídos de caché (descuento en pricing).
Unit / Units: unidad de cobro para proveedores no token-based (p. ej. imágenes).

AIUsage: módulo de medición de uso de IA.
Rollup: agregado diario de consumo por dimensión (usuario, línea, proveedor, callOrigin).
Snapshot: foto inmutable del cierre de día.
CallOrigin: origen del consumo (aiflows, ia_direct, assist, analysis, transcription, image, bot_legacy, etc.).
UsageContext: contexto adicional del consumo (chat, mensaje, etc.).
Pricing: tarifa vigente por proveedor/modelo/credencial con validFrom y validTo.
Missing pricing: modelo sin tarifa configurada; se reporta pero no bloquea (Gate 0 = aviso).
Gate 0: política de aviso (no bloqueo) para modelos sin precio.

MCP (Model Context Protocol): protocolo para exponer herramientas externas al LLM.
Tool / Herramienta: función invocable por el agente IA.
Tool call: invocación de una herramienta por parte del LLM.
Agente IA directa / ia_direct: modo de línea donde el bot delega el control a un agente con MCP.
Asistente de chat: editor de flujos con chat que sugiere cambios sobre el grafo.

WhatsApp Cloud API: integración oficial con Meta.
Messenger: integración con Facebook Messenger.
Webhook: endpoint HTTP saliente que recibe eventos (mensajes, status, data, calls).