Gatilhos e publicar

This content is not available in your language yet.

O fluxo começa por um Gatilho, que decide quando o fluxo abre para um contato. Um fluxo pode ter até 2 gatilhos — por exemplo, um para quem chega por um anúncio e outro para quem digita “menu”. Depois de montar o fluxo, você o publica para entrar no ar e acompanha o desempenho pelas Métricas.

Os tipos de gatilho

Clique no bloco Gatilho para abrir Configuração. Na pergunta Como este gatilho abre o fluxo?, escolha um dos quatro tipos: Palavra-chave, Primeira mensagem, Webhook externo ou Veio do anúncio.

📸 Captura necessária: painel “Configuração” do bloco Gatilho, com a pergunta “Como este gatilho abre o fluxo?” e as quatro opções (Palavra-chave, Primeira mensagem, Webhook externo, Veio do anúncio).

Palavra-chave

O fluxo abre quando a mensagem do contato bate com uma palavra ou frase que você definir.

Escolha Palavra-chave.
Em Palavras ou frases que disparam, digite uma palavra e pressione Enter para adicioná-la. Repita para cada palavra.
Em Como combinar?, escolha o modo de comparação.
Se maiúsculas e minúsculas devem fazer diferença, marque Diferenciar maiúsculas e minúsculas.
Se o fluxo deve abrir só uma vez para cada pessoa, marque Disparar apenas uma vez por contato.

Os modos de comparação:

Contém — a palavra pode estar no meio da mensagem: “preciso de ajuda” aciona a palavra “ajuda”.
Exato — a mensagem tem de ser exatamente a palavra ou a frase.
Começa com — a mensagem começa pela palavra: “ajuda por favor” aciona “ajuda”.
Regex (avançado) — para quem escreve expressões regulares.

Com Diferenciar maiúsculas e minúsculas desmarcada (o padrão), “Menu”, “menu” e “MENU” contam igual. Marcada, a mensagem tem de vir escrita do mesmo jeito que a palavra. Acentos sempre contam: “menú” não aciona “menu”.

Primeira mensagem

O fluxo abre quando o contato manda uma mensagem e se encaixa na condição escolhida em Quando considerar ‘primeiro contato’?:

Nunca conversamos antes — só abre se nunca houve troca de mensagens com o contato.
Sem conversa há mais de 30 dias — para reativar um contato que sumiu.
Sem conversa há mais de 90 dias — para reengajar um contato antigo.

Webhook externo

O fluxo é aberto por um sistema seu — uma loja virtual, um CRM, o n8n ou o Zapier —, que chama a URL do fluxo. Serve para casos como carrinho abandonado ou lead novo no CRM.

Escolha Webhook externo.
Clique em Gerar token aleatório (recomendado).
Em URL pra chamar (do seu sistema), clique em Copiar.
Configure o seu sistema para chamar essa URL. O Exemplo pronto pra copiar (cURL) mostra a chamada completa.

Quem configura a integração precisa saber:

A URL tem o formato https://pragmaz.ai/api/wa/chatbot/trigger/<id do fluxo> e recebe chamadas POST. Copie sempre a URL mostrada no painel.
O token vai no cabeçalho x-trigger-token. Sem token, o gatilho fica desativado.
O corpo leva o telefone do contato no formato do WhatsApp (jid, por exemplo 5511999999999@s.whatsapp.net) e, se quiser, variáveis (vars) que o fluxo usa como {{nome}}.
O limite é de 60 chamadas por minuto por fluxo, e o fluxo precisa estar publicado e no ar (um fluxo pausado recusa a chamada).

Veio do anúncio

O fluxo abre só para quem chegou por um dos anúncios que você escolher (anúncios do Facebook ou do Instagram que levam para o WhatsApp). Quem chegou por outro anúncio, ou sem anúncio, não entra por este gatilho.

Escolha Veio do anúncio.
Em Anúncios que já chegaram neste número, clique em cada anúncio que deve abrir o fluxo.
Confira os anúncios marcados em Anúncios escolhidos.
Se quiser, marque Só uma vez por contato.

A lista mostra os anúncios que já trouxeram contatos para os números deste fluxo (os definidos em Config). Um anúncio que ainda não trouxe ninguém não aparece nela: cole o ID dele — o do Gerenciador de Anúncios da Meta — em Anúncio que ainda não chegou? Cole o código e clique em Adicionar.

Como o gatilho se comporta:

Enquanto a pessoa está no fluxo, nem as respostas dela nem um novo clique no mesmo anúncio reiniciam o fluxo: ela continua de onde parou.
Depois que o fluxo termina, só um novo clique no anúncio abre o fluxo de novo — e nem isso, se Só uma vez por contato estiver marcado. Uma mensagem sem o clique não abre este nem outro fluxo do mesmo anúncio.
Quando a pessoa chega pelo anúncio escolhido, este gatilho vale antes dos outros: um fluxo de palavra-chave como “oi” não fica com ela.

📸 Captura necessária: painel do gatilho “Veio do anúncio”, com a lista “Anúncios que já chegaram neste número”, o campo “Anúncio que ainda não chegou? Cole o código” e os “Anúncios escolhidos”.

Regras de atendimento

Abaixo das opções do tipo, o painel do Gatilho tem duas regras. Elas valem para o fluxo inteiro, não só para aquele gatilho.

Quando alguém da equipe responder — pelo painel, pelo celular ou pelo WhatsApp Web:

Encerrar o fluxo e pausar o chatbot nesta conversa (recomendado) — em Por, defina por quantas horas (o padrão é 24). O bot só volta para essa pessoa depois do prazo, ou quando alguém clicar no botão do chatbot no cabeçalho da conversa (Retomar o chatbot neste chat).
Só encerrar o fluxo — a próxima mensagem que bater com um gatilho abre o fluxo de novo.
Continuar normalmente — o bot segue esperando a resposta do contato, mesmo com a equipe na conversa.

Se o contato não escolher uma opção válida — em vez de repetir “Não entendi” sem fim:

Em Depois de … tentativas seguidas, defina o número de tentativas (o padrão é 3; 0 = sem limite).
Escolha o que acontece depois: Encerrar o fluxo ou Transferir para humano.
Se quiser, escreva uma mensagem de despedida.

Dois gatilhos no mesmo fluxo

Um fluxo pode começar por até 2 gatilhos. Qualquer um deles abre o fluxo, e cada conversa começa pelo gatilho que casou. Cada gatilho tem o seu próprio tipo e as suas próprias opções. Assim você não precisa manter duas cópias do mesmo fluxo.

O uso mais comum:

Gatilho 1 — Veio do anúncio, com o seu anúncio.
Gatilho 2 — Palavra-chave “menu”, no modo Exato.

Ligue os dois ao mesmo primeiro bloco. Quem chega pelo anúncio entra no fluxo, e a pessoa pode recomeçar quando quiser, digitando “menu”.

📸 Captura necessária: canvas de um fluxo com “Gatilho 1” (Veio do anúncio) e “Gatilho 2” (Palavra-chave “menu”, modo Exato), os dois ligados ao mesmo primeiro bloco.

Adicionar o segundo gatilho

No painel Componentes, arraste outro Gatilho para o canvas.
Ligue a saída do novo gatilho ao primeiro bloco do fluxo.
Clique no novo gatilho.
Escolha o tipo e ajuste as opções dele.

O segundo gatilho chega como Palavra-chave, sem palavras e com as mesmas regras de atendimento do primeiro. No canvas e na Configuração, os dois aparecem como Gatilho 1 e Gatilho 2. Quando o fluxo já tem 2 gatilhos, o Gatilho some do painel Componentes.

Regras para publicar

No máximo 2 gatilhos por fluxo.
Só um deles pode ser Webhook externo. Se um gatilho já é webhook, essa opção fica travada no outro.
Todo gatilho precisa estar ligado a um bloco. Os dois podem ir para o mesmo primeiro bloco ou para pontos diferentes do fluxo.
Veio do anúncio precisa de pelo menos um anúncio, e Palavra-chave precisa de pelo menos uma palavra.
O fluxo criado a partir de um template aprovado começa pelo bloco Template de Entrada e não aceita gatilho: o template é o único início dele.

Ao publicar, o editor confere essas regras. Se alguma não for cumprida, aparece um aviso e o bloco com problema abre na Configuração.

O que vale para o fluxo inteiro

Regras de atendimento: com 2 gatilhos, os dois mostram as mesmas regras. Mudar num muda no outro.
Disparar apenas uma vez por contato e Só uma vez por contato valem por fluxo, não por gatilho: se o contato já passou por este fluxo, por qualquer gatilho, o gatilho com essa opção não abre o fluxo de novo.

Recomeçar o fluxo com a palavra-chave

Se o contato está no meio de um fluxo e digita uma mensagem que bate com um gatilho de Palavra-chave de qualquer fluxo publicado, a conversa atual é encerrada e o fluxo começa de novo por esse gatilho. Se a palavra for de outro fluxo, a pessoa passa para esse outro fluxo.

Tocar num botão ou numa opção de lista nunca recomeça o fluxo: o toque segue o caminho que você desenhou.
O gatilho Veio do anúncio nunca reinicia o fluxo em que a pessoa já está. Só um novo clique num anúncio de outro fluxo leva a pessoa para ele. Se ela clicar de novo no anúncio deste fluxo, continua nele — mesmo que o texto pronto do anúncio bata com a palavra de outro fluxo. A palavra de recomeço deste fluxo, junto do clique, ainda recomeça.
O gatilho Primeira mensagem nunca recomeça uma conversa em andamento.
Enquanto o chatbot estiver pausado na conversa (por exemplo, depois que a equipe respondeu), a palavra não recomeça nada.

Ver por qual gatilho a pessoa entrou

No topo do editor, clique em Contatos e abra um contato. Na aba Caminho, o primeiro passo mostra o gatilho de entrada — por exemplo, Gatilho 2 · menu.
Quando o contato já saiu do fluxo, o botão Recomeçar o fluxo, na ficha dele, recomeça pelo gatilho por onde ele entrou.
Com 2 gatilhos, a página aberta por Abrir a página de contatos do fluxo mostra, no quadro Até onde chegaram, uma barra para cada gatilho. Clique numa barra para listar quem entrou por ele. Se o fluxo usa fases do Kanban, esse quadro mostra as fases no lugar dos blocos.
Em Exportar contatos, a planilha traz a coluna Entrou por, com o tipo do gatilho. A coluna Palavra-chave que acionou só vem preenchida para quem entrou por um gatilho de palavra-chave.

Publicar o fluxo

O fluxo só atende contatos depois de publicado. Um chatbot tem três estados: Rascunho, Publicado e Pausado.

Termine de montar o fluxo.
Clique em Publicar.
No aviso Publicar este chatbot?, clique em Publicar.

Antes de pôr o fluxo no ar, o editor confere as regras para publicar e, se algo estiver errado, abre o bloco com problema. Se o rascunho não puder ser salvo naquele momento (aparece Erro ao salvar), nada é publicado: tente de novo.

Quantos chatbots o plano permite

O limite do plano — 5 no Pro e 20 no Business — conta os chatbots publicados: os que estão no ar e os pausados.

Rascunhos não contam. Você pode criar, duplicar e montar quantos quiser.
A vaga é usada quando você publica um rascunho. Republicar um fluxo que já está publicado ou pausado não usa vaga nova.
Pausar não libera a vaga. Para liberar, exclua um chatbot publicado ou pausado.
Excluir rascunhos não libera nada, porque eles não ocupam vaga.

Com o limite cheio, Publicar um rascunho abre o aviso de upgrade do plano. Na lista de chatbots, o dono da conta vê quantos já estão publicados, por exemplo 5/5 publicados no plano.

Ler as métricas

No topo do editor, ligue Métricas. Escolha o período: Hoje, 7d, 30d, 90d ou 1a. Você vê:

Pessoas atendidas — quantas pessoas passaram pelo fluxo. Com 2 gatilhos, quem entrou pelos dois conta uma vez só.
Mais clicado — o caminho mais escolhido.
Onde mais desistem — o ponto em que as pessoas abandonam.
Badges por bloco, com os números de cada um direto no canvas.

📸 Captura necessária: editor do chatbot com “Métricas” ligado, mostrando os badges por bloco e o resumo com “Pessoas atendidas”, “Mais clicado” e “Onde mais desistem”.

Veja também

Montar um fluxo Criar o chatbot e usar o construtor.

Referência de chatbots Gatilhos, regras do início, blocos e estados.

A janela de 24 horas e os templates Inclui a janela de 72 horas de quem chega por anúncio.

Como a IA responde Usar o bloco de IA no fluxo.