Saltar al contenido principal

Pasos del Workflow

Lo que aprenderas
  • Que son los pasos y como forman el cuerpo de un workflow
  • Como agregar, configurar y gestionar pasos usando la seccion Pasos
  • Como depurar pasos individualmente o todos a la vez
  • Como funciona el orden de ejecucion de los pasos

Los Pasos son las acciones que tu workflow ejecuta despues de que el trigger se dispara. Cada paso representa una sola operacion -- como enviar un mensaje, actualizar un registro o llamar a un servicio externo. Los pasos se ejecutan en secuencia de arriba hacia abajo, lo que significa que cada paso se completa antes de que comience el siguiente.

Para una guia detallada campo por campo de cada tipo de paso disponible, consulta la Referencia de Acciones.

Agregar pasos​

Para agregar un paso a tu workflow:

  1. Abre el formulario de creacion o edicion del workflow.
  2. Desplazate hasta la seccion Pasos.
  3. Haz clic en el boton Add step (Agregar paso).
  4. Un nuevo paso se agregara a la lista. Configuralo seleccionando el tipo de paso y completando sus parametros.
  5. Repite para agregar tantos pasos como tu workflow necesite.

Cada paso que agregas aparece en la lista en el orden en que se ejecutara. Puedes agregar multiples pasos para construir automatizaciones complejas que ejecutan varias acciones en secuencia.

Configurar un paso​

Cuando agregas un paso, necesitaras configurarlo segun la accion que deseas ejecutar. Cada tipo de paso tiene su propio conjunto de campos y opciones. Por ejemplo:

  • Un paso de "enviar mensaje" puede requerir que especifiques el texto del mensaje y el destinatario
  • Un paso de "actualizar registro" puede requerir que selecciones que campo cambiar y que valor establecer
  • Un paso de "llamar webhook" puede requerir que proporciones una URL externa y el payload de datos

Puedes usar la sintaxis de placeholder {{variable}} dentro de los campos de los pasos para insertar datos dinamicos del trigger o de pasos anteriores. Por ejemplo, escribir {{client.name}} en un campo de mensaje se reemplazara con el nombre real del cliente cuando el workflow se ejecute. Consulta Entradas del workflow para mas informacion sobre placeholders de variables.

Depurar pasos​

La seccion Pasos proporciona herramientas de depuracion integradas para ayudarte a probar tu workflow antes de activarlo:

  • Debug all -- Haz clic en este boton para ejecutar todos los pasos en modo de depuracion. Esto te permite ver exactamente lo que cada paso hara con datos de muestra, sin ejecutar el workflow en produccion. Es la manera mas rapida de verificar que todo tu workflow se comporta como se espera.
  • Tambien puedes depurar pasos individuales uno a la vez para aislar problemas en una parte especifica del workflow.

La depuracion es especialmente util cuando tu workflow incluye multiples pasos que dependen unos de otros, ya que puedes inspeccionar la salida de cada paso y confirmar que los datos fluyen correctamente.

Al inspeccionar la salida de un paso, AutoTalk tambien puede mostrar un objeto anidado executionContext con metadatos del ejecutor como status, timestamps y valores sanitizados safeError o safeResult. Usa step(N).executionContext cuando quieras ramificar basandote en como se ejecuto un paso anterior, en lugar de depender de campos especificos de la accion como step(N).status.

Limpiar todos los pasos​

Si quieres empezar de cero, haz clic en el boton Clear all items (Limpiar todos los elementos). Esto elimina todos los pasos del workflow a la vez. Usalo con precaucion, ya que no se puede deshacer.

Orden de ejecucion de los pasos​

Los pasos se ejecutan de arriba hacia abajo en el orden exacto en que aparecen en la seccion Pasos. Puntos importantes a tener en cuenta:

  • Ejecucion secuencial: Cada paso debe completarse antes de que comience el siguiente.
  • Flujo de datos: La salida de un paso puede ser referenciada por pasos posteriores. Los campos especificos de la accion se mantienen en step(N), mientras que los metadatos compartidos del ejecutor se encuentran en step(N).executionContext.
  • Manejo de fallos: Si un paso falla durante la ejecucion, el workflow generalmente se detiene en ese punto. El registro de ejecucion aun registra metadatos sanitizados del paso, incluyendo executionContext.safeError, para que puedas ver que paso fallo y por que sin exponer datos internos crudos en la interfaz.
tip

Construye tu workflow incrementalmente. Agrega un paso a la vez, usa Debug all para probar despues de cada adicion, y confirma que todo funciona antes de agregar el siguiente paso. Este enfoque hace mucho mas facil identificar y corregir problemas.

Proximos pasos​