Saltar al contenido principal

Solución de problemas

Solución de problemas

Usa esta guía cuando un workflow no publica, no se ejecuta o no avanza como esperas.

No puedo publicar el workflow​

Esto suele pasar cuando la estructura del flujo todavía tiene errores.

Revisa lo siguiente:

  • hay ramas sin conectar
  • falta una salida en una condición o selector
  • un formulario no tiene destinatario o campos
  • una solicitud HTTP no tiene URL o extractores válidos
  • los bloques de Dividir flujo y Unir flujo no están bien emparejados

Corrige primero los errores estructurales del editor y vuelve a guardar.

El webhook no tiene URL​

La URL pública del webhook se genera después de guardar el workflow.

Haz esto:

  1. Guarda el workflow
  2. Vuelve a abrir el bloque Webhook recibido
  3. Copia la URL generada

Si todavía no aparece, confirma que el workflow se haya guardado correctamente y que el bloque siga siendo el trigger inicial esperado.

El trigger por evento no corre​

Revisa estas causas comunes:

  • el evento seleccionado no es el exacto
  • el payload de prueba no coincide con el evento esperado
  • el workflow tiene advertencias o errores estructurales que bloquean la ejecución

Consulta los eventos disponibles en Obtener contratos de eventos.

El workflow no muestra ejecuciones​

Si el workflow está publicado pero no ves ejecuciones:

  • confirma que el trigger realmente se haya disparado
  • revisa si el workflow sigue en draft, es decir, en Borrador dentro del dashboard
  • valida que el webhook o evento esté apuntando al workflow correcto
  • prueba una ejecución manual desde Ejecutar workflow manualmente

El formulario no reanuda la ejecución​

Esto suele pasar cuando:

  • el formulario ya no está pendiente
  • la respuesta la intenta enviar una persona distinta a la asignada
  • la ejecución original cambió de estado antes de responderse

Revisa la ejecución y confirma que el formulario siga pendiente en Obtener una ejecución de workflow.

Las variables no aparecen o no resuelven​

Revisa estas causas comunes:

  • el trigger no entrega ese dato en el contexto
  • la ruta de la variable está mal escrita
  • el valor viene de una respuesta HTTP que aún no ocurrió
  • el secret global se intentó usar fuera de un template soportado

Si dependes de datos de evento o webhook, valida primero el contrato y la estructura del payload.

La solicitud HTTP falla o no extrae campos​

Revisa:

  • URL y método
  • headers requeridos
  • body esperado por el servicio externo
  • timeout configurado
  • rutas de extracción en la respuesta JSON

Si la llamada responde pero no guarda variables, el problema suele estar en la ruta configurada para la extracción.

No llegan alertas por falla​

Confirma lo siguiente:

  • el workflow tiene activadas las alertas por falla
  • la compañía tiene configurado un correo de alertas
  • la ejecución realmente terminó en estado fallido

Si el flujo es crítico, combina esta revisión con monitoreo de ejecuciones y versiones para detectar regresiones más rápido.

Cuándo conviene restaurar una versión​

Restaura una versión anterior cuando:

  • una edición reciente rompió el flujo
  • una condición nueva desvió ejecuciones válidas
  • una integración HTTP empezó a fallar después de un cambio de configuración

Usa Restaurar una versión de workflow para volver a un estado conocido.