Trigger Flow: catálogo de blocos

O Trigger Flow tem 11 gatilhos (7 disponíveis hoje e 4 em breve), 1 bloco de condição e 16 ações. Esta página lista cada um, com os campos e o que faz de verdade. Os conceitos (editor, variáveis, ligar e desligar) estão em Trigger Flow: conceitos.

​

De onde vem cada gatilho?

Comece por aqui. Um gatilho só roda se algo o disparar. Quatro gatilhos estão indisponíveis hoje (em breve): aparecem no editor, mas não dá para usá-los num fluxo, nem pela API.

​

Gatilhos

Filtro vazio vale para qualquer valor. Quando há mais de um filtro, todos precisam bater. Os gatilhos marcados como em breve estão descritos como foram desenhados, mas não podem ser usados hoje.

​

Condição

Um bloco Condição testa uma ou mais regras e segue pela saída Sim ou Não. Escolha se valem todas as regras ou qualquer regra. Cada regra é campo + operador + valor. Os dois operadores de termos (só no Texto da mensagem):

• contém algum dos termos e contém todos os termos recebem termos separados por vírgula ou quebra de linha. Máximo de 20 termos, cada um com até 100 caracteres.
• Ignoram maiúsculas e acentos e casam por trecho: “oi” casa com “boi”.
• Lista vazia ou mensagem sem texto dá Não.
• Para negar, use a saída Não. Não existe “não contém nenhum”.

Os demais operadores comparam texto assim: é e não é exigem o valor exato; contém e começa com ignoram maiúsculas, mas não acentos.

​

Ações

​

Lead

​

Kanban

​

Mensagens

Nas mídias, a Zatten baixa o arquivo da URL na hora do envio: 30 segundos de limite e no máximo 3 redirecionamentos. A URL precisa ser pública. O arquivo enviado pelo editor fica guardado pela Zatten e vira uma URL. As mensagens enviadas por um fluxo aparecem no chat como enviadas pela API.

​

Integrações

Cuidados da Requisição HTTP:

• Aspas mudam o tipo. No corpo, "{{…}}" vira texto e {{…}} sem aspas vira número ou objeto. É a causa mais comum de erro 400 no sistema do cliente.
• Resposta que não é JSON não tem caminho: .body.campo fica vazio.
• Resposta acima de 32 KB é cortada antes de ser guardada; respostas acima de 10 MB falham.
• Os headers que parecem segredo (com token, auth, key, secret, password) aparecem mascarados no histórico.

​

Pelo MCP

Os blocos viajam dentro de flows[].nodes com os mesmos type e campos desta página. Na exportação, ids de coluna, tag e departamento viram nomes; na criação, nomes viram ids. Propriedade vai por slug e template por nome. O usuário (user_email) não viaja. Regras completas em Trigger Flow: conceitos.

​

Armadilhas

• “Definir responsável” sem usuário usa o rodízio, não deixa o lead “só no departamento”.
• “Notificar responsável” depois de “Conversa encerrada” não tem destinatário: encerrar remove o responsável. O editor avisa.
• Tag ou propriedade de vínculo “conversa” aplicada depois de “Conversa encerrada” fica no lead e aparece na próxima conversa. Use vínculo de contato.
• Mensagem enviada por um fluxo de “Conversa encerrada” não reabre a conversa: fica gravada na conversa encerrada. Se o lead já respondeu e abriu outra, vai para a nova.
• Gatilho “em breve” não roda. Novo lead criado, Mensagem recebida, Propriedade alterada e Lead inativo não podem ser usados hoje, nem pela API. Monte o fluxo com um dos 7 gatilhos disponíveis.
• “Notificar responsável” com {{trigger.message.text}} envia um push por mensagem do lead, sem limite. Filtre com uma condição antes.
• {{trigger.message.text}} é texto do lead. Na URL de uma Requisição HTTP ele é codificado; no corpo e nos headers entra como veio.

​

Perguntas frequentes

​

Para saber mais

• Trigger Flow: conceitos
• Trigger Flow: disparar pela API e receber webhooks
• Trigger Flow: execuções e depuração
• Departamentos e distribuição
• Janela de 24h
• Termos para buscar: “gatilho”, “condição”, “contém algum dos termos”, “Requisição HTTP”, “rodízio”.