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.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”.
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.campofica 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 deflows[].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
Por que o 'Novo lead criado' não rodou para um lead?
Por que o 'Novo lead criado' não rodou para um lead?
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.
Por que meu fluxo de 'Mensagem recebida' nunca roda?
Por que meu fluxo de 'Mensagem recebida' nunca roda?
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.
Como pego o nome da coluna para mandar ao meu sistema?
Como pego o nome da coluna para mandar ao meu sistema?
No gatilho Movido no Kanban, use
{{trigger.column.name}}. A variável
{{lead.column}} traz o id.Qual a diferença entre 'Lead inativo por…' e os dois gatilhos de inatividade?
Qual a diferença entre 'Lead inativo por…' e os dois gatilhos de inatividade?
“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.
Como mando um template daqui a alguns dias?
Como mando um template daqui a alguns dias?
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.
Posso enviar um template com variáveis?
Posso enviar um template com variáveis?
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
- 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”, “inatividade”, “Aguardar”, “Agendar template”.