Este artículo te muestra cómo identificar, depurar y solucionar problemas en las automatizaciones. Desde errores comunes hasta métodos sistemáticos de depuración.
Problemas comunes y soluciones
Problema 1: Los filtros no se aplican correctamente
Problema 1: Los filtros no se aplican correctamente
Qué sucede:
La automatización toma un camino incorrecto o se detiene inesperadamente.
Por qué sucede:
La condición del filtro está configurada incorrectamente (ejemplo: "contiene" en lugar de "es igual a")
"No tiene valor" se malinterpreta (significa que el campo está vacío, no "el valor no es X")
Solución:
Abre la automatización
Ve al nodo de filtro que está causando el problema
Revisa la condición paso a paso:
¿La condición es lógicamente correcta? (ejemplo: "contiene al menos uno de" cuando hay múltiples opciones posibles)
Prueba con un valor conocido
Problema 2: Múltiples automatizaciones ejecutándose simultáneamente
Problema 2: Múltiples automatizaciones ejecutándose simultáneamente
Qué sucede:
El cliente recibe múltiples mensajes al mismo tiempo o diferentes automatizaciones chocan.
Por qué sucede:
Varias automatizaciones tienen déclencheur que escuchan la misma señal (ejemplo: "Nueva conversación entrante" y "Nuevo mensaje entrante").
Solución:
Consulta las instrucciones detalladas en el artículo "Automatizaciones para usuarios avanzados" bajo "Trabajar con múltiples automatizaciones".
Versión corta:
Usa "Esperar / Pausa" (2 segundos) + "Filtro: Otra automatización activa" en la automatización más general
Problema 3: Elementos eliminados en los nodos
Problema 3: Elementos eliminados en los nodos
Qué sucede:
La automatización se detiene repentinamente en un nodo específico y muestra un error.
Por qué sucede:
Un usuario eliminó un elemento (ejemplo: etiqueta, lista de contactos, atributo de contacto) que se utiliza en un nodo de la automatización.
Ejemplo:
Eliminaste la etiqueta "VIP"
El nodo "Actualizar etiqueta" intenta agregar la etiqueta "VIP"
El nodo falla porque la etiqueta ya no existe
Solución:
Ve a la barra lateral derecha en "Automatizaciones" (en el inbox o en el Contact Hub para la conversación o contacto donde falló la automatización)
Haz clic en la ejecución fallida de la automatización
Revisa los nodos ejecutados individualmente: el nodo fallido muestra exactamente qué elemento falta
Abre la automatización
Ve al nodo afectado
Selecciona un elemento existente o recrea el elemento eliminado
Prevención:
Antes de eliminar etiquetas, listas de contactos o inboxes, verifica si se utilizan en automatizaciones.
Problema 4: Dos agentes de IA activos al mismo tiempo
Problema 4: Dos agentes de IA activos al mismo tiempo
Qué sucede:
La automatización se detiene automáticamente en el nodo del agente de IA con un mensaje de error.
Por qué sucede:
Ya hay una automatización con un agente de IA ejecutándose para esta conversación. No permitimos que dos agentes de IA hablen con el mismo contacto en la misma conversación al mismo tiempo.
Solución:
Construye tus automatizaciones para que solo una automatización de agente de IA pueda ejecutarse a la vez:
Usa "Finalizar otra automatización" al inicio de la nueva automatización para detener la anterior
O usa el filtro "Automatización activa" para verificar si una automatización de agente de IA ya está en ejecución
Problema 5: La automatización se ejecuta con una versión antigua
Problema 5: La automatización se ejecuta con una versión antigua
Qué sucede:
Realizaste cambios en la automatización, pero se comporta como antes.
Por qué sucede:
Olvidaste publicar la nueva versión. La versión antigua sigue activa.
Solución:
Abre la automatización
En la parte superior derecha verás el botón "Actualizar"
Haz clic en "Actualizar"
Usar el historial de versiones:
Puedes ver todas las versiones de tu automatización:
En el Automation Builder, haz clic en el menú de tres puntos en la parte superior derecha (junto al botón "Actualizar/Pausar")
Haz clic en "Historial de versiones"
Verás todas las versiones cronológicamente con fecha, hora y quién publicó la versión
"Activa" te muestra qué versión está actualmente en vivo
"Borrador" te muestra los cambios no publicados
Haz clic en el icono del ojo para ver una versión antigua
Para qué sirve el historial de versiones:
Verificar qué versión está actualmente activa
Rastrear cuándo y quién realizó cambios
Ver versiones antiguas para entender qué se modificó
Importante:
Solo las versiones publicadas se ejecutan en vivo
Los cambios en modo de edición no se activan automáticamente
Para automatizaciones actualizadas: Solo las ejecuciones de automatización recién iniciadas pasan por la versión actualizada
Las ejecuciones ya activas finalizan en la versión en la que comenzaron
Ejemplo:
La versión 1 de la automatización está activa
El cliente A inicia la automatización → se ejecuta con la versión 1
Publicas la versión 2
El cliente A aún está en la automatización → finaliza con la versión 1
El cliente B inicia la automatización → se ejecuta con la versión 2
Problema 6: Variables o atributos de contacto están vacíos
Problema 6: Variables o atributos de contacto están vacíos
Qué sucede:
La automatización se detiene en un nodo "Enviar mensaje" u otros nodos que utilizan variables.
Por qué sucede:
La variable o atributo de contacto que deseas utilizar está vacío. No enviamos mensajes con placeholders vacíos porque se ve poco profesional.
Ejemplo:
Nodo "Enviar mensaje": "Hola #{{contact.first_name}}, ¡bienvenido!"
El atributo de contacto "Nombre" está vacío
El mensaje sería: "Hola , ¡bienvenido!"
El nodo falla
Solución 1 - Definir valor de respaldo:
Puedes establecer un valor de respaldo para cada variable que se utilizará si la variable está vacía:
Haz clic en la variable en el campo de texto (ejemplo: el chip "Nombre")
Se abre un popup: "Valor de respaldo para Nombre"
Ingresa un valor de respaldo (ejemplo: "allí" o "Cliente")
Haz clic en "Aplicar"
Ejemplo:
Variable "Nombre" con valor de respaldo "de Berlín"
Si el nombre está completado: "Hola Max, ¡bienvenido!"
Si el nombre está vacío: "Hola de Berlín, ¡bienvenido!"
Solución 2 - Agregar filtro:
Agrega un filtro antes del nodo "Enviar mensaje":
Filtro: "Nombre tiene algún valor"
Solo si el nombre está completado → Enviar mensaje personalizado
De lo contrario → Enviar mensaje genérico sin el nombre
Solución 3 - Solicitar atributo previamente:
Asegúrate de que el atributo esté completado antes de usarlo:
Nodo "Hacer pregunta": "¿Cuál es tu nombre?"
Nodo "Editar contacto": Guardar la respuesta en "Nombre"
Ahora puedes estar seguro de que el nombre está completado
Problema 7: La automatización se activa nuevamente después de cancelarse manualmente
Problema 7: La automatización se activa nuevamente después de cancelarse manualmente
Qué sucede:
El usuario cancela la automatización para tomar el control manualmente. El cliente responde. La automatización se inicia nuevamente desde el principio.
Por qué sucede:
Estás usando el déclencheur "Nuevo mensaje entrante": este se activa con cada mensaje, incluso después de que un agente haya tomado el control.
Ejemplo:
Automatización: Déclencheur "Nuevo mensaje entrante" → Agente de IA
El agente cancela y toma el control manualmente
El agente responde al cliente
El cliente escribe de vuelta
El déclencheur se activa nuevamente → El agente de IA se inicia otra vez
Solución: Usa el déclencheur "Nueva conversación y reabierta" en su lugar:
Solo se activa con el primer mensaje de una conversación
No se activa con cada mensaje de seguimiento
El agente puede tomar el control sin que la automatización se inicie nuevamente
Solución alternativa: Si debes usar "Nuevo mensaje entrante":
Agrega filtro: "Asignación no tiene valor"
La automatización solo se ejecuta si la conversación no está asignada
Tan pronto como el usuario tome el control (se realiza la asignación) → La automatización ya no se activa
Problema 8: No se puede probar la automatización
Problema 8: No se puede probar la automatización
Qué sucede:
Quieres probar la automatización, pero también se activa para clientes reales, o no puedes activarla de manera confiable.
Por qué sucede:
Aún no tenemos un modo de prueba para automatizaciones (solo para el agente de IA).
Solución - Filtro de contenido del mensaje para pruebas: Agrega un filtro al inicio de la automatización que solo se active durante las pruebas:
Opción 1 - Filtro de contenido del mensaje:
Nodo "Filtro / Condición": "El contenido del mensaje contiene 'PRUEBA123'"
Solo cuando escribas "PRUEBA123" en el mensaje → La automatización se ejecuta
Los clientes reales nunca escriben eso → La automatización no se activa para ellos
Opción 2 - Filtro de lista de contactos:
Crea una lista de contactos "Pruebas"
Agrégate a esta lista
Nodo "Filtro / Condición": "Lista de contactos contiene Pruebas"
Solo para contactos en "Pruebas" → La automatización se ejecuta
Importante: ¡Elimina el filtro de prueba antes de publicar la automatización para clientes reales!
Problema 9: La automatización solo se activa una vez
Problema 9: La automatización solo se activa una vez
Qué sucede:
La automatización se ejecuta la primera vez, pero nunca más, ni siquiera al probar.
Por qué sucede:
Razón 1 - "Solo una vez por contacto" activado:
Muchos déclencheurs tienen la opción "Ejecutar solo una vez por contacto"
Si está activado → La automatización solo se ejecuta la primera vez para este contacto
Nunca más después de eso
Razón 2 - Déclencheur "Nueva conversación entrante" sin "Reabierta":
El déclencheur está configurado como "Solo conversaciones nuevas"
Solo se activa con el primer mensaje de un contacto
Las conversaciones reabiertas no activan el déclencheur
Solución:
Al probar:
Elimina completamente la conversación
Comienza de nuevo: la automatización puede activarse nuevamente
Para operación en vivo:
Abre la automatización
Ve al déclencheur
Desactiva "Ejecutar solo una vez por contacto" (si está activado)
O cambia "Solo conversaciones nuevas" a "Conversaciones nuevas y reabiertas"
Problema 10: Tipo de mensaje incorrecto para el canal
Problema 10: Tipo de mensaje incorrecto para el canal
Qué sucede:
La automatización se detiene en un nodo "Enviar mensaje" con un mensaje de error.
Por qué sucede:
Estás intentando enviar un tipo de mensaje que no es compatible con este canal.
Ejemplos más comunes:
Respuestas rápidas de WhatsApp en Instagram:
Usas el nodo "Respuestas rápidas de WhatsApp"
Pero la conversación se realiza a través de Instagram
Las respuestas rápidas de WhatsApp solo funcionan en WhatsApp
Lista de WhatsApp en correo electrónico:
Usas el nodo "Lista de WhatsApp"
Pero la conversación se realiza a través de correo electrónico
Las listas de WhatsApp solo funcionan en WhatsApp
Solución 1 - Agregar filtro:
Agrega un filtro antes del nodo específico del canal:
Nodo "Filtro / Condición": "Tipo de canal es igual a WhatsApp"
Si es WhatsApp:
Ruta 1: Respuestas rápidas de WhatsApp / Lista de WhatsApp
De lo contrario:
Ruta 2: Nodo "Enviar mensaje" regular sin funciones especiales
Solución 2 - Usar automatizaciones multicanal correctamente:
Al crear automatizaciones en múltiples canales:
Crea rutas separadas para cada canal
Usa solo nodos de mensajes específicos del canal en la ruta correcta
Problema 11: Ventana de tiempo de la conversación cerrada
Problema 11: Ventana de tiempo de la conversación cerrada
Qué sucede:
La automatización se detiene en los nodos de respuestas rápidas de WhatsApp, lista de WhatsApp o "Enviar mensaje" independiente del canal con el mensaje de error "Ventana de tiempo de la conversación cerrada".
Por qué sucede:
WhatsApp tiene una regla de 24 horas: solo puedes enviar mensajes gratuitos (respuestas rápidas, listas, texto regular) dentro de las 24 horas posteriores al último mensaje del cliente. Después de 24 horas, la ventana de tiempo de la conversación está cerrada.
Cuándo ocurre este problema:
Ejemplo - Automatización con retraso:
El cliente escribe a las 10:00 AM
La automatización se inicia
Nodo "Esperar / Pausa": Esperar 25 horas
Nodo "Respuestas rápidas de WhatsApp": Intenta enviar
Error: La ventana está cerrada (han pasado más de 24 horas)
Solución - Verificar ventana de tiempo de la conversación:
Agrega un filtro antes de los nodos específicos de WhatsApp:
Nodo "Filtro / Condición": Ventana de tiempo de la conversación
Ruta Abierta: La ventana está abierta (menos de 24 horas)
Respuestas rápidas de WhatsApp / Lista de WhatsApp / Mensaje regular
Ruta Cerrada: La ventana está cerrada (más de 24 horas)
Nodo "Enviar plantilla de WhatsApp" (única opción fuera de la ventana)
Importante entender:
Dentro de la ventana de 24 horas (Ventana de tiempo de la conversación = Abierta):
Mensajes gratuitos permitidos
Respuestas rápidas de WhatsApp permitidas
Listas de WhatsApp permitidas
Plantillas de WhatsApp permitidas
Fuera de la ventana de 24 horas (Ventana de tiempo de la conversación = Cerrada):
SOLO plantillas de WhatsApp permitidas
No se permiten mensajes gratuitos
No se permiten respuestas rápidas de WhatsApp
No se permiten listas de WhatsApp
Problema 12: La automatización se detiene - No hay más créditos
Problema 12: La automatización se detiene - No hay más créditos
Qué sucede:
La automatización se detiene repentinamente en los nodos de acción. En el registro de actividad ves muchas ejecuciones fallidas.
Por qué sucede:
No tienes más créditos de automatización. Sin créditos, las automatizaciones no pueden ejecutarse: solo se ejecuta el déclencheur, pero no los nodos de acción.
Qué son los créditos:
Cada nodo de acción cuesta 1 crédito por ejecución
Los déclencheurs y nodos lógicos son gratuitos
Sin créditos → La automatización se detiene en el primer nodo de acción
Solución:
Ve a Configuración
Haz clic en Plan y Facturación
Haz clic en Créditos
Revisa cuántos créditos quedan disponibles
Cambia a un paquete de créditos más alto o actualiza tu plan para obtener más créditos mensuales
Cómo depurar automatizaciones de manera sistemática
Paso 1: Identificar qué automatización está causando el problema
Paso 1: Identificar qué automatización está causando el problema
Escenario: Se envió un mensaje que no debería haberse enviado
Cómo encontrar la automatización:
Ve a la conversación donde ocurrió el problema
Desplázate hasta el mensaje afectado en la línea de tiempo del chat
Pasa el mouse sobre el icono de rayo junto al mensaje
Aparece una etiqueta con el nombre de la automatización
Para mensajes del agente de IA:
Verás un icono de agente de IA en lugar del icono de rayo
La etiqueta muestra: Nombre de la automatización + nombre del agente de IA
Ahora sabes qué automatización causó el problema.
Paso 2: Revisar qué ejecuciones de automatización han ocurrido
Paso 2: Revisar qué ejecuciones de automatización han ocurrido
Barra lateral derecha → sección "Automatizaciones"
Aquí puedes ver dos cosas importantes:
Automatizaciones actualmente activas:
Qué automatizaciones se están ejecutando actualmente para esta conversación
Estado: "En ejecución"
Ejecuciones pasadas de automatizaciones:
Todas las ejecuciones de automatizaciones para este contacto en todas las conversaciones
Con estado: Completada, Fallida, Cancelada
Lo que puedes ver aquí:
Cuándo se inició la automatización
Qué déclencheur la activó
Estado actual
Cuánto tiempo duró
Paso 3: Analizar la ejecución específica de la automatización
Paso 3: Analizar la ejecución específica de la automatización
Haz clic en una ejecución de automatización en la barra lateral
Ahora puedes ver los detalles:
Resumen:
Estado general de la ejecución (Completada, Fallida, etc.)
Hora de inicio y finalización
Déclencheur que activó la automatización
Lista de todos los nodos que se ejecutaron:
Puedes ver:
Nombre del nodo (ejemplo: "Enviar mensaje", "Filtro / Condición", "Agente de IA")
Estado de la tarea:
Marca de verificación verde → Ejecutado con éxito
X roja → Fallido
Icono de reloj amarillo → Esperando respuesta
Marca de tiempo cuando se ejecutó la tarea
Para tareas fallidas:
Puedes ver el mensaje de error por el que falló
Ejemplo: "La etiqueta 'VIP' ya no existe"
Paso 4: Ir al nodo afectado en la automatización
Paso 4: Ir al nodo afectado en la automatización
Saltar directamente al nodo:
Haz clic en la tarea fallida o problemática en la lista de tareas
Serás redirigido automáticamente a la automatización
El nodo afectado se resaltará
Ahora puedes:
Revisar la configuración del nodo
Verificar las condiciones del filtro
Revisar las variables
Corregir el nodo
Paso 5: Revisar el registro de actividad (para problemas generales)
Paso 5: Revisar el registro de actividad (para problemas generales)
En la automatización → Pestaña "Registro de actividad"
Aquí puedes ver todas las ejecuciones de automatizaciones en todos los contactos.
Cuándo usarlo:
La automatización no se ejecuta para nadie (no solo para ti)
Quieres ver con qué frecuencia se activó la automatización recientemente
Estás buscando patrones en los errores
Opciones de filtro:
Filtrar por estado:
Completada → La automatización se ejecutó correctamente
En ejecución → La automatización se está ejecutando actualmente
Fallida → Al menos una tarea falló
Cancelada → La automatización fue cancelada manualmente o finalizada por otra automatización
Completada sin acción → ¡Muy importante para la depuración!
¿Qué significa "Completada sin acción"?
La automatización se activó PERO no se ejecutó ningún nodo de acción. Esto sucede cuando:
Un filtro justo después del déclencheur detiene la automatización
El filtro está configurado incorrectamente
La condición en el déclencheur mismo no se cumple
Ejemplo:
Déclencheur "Nueva conversación entrante"
Justo después: Filtro "Etiqueta contiene VIP"
El contacto no tiene la etiqueta VIP → El filtro detiene la automatización
No se ejecutó ninguna acción → Estado "Completada sin acción"
Más filtros:
Buscar por nombre de contacto → Encontrar ejecuciones de un cliente específico
Filtrar por automatización → Solo ejecuciones de una automatización específica
Período de tiempo → Solo ejecuciones dentro de un rango de fechas específico