Referência de chatbots

This content is not available in your language yet.

Referência rápida do módulo Chatbots. Para o passo a passo, veja Montar um fluxo e Gatilhos e publicar.

Os 16 tipos de bloco

Categoria	Bloco	Para que serve
Gatilhos	Gatilho	Inicia o fluxo por palavra-chave, 1ª mensagem, anúncio ou webhook — até 2 por fluxo.
Mensagens	Texto	Envia uma mensagem de texto.
Mensagens	Mídia	Envia imagem, vídeo, áudio ou documento.
Mensagens	Botões	Resposta rápida com até 3 botões — cada um tem sua saída. Se a pessoa tocar num botão de um menu que o bot mandou antes, na mesma conversa, o fluxo volta àquele menu e segue a opção tocada.
Mensagens	Lista	Menu interativo com seções e até 10 opções. Vale o mesmo dos botões para uma lista anterior da mesma conversa.
Mensagens	Template	Reusa um template existente (sequência completa).
Captura	Capturar Resposta	Aguarda a resposta do contato e salva numa variável.
Captura	Múltipla Escolha	Aguarda o número da opção e direciona o caminho.
Lógica	Atraso	Espera um tempo fixo ou até uma hora antes de continuar.
Lógica	Aleatório	Escolhe uma das saídas ao acaso, com igual chance.
Integrações	Webhook	Chama um sistema externo e guarda a resposta.
Integrações	IA	A IA responde, classifica a intenção ou extrai dados.
Integrações	Banco de Dados	Consulta dados internos do contato (histórico, CRM).
Ações	Etiqueta	Adiciona ou remove uma etiqueta no chat.
Ações	Transferir Humano	Marca a conversa para atendimento humano e pausa o bot.
Ações	Encerrar	Finaliza o fluxo daquela sessão.

Os tipos de gatilho

A pergunta Como este gatilho abre o fluxo? define o tipo de cada gatilho:

Gatilho	Opções
Palavra-chave	Palavras ou frases; modos Contém / Exato / Começa com / Regex (avançado); opção Disparar apenas uma vez por contato.
Primeira mensagem	Nunca conversamos antes / Sem conversa há mais de 30 dias / Sem conversa há mais de 90 dias.
Webhook externo	Token de autenticação, URL pra chamar e um exemplo cURL pronto. No máximo 1 por fluxo.
Veio do anúncio	Anúncios que já chegaram nos números do fluxo, ou o ID do anúncio colado do Gerenciador de Anúncios da Meta; opção Só uma vez por contato.

Início do fluxo

Regra	Como funciona
Até 2 gatilhos	Qualquer um abre o fluxo, e cada conversa começa pelo gatilho que casou. Cada gatilho tem tipo e opções próprios.
Template de Entrada sozinho	O fluxo criado a partir de um template aprovado começa só pelo Template de Entrada, sem gatilho.
1 webhook por fluxo	Só um dos gatilhos pode ser Webhook externo.
Ligado a um bloco	Todo início do fluxo precisa estar ligado a um bloco.
Anúncio e palavra	Veio do anúncio precisa de pelo menos um anúncio; Palavra-chave, de pelo menos uma palavra.
Uma vez por contato	Vale por fluxo: quem já passou pelo fluxo, por qualquer gatilho, não entra de novo por um gatilho com essa opção.
Recomeço pela palavra-chave	Texto digitado que bate com um gatilho de Palavra-chave de um fluxo publicado encerra a conversa atual e recomeça por esse gatilho. Clique em botão ou em lista não recomeça. Veio do anúncio nunca reinicia o fluxo em que a pessoa já está. Com o chatbot pausado na conversa, nada recomeça.

O botão Publicar confere essas regras antes de pôr o fluxo no ar e abre o bloco com problema.

Regras de atendimento

Ficam no painel do Gatilho, mas valem para o fluxo inteiro: com 2 gatilhos, os dois usam as mesmas regras.

Regra	Opções	Padrão
Quando alguém da equipe responder	Encerrar o fluxo e pausar o chatbot nesta conversa (de 1 a 720 horas) / Só encerrar o fluxo / Continuar normalmente	Pausar por 24 horas
Se o contato não escolher uma opção válida	Depois de 0 a 20 tentativas seguidas (0 = sem limite): Encerrar o fluxo / Transferir para humano; mensagem de despedida opcional	3 tentativas, depois encerrar

Os estados do chatbot

Estado	Significa
Rascunho	Em construção. Não atende contatos. Não conta no limite do plano.
Publicado	No ar, atendendo contatos. Conta no limite do plano.
Pausado	Fora do ar, mas preservado. Continua contando no limite do plano.

O editor salva o rascunho sozinho a cada poucos segundos (Salvo automaticamente). O botão Publicar põe o fluxo no ar; Pausar / Ativar alterna entre fora e dentro do ar. Não há botão de simulação no editor — teste publicando num dispositivo de teste e conversando pelo WhatsApp.

Métricas no editor

Ligue Métricas e escolha o período (Hoje / 7d / 30d / 90d / 1a). Você vê Pessoas atendidas, Mais clicado, Onde mais desistem e badges por bloco. Com 2 gatilhos, quem entrou pelos dois conta uma vez só em Pessoas atendidas.