AtendyDocumentación Ir al panel

Flujos de conversación

El modo Flujo (beta): diseña conversaciones por pasos con un grafo visual de nodos, y cuándo conviene usarlo en vez de un prompt.

Flujos de conversación

En Atendy puedes construir un agente de dos maneras. La forma clásica es el modo Prompt: escribes un único texto con la personalidad, las tareas y las reglas, y el agente improvisa la conversación a partir de ahí. La otra es el modo Flujo: en lugar de un solo texto, dibujas la conversación como un mapa de pasos conectados entre sí. En cada paso el agente sabe exactamente qué tiene que hacer y por dónde puede continuar.

El modo Flujo está en beta. Funciona en llamadas reales, pero seguimos puliendo detalles. Para conversaciones sencillas o abiertas, el modo Prompt sigue siendo la opción recomendada.

¿Prompt o Flujo?

No hay una opción mejor que otra: depende de la conversación que necesites.

Usa el modo Prompt cuando…
La conversación es abierta y flexible: resolver dudas, atención general, un recepcionista que responde lo que le pregunten. El agente decide sobre la marcha y tú solo describes cómo debe comportarse.
Usa el modo Flujo cuando…
La conversación tiene pasos claros y un orden: recoger unos datos concretos, decidir según la respuesta, llamar a una integración y terminar. Por ejemplo reservar una cita, cualificar un contacto o gestionar una incidencia.

Cómo funciona un flujo

Un flujo es un mapa de nodos (los pasos) unidos por flechas (los caminos). El agente empieza en el nodo inicial y va avanzando de un nodo al siguiente según lo que ocurre en la conversación.

Además de los nodos, un flujo tiene una descripción general de personalidad y tono que está siempre activa: define quién es el agente y cómo habla, en todos los pasos. Cada nodo añade encima la instrucción concreta de ese momento y sus posibles salidas.

La clave de un buen flujo son nodos pequeños y enfocados: un nodo, una tarea. Cuanto más concreto es cada paso, más fiable es el agente.

Los tipos de nodo

Cada nodo tiene un tipo según lo que hace en la conversación.

NodoPara qué sirveCómo continúa
ConversaciónEl agente habla y escucha: da información, hace preguntas o recoge datos del cliente.Sale por la condición que se cumpla, descrita en lenguaje natural (por ejemplo: el cliente quiere reservar).
DecisiónClasifica la respuesta del cliente en una de varias opciones para encaminar la conversación.Una salida por cada opción.
HerramientaLlama a una integración o webhook durante la llamada: agendar en Cal.com o Google Calendar, consultar o guardar datos, enviar un email o un mensaje.Dos salidas: si salió bien o si hubo un error.
TransferirPasa la llamada a una persona o a otro destino configurado.Es un nodo final: la llamada sale del flujo.
FinEl agente se despide y cuelga la llamada.Es un nodo final.

Recoger datos durante la conversación

En los nodos de conversación puedes indicar qué datos quieres capturar (por ejemplo nombre, email y fecha). El agente los pregunta, los confirma uno a uno y los guarda para usarlos más adelante en el flujo: al llamar a una herramienta, en el mensaje de despedida o en cualquier paso siguiente.

Para usar un dato recogido más adelante, escríbelo entre dobles llaves, por ejemplo {{nombre}}. También tienes la variable {{numero_origen}}, que siempre trae el teléfono de quien llama, y las variables que devuelva tu webhook de entrada.

Ejemplo: reservar una cita

Un flujo típico para pedir cita podría tener estos pasos:

PasoTipo de nodoQué hace
1. BienvenidaConversaciónSaluda y pregunta en qué puede ayudar. Si el cliente quiere cita, avanza a recoger datos; si pide hablar con una persona, va a Transferir.
2. Recoger datosConversaciónPide nombre, email y fecha deseada, y los confirma con el cliente.
3. Crear la reservaHerramientaLlama a la integración de agenda con esos datos. Si sale bien, avanza a la despedida; si falla, vuelve a pedir los datos.
4. DespedidaFinConfirma la cita y se despide.
(alternativa) A recepciónTransferirPasa la llamada a una persona.

Crear tu primer flujo

  1. En la sección Agentes, crea un agente y abre la pestaña Agente.
  2. En Modo de construcción, cambia de Prompt a Flujo. Se abre el editor visual.
  3. Escribe la descripción general de personalidad y tono: quién es el agente y cómo habla.
  4. Añade nodos desde la paleta y colócalos en el lienzo. Empieza por el nodo de bienvenida.
  5. Une los nodos con flechas y escribe en cada flecha la condición por la que se toma ese camino.
  6. Configura cada nodo en su panel: la instrucción, los datos a recoger, la herramienta o el destino de transferencia.
  7. Prueba el agente en el navegador con Probar agente y ajusta lo que haga falta.
  8. Cuando esté listo, vincula un número al agente para recibir llamadas reales.
La prueba en el navegador es una aproximación del flujo, pensada para revisarlo rápido. En una llamada de teléfono real el agente lo sigue paso a paso con toda la precisión. Haz siempre una llamada de prueba antes de darlo por bueno.

Antes de guardar

Atendy revisa el flujo al guardar y avisa si hay algo que impediría que funcione. Comprueba estos tres puntos:

Un único inicio
El flujo debe tener un solo nodo de bienvenida por donde arranca la conversación.
Sin caminos sueltos
Todas las flechas deben llevar a un nodo. Ningún paso puede quedar sin salida ni apuntar al vacío.
Herramientas y destinos definidos
Cada nodo de herramienta debe apuntar a una integración real, y cada transferencia a un destino ya configurado.

Buenas prácticas

Nodos pequeños
Una tarea por nodo. El flujo es más fácil de mantener y el agente se equivoca menos.
Condiciones claras
Escribe en cada flecha una condición concreta y sin ambigüedad, para que el agente sepa cuándo tomar ese camino.
Prevé la vía humana
Añade siempre una salida a Transferir para cuando el cliente pida hablar con una persona o la conversación se atasque.
Camina siempre hacia un final
Revisa que toda conversación avance hacia un nodo Fin o una Transferencia. Atendy protege contra bucles infinitos, pero un flujo bien dibujado no los necesita.