> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Actualizaciones del Producto
> Nuevas funcionalidades y mejoras en Jelou AI
## Meta Business Agent disponible en el plan Free
**Meta Business Agent** ya está disponible para los proyectos del **plan Free**. Puedes activarlo por tu cuenta desde **Configuración del proyecto → Meta Business Agent**, con el mismo flujo Self Service que el resto de los planes: eliges el canal de WhatsApp Cloud, aceptas los Términos de IA de Meta y configuras las instrucciones y la audiencia.
Jelou no aplica ningún cargo adicional por el agente en ningún plan. Meta factura el consumo directamente a la línea de crédito de tu cuenta de WhatsApp Business.
Revisa los requisitos y el paso a paso para activar Meta Business Agent.
## Voice: agentes que atienden y emiten llamadas telefónicas
Ya puedes crear **agentes de voz** que atienden y emiten llamadas telefónicas. **Voice**, en el menú lateral, reúne los agentes, el registro de llamadas, las campañas salientes y los webhooks de eventos.
Una operación de voz se arma con dos piezas que se crean por separado: el **agente**, que define qué dice y cómo suena, y el **número de teléfono**, que se aprovisiona activando un canal de **ElevenLabs**. El último paso es conectarlas con el campo **Agente que responde** en la configuración del canal. Un agente puede existir sin número asignado, así que puedes diseñarlo y probarlo antes de aprovisionar telefonía.
El editor del agente tiene cuatro pestañas. En **Comportamiento** defines el prompt del sistema — con variables dinámicas `{{variable}}`, incluidas `{{system__time}}` y `{{system__time_utc}}` — el primer mensaje y si el usuario puede interrumpir el saludo. Los paneles laterales cubren la **voz** (voz, idioma, modelo de voz filtrado por idioma, velocidad, estabilidad, similitud y estilo) y el **modelo y la llamada** (modelo de lenguaje, duración máxima y zona horaria en la que el agente interpreta y expresa las horas).
En **Herramientas** hay siete funciones nativas de telefonía que se activan con un interruptor: finalizar llamada, detección de idioma, saltar turno, detección de buzón de voz, marcado DTMF, transferir a otro agente y transferir a un número. Debajo puedes definir tus propias **herramientas HTTP** para que el agente consuma tus APIs durante la conversación, con autenticación reutilizable, headers y parámetros del body. La pestaña **Knowledge base** admite documentos y URLs, y **Análisis** permite definir criterios de evaluación y campos de datos estructurados que se extraen de cada conversación.
Al aprovisionar el número eliges entre **SIP trunk** — con la opción de enrutar las salientes por tu propia troncal — o **Twilio**, ya sea sobre la cuenta de Jelou buscando número por país y dígitos, o con tus propias credenciales. Las tarifas base son 1.15 USD/mes de renta, 0.0085 USD/min entrante y 0.014 USD/min saliente.
Si ya tienes un número de **WhatsApp** (Cloud API o Gupshup), puedes habilitar llamadas de voz sobre él sin aprovisionar un número nuevo, decidir si se muestra el botón de llamada en el chat y conectarle un agente de voz.
Cada llamada queda registrada con su dirección, estado, duración y créditos, y guarda su **grabación** y su **transcripción** turno por turno.
Consulta la arquitectura y el paso a paso para crear el agente, darle herramientas y aprovisionar el número.
## Meta Business Agent disponible en Self Service
Ya puedes activar **Meta Business Agent** por tu cuenta desde **Configuración del proyecto → Meta Business Agent**. Antes la activación requería la intervención de nuestro equipo. Meta Business Agent es la IA que Meta ejecuta de forma nativa dentro de WhatsApp; al conectarle tus workflows y tools de Jelou, deja de solo responder y empieza a resolver.
### Novedades principales
* **Activación por canal**: eliges el número de WhatsApp Cloud y lo activas desde Configuración del proyecto, sin depender de nuestro equipo.
* **Instrucciones del agente**: hasta **20.000 caracteres** para definir tono, reglas y casos de uso.
* **Audiencia controlada**: `solo lista de permitidos` para probar sin riesgo, o `todos` cuando ya validaste el comportamiento.
* **Herramientas conectadas**: expones tus workflows y tools de Jelou para que el agente consulte un pedido, verifique una identidad o genere un cobro.
* **Relevo a operador**: cuando el cliente pide hablar con una persona, la conversación pasa a Jelou con todo el contexto.
### Cómo usarlo
1. Verifica que el canal sea de **WhatsApp Cloud**. Meta Business Agent solo funciona con WhatsApp Cloud: si el proyecto usa otro proveedor (por ejemplo Gupshup), ese número no puede ejecutarlo y necesitas agregar un canal de WhatsApp Cloud.
2. Entra en **Configuración del proyecto → Meta Business Agent** y elige el canal.
3. Acepta los **Términos de IA de Meta**. Es un paso único que Jelou abre por ti.
4. Atiende el aviso sobre la suscripción al webhook `standby`. Sin ella el agente responde, pero Jelou no guarda la conversación: te quedas sin historial y sin contexto para el operador.
5. Redacta las instrucciones, deja la audiencia en `solo lista de permitidos` y prueba con números controlados antes de abrirlo a `todos`.
Meta Business Agent **no tiene cargo adicional de Jelou**. **Meta factura el consumo** directamente a la línea de crédito de la cuenta de WhatsApp Business, según su tarifa. Meta **todavía no expone el detalle por conversación**, así que el dashboard aún no puede mostrar ese costo; cuando Meta lo publique, se verá en el panel.
Qué hace Meta Business Agent y en qué se diferencia del AI Agent de Jelou.
WhatsApp Cloud, Términos de IA de Meta y el webhook `standby`.
Instrucciones, audiencia, herramientas conectadas y relevo a operador.
Cómo se factura el consumo del agente.
## El Mapa del proyecto se movió a Configuración del proyecto → Workflows
El Mapa del proyecto ahora vive dentro de **Configuración del proyecto** como una nueva sección **Workflows**, junto a **General** y **Meta Business Agent**. La ruta anterior `/brain/projects/:projectId/workflows` ya no existe; la nueva es `/brain/:projectId/settings?section=workflows`. El selector de proyecto persiste entre secciones de configuración, así que puedes saltar entre General, MBA y Workflows sin perder el contexto del proyecto. La funcionalidad del mapa y de la lista de workflows no cambia.
Revisa cómo acceder al mapa desde Configuración del proyecto → Workflows.
## Optimización de tokens en el AI Agent
La pestaña Tools del nodo AI Agent ahora incluye el interruptor **Optimización de tokens**. Al activarlo, los resultados de las herramientas se envían al modelo en formato **TOON** (Token-Oriented Object Notation), una representación compacta que elimina la puntuación repetitiva del JSON y reduce el consumo de tokens, especialmente en listas grandes de datos estructurados.
Conoce cómo funciona el formato TOON y cuándo conviene activarlo.
## Modo prueba para pasarelas de pago
Ya puedes instalar una pasarela y validar cobros de punta a punta **sin cuenta ni credenciales propias**. Al instalar una pasarela compatible, elige **Probar con Jelou** para probar de inmediato o **Conectar mi cuenta** para usar tus credenciales.
El modo prueba permite **hasta 10 pruebas** por configuración. Al terminar puedes abrir una plantilla con el workflow armado. Cuando quieras cobrar de verdad, conectas tu cuenta sobre la misma instalación sin rearmar el flujo.
Disponible en Wompi, Stripe, PayPal, Mercado Pago, Kushki, Conekta, Payphone y Nuvei, en determinados países. **DeUna** todavía no tiene modo prueba. El país no se puede cambiar después; si te equivocas, reinstala la pasarela.
Revisa el paso a paso, los países por pasarela y cómo conectar tu cuenta después.
## El campo canónico del teléfono del usuario es `phone`
WhatsApp deja de garantizar el número telefónico como identificador estable y adopta un identificador propio, el BSUID. Para que el objeto `user` siga entregando un teléfono confiable, el campo canónico es ahora `phone`.
* **Usa `phone`**: devuelve el teléfono real del contacto, resuelto internamente incluso cuando la conversación entra identificada por BSUID.
* **`phoneNumber` sigue disponible** como alias del mismo valor. Antes podía devolver el BSUID en lugar del teléfono; ya no lo hace.
* **Ambos campos pueden venir en `null`** cuando no es posible resolver un teléfono para ese contacto, y solo aparecen en canales de WhatsApp. Tus integraciones deben tolerar el `null` en lugar de asumir que siempre hay un número.
* El valor viene normalizado a solo dígitos, sin `+`, espacios ni guiones.
Si tus flujos leen `{{$user.phoneNumber}}`, siguen funcionando. Te recomendamos migrar a `{{$user.phone}}`, que es el campo que mantendremos.
Consulta qué datos del contacto tienes disponibles y cómo usarlos en tus flujos.
## Nueva sección de API: Gestión de etiquetas
La referencia de API ya documenta cómo gestionar las etiquetas (*tags*) de tus conversaciones desde tus propios sistemas, con el flujo completo en una sola página.
* **Catálogo de la compañía**: `GET /v1/company/{companyId}/tags` devuelve las etiquetas disponibles con sus `id`, colores y filtros por nombre, idioma, equipos y canales.
* **Etiquetas de una conversación**: `GET /v1/rooms/{roomId}` incluye las etiquetas actuales en el atributo `data.tags`.
* **Asignar o actualizar**: `POST /v1/bots/{botId}/rooms/tags` recibe el `roomId` y la lista de `id`.
Ten en cuenta que el arreglo `tags` reemplaza por completo las etiquetas actuales de la conversación: para conservar las existentes debes enviarlas junto con las nuevas, y un arreglo vacío las elimina todas.
Consulta los parámetros, los ejemplos de solicitud y respuesta, y los códigos de estado.
## Multiorganización: una cuenta en varias organizaciones
Una misma cuenta ya puede pertenecer a varias organizaciones. Sigues teniendo la tuya y ahora puedes ser invitado a otras y cambiar entre ellas desde el selector, sin cerrar sesión ni crear otra cuenta. Si el correo invitado ya existe en Jelou, la persona entra con sus credenciales de siempre.
También puedes abandonar las organizaciones a las que te invitaron, y el super administrador puede quitar miembros. Las organizaciones en plan FREE no pueden invitar. Disponible para los planes Builder y Business.
Consulta cómo cambiar de organización, invitar, salir, quitar miembros y qué pasa con la verificación en dos pasos.
## Tool nativa AI Routing en el AI Agent
El nodo **AI Agent** ya puede derivar una conversación al workflow correcto cuando el usuario pide algo que ese agente no puede hacer. Activa la tool **AI Routing** en la sección **TOOLS** del nodo.
* **Automático**: el agente pasa el mensaje tal cual y el AI Routing del proyecto elige el destino.
* **Destino indicado**: si el usuario nombra a dónde quiere ir, la derivación va directo a ese workflow.
* **Consultar destinos**: el agente puede listar los workflows disponibles antes de decidir u ofrecer opciones al usuario.
Una derivación exitosa termina el turno del agente: la respuesta llega desde el workflow de destino. Si no hay coincidencia, el agente sigue atendiendo la conversación.
Consulta los parámetros, los ejemplos de argumentos y cuándo no usar esta tool.
## Coexistencia: atención desde WhatsApp Business
La nueva sección **Configuraciones → Coexistencia** define, por canal de WhatsApp, cómo se comporta tu agente cuando un asesor humano responde desde la app de **WhatsApp Business**.
* **Pausar workflow**: el workflow predeterminado se pausa en cuanto el asesor interviene. La pausa puede ser **Dinámica**, que se reinicia con cada mensaje, o de **Tiempo fijo**, y dura entre 15 minutos y 4 horas.
* **Palabras clave**: hasta 5 por canal, cada una asociada a un workflow, para devolver el control a la IA sin esperar el fin de la pausa.
* **Confirmación de lectura y escritura**: marca los mensajes del cliente como leídos y muestra el indicador de escritura.
Consulta los tipos de pausa, las reglas de las palabras clave y cómo se guardan los cambios.
## Clona workflows a otro proyecto
Ya puedes copiar workflows de un proyecto a otro de tu compañía sin volver a construirlos. En la sección **Workflows** de la barra lateral, el ícono junto al **+** activa el modo de clonación: marca los workflows que quieras y confirma el proyecto de destino.
Antes de copiar nada, Jelou revisa la selección y te dice qué va a pasar. Si algo lo impide —una variable o un secreto que no existe en el destino, dos workflows con el mismo nombre, un nodo que llama a un workflow que no viaja— lo muestra en rojo y no te deja continuar. Si solo hay advertencias, como sobrescribir un workflow que ya existía allí, te dice cuál y decides tú.
Cada workflow se empareja por su nombre: si el destino no tiene ninguno con ese nombre se crea, y si tiene exactamente uno se reemplaza conservando el nombre del destino. Al confirmar puedes dejar marcada la casilla **Ir al proyecto de destino cuando la clonación termine** para que Jelou te lleve allí al finalizar. Si la copia falla a mitad de camino, se revierte todo.
Ten en cuenta que algunos nodos llegan con su sitio y sus conexiones, pero sin el recurso que estaba atado al proyecto de origen: las plantillas HSM y los WhatsApp Flows quedan sin seleccionar, y el AI Agent llega sin su conocimiento. Revísalos antes de publicar en el destino.
Consulta el paso a paso, qué se copia y qué puede impedir la clonación.
## Jelou CLI: `jelou voice` cubre todo el servicio de voz (v1.93)
`jelou voice` dejó de ser solo consulta de llamadas y números: ahora administra el servicio de voz completo, de punta a punta, desde el CLI.
* **`jelou voice schedules`** — campañas de llamadas de principio a fin: crear, activar, ver el avance de marcado, listar las llamadas hechas, pausar, reanudar y cancelar. Activar una campaña pide confirmación y muestra cuántos contactos serán llamados.
* **`jelou voice contacts`** y **`jelou voice contacts lists`** — administra a quién llama una campaña, incluida la creación de una lista directo desde un archivo CSV o XLSX.
* **`jelou voice agents`** — crea y ajusta el agente que habla en la llamada (prompt, voz, idioma, límite de duración) y alimenta su base de conocimiento desde un archivo o una URL.
* **`jelou voice calls outbound`** hace una llamada individual; **`jelou voice billing`** muestra el costo de las llamadas; **`jelou voice reports`** y **`jelou voice webhooks`** cubren reportes de campaña y destinos de eventos.
Todo lo que marca un número real o gasta dinero pide confirmación antes de ejecutarse (activar campaña, llamada de prueba, llamada saliente, cualquier `delete`); usa `--yes` en CI. Ver [Voz](/guides/cli/voice).
## Nuevo canal: Slack
Ya puedes conectar tu agente de Brain Studio a **Slack** para atender a tu equipo y a tus clientes por mensaje directo, sin que salgan de su espacio de trabajo.
La activación toma cuatro datos de tu app de Slack: el **Bot User OAuth Token**, el **Signing Secret**, el **App ID** y un **token de configuración de la app**. Con ese último token Jelou establece por ti las Request URLs de **Events** e **Interactivity**, así que no tienes que pegarlas a mano. El token se usa una sola vez, no se guarda y expira alrededor de 12 horas después de generarlo. Si la configuración automática falla, el canal igual queda creado y el modal te muestra la URL para pegarla tú.
Slack entrega los eventos y las interacciones a la misma ruta, por lo que una sola URL sirve para ambos campos. El **Bot User ID** se resuelve automáticamente desde el bot token y se usa para ignorar los mensajes del propio bot. En las propiedades del canal encontrarás la Request URL siempre disponible para copiar; el bot token y el Signing Secret quedan enmascarados.
El canal opera únicamente sobre mensajes directos y admite texto (3000 caracteres), imágenes JPEG y PNG de hasta 5 MB, botones (hasta 10), listas (hasta 10 opciones) y CTA URL.
Consulta los requisitos previos, el paso a paso de activación y las limitaciones del canal.
## Mapa del proyecto en Gestionar workflows
La sección **Gestionar workflows** de un proyecto con **AI Routing** activo ahora incluye un mapa visual con el AI Router y todos los workflows conectados, junto a la lista de workflows (misma UX que la tarjeta de **Ajustes → AI Routing**, con badge **Respaldo**, switch por fila y accesos rápidos a **Configuración** y **Studio**). Puedes filtrar el mapa por canal, ocultar workflows del router con el switch o arrastrándolos al panel lateral, filtrar la lista entre **Todos / AI Router / Ocultos**, y probar el enrutamiento con mensajes reales sin salir de la sección.
Los proyectos sin AI Routing siguen aterrizando en la tabla clásica de workflows sin ningún cambio.
Consulta la guía completa con las interacciones, filtros y estados del mapa.
## Crea un proyecto desde cero o clonando otro
El modal de creación de proyectos ahora te deja elegir cómo empezar: **Desde cero**, el comportamiento de siempre, con un primer workflow que trae únicamente el nodo Start, o **Clonar existente**, partiendo de la configuración de un proyecto que ya tienes.
Al clonar se copian los workflows con todos sus canvas, nodos y conexiones, las rutas de AI Routing, las preguntas de entrenamiento, los ajustes del proyecto y las integraciones instaladas. Los nodos de apps del marketplace y de bases de datos ahora se conservan y siguen apuntando a los mismos recursos de tu compañía, en lugar de quedar vacíos. Las derivaciones a agente humano también mantienen su configuración de asignación. Los nodos que envían un WhatsApp Flow y los de plantilla HSM conservan sus conexiones, pero debes volver a elegir el flow o la plantilla.
Por seguridad, los secretos se copian solo por nombre, sin su valor, y el conocimiento del AI Agent no se traslada. El proyecto de origen nunca se modifica, solo puedes clonar proyectos de tu propia compañía, y si la clonación falla a mitad de camino se revierte por completo.
Los proyectos creados por clonación quedan marcados con la etiqueta **Clonado**, visible en la tabla de **Proyectos**, en el selector de proyectos, en la barra superior de Studio y en la configuración del proyecto. Ahí la tarjeta de información suma dos filas: **Origen**, con la etiqueta, y **Clonado de**, con el nombre del proyecto de origen y su ID listo para copiar. Si el original se eliminó, la fila muestra solo el ID.
El canal de WhatsApp de pruebas que se crea junto al proyecto — tanto desde cero como al clonar — toma el nombre del proyecto tal cual, sin el prefijo `Sandbox - ` que usaba antes.
Consulta la guía completa con todo lo que se copia, la etiqueta Clonado y lo que debes revisar antes de publicar.
## Nuevo canal: Microsoft Teams
Ya puedes conectar tu proyecto de Brain Studio a **Microsoft Teams** para que tus colaboradores y clientes obtengan respuestas rápidas y personalizadas sin salir de la plataforma de colaboración de Microsoft.
La conexión se hace a través de una app de **Azure Bot** que registras en Azure. La activación toma tres datos, todos obligatorios: el **App ID** (client ID), la **contraseña de la app** (client secret) y el **Tenant ID**. El canal se provisiona únicamente como **single-tenant**; el tipo de app no es seleccionable durante la activación.
Al crear el canal, Jelou muestra la **URL del messaging endpoint** que debes pegar del lado de Microsoft, ya sea en el **Portal de Desarrolladores de Teams** (*Tools → Bot management → Endpoint address*) o en el **Portal de Azure** (*Settings → Configuration → Messaging endpoint*). La URL queda siempre disponible en las propiedades del canal, donde el client secret aparece enmascarado y no se puede copiar.
Teams renderiza los mensajes como Adaptive Cards, así que el canal admite texto (4096 caracteres), imágenes JPEG y PNG de hasta 5 MB, botones (hasta 3 por mensaje), listas (hasta 10 opciones) y CTA URL, que se envía como `Action.OpenUrl`.
Consulta los requisitos previos de Azure, el paso a paso de activación y las limitaciones del canal.
## Jelou CLI: documentación al día con la v1.89
Actualizamos toda la documentación del **Jelou CLI** para que coincida con el comportamiento real de la versión 1.89.0, en español, inglés y portugués.
Se documentaron comandos y comportamientos nuevos que no tenían página:
* **`jelou context`** — identidad, drift de proyecto y workflows, allowlist de modelos, nombres de secrets e inventario de bases de datos en una sola llamada. Referenciado desde [Proyectos y canales](/guides/cli/project) y [Modelos de IA](/guides/cli/models).
* **`jelou tool`** y **`jelou test tool`** — ciclo de vida de tools reutilizables entre proyectos de la app.
* **`jelou channels testers`** — whitelist de números para el sandbox de WhatsApp antes de conectar un número real. Ver [WhatsApp](/guides/cli/whatsapp).
* **`jelou workflow node-spec`** y la nueva validación de `tools/*.json` en `jelou workflow validate --partial`. Ver [Workflows y pruebas](/guides/cli/workflows).
* **`jelou databases plans`**, el comportamiento *get-or-create* de `collections create`, y las confirmaciones nuevas en `api-keys regenerate`/`create`. Ver [Bases de datos](/guides/cli/databases).
* **[Métricas](/guides/cli/metrics)** — página nueva para `jelou metrics list/get/dashboard`: catálogo por categoría, filtros por métrica, ventanas de tiempo (`--last`, `--period`, rango a medida) y tableros oficiales por `--template`.
También corregimos ejemplos que ya no coincidían con el CLI real: eventos de trigger (`insert` → `create`), `jelou shop products images add` (usa `--file` y SKU, no `--url` ni id de producto), `jelou shop coupons show/uses` (por código, no por id), `jelou shop imports upload` (flags, no argumento posicional), los flags de instalación de skills (`--method`, no `--symlink`/`--copy`), y la nota sobre `jelou functions tokens create` que decía estar deprecada y ya no lo está.
## Soporte para Business Scoped User ID (BSUID)
Jelou ya es compatible con el **Business Scoped User ID (BSUID)**, el nuevo identificador único que Meta utiliza para representar a los usuarios dentro de WhatsApp Business.
Con la llegada de los Usernames, algunos usuarios dejarán de compartir su número de teléfono con las empresas. En esos casos, el BSUID es el identificador que permite continuar enviando y recibiendo mensajes sin afectar la comunicación. No necesitas realizar configuraciones adicionales: la plataforma soporta ambos identificadores.
Si tu empresa cuenta con integraciones externas o desarrollos propios que consumen de Jelou, revísalas para asegurar que puedan procesar el BSUID como identificador del usuario.
Consulta la guía completa sobre el nuevo identificador y su cronología de implementación.
## Envío de plantillas por BSUID
El envío de plantillas de WhatsApp (HSM) ahora acepta un **BSUID (Business-Scoped User ID)** en `destinations`, además del número de teléfono tradicional. Esto aplica al envío individual, al envío masivo por CSV y al nodo de Plantilla de WhatsApp en Brain Studio, y te permite enviar plantillas a usuarios que activaron la privacidad de número en WhatsApp usando el identificador que Meta les asigna en lugar de su teléfono real.
Consulta la guía completa, con el formato de BSUID y las restricciones para plantillas de autenticación.
## Jelou CLI: secciones nuevas y cobertura completa de comandos
La documentación del **Jelou CLI** pasó a ser su propia sección de nivel superior, organizada por área de producto: Empezar, Proyectos, Datos, Canales, IA y voz, Comercio y Referencia.
Se agregaron cuatro páginas para los comandos que faltaban:
* **[Connect](/guides/cli/connect)** — lista operadores y equipos para enrutar los nodos de atención humana de tus workflows.
* **[Modelos de IA](/guides/cli/models)** — descubre y valida los modelos disponibles para los nodos AI Agent y AI\_TASK, con códigos de salida pensados para CI.
* **[Voz](/guides/cli/voice)** — consulta llamadas, descarga grabaciones, exporta a CSV o XLSX y revisa los números de la organización.
* **[Shop](/guides/cli/shop)** — administra catálogo, sucursales, categorías, cupones, pedidos, importaciones y sincronización de catálogos externos.
## Functions: ejecuciones diferidas, verificación de webhooks y validación de plantillas
Jelou Functions ahora documenta tres capacidades nuevas:
* **Ejecuciones diferidas**: agenda una ejecución futura de tu función con `ctx.jelou.schedule` o con cabeceras HTTP — recordatorios a 24 horas, seguimientos de carrito abandonado, encuestas post-compra. Incluye consulta, cancelación en bloque y `ctx.guard` para verificar antes de actuar.
* **Verificación de webhooks**: `ctx.verifyStripe`, `verifyShopify`, `verifyMeta` y `verifyHmac` validan la firma de un webhook en una línea.
* **Validación de plantillas de WhatsApp**: `ctx.templateRegistry` te deja confirmar nombre, idioma y cantidad de parámetros antes de llamar a Meta.
En el CLI se documentaron `jelou functions check` (valida el proyecto antes de desplegar), `jelou functions defer list/get`, `jelou functions deployments build` (por qué falló un deploy) y los flags `--dry-run`, `--agent` y `--describe`. `jelou skill install` pasó a ser `jelou agent install`.
Agendar, consultar, cancelar y verificar antes de actuar.
Stripe, Shopify, Meta y firmas HMAC genéricas.
## Canal Personalizado
Ya puedes conectar tu propia aplicación a los flujos de Brain Studio con el canal **Personalizado**: configura tu webhook con su autenticación respectiva en Jelou, envía interacciones por API y recibe las respuestas del Agente en tu sistema. Consulta los nodos y las herramientas disponibles para este canal.
Activa el canal Personalizado en el builder.
Endpoints, formatos de respuesta y firma HMAC.
## Pasarelas de pago personalizadas
Ahora puedes conectar cualquier proveedor de pago (PSP) que no esté en el catálogo de proveedores, describiendo su integración de forma declarativa desde **Pagos**: credenciales, solicitud de cobro, webhook y retorno. Sin escribir código de backend por cada proveedor nuevo, la pasarela queda disponible para el nodo **Pagos** en Brain Studio.
Revisa la arquitectura, el wizard de alta, los placeholders disponibles y cómo probarla antes de publicarla.
## Composición de Tools
Ahora puedes usar el nodo **Tool** dentro de otras Tools. En el canvas aparece el buscador — arrastra la que necesites y listo. Disponible para todas las compañías.
Esta funcionalidad incluye:
* **Mecanismo anti-recursión**: una Tool no puede referenciarse a sí misma, y un límite de anidamiento en tiempo de ejecución evita ciclos infinitos (por ejemplo, A → B → A). Al publicar, un analizador detecta si existen ciclos.
* **Trazabilidad completa**: el `executionId` de una Tool hija queda registrado siempre, incluso si la ejecución termina en timeout. Desde la Tool padre puedes depurar directamente sus hijas.
Consulta la guía completa para anidar, salvaguardas y depuración.
## Nuevas integraciones de pagos: Kushki y Conekta
Se agregó documentación para conectar **Kushki** (México, Colombia, Perú, Chile y Ecuador) y **Conekta** (México) en Brain Studio, y cobrar mediante checkout **WebView embebido**.
Revisa cómo funciona, configura credenciales y usa el nodo de pago en Canvas.
Revisa cómo funciona, configura credenciales y usa el nodo de pago en Canvas.
## Condiciones de evaluación en el nodo AI Agent
El nodo **AI Agent** ahora permite evaluar sus conversaciones. En la pestaña **Eventos**, define condiciones mediante un prompt; cuando el agente finaliza una conversación, analiza el historial y dispara un evento por cada condición que se cumple, listo para analizarse en tus métricas.
Principales características:
* **Condiciones por prompt** — Un nombre (hasta 60 caracteres) y una instrucción (hasta 900 caracteres) por condición.
* **Un evento por condición cumplida** — El nombre de la condición define el nombre del evento que se dispara.
* **Toggle por condición** — Activa o desactiva cada condición sin eliminarla.
* Hasta **10 condiciones** por agente, con búsqueda, edición y eliminación desde la misma pestaña.
Consulta la guía completa en el nodo AI Agent.
## Perfil de Negocio
Ahora puedes configurar el Perfil de Negocio de WhatsApp Business directamente desde Configuración: foto de perfil, nombre, categoría, correo electrónico, sitio web, descripción y dirección. Esta sección está disponible actualmente para todas las compañías.
Consulta la guía completa para editar el perfil de tu canal de WhatsApp.
## Motivo de Operador no Disponible
Ahora, al cambiar su estado a **No disponible**, el operador puede indicar un motivo — texto libre más un emoji, o uno de los 7 motivos predeterminados (En reunión, Almuerzo, Trabajo administrativo, Problema técnico, Ausencia médica, Pausa activa, Fin de jornada). El motivo queda visible para su equipo y administradores en el header del operador, el historial de conexiones y el monitoreo de operadores.
Consulta la guía completa para activar y configurar esta funcionalidad.
## El nombre de campaña solo se pide cuando aplica
Ajustamos el flujo de creación de campañas (HSM): el campo **Nombre de campaña** ya no se solicita en el paso General. Ahora aparece en el paso de Destinatarios, y solo cuando eliges enviar a **Múltiples contactos**.
Antes se pedía el nombre sin importar el número de destinatarios, incluso al enviar a un solo contacto — un dato que podía generar confusión al revisar los registros de envíos.
Si eliges **Múltiples contactos**, el campo de nombre aparece justo debajo para completarlo antes de avanzar. Si eliges **Un solo contacto**, el campo no se muestra, y un aviso indica que esa campaña no aparecerá en el módulo de Campañas — su información estará disponible solo en Reportes.
## Reenvío de Campañas
Ahora puedes reenviar una campaña existente sin configurarla desde cero, ideal para campañas recurrentes donde solo cambia la base de contactos.
Desde el menú de acciones de una campaña **Completada** o **Cancelada**, selecciona **Reenviar**, ingresa el nombre de la nueva campaña y sube el nuevo archivo de destinatarios.
La nueva campaña hereda automáticamente la configuración de la original —plantilla, mapeo de parámetros, tipo de respuesta y asociaciones de workflows—, mostrada como un resumen de solo lectura tanto en la creación como en la vista previa de confirmación. El archivo CSV se valida contra las columnas esperadas de la campaña original, y el mapeo de parámetros se conserva aunque elimines y vuelvas a subir el archivo. Las campañas reenviadas se identifican con un badge **Reenviada** en la tabla de monitoreo, con referencia a la campaña original.
## Edición de Nombre de Cliente en PMA
Ahora los operadores, supervisores y administradores pueden editar el nombre de un cliente directamente desde la interfaz de PMA, sin necesidad de navegar al módulo de Clientes (CRM).
Esta mejora resuelve casos frecuentes durante la atención: nombres incorrectos, actualizaciones solicitadas por el cliente, captura automática incompleta o contactos que solo muestran el número telefónico. La edición está disponible tanto en conversaciones activas como en casos ya archivados, y se refleja en las descargas en PDF de la conversación.
## Atenciones de Canales Públicos en Monitoreo
Agregamos una nueva sección en el módulo de Monitoreo para visualizar las atenciones de canales públicos —como Facebook Feed, Instagram Feed y Twitter Replies—, complementando las vistas que ya existían para casos privados y correos electrónicos.
Esta sección solo aparece si la compañía tiene configurado al menos un canal público, así la vista se mantiene limpia y relevante para cada cliente. Las columnas de la nueva tabla guardan relación con las que ya conoces de casos privados y emails, para una experiencia consistente. Las descargas se generan desde el Centro de Descargas, en formato Excel o CSV.
Consulta la guía completa del módulo de Monitoreo.
## Eventos de Nodo
Ahora puedes agregar una pestaña **Eventos** en la configuración de tus nodos (HTTP, SOAP, Código, Tool, Condicional, Skill, AI Agent, entre otros) para registrar eventos de seguimiento cada vez que un nodo se ejecuta. Define un nombre y hasta 5 propiedades personalizadas por evento, para alimentar tus métricas y paneles de rendimiento.
Consulta la guía completa para configurar eventos de seguimiento en tus nodos.
## Gestión de memoria en el AI Agent
Sumamos un nuevo grupo de tools nativas para la **Gestión de memoria** en la pestaña Contexto del nodo AI Agent. Con toggles por fuente, el agente puede guardar y recordar información (memoria de trabajo por usuario), leer y actualizar datos del contacto con el **CRM de bandeja de entrada**, compartir variables entre nodos con **\$context** e inyectar información de usuario, canal y empresa como contexto. Además, agregamos la conexión nativa a **Bases de datos (Datum v2)** en la pestaña Tools.
Consulta la guía completa en la pestaña Contexto del nodo AI Agent.
## Gestión de memoria en la API
Puedes usar la nueva sección de la API para leer y escribir la memoria de sesión por usuario mediante la **Memory API v2**. Consulta todos los registros de un usuario, obtén un registro puntual por clave o guarda uno o varios registros por referencia de usuario. Los endpoints se autentican con **API key** (`x-api-key`) a través de `gateway.jelou.ai` y requieren los scopes `memory:read` o `memory:write`.
Consulta la guía completa de los recursos de memoria.
## Envío de mensajes por BSUID
El endpoint de envío de mensajes ahora acepta un **BSUID (Business-Scoped User ID)** en `userId`, además del número de teléfono tradicional. Esto te permite responder o escribir proactivamente a usuarios que activaron la privacidad de número en WhatsApp, usando el identificador que Meta les asigna en lugar de su teléfono real.
Consulta la guía completa, con casos de uso y ejemplos.
## Estadísticas de operadores en la API
Agregamos un nuevo recurso a la API para consultar las estadísticas de atención de tus operadores por rango de fechas: casos totales, atendidos, no atendidos, transferidos y tiempos promedio de respuesta. Filtra por un `operatorId` específico o consulta el rango completo para una vista general del equipo.
Consulta la guía completa del recurso.
## Integración con Genesys
Jelou ahora se integra con **Genesys Cloud** para habilitar la interoperabilidad entre ambas plataformas. Puedes transferir conversaciones, escalar hacia agentes de Genesys y centralizar la atención al cliente utilizando Open Messaging, Triggers, Workflows y Data Actions.
Consulta la guía completa de integración.
## Importación masiva de productos por Excel
Ahora puedes cargar tu catálogo de Jelou Shop subiendo un archivo Excel. Descarga una plantilla guiada —con una hoja de instrucciones, encabezados coloreados por obligatoriedad y comentarios en cada columna— y elige entre una **carga simple** (con SKU generado automáticamente) o una **carga completa** habilitando hojas opcionales de variaciones, características y modificadores.
Consulta la guía de [Importar productos](/guides/integraciones/e-commerce/shop-import).
## Conexión de WooCommerce con OAuth
Conectar tu tienda de WooCommerce ahora es un flujo simple con OAuth. Ya no necesitas generar manualmente el `Consumer key` ni el `Consumer secret`: solo ingresas el **dominio de tu tienda**, inicias sesión en WooCommerce y apruebas el acceso. Jelou crea las credenciales por ti.
Consulta la guía de [WooCommerce](/guides/integraciones/e-commerce/woocommerce).
## Username en WhatsApp
La guía cubre:
* Qué es un nombre de usuario y cómo funciona el identificador `@`.
* Beneficios para la privacidad y visibilidad de tu negocio.
* Pasos para crear y configurar tu username desde el Administrador de WhatsApp.
* Consideraciones importantes sobre disponibilidad y restricciones.
Consulta la guía completa para configurar tu nombre de usuario.
## Documentación de plantillas de workflow
Actualizamos la documentación sobre los templates de workflows en Brain Studio: cómo crearlos y compartirlos con el Jelou Agent, instalarlos en otras cuentas y explorar el catálogo desde la vista de inicio.
Consulta las guías de [Jelou Agent](/guides/getting-started/jelou-agent#convierte-tu-workflow-en-una-plantilla) y [Tu primer workflow](/guides/getting-started/tu-primer-workflow).
## Promociones y cupones en Jelou Shop
Jelou Shop ahora incluye un módulo de **Promociones** para crear y gestionar cupones de descuento, disponible en el panel Shop Admin y por API.
Principales cambios:
* **Cupones por porcentaje o monto fijo** — Define el descuento como un porcentaje o un valor fijo.
* **Vigencia** — Configura fecha de inicio y fin, o déjalo sin vencimiento.
* **Alcance por sucursal** — Aplica el cupón a todas las sucursales o solo a las que elijas, con límite de usos por sucursal.
* **Límites de uso** — Define un total de canjes y la opción de un uso por cliente.
* **Estados automáticos** — Cada cupón muestra su estado (Activo, Programado, Caducado, Agotado o Inactivo) calculado a partir de su vigencia y usos.
* El descuento se valida y aplica en el checkout; un cupón inválido, expirado o fuera de sucursal se rechaza con un mensaje claro.
Consulta la guía de [Shop Admin → Promociones](/guides/integraciones/e-commerce/shop-admin#promociones) y la [API de Promociones](/guides/integraciones/e-commerce/api-cupones/crear).
## Mensaje de seguimiento configurable en el nodo AI Agent
El **Mensaje de seguimiento** del nodo **AI Agent** ahora es configurable. Al activar el toggle en **Avanzado** aparece un botón que abre un modal para definir cómo el agente retoma una conversación inactiva.
Principales cambios:
* **Modos Manual y Automático** — En **Manual** escribes la instrucción que guía el recordatorio (hasta 900 caracteres); en **Automático** el agente lo redacta por sí mismo.
* **Espera entre wakeups** — Define el tiempo de inactividad antes de cada recordatorio (de 5 a 120 minutos).
* **Detener tras # intentos sin respuesta** — Limita los recordatorios consecutivos sin respuesta (de 1 a 5, por defecto 2).
* Las opciones se ajustan automáticamente al tiempo de expiración del agente.
## Actualización del módulo de Configuraciones
Continuamos mejorando la plataforma para ofrecer una experiencia más simple, organizada e intuitiva. A continuación, las novedades de la actualización del módulo de Configuraciones.
Principales cambios:
* **Sistema de navegación renovado** — Ahora las configuraciones se organizan en dos grandes secciones: Organización y Producto, facilitando la búsqueda y reduciendo la sobresaturación de opciones.
* **Nueva sección "Configuración avanzada"** — Centralizamos las configuraciones específicas de canales, equipos y otras opciones globales, permitiendo una administración más clara y eficiente.
* **Mejoras en el semáforo de tiempos** — Actualizamos la visualización y gestión de los tiempos para facilitar el seguimiento de las conversaciones y mejorar el control operativo.
Estas mejoras buscan que la administración de la plataforma sea más rápida, intuitiva y alineada con las necesidades de los equipos.
## Actualización del módulo de Monitoreo
Se realizó una actualización del módulo de Monitoreo con navegación mejorada, nueva interfaz y gestión optimizada de etiquetas.
Principales cambios:
* **Navegación más rápida y organizada** — Acceso simplificado a la información más relevante, con una estructura mejorada para mayor eficiencia.
* **Consistencia con la nueva UI de la plataforma** — Una experiencia homogénea y moderna en todos los módulos, manteniendo coherencia visual.
* **Gestión de etiquetas optimizada** — La creación de etiquetas se ha reubicado al módulo de Clientes y estará disponible directamente desde el PMA para mayor accesibilidad.
Estos cambios forman parte de nuestro compromiso continuo de mejorar su experiencia en Jelou.
## Nuevas páginas de documentación en Connect — Gestión
Se incorporaron cinco nuevas páginas a la sección **Gestión** dentro de la pestaña **Connect**, ampliando la documentación disponible para supervisores y administradores:
* **Monitoreo en Vivo**: supervisa en tiempo real conversaciones activas, tiempos de respuesta y casos que requieren acción inmediata.
* **Supervisión de Operadores**: consulta el estado, carga de trabajo y actividad de cada operador, con acciones como impersonación y transferencia de conversaciones.
* **Gestión Consolidada de Casos**: analiza todos los casos gestionados dentro de un período, con indicadores de atención y clasificación por tipo de derivación.
* **Historial de Conversaciones**: revisa y audita interacciones pasadas con trazabilidad completa de mensajes, eventos y transferencias.
* **Mensajes Rápidos**: crea y administra respuestas predefinidas para agilizar la atención de los operadores.
Explora las nuevas secciones de gestión en Connect.
## Emails en Bandeja de entrada — Nuevo diseño disponible
Renovamos por completo el módulo de Emails: ahora la experiencia se siente como un cliente de correo moderno, con todo más organizado, limpio y fácil de usar.
Lo nuevo incluye:
* **Preferencias de vista**: elige entre la nueva vista de paneles o la vista de pantalla completa con el layout de siempre.
* **Vista dividida y redimensionable**: bandeja, correo y CRM del cliente en una sola pantalla.
* **Look and feel renovado**.
* **Misma funcionalidad**, ahora potenciada y mejor ordenada.
## Filtro de etiquetas en la bandeja de chats
Ya está disponible en **Bandeja de entrada → Chats** un nuevo filtro que permite buscar conversaciones según las etiquetas asignadas a cada chat, de forma rápida y dinámica.
* El filtro se alimenta automáticamente de las etiquetas que tengan tus chats activos.
* Si ninguno de tus chats tiene etiquetas, el filtro no aparecerá.
* Es especialmente útil cuando manejas múltiples conversaciones y necesitas encontrar rápidamente las de un tipo específico.
## Nuevas secciones de envío de plantillas de WhatsApp
Dentro de la sección de **perfil de Clientes** y desde las conversaciones de **bandeja de entrada**, ahora verás un nuevo ícono que despliega el listado de plantillas disponibles para enviar a tus clientes, tanto dentro como fuera de una sesión activa.
Esta funcionalidad es especialmente útil para recontactar usuarios. Además, puedes disparar un workflow que comenzará automáticamente cuando el cliente responda al mensaje recibido.
**Consideraciones:**
* El botón solo se muestra para roles con permiso de envío de campañas.
* Las plantillas con QR y las plantillas especiales (LTO, Catálogo, Flujos, Carrusel, etc.) están excluidas temporalmente.
* El workflow escogido se ejecuta siempre que el usuario no se encuentre en la Bandeja de entrada.
## Actualización de la pestaña Connect
Actualizamos la pestaña **Connect** con una estructura reorganizada para la operación y gestión de atención al cliente. Los cambios principales son:
* **Secciones reorganizadas**: Empezando, Mensajería Outbound, Gestión, Canales y Configuraciones.
* **Introducción unificada** en Brain Studio que presenta la plataforma completa: builder, atención humana y mensajería outbound.
* **Grupos renombrados**: "Campañas" ahora es "Mensajería Outbound", "Panel Multi Agente" ahora es "Gestión", "Motivo de cierre" ahora es "Derivación a workflow".
Conoce la plataforma desde la nueva página de inicio.
Explora la nueva pestaña de operación y atención al cliente.
## API de ecommerce — Migración al gateway
La API de Jelou Shop ahora se consume a través del **gateway de Jelou**. La URL base cambia a `https://gateway.jelou.ai/ecommerce` y la autenticación se realiza con una **clave API** enviada en el header `x-api-key` (en lugar de `Authorization: Bearer`).
Genera y administra tu clave API desde el módulo de [Claves API](/guides/configuracion/claves-api). El `app_id` (Shop ID) se mantiene sin cambios.
Consulta los endpoints actualizados de sucursales, categorías y productos.
## Shopify — Conexión con OAuth 2.0
Conectar tu tienda de Shopify ahora usa **OAuth 2.0**. Ya no necesitas crear una aplicación en Shopify ni ingresar el dominio de tu tienda, el Client ID o el Client Secret. Desde el Marketplace (o el Jelou Agent) haces clic en **Conectar**, autorizas la app **Jelou Commerce** en tu cuenta de Shopify y la integración queda lista.
Sigue los pasos para conectar tu tienda con el nuevo flujo de autorización.
## Auto-publicación de Workflows
Las nuevas cuentas self-service tienen la **auto-publicación** activa por defecto: cada cambio guardado en el canvas se despliega de inmediato en producción sin necesidad de hacer clic en **Publicar**. El botón desaparece del editor mientras la función esté activa.
Las cuentas existentes (enterprise y self-service) mantienen el flujo de publicación manual. Los super admins pueden activar o desactivar la auto-publicación desde el menú contextual (esquina superior derecha).
**A tener en cuenta:** con auto-publicación activa no se genera historial de versiones ni existe opción de rollback. Solo aplica a workflows regulares — las Tools y Skills del Marketplace siempre requieren publicación manual.
Consulta cómo configurar el modo de publicación de tu cuenta.
## AI Routing — Toma de control
Nueva tarjeta en la página de **AI Routing** en Ajustes que define cuándo el AI Router toma el control de la conversación. Es especialmente útil para proyectos donde los usuarios inician con un saludo antes de exponer su consulta real.
Elige entre dos modos:
* **Ruteo inmediato**: el AI Router intenta derivar al usuario desde su primer mensaje.
* **Filtrar saludos**: ignora mensajes cortos de cortesía y espera a detectar una intención real antes de enrutar. Configura el tiempo de espera (en segundos) y el mensaje que se envía cuando ese tiempo vence.
Consulta cómo configurar la estrategia de toma de control.
## AI Routing — Migración desde intenciones legacy
Los proyectos con intenciones legacy ahora ven el botón **Migrar proyecto** en la página de AI Routing en Ajustes. Al hacer clic, se muestra el listado completo de workflows con la cantidad de intenciones de cada uno y un slider para definir el porcentaje de despliegue hacia AI Routing de forma controlada.
Sigue los pasos para migrar de intenciones legacy a AI Routing con un despliegue controlado.
## AI Routing
El AI Routing enruta automáticamente cada mensaje entrante al workflow más adecuado del proyecto, usando comparación semántica en lugar de palabras clave exactas. Cuando ningún workflow coincide, el mensaje se envía al **workflow de respaldo** que definas.
### Novedades principales
* **Enrutamiento semántico**: el sistema compara el mensaje con el nombre y descripción de cada workflow y elige la mejor coincidencia sin reglas manuales.
* **Configuración por proyecto**: habilita o deshabilita el AI Routing por proyecto, define un workflow de respaldo y controla la estrategia de despliegue (porcentaje de tráfico entre AI Routing e intenciones legacy).
* **Configuración por workflow**: desde el nodo Start, cada workflow puede definir su nombre, descripción y reglas avanzadas de ejecución.
* **Reglas avanzadas**: restringe un workflow a una lista de usuarios o a prefijos de país específicos; u ocúltalo del enrutamiento automático para ejecutarlo solo por redireccionamiento forzado.
* **Panel de pruebas**: evalúa mensajes individuales, en lote o por carga masiva (CSV) y verifica a qué workflow se enrutarían antes de publicar.
Configuración por proyecto, por workflow, reglas avanzadas y panel de pruebas.
## Integración con HubSpot
Ahora puedes conectar Jelou con **HubSpot** directamente desde el módulo Brain. La integración permite gestionar conversaciones, automatizar flujos conversacionales y transferir la atención al cliente hacia HubSpot Inbox o canales personalizados.
* Configurable desde el **nodo de HubSpot** en Canvas.
* Soporta **Inbox de HubSpot** y **canales personalizados**.
* Requiere cuenta Enterprise con el nodo de HubSpot habilitado.
Consulta la documentación completa para instalar, configurar y usar la integración.
## PayPal y Wompi disponibles como proveedores de pago
Brain Studio ahora permite conectar **PayPal** y **Wompi** como proveedores de pago desde Marketplace, Jelou Agent, el nodo Pagos en Canvas o templates compatibles.
Ambos proveedores usan **checkout WebView embebido** dentro del flujo conversacional.
* **PayPal** — Cobertura global. Requiere cuenta Business con acceso a API. Se configura con Client Id y Client Secret.
* **Wompi** — Disponible en Colombia (COP). Requiere cuenta activa de Wompi con llaves y secretos de Sandbox o Producción.
Guía de inicio para conectar PayPal en Brain Studio.
Guía de inicio para conectar Wompi en Brain Studio.
## Carrusel de WhatsApp en API de mensajes
Ahora puedes enviar mensajes interactivos tipo **carrusel** a través del endpoint `POST /v1/bots/{botId}/messages`, sin necesidad de una plantilla HSM aprobada por Meta.
### Novedades principales
* **Hasta 10 tarjetas por carrusel**, cada una con header de imagen o video, cuerpo de texto y acción.
* **Acciones soportadas**: botón CTA URL (`cta_url`) o botones de respuesta rápida (`quick_reply`).
* **Providers compatibles**: WhatsApp Cloud API y Gupshup CAPI.
Estructura del body, ejemplos y restricciones del nuevo tipo de mensaje.
## Aplicación Móvil Jelou Connect
Hemos realizado mejoras importantes para optimizar tu experiencia en la app. Los cambios principales incluyen:
* **Nueva interfaz**: Diseño más moderno, simple y fácil de usar.
* **Modo claro y oscuro**: Adapta la app a tu preferencia visual.
* **Captura multimedia integrada**: Toma y envía fotos y videos directamente desde la app.
* **Mayor seguridad**: Inicio de sesión con Google (SSO) y doble factor de autenticación (OTP por correo o apps TOTP).
* **Mejora en reproducción de audios**: Escucha audios en velocidad 1.5x y 2x para optimizar tiempos.
Descarga Jelou Connect para Android.
Descarga Jelou Connect para iOS.
## Tester de workflows con look unificado
Renovamos el Tester del canvas de Brain Studio para que comparta interfaz con el Debugger de producción. El builder ya no necesita aprender dos herramientas distintas: las burbujas, los indicadores de nodo y el panel de detalle son idénticos en los dos lados.
### Novedades principales
* **Indicadores de nodo intercalados** con los mensajes: cada nodo ejecutado aparece como una tarjeta con su ícono y nombre del canvas. Click abre el panel de detalle con input, output, estado inicial, estado final y errores.
* **Vista Mensajes / Vista Ejecución**: toggle al pie del panel para alternar entre solo conversación y conversación + indicadores.
* **Acciones contextuales**: "Ir al nodo" centra el canvas; "Debuggear Tool" abre la ejecución interna de un Tool con sus logs.
* **Copiar path JSON**: click sobre cualquier key del estado inicial/final copia el path en notación bracket (ej. `finalState.tool.url`) al portapapeles.
* **Burbujas interactivas clickeables**: respuestas rápidas, listas, CTAs con URL y carouseles ahora se simulan haciendo click directo, igual que en WhatsApp.
* **Sub-workflows identificados visualmente**: los nodos internos de un sub-workflow se renderizan como un grupo aparte para marcar la frontera de ejecución.
El motor de ejecución no cambia. Disponible para todos los planes y usuarios sin migración ni feature flag.
Cómo usar el Tester, leer indicadores y depurar paso a paso.
## Nueva UI de Jelou Shop
Jelou Shop estrena una interfaz rediseñada en [apps.jelou.ai/shop-v2/products](https://apps.jelou.ai/shop-v2/products) que unifica productos, categorías, sucursales y configuración en un solo panel. El detalle de producto incorpora **vista previa en vivo** del webview, formularios en bloques colapsables y nuevas opciones de personalización (variaciones, modificadores, características y notas al cliente).
La versión anterior sigue disponible desde el enlace **¿Necesitas la versión anterior?** en el sidebar.
Recorrido visual por el panel.
## Cambio de contraseña con verificación 2FA
El flujo de cambio de contraseña ya no solicita la contraseña actual. Ahora, tras ingresar la nueva contraseña y su confirmación, la plataforma valida la identidad del usuario mediante el **doble factor de autenticación (2FA)**, solicitando un código de verificación por correo electrónico (OTP) o mediante una aplicación de autenticación (TOTP).
Consulta la guía de gestión de perfil.
## Respuesta en varios mensajes en el nodo AI Agent
El nodo AI Agent ahora puede dividir su respuesta en burbujas separadas cuando contiene saltos de párrafo (`\n\n`), URLs de medios o listas. Esto produce conversaciones más naturales en WhatsApp y otros canales: el texto introductorio aparece primero, la imagen llega como mensaje aparte, y la pregunta de seguimiento con botones se entrega al final.
### Cómo funciona
* Las URLs de imagen, video, audio o documento se envían como burbujas de medios independientes según el canal.
* Las listas numeradas (`1.`, `2.`, `3.`) y los saltos de línea simples se mantienen juntos en la misma burbuja.
### Activación
* Activado por defecto en los agentes creados a partir del 24 de abril de 2026.
* Los agentes anteriores mantienen el comportamiento previo (una sola burbuja) hasta que actives el toggle **Respuesta en varios mensajes** en la pestaña **Avanzado**.
Consulta la guía del nodo AI Agent.
## Nueva documentación de Panel de Atención Externo
Documentación completa para integrar tu panel de atención al cliente existente con Jelou. Permite que proveedores externos gestionen conversaciones de soporte humano utilizando webhooks y la API REST de Jelou.
### Contenido incluido
* **Proceso de integración**: Guía paso a paso con verificación de firma HMAC-SHA256 para comunicación bidireccional segura.
* **Configuración**: Endpoints para crear, obtener, actualizar, eliminar integraciones y regenerar el signing secret.
* **Eventos webhook**: Estructura común de eventos y referencia de todos los tipos de eventos (`conversation.start`, `conversation.close`, `message`).
* **Mensajes**: Recepción de mensajes del usuario final y envío de respuestas de texto y multimedia.
* **Conversaciones**: Endpoints para iniciar, cerrar y consultar conversaciones, con documentación del evento webhook asociado a cada operación.
### Disponibilidad
Documentación disponible en español, inglés y portugués.
Consulta la guía completa de integración con tu panel externo.
## Nueva pestaña Contexto en el nodo AI Agent
La tercera pestaña del nodo AI Agent ahora se llama **Contexto** (antes *Knowledge*) y centraliza toda la configuración de entrada del agente en un solo lugar.
### Qué incluye la nueva pestaña Contexto
* **Mensaje inicial**: selector con tres opciones para controlar cómo arranca cada conversación:
* **Pasar el último mensaje** — el agente recibe lo que el usuario escribió (opción predeterminada).
* **Sin mensaje de usuario** — ideal para campañas HSM, workflows automatizados o post-recolección de datos.
* **Personalizado** — campo de texto con selector de variables para contextos específicos.
* **Recordar mensajes previos**: define cuántos mensajes anteriores incluir como contexto en cada sesión (rango: 1–50 mensajes).
* **Bloque de carga unificado**: sube documentos e imágenes desde el mismo bloque, con soporte para arrastrar, hacer clic o pegar una URL.
* **Contexto externo**: permite reanudar el nodo desde un sistema externo mediante la API de reanudación. Muestra el endpoint, los headers requeridos y el payload de ejemplo (antes llamado *Reanudación externa* en la pestaña Avanzado).
### Cambios en la pestaña Avanzado
* **Guardar respuesta** se movió al inicio de la pestaña Avanzado.
* **Reanudación externa** se renombró a **Contexto externo** y se movió a la pestaña Contexto.
* Se agregó **Mensaje de seguimiento** para mantener la conversación activa si el usuario no responde.
Consulta la guía completa del nodo AI Agent con la nueva estructura de pestañas.
## Gestión de Perfil
Renovamos la experiencia de gestión de perfil para que sea más simple, fluida y alineada con la plataforma.
### Novedades principales
* **Nueva interfaz de perfil**: Diseño más intuitivo, moderno y consistente con el resto de la plataforma.
* **Gestión de notificaciones**: Activa o desactiva notificaciones y configura el sonido según tu preferencia.
* **Inicio automático de sesión**: Configura si deseas conectarte automáticamente al iniciar sesión.
* **Cambio de contraseña**: Actualiza tu contraseña de forma rápida y segura.
* **Doble autenticación (2FA)**: Elige tu método preferido para mayor seguridad (correo o apps de autenticación).
* **Historial de conexión**: Consulta los accesos recientes a tu cuenta para mayor control.
Consulta la guía completa de gestión de perfil.
## Mejoras en el nodo Plantilla de WhatsApp
El nodo de Plantilla de WhatsApp en Brain Studio recibió mejoras para facilitar su uso y configuración. Ahora cuenta con un flujo de pasos más claro que incluye selección de plantilla, destinatarios, media, parámetros dinámicos y respuesta.
Consulta la guía completa del nodo Plantilla de WhatsApp.
## Nuevo nodo Bases de datos en Brain Studio
Ya puedes leer, crear, actualizar y eliminar registros de tus bases de Datum directamente desde el canvas, sin escribir código. El panel del nodo arma la petición HTTP por ti a partir de la base, la colección y la operación que elijas.
### Qué incluye este cambio
* **Cinco operaciones**: listar, obtener, crear, actualizar y eliminar registros.
* **Editor por tipo de campo**: text, number, bool, date, email, url, select (simple y múltiple), rich text y json — cada campo con el control correcto y soporte de variables.
* **Filtros y ordenamiento visuales**: constructor con operadores (`=`, `!=`, `>`, `>=`, `<`, `<=`, `~`, `!~`), reglas AND y paginación.
* **Pruebas desde el panel**: ejecuta la petición y revisa la respuesta (código, cuerpo y cabeceras) sin salir del nodo; el resultado se cachea hasta que cambias la configuración.
* **Acceso directo a Datum**: botón **Abrir** junto al selector para lanzar la base seleccionada en una pestaña nueva del app de Datum.
Cómo configurar el nodo, ejemplos por operación y acceso a la respuesta.
## Revamp del nodo Webhook
El nodo Webhook recibió una actualización completa que amplía significativamente sus capacidades. Los cambios principales incluyen:
* **Nueva UI**: Interfaz de configuración rediseñada, alineada con el estilo de los demás nodos.
* **Nuevas ejecuciones sin `executionId`**: Ahora es posible usar el webhook para iniciar ejecuciones nuevas, sin necesidad de pasar un `executionId`.
* **Nueva variable `$webhook`**: Similar a `$memory` y `$context`, expone `body`, `headers`, `query`, `method`, `mode`, `executionId` e `isNewExecution` del request recibido.
* **Múltiples resumes configurables**: Opción `oneTimeOnly` para controlar si una ejecución puede ser reanudada más de una vez.
* **Webhook en Workflows**: El nodo Webhook está disponible en Workflows, permitiendo iniciar y reanudar flujos conversacionales desde eventos externos.
* **Testing con `/test`**: URL dedicada para probar el draft sin afectar la versión publicada.
* **Retrocompatibilidad total**: Los webhooks existentes siguen funcionando sin cambios.
Consulta la guía completa del nodo Webhook.
## Documentación: workflows y nombre anterior *skill*
Actualizamos el lenguaje de la documentación para hablar de **workflows** como concepto principal. Donde ayuda a orientarse, usamos la forma **flujo (skill)** para que sigas reconociendo el término anterior del producto.
### Qué incluye este cambio
* **Guías y textos visibles** alineados con la nueva terminología (por ejemplo, *Tu primer flujo (skill)* en las páginas de introducción y primeros pasos).
* **Sin cambios en URLs**: las rutas de las páginas y los enlaces internos se mantienen; solo se actualiza el texto que lees en pantalla.
* **Referencias técnicas**: en contextos de API o nombres exactos del sistema, se conserva *skill* cuando corresponde al identificador real.
## Secrets ahora en Configuración
Los Secrets se movieron de Brain a **Configuración → Secrets**. Desde un solo lugar puedes administrar secretos de toda tu organización y de proyectos individuales sin tener que navegar dentro de cada proyecto.
### Qué cambió
* **Nueva ubicación**: accede desde el menú lateral de Configuración. Los enlaces anteriores (`/brain/:projectId/secrets`) redirigen automáticamente.
* **Dos modos desde una sola pantalla**:
* **Organización**: Secrets disponibles en toda tu cuenta.
* **Proyecto**: Secrets scoped a un proyecto específico, con selector de proyecto integrado.
* **Gestión completa**: crea, edita y elimina Secrets con confirmación antes de borrar. Al eliminar un Secret activo se muestra una advertencia explícita.
### Permisos
Los usuarios con acceso de **solo lectura** a Brain pueden ver la lista de secretos. Para crear, editar o eliminar secretos se requiere acceso de **escritura** en Brain.
## Conecta canales directamente desde Brain Studio
Ahora puedes conectar un canal de WhatsApp sin salir de Brain Studio. El flujo de conexión está disponible desde dos puntos dentro del canvas:
* **Publicar → Conecta tu canal**: haz clic en **Publicar** y luego en el enlace **Conecta tu canal** en la parte inferior del panel lateral.
* **Administrar canales**: abre el menú de la esquina superior derecha del canvas y selecciona **Administrar canales**.
Como ya estás dentro de un proyecto, el modal salta directamente a los pasos de nombre del canal, autenticación con Facebook y aceptación de términos — sin tener que elegir integración ni proyecto.
Consulta los pasos detallados para conectar tu número de WhatsApp Business.
## Nueva interfaz de Campañas en Connect
La experiencia de creación y gestión de campañas en Connect se rediseñó por completo. Ahora puedes completar el flujo en menos pasos, con una navegación más clara y consistente con el resto de la plataforma.
### Qué mejora con esta actualización
* **Navegación más rápida y ordenada**: el asistente de creación guía cada etapa de forma secuencial y sin distracciones.
* **Menos pasos para crear campañas**: se simplificó el flujo sin eliminar funcionalidades.
* **Mayor claridad en cada etapa del proceso**: nombres, descripciones y controles más explícitos en cada paso.
* **Consistencia con la nueva UI de la plataforma**: diseño visual alineado con el resto de Connect y Brain Studio.
## Parámetros por defecto en herramientas MCP
Las herramientas MCP en modo granular ahora permiten configurar **parámetros por defecto** desde los nodos AI Agent y AI Task. Al abrir el detalle de una herramienta individual puedes:
* Fijar valores por defecto que el agente usará en cada invocación, en lugar de dejar que la IA los decida.
* Inyectar variables dinámicas del flujo mediante el selector de variables.
* Alternar entre vista de formulario y editor JSON.
* Buscar parámetros por nombre.
Cada parámetro muestra un indicador **Manual** (valor fijado por ti) o **Auto** (el agente decide).
Consulta la configuración de parámetros por defecto en el nodo AI Agent.
## Nuevo selector de mensaje inicial en AI Agent
El campo de mensaje de inicio (ahora **Mensaje inicial**) en la pestaña Advanced del nodo AI Agent fue reemplazado por un selector con tres opciones claras:
* **Pasar el último mensaje**: el agente recibe automáticamente lo que escribió el usuario (opción predeterminada)
* **Sin mensaje**: el agente inicia de forma autónoma, ideal para saludos proactivos
* **Personalizado**: campo de texto con selector de variables para contextos específicos
Consulta la sección de configuración avanzada del nodo AI Agent.
## Aumento del límite de JSON en memoria
El tamaño máximo permitido para objetos JSON almacenados con `$memory.setJson()` es de **15 KB**.
## Guardar respuesta en nodos de mensajes interactivos
Los nodos **Botones**, **Lista** y **Lista numerada** ahora permiten guardar la opción seleccionada por el usuario directamente en una variable de memoria desde la pestaña **Avanzado** del panel de configuración.
### Novedades principales
* **Variable de respuesta en Botones**: Activa el interruptor "Guardar respuesta" e indica el nombre de la variable. El payload del botón elegido queda disponible como `{{$memory.nombre_variable}}`.
* **Variable de respuesta en Lista**: Misma funcionalidad para el nodo Lista. La opción seleccionada se almacena para uso posterior en el flujo.
* **Variable de respuesta en Lista numerada**: Soporte completo en el nuevo nodo Lista numerada, disponible en todos los canales.
* **Nuevo nodo Lista numerada**: Nodo de mensajes interactivos que presenta opciones como texto numerado, compatible con WhatsApp, Web, Facebook e Instagram.
### Cómo usarlo
1. Abre el panel de configuración de un nodo Botones, Lista o Lista numerada.
2. Ve a la pestaña **Avanzado**.
3. Activa el interruptor **Guardar respuesta**.
4. Escribe el nombre de la variable donde se almacenará la selección.
5. Accede al valor en nodos posteriores con `{{$memory.nombre_variable}}`.
Configura la variable de respuesta en botones interactivos
Configura la variable de respuesta en listas desplegables
Nuevo nodo multicanal con soporte de variable de respuesta
## Nueva documentación de activación de canales
Documentación completa sobre cómo activar y configurar canales de comunicación en la plataforma Jelou.
### Canales documentados
* [**Facebook**](/guides/activacion-canales/facebook): Conecta tu página de Facebook para gestionar conversaciones
* [**Web**](/guides/activacion-canales/web): Integra un widget de chat en tu sitio web
* [**WhatsApp**](/guides/channels/whatsapp): Configura WhatsApp Business API para atención al cliente
### Contenido incluido
* Requisitos previos para cada canal
* Configuración básica paso a paso
* Validaciones y restricciones
* Mejores prácticas específicas por canal
Consulta las guías completas de activación de canales.
## Mejoras UX en nodo Aleatorio
Nueva interfaz mejorada para el nodo Aleatorio con mejor experiencia de usuario y validación visual.
### Mejoras principales
* **Estado vacío mejorado**: Interfaz clara cuando no hay rutas configuradas con botón de acción directa
* **Validación visual**: Alertas de color que indican si la distribución de porcentajes suma 100%
* **Mejor organización**: Panel de configuración rediseñado para facilitar la gestión de rutas
* **Retroalimentación en tiempo real**: Indicadores visuales del estado de la distribución de porcentajes
Consulta la guía completa del nodo Aleatorio.
## Nueva interfaz de Workflows & Tools en Brain Studio
Mejora en la experiencia de usuario con un nuevo diseño de acceso a Workflows, Tools y Marketplace.
### Cambios principales
* **Botón flotante**: Reemplaza la barra lateral izquierda fija con un botón flotante que muestra el nombre del flujo y un ícono de carpeta
* **Panel popover**: Al hacer clic en el botón flotante, se abre un panel emergente con acceso a Workflows, Tools y Marketplace
* **Interfaz más limpia**: Mayor espacio de trabajo al eliminar la barra lateral permanente
Consulta las guías actualizadas con la nueva interfaz.
## Configuración avanzada de AI Agent
Nueva documentación sobre las opciones de configuración avanzada disponibles en el nodo AI Agent.
### Opciones documentadas
* **Soporte de payload de respuesta rápida**: Permite procesar payloads de quick replies en mensajes interactivos
* **Soporte de documentos PDF**: Habilita la lectura y procesamiento de archivos PDF (solo texto, sin imágenes)
* **Leer imagen con URL y pie de foto**: Procesa imágenes junto con sus descripciones textuales
Consulta la guía completa de configuración avanzada de AI Agent.
## Memory V2
Nueva versión del sistema de memoria con mejoras significativas para el nodo código.
### Novedades principales
* **Soporte para archivos**: Almacena imágenes, videos, audios y documentos (hasta 10MB)
* **Control de TTL**: Define tiempo de expiración para cada dato almacenado
* **API mejorada**: Métodos específicos para primitivos, JSON y archivos
* **Mayor capacidad**: JSON hasta 5KB, archivos hasta 10MB
### Ejemplo rápido
```javascript theme={null}
// Primitivos
$memory.set('idioma', 'es');
// JSON con TTL de 1 hora
$memory.setJson('perfil', { nombre: 'María' }, 3600);
// Archivos con TTL de 1 día
await $memory.setFile('foto', base64Data, 86400, 'image/jpeg');
```
Consulta la guía detallada con todos los métodos, tipos admitidos y ejemplos de migración.