Manual — Agentes IA

Qué es Agentes IA

IA que atiende a tus clientes dentro de Yoizen

Si tu empresa atiende clientes por WhatsApp o redes sociales con Yoizen (ySocial y yFlow), esta solución le pone un cerebro de inteligencia artificial: agentes que conversan con tus clientes siguiendo tus reglas y tu conocimiento, transfieren a un asesor humano cuando toca, y te muestran con total transparencia cuánto cuesta cada conversación.

💬

Se construye conversando

Describes el agente en español y la IA lo diseña por ti. Sin programar, sin diagramas manuales.

"Crea un agente de ventas que salude, pregunte qué necesita el cliente, consulte el catálogo y agende una llamada si está listo para comprar."

🗺️

Lo ves como un flujo

Cada agente se dibuja como un mapa de etapas y transiciones — entiendes exactamente qué hará antes de activarlo.

🧪

Lo pruebas sin riesgo

Un simulador tipo WhatsApp te deja conversar con tu agente antes de conectarlo. Nada llega a tus clientes reales hasta que tú lo actives.

📚

Responde con tu conocimiento

Conéctale un proyecto de Proyectos y responderá solo con la información de tus documentos, de forma estricta.

🙋

Sabe cuándo pasar a un humano

Define reglas de transferencia (palabras clave, temas delicados, solicitud del cliente) hacia tus colas de agentes de ySocial.

💰

Costo transparente

Ves cuánto cuesta cada agente y cada conversación atendida, con presupuesto diario y pausa automática.

Instalar la solución

Desde el catálogo de Soluciones, en minutos

La solución se instala en tu propio servidor de Dev Studio — tus conversaciones y credenciales viven en tu infraestructura, no en un sistema compartido.

Abre el catálogo

Ruta: Dev Studio → Soluciones → Agentes IA → Instalar.

Elige el servidor

Puedes instalarla en un servidor existente (si tiene memoria disponible) o crear uno nuevo. Se requiere un servidor tamaño M o superior.

Espera la instalación

La plataforma configura todo automáticamente: los servicios, el dominio seguro (https://tu-servidor-agentes...) y los certificados. Verás el progreso en pantalla.

Necesitas saldo disponible en tu cuenta: la solución tiene una cuota de gestión mensual (se cobra por horas, solo mientras está instalada) y el consumo de IA se cobra por uso. Todo se descuenta de tu saldo como el resto de la plataforma — ver Facturación.

Conectar con Yoizen

Dos llaves (JWT) que generas en ySocial

Para que la solución hable con tu Yoizen necesita dos credenciales llamadas JWT: una para ySocial (casos, mensajes, colas) y otra para yFlow (los flujos del bot). Se generan una sola vez y no caducan hasta que las regeneres.

Generar el JWT en ySocial

Entra a integraciones

Ruta en Yoizen: ySocial → Configuración → Sistema → Integraciones.

Crea una integración con terceros

Si no existe una, crea una nueva integración con terceros para SIAC.

Copia el token

Pulsa "Editar configuración JWT" y copia el token completo. Repite el proceso equivalente para yFlow si tu cuenta lo maneja por separado.

Pegarlos en SIAC

En el panel de la solución (Ruta: Dev Studio → tu servidor → Soluciones → Agentes IA → Conexión con Yoizen) pega la dirección de tu Yoizen (por ejemplo https://tuempresa.ysocial.net) y los dos tokens, y pulsa Probar conexión.

¿Qué valida la prueba? Hacemos una llamada real a tu Yoizen con cada token. Si todo está bien verás "Conectado ✓" y la lista de colas de agentes detectadas — esas colas son las que tu agente de IA podrá usar para transferir conversaciones a tu equipo humano. Si algo falla, el mensaje te dice exactamente qué corregir.

El ID del servicio de WhatsApp

En el mismo formulario hay un campo ID del servicio de WhatsApp: es el número de serviceId de tu línea en ySocial. Es el dato que le permite a tu agente responderle al paciente por WhatsApp. Lo encuentras en ySocial → Configuración → Servicios (o pídelo a tu administrador de Yoizen). Sin él, el agente entiende los mensajes pero no puede contestar.

Crear tu primer agente

Descríbelo en español; el Estudio hace el resto

1. Describe lo que quieres

En Agentes → Crear agente se abre el Estudio: un chat a la izquierda y un lienzo al centro. Escribe en lenguaje natural qué debe hacer tu agente — a qué se dedica tu empresa, cómo debe saludar, qué información puede dar, cuándo debe pasar con un humano.

💬

"Crea un agente para mi clínica odontológica que agende citas, responda precios de los tratamientos y transfiera a recepción si el paciente tiene dolor."

El Estudio diseña las etapas: bienvenida → identificar necesidad → agendar / informar → despedida, con transferencia por urgencia.

✏️

"Haz que antes de agendar siempre pregunte la ciudad, y que solo ofrezca sedes de esa ciudad."

Puedes editar cualquier detalle conversando; el flujo se actualiza en el lienzo al instante.

2. Entiende el lienzo

Tu agente aparece como un mapa de etapas (tarjetas) unidas por flechas (las transiciones y sus condiciones). Cada tarjeta muestra qué hace esa etapa, qué herramientas puede usar y si consulta tu base de conocimiento. Haz clic en una etapa para ver su detalle. Ese mapa es exactamente lo que el agente ejecutará en producción — lo que ves es lo que hay.

3. Dale tu conocimiento

Crea un proyecto en Proyectos con tus documentos (catálogos, listas de precios, políticas, preguntas frecuentes) y asócialo al agente. Con el modo estricto activado, el agente solo afirma lo que está respaldado por tus documentos; si no encuentra la respuesta, lo dice con honestidad y ofrece pasar con un asesor.

4. Pruébalo en el simulador

El panel derecho es un chat de prueba tipo WhatsApp. Conversa con tu agente como lo haría un cliente: verás iluminarse en el lienzo la etapa por la que va, las fuentes que consultó y el costo de cada respuesta. Nada de esto toca tu Yoizen real — puedes probar y corregir cuantas veces quieras.

Todos los cambios quedan en un borrador con historial: lo que publiques es una versión revisada, y siempre puedes volver a la versión anterior con un clic.

Capacidades avanzadas

Tu agente puede hacer mucho más que responder texto

Además de conversar y consultar tu conocimiento, un agente puede habilitar por etapa capacidades de primera clase de la plataforma:

👁️ Leer imágenes — el agente analiza una foto que envíe el cliente (un documento, una cédula, un formulario) y extrae sus datos de forma estructurada, con un nivel de confianza por cada campo.

🩺 Clasificación con reglas — para casos donde la decisión debe ser exacta y auditable (por ejemplo un triage clínico), el agente aplica reglas deterministas: la IA nunca “inventa” el resultado, lo calcula un motor de reglas que tú defines.

📹 Videollamada instantánea — el agente genera un enlace de videoconferencia y se lo comparte al cliente para una atención en vivo.

🚑 Evaluación logística — con la ubicación del cliente, el agente compara opciones de traslado (terrestre, fluvial, aéreo) con distancias y clima reales, y recomienda la mejor.

Caso real — Nathalia (Fundación Valle del Lili): un agente que atiende a médicos rurales por WhatsApp, recibe la foto de la lista de chequeo de una paciente, extrae los signos vitales, clasifica el riesgo con reglas médicas, si es alto abre una videollamada con el especialista y recomienda el medio de traslado — todo construido sobre estas capacidades, integrado a Yoizen. Es la muestra de hasta dónde puede llegar un agente en la plataforma. Pídele estas capacidades al Estudio conversando (“que pueda leer la foto del formulario y clasificar según estas reglas…”).

Activarlo en Yoizen

Un flujo sencillo en yFlow y listo

Cuando tu agente esté probado, pulsa Activar en el Estudio. Se abre una lista de chequeo con todos los valores listos para copiar. El paso central es crear en yFlow un flujo que le entregue los mensajes a tu agente:

Crea el flujo en yFlow

En yFlow crea un flujo nuevo (o edita el del canal) y agrega un nodo de llamada API donde quieras que el agente de IA tome la conversación.

Configura el nodo API

Método POST a la URL que te muestra la lista de chequeo:
https://tu-servidor-agentes.tudominio/bot/tu-agente/message
con el encabezado X-API-Key (cópialo del panel — es la llave privada de tu instalación) y el cuerpo JSON que arma yFlow con los datos del mensaje:

{"phone":"{{phone}}", "name":"{{name}}", "type":"chat", "text":"{{text}}", "caseId":"{{caseId}}"}

Crea la rama por "handoff"

La respuesta del nodo trae un campo handoff. Configura la condición: si es true, deriva el caso a tu cola de agentes humanos; si es false, el flujo espera el siguiente mensaje del cliente (el agente de IA ya le respondió por el canal).

Publica el flujo

Asigna el flujo al canal (por ejemplo tu línea de WhatsApp) y publícalo en yFlow.

Haz la prueba real

Escribe un mensaje a tu línea como cliente. Cuando el primer caso real pase por tu agente, la lista de chequeo se marca sola y el agente queda Activo.

Opcional: notificaciones de WhatsApp (postbacks)

Si tu proveedor de WhatsApp entrega los mensajes y estados por notificaciones directas (postbacks), la lista de chequeo también te da esas dos URLs para configurarlas en el proveedor: una para mensajes (.../ysocial/whatsapp/postback/tu-numero) y otra para estados (.../ysocial/whatsapp/postback/statuses/tu-numero). Si no usas este esquema, puedes ignorarlas.

Las respuestas del agente al cliente no viajan por el nodo API: el agente las envía directo por el canal de ySocial. El nodo solo controla el flujo (seguir con IA o pasar a humano). Por eso la rama por handoff es importante.

Costos por agente

Sabes cuánto cuesta atender a cada cliente

Cada agente tiene su propia pestaña de Costos en el Estudio (y aparece también en el desglose de costos de tu servidor en Dev Studio):

Costo por conversación atendida — el indicador estrella: el gasto total de IA del agente dividido entre las conversaciones que atendió. Ejemplo: si tu agente de ventas gastó $4.20 USD atendiendo 600 conversaciones en el mes, cada cliente atendido te costó $0.007 USD.
Desglose por modelo de IA — qué modelos usó y cuánto costó cada uno.
Resolución — cuántas conversaciones cerró el agente solo y cuántas transfirió a tu equipo humano.
Presupuesto diario — define un tope de gasto por día. Si el agente lo alcanza, se pausa automáticamente (las conversaciones nuevas pasan a tus asesores humanos) y te llega una notificación. Nunca tendrás una sorpresa en la factura.

Cómo se cobra

Cuota de gestión mensual de la solución (prorrateada por horas, mientras esté instalada).
Consumo de IA por uso — cada respuesta del agente, al precio por modelo de tu organización (ver Precios).
La infraestructura del servidor y el almacenamiento de tus documentos se cobran igual que en el resto de Dev Studio.

Más integraciones

Tu agente puede llegar tan lejos como lo necesites

¿Quieres que el agente consulte tu inventario, cree pedidos en tu sistema o registre citas en tu agenda? Pídelo en el chat del Estudio. La IA investiga cómo conectarse, te propone la integración en lenguaje claro y la construye. No hay una lista cerrada de integraciones — se desarrollan a la medida, conversando.

Qué conviene tener a mano

La dirección (URL) de la API del sistema a conectar y su documentación, si la tienes.
Las credenciales (usuario/clave o token). Se piden en un formulario seguro y quedan cifradas — nunca las pegues en el chat.

Clases de riesgo

Consulta — la integración solo lee datos (ver un saldo, buscar un producto). Se activa directo.
Edición — la integración crea o modifica datos (crear un pedido, agendar una cita). Requiere tu confirmación explícita y puedes exigir que el agente confirme con el cliente antes de ejecutarla.

Cada integración nueva incluye una prueba automática que debe pasar en el simulador antes de poder publicarse a producción.

Y si en el mismo servidor tienes instaladas otras soluciones (por ejemplo n8n u Odoo), el Estudio ya las conoce y puede integrar tu agente con ellas sin salir a internet.

Solución de problemas

Los tropiezos más comunes y su arreglo

"Token rechazado" al probar la conexión. El JWT es incorrecto o fue regenerado en Yoizen. Genera uno nuevo (Ruta: ySocial → Configuración → Sistema → Integraciones → Editar configuración JWT), pégalo de nuevo y vuelve a probar. Recuerda: al regenerar un JWT en Yoizen, el anterior deja de servir.
El agente responde en el simulador pero no en WhatsApp. Revisa en yFlow que el flujo esté publicado en el canal, que el nodo API apunte a la URL exacta de tu agente y que el encabezado X-API-Key esté bien copiado. La lista de chequeo del Estudio te muestra los valores correctos para comparar.
El agente transfiere todo a humanos. Suele ser el modo estricto sin suficiente conocimiento: revisa que el proyecto asociado tenga los documentos correctos, o ajusta las reglas de transferencia conversando con el Estudio.
"Agente pausado por presupuesto". Alcanzó su tope diario de gasto. Puedes subir el presupuesto en la pestaña de Costos o esperar a que se reinicie al día siguiente; mientras tanto, las conversaciones van a tus asesores.
¿Necesitas ayuda? Escríbenos desde el panel o a tu contacto de SIAC — el estado de tu instalación y la última prueba de conexión quedan registrados para que el soporte sea rápido.

🤖 Abrir Agentes ← Otros manuales