Fluxos sem código com gatilhos e tratamento de falhas

Um fluxo sem código torna um processo explícito: ele define o que inicia uma execução, quais etapas acontecem em seguida e onde a entrega para. Cada execução percorre etapas nomeadas; não depende de alguém lembrar a sequência de cabeça.

No exemplo da Casa Horizonte, o fluxo recebe uma solicitação fictícia, consulta referências e prepara um rascunho. O limite é intencional: ele não envia mensagens, não confirma inscrições e não realiza ações externas.

O gatilho inicia uma execução; as demais etapas são ações do percurso. Um gatilho manual acontece quando uma pessoa decide iniciar o fluxo. Um gatilho por evento acontece quando algo definido ocorre, como a chegada de uma nova solicitação fictícia.

Os dois podem levar ao mesmo percurso. Neste tutorial, você pode usar o gatilho manual para executar ou simular o exemplo com segurança no seu computador.

Cada etapa recebe e devolve dados

Em um fluxo sem código, uma ação não deve depender de “lembrar” o que aconteceu antes. Ela recebe campos de entrada definidos e produz campos de saída que outra etapa poderá usar.

No fluxo da Casa Horizonte, a execução começa com dois dados mínimos:

• Tema
• Solicitação

No caso normal, o gatilho manual informa Tema: Origami e a solicitação da pessoa. A etapa Consulta usa esses dados para localizar evidências. Depois, Rascunho usa a solicitação original junto das evidências encontradas.

Pense nos campos como uma passagem explícita de informações entre etapas, e não como uma conversa compartilhada automaticamente.

Escrever não é transferir

Um valor fixo é digitado diretamente em uma etapa. Ele continua igual em todas as execuções. Uma transferência, por outro lado, usa o valor que veio de uma etapa anterior naquela execução.

Para o campo pedido pela pessoa, faça a transferência:

Início.Solicitação → Rascunho.Solicitação

Para as evidências obtidas, faça transferências distintas:

Consulta.Trechos → Rascunho.Trechos

Consulta.Referências → Rascunho.Referências

Copiar hoje o texto da solicitação como valor fixo pode parecer funcionar neste exemplo, mas falhará quando o próximo gatilho trouxer outra pergunta. O mapeamento explícito conserva a solicitação e as referências corretas de cada execução.

Uma condição é uma regra verificável que escolhe o próximo encaminhamento. Aqui, a condição da etapa Validação da entrada pergunta: Tema e Solicitação estão preenchidos?

• Sim: o fluxo continua para Consulta.
• Não: o fluxo muda para Pendente de dados.

A condição confere presença dos campos; ela não inventa, completa nem interpreta informações ausentes. Por isso, ela ocorre antes de consultar as referências ou produzir um rascunho.

Escolha um documento ou uma planilha no seu computador e crie áreas visíveis para as etapas: Início, Validação da entrada, Consulta, Rascunho e Validação da saída. Isso já permite montar um fluxo sem código sem conectar nenhuma conta.

A execução manual equivalente funciona porque cada área registra o que entra e o que sai. Você inicia pelo gatilho manual, confere a entrada e só então transfere dados entre as áreas. Se já tiver uma ferramenta sem código disponível, poderá representar as mesmas áreas como início manual, condição e ações — mantendo exatamente os mesmos campos e regras.

Em uma seção de apoio do mesmo documento ou planilha, cole os textos abaixo. Eles substituem uma base externa e permitem executar ou simular a Consulta sem integrações pagas, contas profissionais ou mensagens reais.

Para o caso normal, use o gatilho manual com Tema: Origami e Solicitação: Qual é o horário da oficina de origami e como faço a inscrição?. Após a conferência da entrada, envie Tema e Solicitação para a Consulta sobre os 2 textos e registre o resultado antes de criar o rascunho.

A transferência é explícita: não suponha que a área Rascunho conhece o que foi encontrado na Consulta. Copie ou vincule os campos identificados e preserve os títulos, as seções e a versão das referências.

A etapa Validação da saída é uma condição do fluxo: ela decide o encaminhamento do resultado produzido em Rascunho. Não é uma leitura opcional no fim.

Só avance se o rascunho estiver preenchido, responder ao horário e à inscrição, trouxer as Referências e fizer apenas afirmações sustentadas pelos Trechos consultados. Se qualquer critério falhar, encaminhe para Revisão manual. Se todos forem atendidos, o Status passa a Aguardando aprovação.

A aprovação humana ainda é necessária; o fluxo não envia mensagens nem confirma inscrições.

Use critérios verificáveis, não a impressão de que o texto “parece bom”. Cada item abaixo deve ser conferido antes de liberar o rascunho.

O texto respondeu às duas perguntas e trouxe referências, portanto foi produzido com sucesso técnico. Mesmo assim, ele declara uma confirmação de vaga que os Trechos negam: a referência diz que não há confirmação de vaga por mensagem.

Como há uma afirmação sem sustentação, a condição falha. O encaminhamento correto é Revisão manual, não Aguardando aprovação.

Uma falha não tem uma única resposta. Antes de decidir o próximo passo, classifique o que ocorreu:

• Dado ausente: falta uma informação obrigatória na entrada, como Tema ou Solicitação.
• Saída inválida: uma etapa gerou algo, mas o resultado não atende à condição para avançar.
• Etapa indisponível: a ação não pôde ser executada; registre Etapa indisponível.

Os dois primeiros casos já têm rotas definidas: dados ausentes ficam em Pendente de dados; saída inválida vai para Revisão manual. Nova tentativa é reservada à indisponibilidade que pareça temporária. Ela não corrige dados faltantes nem torna um rascunho inadequado automaticamente válido.

Use o tipo de falha como critério de encaminhamento. O fluxo não deve avançar por suposição nem registrar como concluída uma etapa que não ocorreu.

Faça 2 testes separados e registre primeiro o Resultado esperado; só então execute ou faça a simulação. Após cada etapa, anote o Resultado observado antes de avançar. Assim, uma expectativa não vira evidência.

No teste normal, use a entrada completa da Casa Horizonte e siga até Aguardando aprovação. No teste de falha, mantenha a mesma entrada, mas simule Etapa indisponível na Consulta. Não provoque falhas em contas, serviços ou mensagens reais.

No teste normal, acione o gatilho manual ou faça a execução manual equivalente. Confira a entrada completa, consulte os 2 textos e transfira os dados sem substituir referências por memória ou suposição:

Início.Solicitação → Rascunho.Solicitação
Consulta.Trechos → Rascunho.Trechos
Consulta.Referências → Rascunho.Referências

O resultado-modelo a seguir permite comparar seu registro ou realizar uma simulação quando uma ferramenta não estiver disponível.

Faça agora um teste separado, com a mesma solicitação completa. Ao chegar à Consulta, registre Etapa indisponível como resultado esperado e observado da simulação. Não tente derrubar nem desconectar um serviço real.

Após a Tentativa 1, repita somente a Consulta. Após a Tentativa 2, o limite foi atingido: encaminhe para Revisão manual. Como não houve Trechos e Referências válidos nessa execução, não prossiga para as etapas seguintes.