Pular para o conteúdo principal

Etapas do Workflow

O que voce vai aprender
  • O que sao etapas e como elas formam o corpo de um workflow
  • Como adicionar, configurar e gerenciar etapas usando a secao Etapas
  • Como depurar etapas individualmente ou todas de uma vez
  • Como funciona a ordem de execucao das etapas

Etapas sao as acoes que seu workflow executa apos o trigger disparar. Cada etapa representa uma unica operacao -- como enviar uma mensagem, atualizar um registro ou chamar um servico externo. As etapas executam em sequencia de cima para baixo, o que significa que cada etapa e concluida antes que a proxima comece.

Para um guia detalhado campo a campo de cada tipo de etapa disponivel, veja a Referencia de Acoes.

Adicionando etapas​

Para adicionar uma etapa ao seu workflow:

  1. Abra o formulario de criacao ou edicao do workflow.
  2. Role ate a secao Etapas.
  3. Clique no botao Add step (Adicionar etapa).
  4. Uma nova etapa sera adicionada a lista. Configure-a selecionando o tipo de etapa e preenchendo seus parametros.
  5. Repita para adicionar quantas etapas seu workflow necessitar.

Cada etapa adicionada aparece na lista na ordem em que sera executada. Voce pode adicionar multiplas etapas para construir automacoes complexas que executam varias acoes em sequencia.

Configurando uma etapa​

Quando voce adiciona uma etapa, precisara configura-la com base na acao que deseja executar. Cada tipo de etapa tem seu proprio conjunto de campos e opcoes. Por exemplo:

  • Uma etapa de "enviar mensagem" pode exigir que voce especifique o texto da mensagem e o destinatario
  • Uma etapa de "atualizar registro" pode exigir que voce selecione qual campo alterar e qual valor definir
  • Uma etapa de "chamar webhook" pode exigir que voce forneca uma URL externa e o payload de dados

Voce pode usar a sintaxe de placeholder {{variable}} dentro dos campos de etapas para inserir dados dinamicos do trigger ou de etapas anteriores. Por exemplo, digitar {{client.name}} em um campo de mensagem sera substituido pelo nome real do cliente quando o workflow executar. Veja Entradas do workflow para mais sobre placeholders de variaveis.

Depurando etapas​

A secao Etapas fornece ferramentas de depuracao integradas para ajudar a testar seu workflow antes de ativa-lo:

  • Debug all -- Clique neste botao para executar todas as etapas em modo de depuracao. Isso permite ver exatamente o que cada etapa fara com dados de amostra, sem executar o workflow em producao. E a maneira mais rapida de verificar que todo o seu workflow se comporta como esperado.
  • Voce tambem pode depurar etapas individuais uma de cada vez para isolar problemas em uma parte especifica do workflow.

A depuracao e especialmente util quando seu workflow inclui multiplas etapas que dependem umas das outras, pois voce pode inspecionar a saida de cada etapa e confirmar que os dados estao fluindo corretamente.

Ao inspecionar a saida de uma etapa, o AutoTalk tambem pode mostrar um objeto aninhado executionContext com metadados do executor como status, timestamps e valores sanitizados safeError ou safeResult. Use step(N).executionContext quando voce quiser fazer ramificacao com base em como uma etapa anterior executou, em vez de depender de campos especificos da acao como step(N).status.

Limpando todas as etapas​

Se voce quiser comecar do zero, clique no botao Clear all items (Limpar todos os itens). Isso remove todas as etapas do workflow de uma vez. Use com cuidado, pois nao pode ser desfeito.

Ordem de execucao das etapas​

As etapas executam de cima para baixo na ordem exata em que aparecem na secao Etapas. Pontos importantes a ter em mente:

  • Execucao sequencial: Cada etapa deve ser concluida antes que a proxima comece.
  • Fluxo de dados: A saida de uma etapa pode ser referenciada por etapas subsequentes. Campos especificos da acao ficam em step(N), enquanto metadados compartilhados do executor ficam em step(N).executionContext.
  • Tratamento de falhas: Se uma etapa falhar durante a execucao, o workflow geralmente para naquele ponto. O log de execucao ainda registra metadados sanitizados da etapa, incluindo executionContext.safeError, para que voce possa ver qual etapa falhou e por que sem expor dados internos brutos na interface.
dica

Construa seu workflow incrementalmente. Adicione uma etapa de cada vez, use Debug all para testar apos cada adicao, e confirme que tudo funciona antes de adicionar a proxima etapa. Essa abordagem torna muito mais facil identificar e corrigir problemas.

Proximos passos​