Trigger Flow: conceitos

O Trigger Flow é o editor visual de automações da Zatten. Cada fluxo tem um gatilho (o evento que o inicia), condições opcionais (que escolhem um caminho Sim ou Não) e ações (o que acontece com o lead: mover no funil, pôr tag, enviar mensagem, chamar uma API). Use quando os tipos nativos de automação não bastam: reagir a uma tag, avisar o responsável, integrar com o sistema do cliente final.

​

Onde fica no painel

Automações → aba Trigger Flow (/automations?tab=trigger-flow). A lista mostra cada fluxo com o gatilho, a chave de ligar e desligar e as opções de duplicar e excluir. O editor abre em /automations/flows/<id> (/automations/flows/new cria um fluxo novo). Só admin e editor veem e editam fluxos. O gestor vê apenas a aba de mensagens rápidas. Ver Usuários, papéis e permissões.

​

Como configurar

​

As três peças

Todo fluxo roda para um lead. Até o gatilho de webhook precisa dizer qual é o lead. O catálogo completo, com os campos de cada bloco, está em Trigger Flow: catálogo de blocos.

​

O editor

1. Escolha o gatilho. O painel lateral mostra os campos dele.
2. Clique no + para adicionar blocos e ligue a saída de um à entrada do próximo.
3. Clique num bloco para configurar. Campos com {{…}} aceitam variáveis.
4. Salvar valida o fluxo inteiro. Blocos com problema ficam com borda âmbar e o salvamento é bloqueado até corrigir.
5. Depois do primeiro salvamento aparece o botão Execuções, com o histórico (ver Execuções e depuração).

O que o editor recusa ao salvar:

• fluxo sem gatilho, ou com mais de um;
• ciclo (um bloco que volta para um anterior);
• mais de uma ligação saindo da mesma saída. Cada saída leva a um bloco só; para dividir o caminho, use uma condição;
• bloco solto, sem nada ligado acima dele;
• campo obrigatório vazio, ou valor fora do limite;
• tag, coluna, propriedade, departamento, usuário ou template que não existem mais no projeto (o card mostra “(item removido)”).

Um gatilho marcado como em breve no editor ainda não pode ser usado num fluxo ligado. Hoje estão em breve: Novo lead criado, Mensagem recebida, Propriedade alterada e Lead inativo.

​

Variáveis

Campos de texto marcados com {{…}} aceitam variáveis, resolvidas na hora em que o bloco roda. Há três famílias: O seletor de variáveis de cada campo lista só o que existe naquele ponto do fluxo: trigger.* do gatilho escolhido e node.* dos blocos HTTP que vêm antes.

​

Ligar e desligar

O fluxo nasce desligado. Ligue pela chave na lista de fluxos. Só fluxos ligados rodam. Não dá para ligar um fluxo sem gatilho, nem um cujo gatilho ainda aparece como “em breve”.

​

Como funciona por trás

1. O evento acontece (ou alguém chama a API dizendo que aconteceu).
2. A Zatten procura os fluxos ligados do projeto com aquele gatilho.
3. Para cada fluxo, confere os filtros do gatilho. Se não batem, a execução é registrada como Ignorado e nenhum passo roda.
4. Se batem, cria uma execução e roda os blocos um por vez, em fila, seguindo as ligações. Uma condição escolhe Sim ou Não.
5. Se um passo falha, a execução para ali com status Falhou. Os blocos seguintes não rodam: eles pressupõem que o anterior deu certo. Não há nova tentativa automática.

Cada fluxo que bate gera uma execução separada. Dois fluxos com o mesmo gatilho rodam os dois, sem ordem garantida entre eles. Os dados lead.* são uma foto tirada no início da execução. Uma ação que mude o lead no meio do fluxo (mover de coluna, pôr tag) não atualiza {{lead.column}} ou {{lead.tags}} nos blocos seguintes. A exceção é a janela de 24h: a condição Janela de 24h é reavaliada no momento em que roda. Limites, timeouts e o histórico estão em Trigger Flow: execuções e depuração.

​

Pelo MCP

Os fluxos viajam no bloco flows do template do projeto. O que o MCP faz:

• Cria fluxo novo, desligado se status não vier. Referências a coluna, tag e departamento vão por nome; propriedade vai por slug e template da Meta por nome. Se alguma não existir no projeto, o fluxo não é criado, com nota.
• Não reescreve o grafo de um fluxo que já existe (mesmo nome). Só muda o status (ligar e desligar). Para redesenhar, use o editor.
• O usuário responsável (em “Definir responsável” e nos filtros) não viaja: é uma pessoa, não configuração.
• Fluxo sem gatilho não é criado. Dois fluxos com o mesmo caminho de webhook de entrada também não.

Detalhes do bloco em Referência do template.

​

Armadilhas

• Gatilho em breve. Novo lead criado, Mensagem recebida, Propriedade alterada e Lead inativo estão indisponíveis hoje, nem pela API. Um fluxo com esses gatilhos não pode ser ligado. Ver o catálogo.
• Ações do fluxo disparam outros fluxos. Mover o lead, pôr ou tirar tag, “Definir responsável” e “Encerrar atendimento” dentro de um fluxo disparam os fluxos de Kanban, tag, responsável alterado e conversa encerrada. Monte os fluxos sem laço: um fluxo nunca deve recriar o evento que o disparou.
• {{lead.column}} e {{lead.tags}} trazem ids, não nomes. Para o nome da coluna de destino, use {{trigger.column.name}} no gatilho de Kanban.
• Foto do início: depois de “Mover no Kanban”, {{lead.column}} ainda mostra a coluna antiga.
• Ações em massa no CRM não disparam fluxos.
• Texto livre fora da janela de 24h falha na conexão oficial e derruba a execução. Antes de “Enviar texto” ou mídia, use a condição Janela de 24h e, no Não, envie um template.

​

Perguntas frequentes

​

Para saber mais

• Trigger Flow: catálogo de blocos
• Trigger Flow: disparar pela API e receber webhooks
• Trigger Flow: execuções e depuração
• Quando as automações disparam
• Janela de 24h
• Termos para buscar: “Trigger Flow”, “fluxo”, “gatilho”, “condição”, “variáveis do fluxo”.