Skip to main content
O Trigger Flow tem 13 gatilhos (10 disponíveis hoje e 3 em breve), 1 bloco de condição e 18 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. Três gatilhos estão indisponíveis hoje (em breve): aparecem no editor, mas não dá para usá-los num fluxo, nem pela API.
Mover o lead ou pôr/tirar tag pela API pública (/api/v1/leads/{numero}/kanban e /tag) e dentro de um fluxo também dispara os fluxos de Kanban e de tag. Um fluxo que move o lead ou aplica uma tag pode, então, iniciar outro fluxo. Evite laços: não monte um fluxo de “Tag adicionada” que aplica a mesma tag, nem dois fluxos de Kanban que movem o lead um para a coluna do outro. Mudar propriedade e ligar/desligar a IA pela API não disparam fluxos. Ver Disparar pela API.

Novo lead criado: quando dispara

Roda uma vez por lead, na hora em que o lead é criado. Os fluxos ligados com esse gatilho rodam quando o lead nasce por um destes caminhos: O lead chega ao fluxo já com coluna e responsável definidos. No caso do WhatsApp, o fluxo de Primeira mensagem do lead também roda para a mesma mensagem: os dois são independentes, e não há garantia de qual termina primeiro. O lead criado pelo PUT não tem conversa: o Primeira mensagem do lead só roda quando o cliente escrever.

Inatividade: o que conta

Os dois gatilhos de inatividade contam o tempo a partir de uma mensagem e disparam se nada acontecer do outro lado até o fim do prazo.
  • Mensagens de fluxos e templates não contam. Uma mensagem enviada por qualquer fluxo, ou um template (por qualquer caminho), não inicia nem zera a contagem. Assim um fluxo de “Inatividade do lead” que manda um lembrete não reinicia a si mesmo.
  • Reação não conta. Figurinha e localização contam. Envio que falhou não conta.
  • Mensagens seguidas do mesmo lado não reiniciam o prazo: conta a primeira.
  • Encerrar o atendimento zera os dois e cancela as execuções em andamento. A exceção é a própria execução que encerrou: ela segue até o fim.
  • Quando zera, a execução em andamento é cancelada, inclusive a que está parada num bloco Aguardar. Ela fica como Cancelado no histórico, com o motivo (ex.: “Cancelada: o lead respondeu”).
  • Depois que o fluxo roda, o ciclo só recomeça no próximo início (nova mensagem do lead, ou nova mensagem enviada a ele).
  • Prazo: inteiro de 1 minuto a 30 dias.

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, inclusive templates, aparecem no chat como enviadas pelo agente (ícone do robô). Agendar template, em detalhe:
  • Mínimo de 1 em minutos e horas e de 0 em dias (hoje). Máximo de 365 dias (ou o equivalente em horas e minutos).
  • As variáveis do template são preenchidas na hora de agendar, com os dados que o lead tem naquele momento.
  • Cada vez que o bloco roda, agenda um envio novo: não há checagem de “já agendado”.
  • O envio agendado não depende mais do fluxo: desligar o fluxo ou a execução ser cancelada não desfaz o agendamento. Para desfazer, cancele nas mensagens agendadas do lead.
  • Template não inicia nem zera os gatilhos de inatividade.

Lógica

  • Aguardar no fim do fluxo não espera: sem bloco depois, a execução termina na hora. O editor avisa.
  • Depois de esperar, os blocos seguintes usam os dados atuais do lead.
  • Em fluxos de inatividade, a resposta do outro lado durante a espera cancela a execução. Nos outros gatilhos, nenhuma mensagem cancela uma execução parada num Aguardar; um novo disparo do mesmo fluxo para o mesmo lead a substitui (ver Execuções e depuração).

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 e troca o responsável, mesmo que o lead já esteja nesse departamento. Não deixa o lead “só no departamento”.
  • Ação que dispara o próprio fluxo deve ser a última do ramo. Ex.: “Responsável alterado” → … → “Definir responsável”. O novo disparo substitui a execução em andamento, e os blocos depois dessa ação não rodam.
  • Aguardar como último bloco não espera nada: a execução termina na hora.
  • “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. Mensagem recebida, Propriedade alterada e Lead inativo por… não podem ser usados hoje, nem pela API. Monte o fluxo com um dos 10 gatilhos disponíveis. Para lead parado, use Inatividade do lead ou Inatividade de atendimento.
  • Novo lead criado e Primeira mensagem no mesmo fluxo de boas-vindas. Um contato novo que manda mensagem dispara os dois, sem ordem garantida entre as execuções. Escolha um só para não mandar duas mensagens.
  • Lead importado nunca recebe “Novo lead criado”. Nem depois, quando ele mandar mensagem: ele já existe. Ações em massa no CRM também não disparam fluxos; para reagir a leads importados, use Primeira mensagem do lead.
  • “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

Confira como o lead nasceu. Importação de CSV, mensagem enviada pelo celular para um número novo e o lead de teste não disparam. Um lead que já existia também não: o gatilho roda só quando o lead é criado. Confira também se o fluxo estava ligado na hora em que o lead nasceu.
Porque esse gatilho está indisponível hoje (em breve). Para reagir à mensagem do lead, use Primeira mensagem do lead com uma condição Texto da mensagem. Ela roda uma vez por conversa nova.
No gatilho Movido no Kanban, use {{trigger.column.name}}. A variável {{lead.column}} traz o id.
“Lead inativo por…” está em breve e não roda. Os disponíveis são Inatividade de atendimento (o lead escreveu e ninguém respondeu) e Inatividade do lead (foi enviada uma mensagem e o lead não respondeu). Ver o que conta.
Use Agendar template, com a unidade em dias e o horário. O agendamento aparece nas mensagens agendadas do lead. Para esperar e depois fazer outras ações (não só enviar), use Aguardar antes delas.
Sim. O bloco escolhe só o template; as variáveis são preenchidas com os dados do lead. Ver Templates do WhatsApp.

Para saber mais