Automatize ações com fluxos de trabalho

O que ele faz

Os Fluxos de automação permitem dizer “quando isto acontecer, faça aquilo” — sem código. Escolha um evento que dispare o fluxo (um solicitante envia um formulário, uma verificação é aprovada, a pontuação de confiança ultrapassa um limite…) e depois adicione as ações a executar: enviar um e-mail ao solicitante, atribuir a verificação a um departamento e mais.

Esta é a segunda de duas ferramentas, e é importante não confundi-las:

Um fluxo de trabalho nunca altera o veredito — esse é o papel da política. Os fluxos orquestram em torno dele. Você pode ter vários fluxos ativos ao mesmo tempo.

Antes de começar

• Seu plano precisa incluir os Fluxos de automação (Pro ou superior). Se o item Fluxos de automação no menu Desenvolvedor mostrar um selo “Requer Pro”, peça ao proprietário que faça o upgrade — veja Faturamento e créditos.
• Decida o que deve acionar o fluxo e o que ele deve fazer.
• Para "atribuir a um departamento", primeiro cadastre as contas dos membros da equipe na sua organização — veja Convide membros.

Conceitos principais

• Gatilho — o único evento que inicia um fluxo de trabalho. Cada fluxo tem exatamente um.
• Filtro — uma condição opcional sobre o gatilho (mesma sintaxe das condições de política, por exemplo applicant.country IN ["CA","US"]). O fluxo só é executado quando o filtro é verdadeiro. Ele lê os dados do evento mais os fatos da solicitação — os mesmos campos que um nó de Condição enxerga, por exemplo liveVerification.applicantAttended = false em um gatilho de chamada encerrada.
• Ações — as etapas ordenadas a executar quando o fluxo é disparado.
• Nós — além das ações, a tela tem os nós Condição (ramifica em verdadeiro / falso), Espera (pausa), Paralelo (divide em várias ramificações), Laço (repete um corpo limitado) e Fim (terminal) — veja Tipos de nós abaixo.
• Execução — uma execução de um fluxo de trabalho para um evento. Cada etapa é registrada para que você veja exatamente o que aconteceu.

Como ele é executado

flowchart LR
    A[An event fires<br/>e.g. form submitted] --> B{Matching active<br/>workflows?}
    B -->|trigger + filter match| C[Create a run]
    C --> D[Walk the actions:<br/>email · assign ·<br/>conditions · waits]
    D --> E[Run recorded<br/>with a full trace]
    B -->|no match| F[Nothing happens]

Os fluxos são executados automaticamente — não existe botão "executar". Publicar um fluxo o torna ativo; a partir daí, ele é disparado sempre que o evento correspondente ocorre.

Passo a passo

Vinculando um fluxo de trabalho a um formulário específico

Para um fluxo form.submitted, vincule-o a um ou mais formulários para que apenas eles o acionem (caso contrário, todo envio de formulário o dispara). É assim que os formulários de Nova conta e Financiamento imobiliário do banco executam fluxos diferentes. O vínculo fica no gatilho do fluxo.

Tipos de nós na tela

Um fluxo de trabalho é um pequeno grafo. Arraste nós para a tela e conecte seus pontos de ligação para montar o caminho que uma execução percorre. Além do Gatilho único (adicionado automaticamente) e dos nós de Ação, você tem:

Condições

Um nó Condição ramifica em verdadeiro / falso com base em uma expressão DSL — a mesma gramática de uma condição de política e do filtro do gatilho, de modo que há um único mecanismo de expressões, e não dois. Ele lê fatos tipados sobre o evento: a pontuação de confiança (overallScore >= 75), o decision do avaliador, os campos do solicitante (applicant.country IN ["CA","US"]) e sinais de cada verificação, como checks.liveness.confidence ou sanctions.isMatch. Essas predefinições tipadas são os mesmos campos que o designer de políticas expõe, portanto uma expressão que funciona lá funciona aqui. Uma expressão que não pode ser interpretada falha de forma segura para a ramificação falso — nunca corresponde em silêncio.

Os fatos são carregados novamente da solicitação a cada vez que uma condição é executada, portanto um fluxo que esperou dois dias vê o estado de hoje, e não o estado de quando começou. Além das pontuações, você pode testar:

CONTAINS verifica se uma lista contém um valor (ou se um texto contém uma palavra, ignorando maiúsculas e minúsculas); NOT CONTAINS é o oposto. Um campo que a solicitação não tem nunca corresponde a !=, NOT IN ou NOT CONTAINS — portanto document.issuingCountry != "US" continua falso quando nenhum documento foi lido, em vez de passar em silêncio.

Esperas

Um nó Espera estaciona a execução e a retoma mais tarde. Quatro modos:

• Por uma duração fixa — retoma após N minutos.
• Até a chegada de um evento — estaciona até que um evento (por exemplo, documento enviado, status alterado, verificação de identidade ao vivo iniciada / encerrada / concluída, gravação pronta) seja disparado para a mesma solicitação. Defina um tempo limite (horas ou dias; padrão de 7 dias): quando ele se esgota, a execução segue pela ramificação de tempo limite do nó ou continua pelo caminho normal se essa ramificação não estiver conectada.
• Até que uma condição seja atendida — reavalia um predicado DSL em intervalos fixos, retomando assim que ele for verdadeiro (com um limite de segurança para que um predicado que nunca é verdadeiro não estacione uma execução para sempre).
• Durante o horário comercial — retoma no próximo horário dentro da janela (padrão de seg–sex 09:00–17:00 UTC; os dias, as horas e o fuso horário são configuráveis, e as mudanças de horário de verão são tratadas).

Paralelo

Um nó Paralelo se divide em várias ramificações que executam suas etapas e depois continua em uma junção opcional quando todas as ramificações terminam. As ramificações não estacionam — uma Espera dentro de uma ramificação é apenas atravessada — portanto um bloco paralelo sempre termina.

Laço

Um nó Laço repete um corpo enquanto um predicado DSL for verdadeiro, até um limite obrigatório de iterações — o laço sempre termina, mesmo que o predicado continue verdadeiro (o limite atingido é anotado no rastreamento da execução). Um laço sem expressão "enquanto" executa seu corpo zero vezes, de modo que um laço mal configurado nunca fica girando.

Resultados de Fim

Um nó Fim é um terminal — a execução termina ali. Você pode marcar um Fim com um resultado apenas de apresentação (aprovado, rejeitado, encaminhado, concluído ou erro) que é registrado na entrada de rastreamento final da execução para indicar como aquele caminho terminou. Esta marca é puramente descritiva: ela rotula a execução, ela NÃO altera o veredito da verificação. O veredito continua com a política de decisão; um Fim marcado como aprovado não aprova nada.

Opções e campos

Versões, restauração e testes A/B

O botão Versões e teste A/B fica desabilitado até que o fluxo tenha sido salvo uma vez.

Um fluxo de trabalho é uma cadeia de versões sob um mesmo nome. Salvar sempre edita um rascunho; Publicar o congela como uma versão imutável e arquiva a versão ativa anterior de mesmo nome. Cada execução registra a versão em que rodou (exibida na lista de execuções e no rastreamento).

Clique em Versões e teste A/B no cabeçalho do editor para:

• Ver todas as versões — rascunho, ativa, arquivada — e abrir qualquer uma delas.
• Restaurar como novo rascunho — copia uma versão (por exemplo, uma mais antiga que você quer de volta, ou a ativa que você quer alterar) para um novo rascunho com o mesmo nome. As versões publicadas nunca são editadas no local.
• Executar um teste A/B — compare a versão ativa (A) com um desafiante (B, um rascunho ou uma versão mais antiga do mesmo fluxo). Escolha que parcela (0–100%) das novas verificações que o gatilho do fluxo inicia vai para B em vez de A. O gatilho, o escopo e o filtro da versão ativa continuam decidindo se o fluxo é executado; a divisão decide apenas qual versão é executada. Uma verificação sempre recebe a mesma variante, e uma execução termina na versão em que começou.

Enquanto um teste está em andamento, o rascunho desafiante fica congelado. A tabela de resultados mostra, por variante, as verificações direcionadas, quantas foram aprovadas, rejeitadas e encaminhadas, quantas chegaram a uma decisão e quantas execuções do fluxo foram concluídas ou falharam. Como os fluxos nunca definem o veredito, use isso para comparar resultados operacionais (por exemplo, um e-mail de lembrete enviado mais cedo). Publicar o desafiante encerra o teste; Interromper teste devolve todas as novas verificações à versão ativa. Execuções sem verificação (agendamentos, webhooks de entrada) sempre usam a versão ativa.

Solução de problemas

Meu fluxo de trabalho não foi executado

Verifique, nesta ordem: se ele está publicado (ativo, não rascunho); se o evento de gatilho realmente ocorreu; no caso de um fluxo form.submitted, se o formulário que disparou corresponde ao vínculo de formulário do gatilho; e se algum filtro foi avaliado como verdadeiro. Abra as execuções do fluxo para confirmar se uma execução chegou a ser criada.

O e-mail não chegou

Confirme se o destinatário foi resolvido — para "o solicitante", o formulário precisa ter coletado um e-mail; para "o proprietário da organização", sua organização precisa ter um proprietário com e-mail cadastrado. Verifique sua pasta de spam e a configuração de envio de e-mails.

"Atribuir a um departamento" não atribuiu ninguém

A ação precisa de pelo menos um membro selecionado, e a verificação precisa ter sido criada (o fluxo deve ser acionado por um evento de verificação). Os membros escolhidos precisam pertencer à sua organização.

Publiquei uma nova versão — o que acontece com as execuções já em andamento?

Elas terminam na versão com que começaram (por exemplo, uma execução estacionada em uma espera de dois dias ainda envia o lembrete). Os novos eventos executam a nova versão. Arquivar um fluxo é a única forma de interromper as execuções em andamento dele.

"Agendar uma verificação de identidade ao vivo" foi ignorada

Abra o rastreamento da execução: a etapa informa o motivo. Os motivos habituais são que a solicitação já tem uma chamada agendada ou em andamento (uma segunda nunca é marcada), que o anfitrião escolhido saiu da sua organização ou que seu plano não inclui a verificação ao vivo.

Um fluxo de trabalho foi executado mais vezes do que eu esperava

Um fluxo é executado no máximo 10 vezes por solicitação em 24 horas (acima disso o evento é ignorado e registrado como possível laço), e fluxos que chamam uns aos outros por meio de Acionar outro fluxo de trabalho param após 5 níveis. Se um evento dispara repetidamente (por exemplo, status alterado), adicione um Filtro como status = "ESCALATED" para que o fluxo reaja apenas à mudança que interessa.

Não vejo "Fluxos de automação" no menu

Ele fica em Desenvolvedor e é um recurso Pro. Se mostrar um selo “Requer Pro”, peça ao proprietário que faça o upgrade em Faturamento e créditos.

Relacionados

• Crie uma política de risco — a outra ferramenta: decide o veredito.
• Formulários — vincule um fluxo form.submitted a um formulário.
• Webhooks — para enviar eventos de verificação aos seus próprios sistemas.
• Convide membros — adicione as pessoas às quais um fluxo pode atribuir trabalho.