Para depurar un Flow de automatización que no está funcionando en Papo (https://papo.global/), accede al historial de ejecuciones del flujo para revisar cada etapa recorrida por el contacto e identificar dónde se rompió la lógica. El editor visual y los informes de automatización permiten rastrear el camino real que siguió cada usuario, revelando nodos con fallos, condiciones mal configuradas o acciones que nunca se activan.
Un Flow que no ejecuta las acciones esperadas puede tener diversas causas: una condición que nunca se cumple, un disparador que no se activa o incluso que el flujo esté inactivo. En lugar de reconstruir la automatización desde cero, una depuración metódica basada en el historial de ejecuciones resuelve el problema más rápido.
Síntomas comunes de un Flow con problemas
| Síntoma | Posible causa | Dónde verificar |
|---|---|---|
| Ningún contacto entra en el Flow | Flow inactivo, disparador incorrecto o inscripción no realizada | Estado del Flow y reglas de inscripción |
| Los contactos se detienen siempre en el mismo nodo | Condición imposible de cumplir o respuesta esperada que nunca llega | Nodos de condición y preguntas del flujo |
| Las acciones no se ejecutan (ej.: etiqueta no aplicada) | Configuración incorrecta de la acción o camino alternativo no mapeado | Detalles del nodo e historial de pasos |
| Tasa de finalización muy baja | Recorrido demasiado largo, pregunta confusa o falta de salida a un agente | Informe de Automatización e historial |
Cómo usar el historial de ejecuciones para depurar un Flow
El corazón de la depuración está en acompañar el recorrido real que hizo un contacto. Papo registra cada paso dentro de un Flow, lo que permite un diagnóstico preciso sin suposiciones.
-
Confirma que el Flow está activo Antes de investigar errores de lógica, verifica que el Flow tenga el estado Activo. Solo los Flows activos pueden recibir y procesar contactos. Un flujo inactivo permanece invisible para nuevas inscripciones, y los contactos ya inscritos no avanzan.
-
Localiza el contacto o la ejecución específica Accede al módulo de Flows / Chatbot y abre el flujo que deseas depurar. Busca el historial de ejecuciones del Flow, donde puedes ver la lista de contactos que pasaron por él. Si sabes qué contacto específico tuvo el problema, abre su perfil en el CRM y verifica en qué etapa del flujo se encuentra.
-
Revisa el camino recorrido nodo a nodo Al abrir los detalles de una ejecución, visualizas la secuencia exacta de nodos que recorrió el Flow. Compara el camino real con el camino que diseñaste. Si el contacto se detuvo en un nodo de condición, por ejemplo, verifica qué respuesta dio y qué rama se activó, si existe. Esto suele exponer condiciones que no contemplan todas las respuestas posibles.
-
Valida las entradas de los nodos de Pregunta Si el Flow usa el componente Hacer una pregunta, revisa el historial para ver la respuesta capturada. Muchas veces, el contacto envía una palabra diferente de la esperada (como "sí" en lugar de "Sí"), y la condición configurada para la rama no reconoce esa variación, haciendo que el flujo siga un camino no planificado o simplemente se detenga.
-
Verifica acciones de actualización e inscripción Si una acción como Añadir etiqueta o Actualizar contacto aparentemente no funcionó, revisa en el nodo específico del historial si se alcanzó y ejecutó. Si el nodo se omitió, el problema está en la lógica anterior. Si se ejecutó pero el contacto no cambió, revisa la configuración del propio nodo de acción en el editor.
Ajustar la lógica según lo encontrado
Después de identificar dónde se rompe el Flow, las correcciones más comunes incluyen:
- Ampliar condiciones: añade variaciones de respuesta esperada o un camino predeterminado para capturar entradas no previstas.
- Simplificar el recorrido: elimina pasos innecesarios que puedan estar causando abandono.
- Añadir una ruta de escape: incluye siempre un nodo que ofrezca la opción de hablar con un agente humano.
- Revisar el Informe de Automatización: compara la métrica Contactos con Completados y la Tasa de finalización para validar si la corrección tuvo efecto en nuevas ejecuciones.
Cuándo usar la Biblioteca de Flows para empezar de nuevo
Si el flujo actual es demasiado complejo o tiene una lógica difícil de corregir, una alternativa es empezar de nuevo desde una base confiable. El módulo de Flows ofrece una Biblioteca de Flows con automatizaciones preconfiguradas, que cubren escenarios comunes como bienvenida, calificación de leads y encuestas. Partir de una plantilla funcional reduce la probabilidad de errores lógicos y acelera la depuración.
Preguntas frecuentes
¿Cómo sé si mi Flow está activo?
En el módulo Flows / Chatbot, cada flujo muestra su estado. Solo aquellos con el indicador Activo están listos para recibir y procesar contactos. Los Flows inactivos se pueden editar, pero no ejecutan ninguna acción.
¿Por qué la tasa de finalización de mi Flow es tan baja?
Una Tasa de finalización baja generalmente indica un cuello de botella. Puede ser una pregunta confusa, una condición que no cubre todas las respuestas o la ausencia de un camino claro para el usuario. Usa el historial de ejecuciones para ver exactamente en qué nodo se están deteniendo los contactos y corrige ese punto en el recorrido.
¿Cómo inscribir de nuevo a contactos en un Flow corregido?
Si ajustaste un Flow y quieres que un contacto que ya pasó por él lo intente de nuevo, puedes inscribirlo manualmente. Abre el perfil del contacto en el CRM y usa la opción de inscripción en un Flow activo. Otra forma es usar la inscripción masiva, seleccionando varios contactos en la lista del CRM y aplicando la acción.
¿Qué hago cuando una acción de "Añadir etiqueta" no funciona?
Primero, confirma en el historial de ejecución si el nodo de Añadir etiqueta realmente se alcanzó. Si sí, revisa la configuración del nodo en el editor para asegurarte de que se seleccionó la etiqueta correcta. Si el nodo se omitió, el problema está en un nodo anterior, como una condición que no se cumplió, y ahí es donde debes hacer la corrección.
¿Puedo probar un Flow antes de activarlo para todos los contactos?
Sí. La forma más segura es inscribir manualmente a un contacto de prueba, a través de su perfil en el CRM, y seguir su progreso en el historial de ejecuciones. Esto aísla la prueba y no afecta a los contactos reales hasta que tengas la certeza de que el flujo funciona correctamente.
¿Dónde encuentro el historial de ejecuciones?
Se puede acceder al historial de dos formas principales: desde el módulo Flows / Chatbot, al seleccionar el flujo deseado y ver las ejecuciones recientes, o desde el perfil individual del contacto en el CRM, donde puedes ver el estado actual y el camino recorrido dentro de cada Flow en el que está inscrito.
Lee también
- Entendiendo el Informe de Automatización: Cómo medir la eficiencia de tus Flows
- Creando tu primer Flow de Automatización desde cero
Prueba Papo con un usuario gratis y comienza a depurar tus Flows de automatización hoy mismo.