Antes de que una automatización trabaje para sus miembros, usted quiere verla funcionar. Una ejecución de prueba la inicia una vez cuando usted lo pide. El historial de ejecuciones muestra luego cada ejecución, real o de prueba, paso a paso, para que vea qué ocurrió y por qué falló una ejecución.
Qué hace realmente una ejecución de prueba
Una ejecución de prueba no es una simulación. Ejecuta la automatización una vez, de inmediato:
- Las acciones se ejecutan de verdad. Se envían correos, cambian etiquetas, grupos y accesos a cursos, y se envían webhooks y solicitudes externas. Pruebe con su propia cuenta o con un miembro de prueba, no con un cliente real.
- Usa la última versión guardada, aunque todavía no la haya publicado. Los eventos reales siguen usando la versión publicada hasta que publique.
- También funciona mientras la automatización está desactivada.
- Cuando el flujo llega a un paso Retraso o Esperar hasta la fecha, la ejecución de prueba espera como una ejecución real. Los pasos restantes se ejecutan de verdad cuando termina la espera.
- Un paso Ejecutar workflow inicia la otra automatización de verdad. Esa ejecución aparece en el historial de ejecuciones de la otra automatización con el origen Automático.
- Todas las integraciones que usa el flujo deben estar conectadas. De lo contrario, la prueba se detiene con "Conecta primero estas integraciones:" y los nombres que faltan.
Las ejecuciones de prueba no cuentan en la lista: Última ejecución, Ejecuciones (7 d), Éxito (7 d) y la vista Fallido las ignoran. Una prueba fallida no marca su automatización como fallida.
Iniciar una ejecución de prueba desde la lista
Abra el menú de una automatización en la lista y elija Ejecución de prueba. El diálogo explica: "Ejecuta el borrador actual una vez con datos de prueba vacíos. Las acciones se ejecutan de verdad." Esta prueba empieza sin datos del disparador y sin miembro. Sirve para una comprobación rápida. Para probar con un miembro o con sus propios datos, inicie la prueba en el editor.
Si la automatización tiene varios disparadores, elija uno en Empezar desde el disparador. Luego haga clic en Iniciar ejecución de prueba. El resultado aparece en el mismo diálogo:
- Ejecución de prueba completada, con la duración.
- La ejecución de prueba está esperando en un paso de retraso o espera cuando el flujo se pausó en un paso Retraso o Esperar hasta la fecha. El resto sigue más tarde.
- La ejecución de prueba falló, con el mensaje de error de la ejecución.
Ejecutar de nuevo inicia otra prueba. Si la automatización no tiene disparador, el diálogo muestra "Esta automatización no tiene un disparador desde el que empezar."
Iniciar una ejecución de prueba en el editor
Haga clic en Ejecución de prueba en el encabezado del editor. El diálogo ofrece más control:
- Si tiene cambios sin guardar, una nota dice "Los cambios sin guardar se guardan antes de la ejecución de prueba." La prueba guarda primero y luego empieza. Si el guardado falla, la prueba no empieza.
- Con un disparador, el diálogo lo nombra. Con varios, elija uno en Disparador.
- Carga útil son los datos que entregaría el disparador. Empieza como
{}. Introduzca los campos que leen sus pasos, por ejemplo el campo que comprueba una condición o el que usa un marcador de posición como{{order_id}}:{"order_id": 1042, "amount": 4900}. Mientras el texto no sea JSON válido, el diálogo muestra "JSON no válido. Revisa la carga útil e inténtalo de nuevo." y no se ejecuta. - UUID del miembro es el miembro al que se refiere la ejecución. Las acciones que trabajan sobre un miembro, por ejemplo añadir una etiqueta o conceder un curso, necesitan uno. Déjelo vacío para flujos sin miembro, como una programación o un webhook. Encuentra el UUID al final de la dirección web cuando abre el miembro en el área de administración. Un UUID desconocido detiene la prueba con "No se encontró este miembro en este negocio."
Haga clic en Ejecutar prueba. El diálogo se cierra, se abre el historial de ejecuciones y el lienzo muestra la ejecución nueva.
Estos mensajes detienen una prueba antes de que empiece:
- "Guarda la automatización una vez antes de iniciar una ejecución de prueba."
- "Añade un disparador y guarda antes de iniciar una ejecución de prueba."
- "Este disparador aún no está en la versión guardada. Guarda e inténtalo de nuevo."
- "Esta automatización no tiene disparadores para probar."
El historial de ejecuciones
Haga clic en Ejecuciones en el encabezado del editor. El botón funciona en cuanto la automatización está guardada. El panel lista las 50 ejecuciones más recientes que coinciden con sus filtros, de la más nueva a la más antigua, y se actualiza cada pocos segundos. Cada entrada muestra el estado, el origen, el disparador, cuándo empezó la ejecución y, una vez terminada, cuánto duró. Para una ejecución en espera, muestra también cuándo se reanuda.
Estado
- En ejecución: la ejecución está en curso.
- En espera: la ejecución espera en un paso Retraso o Esperar hasta la fecha. La entrada muestra Se reanuda con la fecha y la hora en su hora local en que continúa. Si esperan varias rutas, es la hora más temprana.
- Completado: la ejecución llegó a su final.
- Fallido: un paso falló o la ejecución alcanzó un límite. Abra la ejecución para ver por qué.
- Cancelado: la ejecución estaba en espera y se detuvo porque la automatización se desactivó, se archivó o se eliminó. Más información más abajo.
Origen
- Automático: algo en su plataforma inició la ejecución, por ejemplo un miembro nuevo o un pedido. Las ejecuciones iniciadas por un paso Ejecutar workflow de otra automatización también muestran este origen.
- Programador: el reloj de la plataforma inició la ejecución. Esto abarca los disparadores Según una programación (cron), Miembro inactivo, El evento empieza pronto y Renovación próxima.
- Manual: una ejecución de prueba o una repetición.
- Webhook: un webhook entrante o una llamada de un servicio externo.
- Otro: cualquier otro inicio.
Filtros
Sobre la lista puede filtrar por estado (Cualquier estado), por origen (Cualquier origen) y por una fecha y hora de inicio en Desde. No hay un filtro de estado aparte para las ejecuciones en espera: aparecen en En ejecución. Borrar filtros restablece todos los filtros y muestra cuántos están activos. Cuando nada coincide, el panel dice "Ninguna ejecución coincide con tus filtros" con un enlace Mostrar todo. Antes de la primera ejecución dice "Aún no hay ejecuciones".
Ver una ejecución
Haga clic en una ejecución de la lista. El lienzo cambia a esa ejecución y muestra el flujo tal como era en la versión que usó la ejecución. Un aviso en la parte superior muestra cuándo empezó la ejecución, su estado y "La repetición es de solo lectura." No puede editar mientras mira una ejecución. Salir de la repetición devuelve su borrador actual.
Cada paso al que llegó la ejecución recibe un anillo de color y una pequeña insignia:
- Verde: Completado.
- Rojo: Fallido.
- Azul: En ejecución.
- Morado con un reloj de arena: En espera. El paso es un Retraso o un Esperar hasta la fecha y la ejecución continúa más tarde.
- Gris: Omitido. El paso se saltó, por ejemplo porque un filtro detuvo esta ruta o porque la ejecución se canceló durante la espera.
Los pasos sin anillo no se alcanzaron.
Haga clic en un paso para abrirlo en el panel de la derecha. Configuración muestra su configuración, en solo lectura. Ejecución muestra lo que ocurrió:
- Estado, Iniciado y Finalizado. Un paso en espera muestra Se reanuda con la hora en que continúa la ejecución.
- Entrada y Salida: los datos que el paso recibió y transmitió.
- Un recuadro rojo con el error si el paso falló. Mostrar traza abre detalles técnicos que puede enviar al soporte.
- Una Nota amarilla en un paso completado significa que el paso se ejecutó pero no cambió nada, por ejemplo "The member already has this badge."
Un paso al que la ejecución nunca llegó dice "No hay traza disponible". Si falló toda la ejecución, el aviso muestra además en rojo el error de la ejecución.
Repetir una ejecución
Repetir en el aviso vuelve a iniciar la ejecución. Tras la pregunta ¿Repetir esta ejecución? el diálogo advierte: "Ejecuta de nuevo el borrador actual con la misma carga útil. Las acciones se ejecutan de verdad." La repetición usa los mismos datos del disparador y el mismo miembro que la ejecución original, pero la última versión guardada de su flujo. Eso la convierte en la forma más rápida de comprobar una corrección: busque la ejecución fallida, corrija el paso, guarde y repita.
La repetición es una ejecución nueva con el origen Manual, y el lienzo cambia a ella de inmediato. Si sustituyó el disparador desde la ejecución original, la repetición se detiene con "El disparador de esta ejecución ya no existe en la versión actual. Inicie una nueva ejecución de prueba."
Detectar fallos en la lista
No tiene que abrir cada automatización para encontrar problemas. La lista los muestra, basándose solo en ejecuciones reales:
- La vista Fallido junto a sus carpetas lista todas las automatizaciones cuya última ejecución falló. Cuando no hay ninguna, muestra No hay automatizaciones fallidas.
- La columna Última ejecución muestra Nunca, o la hora de la última ejecución con un punto de color: verde para completada, azul para en ejecución, gris para cancelada. Una última ejecución fallida aparece como una insignia roja con la información sobre herramientas La última ejecución falló.
- Éxito (7 d) es la proporción de ejecuciones completadas entre las ejecuciones terminadas de los últimos siete días. Las ejecuciones aún en curso no cuentan. Las fallidas y las canceladas la reducen. Ejecuciones (7 d) cuenta todas las ejecuciones de los últimos siete días y está oculta de forma predeterminada.
- El filtro Estado de la última ejecución encuentra automatizaciones por Completado, Fallido, En ejecución, Cancelado o Nunca.
Desde ahí, abra la automatización, abra Ejecuciones, filtre por Fallido y haga clic en la ejecución para ver qué paso falló y por qué.
Actividad: quién cambió qué
Actividad en el menú de una automatización lista sus últimos 50 cambios, cada uno con la persona y la hora: Creado, Guardado, Publicado, Revertida, Habilitado, Deshabilitado, Archivado, Desarchivada, Eliminado, Duplicado, Importado para una automatización creada a partir de una plantilla, y Secreto del webhook rotado. Los cambios hechos en varias automatizaciones a la vez aparecen en cada una de ellas. Las ejecuciones de prueba y las repeticiones no forman parte de la actividad; las encuentra en el historial de ejecuciones. Una automatización nueva sin cambios muestra "Aún no hay actividad."
Resumen de las automatizaciones
Qué ocurre con las ejecuciones en espera
Una ejecución que espera en un paso Retraso o Esperar hasta la fecha vuelve a comprobar la automatización cuando termina la espera:
- Desactivada: una ejecución real que vence mientras la automatización está desactivada se cancela. Sus pasos restantes no se ejecutan. Si vuelve a activar la automatización antes de que termine la espera, la ejecución continúa con normalidad. Las ejecuciones de prueba y las repeticiones continúan incluso mientras la automatización está desactivada.
- Archivada: la ejecución se cancela, incluidas las ejecuciones de prueba. Archivar también desactiva la automatización.
- Eliminada: la ejecución se cancela.
- Nueva versión publicada: una ejecución que ya ha empezado termina con la versión con la que empezó. Solo las ejecuciones que empiezan después de publicar usan la versión nueva. Lo mismo se aplica a una reversión.
Una ejecución cancelada muestra Cancelado en el historial de ejecuciones, y su paso en espera pasa a Omitido. El error de la ejecución dice por qué: "La automatización se pausó mientras la ejecución estaba en espera.", o lo mismo con archivó o eliminó.
Cuánto tiempo se conservan las ejecuciones
El historial de ejecuciones conserva las ejecuciones durante 90 días. Una vez al día, las ejecuciones más antiguas se eliminan junto con la entrada y la salida de sus pasos. Las ejecuciones que todavía están en espera se conservan hasta que terminan.
Errores frecuentes y qué significan
Problemas que marca el editor
El editor marca los pasos con problemas antes de que ejecute nada. Guardar sigue funcionando, pero es posible que la automatización no se comporte como espera:
- "El disparador no tiene ningún tipo de evento seleccionado.": elija a qué reacciona el disparador.
- "Un disparador no debería tener una conexión entrante.": un disparador siempre inicia el flujo. Quite la conexión que lleva hacia él.
- "La acción no tiene ningún tipo seleccionado.": elija lo que hace la acción.
- "La acción necesita una integración, pero no hay ninguna seleccionada." y "La integración necesaria no está conectada.": conecte el servicio en Integraciones y seleccione la conexión en el paso.
- "«Días de inactividad» debe ser 1 o más.", "«Días antes de la renovación» debe ser 1 o más." y "«Horas antes del inicio» debe ser 1 o más.": los disparadores Miembro inactivo, Renovación próxima y El evento empieza pronto nunca se inician sin este número. Introduzca un número entero de 1 o más.
- "El retraso no tiene duración.": introduzca una duración mayor que cero.
- "No se ha seleccionado ningún flujo de trabajo en "Ejecutar flujo de trabajo".": elija la automatización que debe iniciar el paso.
- "Sin conexión entrante. Este nodo es inalcanzable.": conecte el paso al flujo o elimínelo.
- "El flujo no tiene ningún disparador.": añada un disparador.
- "Responder al webhook se ejecuta después de un paso de retraso o espera. Quien llama al webhook recibe la respuesta predeterminada.": mueva la respuesta antes de la espera.
Errores en una ejecución fallida
El error de una ejecución fallida nombra el paso y su tipo, por ejemplo "El paso "Enviar email" (Acción) falló." o "El paso "Enviar email" (Acción) se detuvo con un error.", seguido del motivo. Los disparadores y las acciones aparecen con su nombre de la biblioteca, y los demás pasos con el nombre que muestran en el lienzo. Haga clic en el paso rojo del lienzo para leer el mensaje completo. Estos errores aparecen en el idioma predeterminado de su plataforma, también para las ejecuciones de prueba y las repeticiones. Causas frecuentes:
- "… se detuvo con un error.": el paso se encontró con un error, a menudo un servicio externo que rechazó la solicitud o una conexión que hay que renovar.
- "La solicitud devolvió HTTP …", "No se pudo enviar la solicitud: …" o "La URL "…" no es válida o no está permitida.": un paso Hacer solicitud externa recibió un error de su servidor, ninguna respuesta a tiempo, una redirección, o una dirección a la que no puede llamar.
- "No se encontró el flujo de trabajo que se debe ejecutar.", "El flujo de trabajo que se debe ejecutar no tiene ninguna versión publicada." o "El flujo de trabajo que se debe ejecutar no tiene disparador.": la automatización que inicia un paso Ejecutar workflow se eliminó, nunca se publicó o no tiene disparador.
- "Un flujo de trabajo no puede ejecutarse a sí mismo." y "Los flujos de trabajo están demasiado anidados (como máximo 5 niveles).": los pasos Ejecutar workflow se llaman entre sí en círculo o con demasiada profundidad.
- "El flujo de trabajo "…" falló.": la otra automatización falló. Mire su propio historial de ejecuciones.
- "Se alcanzó el límite de 500 pasos.": una ejecución realiza como máximo 500 pasos de una vez. Esto suele deberse a un bucle sobre una lista larga con varios pasos dentro.
- "La ejecución tardó demasiado y se detuvo.": la ejecución duró más de lo que permite la plataforma, por ejemplo porque un servicio externo respondió demasiado despacio.
Notas en pasos completados
Una nota amarilla marca un paso que se completó sin hacer su trabajo:
- "No member of this business could be resolved for this run.": la ejecución no tiene miembro. Pruebe de nuevo con un UUID del miembro, o compruebe si el miembro se eliminó durante una espera.
- "The configured course no longer exists.", o lo mismo para un grupo o una insignia: elija uno nuevo en el paso.
- "The course is not published, so no access was granted.": publique primero el curso.
- "No se encontró ninguna fecha en "…". El flujo continuó sin esperar." o "No se pudo leer la fecha "…". El flujo continuó sin esperar.": un paso Esperar hasta la fecha no encontró ninguna fecha utilizable y continuó sin esperar.
- "El flujo de trabajo "…" está en pausa. El flujo continuó sin él.": active la automatización que inicia el paso Ejecutar workflow.
No todas las acciones dejan una nota. Si un paso de miembro muestra Completado pero no cambió nada, compruebe si la ejecución tenía un miembro en Entrada.