Chatbots
Monte fluxos de atendimento automático no builder visual, sem código.
- Criar um chatbot no builder visual, sem código
- Configurar o gatilho que inicia o chatbot
- Usar os nós: enviar mensagem, pergunta, menu e condição
- Disparar o chatbot proativamente a partir do CRM
- Passo "Transferir atendimento": atendente fixo ou rodízio por porcentagem
- Publicar, pausar e acompanhar o chatbot
Criar um chatbot no builder visual, sem código
Crie um chatbot que responde sozinho no seu canal, dando boas-vindas e fazendo a triagem, montando o fluxo em um quadro visual, sem escrever nenhuma linha de código.
🧩 Este recurso faz parte do módulo Chatbots. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja Planos e módulos.
Objetivo
Criar um chatbot ligado a um canal e abrir o builder visual para montar o fluxo.
Pré-requisitos
- Perfil Administrador: apenas administradores gerenciam chatbots.
- Módulo Chatbots ativo.
- Um canal conectado (por exemplo, WhatsApp). Veja Conectar seu primeiro canal de WhatsApp (QR Code).
Tempo estimado
3 minutos.
Caminho de acesso
Bots → Chatbots
💻 O builder de chatbots é uma tela de computador (desktop). No celular, use um notebook ou computador para montar seus fluxos.
Passo a passo
- Abra Bots → Chatbots e clique em Novo chatbot, no canto superior direito.
- Na janela Criar chatbot de atendimento, preencha o Nome, por exemplo,
Triagem inicial. - Em Tipo de canal, selecione o canal conectado onde o chatbot vai responder.
- Em Equipe padrão do chatbot (opcional), escolha a equipe que recebe os atendimentos. Se deixar em branco, ele usa a equipe padrão do canal.
- Clique em Criar e abrir.
Resultado esperado
O chatbot é criado com status Rascunho e o builder visual abre já com o gatilho no quadro. A partir daqui, você configura o gatilho e arrasta os passos do fluxo. Ele só passa a atender depois de publicado.
Erros comuns
- Sintoma: o botão Criar e abrir fica desativado. Solução: preencha o Nome e selecione um canal: os dois são obrigatórios.
- Sintoma: a lista de canais aparece vazia ("Nenhum canal conectado"). Solução: conecte um canal antes em Ajustes → Canais. Veja Conectar seu primeiro canal de WhatsApp (QR Code).
- Sintoma: a tela diz "Acesso restrito". Solução: seu perfil não é Administrador; peça a um administrador.
Artigos relacionados
- Configurar o gatilho que inicia o chatbot
- Usar os nós: enviar mensagem, pergunta, menu e condição
- Publicar, pausar e acompanhar o chatbot
- Qual a diferença entre chatbot e agente de IA?
Configurar o gatilho que inicia o chatbot
Defina o que faz o chatbot entrar em ação: o início de uma conversa, uma palavra-chave ou o horário de atendimento.
🧩 Este recurso faz parte do módulo Chatbots. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja Planos e módulos.
Objetivo
Escolher e configurar o gatilho que dá início ao fluxo do chatbot.
Pré-requisitos
- Perfil Administrador.
- Um chatbot já criado. Veja Criar um chatbot no builder visual, sem código.
Tempo estimado
2 minutos.
Caminho de acesso
Bots → Chatbots → abra o chatbot → clique no bloco de gatilho no quadro
💻 O builder de chatbots é uma tela de computador (desktop).
Passo a passo
-
No builder, dê duplo clique no bloco de gatilho (o primeiro passo do fluxo, no topo do quadro) ou clique no ícone de lápis nele. Abre a janela Configurar gatilho.
-
No campo Quando..., escolha o gatilho:
- Iniciar atendimento pelo canal: dispara quando o contato inicia uma conversa no canal do chatbot.
- Palavra-chave: dispara quando a mensagem do contato contém uma palavra que você definir.
- Dentro do horário de atendimento: dispara quando o contato fala dentro do horário configurado.
- Fora do horário de atendimento: dispara quando o contato fala fora do horário (ideal para uma mensagem automática de "estamos fechados").
- Chamado por direcionamento: não dispara sozinho: só inicia quando outro chatbot usa o passo Direcionar para outro chatbot, quando uma automação usa o passo Iniciar chatbot ou pela API pública.
-
Se escolher Palavra-chave, preencha o campo Palavras-chave (separadas por vírgula), por exemplo,
orçamento, preço, valor. -
Se escolher um gatilho de horário, o botão Horário aparece na barra do topo. Clique nele para definir os dias e horários em Horário de atendimento e clique em Salvar horário.
-
Clique em Salvar na barra do topo para guardar a configuração.
Resultado esperado
O bloco de gatilho passa a mostrar um resumo do que você configurou (por exemplo, "Palavra-chave: orçamento"). O fluxo já sabe quando começar: falta ligar os próximos passos e publicar.
Erros comuns
- Sintoma: o botão Horário não aparece. Solução: ele só existe para os gatilhos Dentro do horário e Fora do horário; escolha um deles primeiro.
- Sintoma: o chatbot não inicia com a palavra-chave. Solução: confira se a palavra está escrita igual (sem acento a mais) e separada por vírgula das outras; e lembre que o chatbot precisa estar Publicado.
- Sintoma: tenho mais de um chatbot ativo no mesmo canal e o errado responde. Solução: quando mais de um gatilho bate ao mesmo tempo, a ordem de prioridade é Palavra-chave > horário (Dentro/Fora) > Iniciar atendimento pelo canal.
Artigos relacionados
- Criar um chatbot no builder visual, sem código
- Usar os nós: enviar mensagem, pergunta, menu e condição
- Publicar, pausar e acompanhar o chatbot
- Disparar o chatbot proativamente a partir do CRM
- Configurar fuso horário e horário de atendimento
Usar os nós: enviar mensagem, pergunta, menu e condição
Monte o fluxo do chatbot com os passos certos: envie mensagens, faça perguntas, ofereça um menu de opções e ramifique conforme a resposta.
🧩 Este recurso faz parte do módulo Chatbots. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja Planos e módulos.
Objetivo
Adicionar e conectar os principais passos do fluxo de um chatbot.
Pré-requisitos
- Perfil Administrador.
- Um chatbot com o gatilho já configurado. Veja Configurar o gatilho que inicia o chatbot.
Tempo estimado
5 minutos.
Caminho de acesso
Bots → Chatbots → abra o chatbot
💻 O builder de chatbots é uma tela de computador (desktop).
Passo a passo
-
No painel da esquerda, em Adicionar passo, os passos ficam agrupados por seção (Mensagem, Contato, Atendimento, IA, CRM, Tempo, Fluxo, Avançado). Clique num passo para adicioná-lo ao quadro, ou arraste-o para a posição desejada.
-
Enviar mensagem: envia um ou mais balões de texto. No painel do passo, escreva o texto em Mensagens (balões) e use Adicionar balão para mandar várias mensagens seguidas.
-
Enviar pergunta: pergunta e espera a resposta do contato. Preencha a Pergunta e o Tipo de resposta (Texto livre ou E-mail, que só aceita um endereço válido). Em Tempo de espera (minutos), defina quanto tempo esperar (padrão 60). Se quiser reaproveitar a resposta depois, preencha Salvar resposta na variável (opcional, por exemplo
nome). As saídas são Respondeu e Não respondeu, mais Resposta inválida quando o tipo é E-mail. -
Enviar menu: mostra opções numeradas. Preencha o Texto do menu e cada opção em Opções (use Adicionar opção). Se quiser reaproveitar a escolha depois, preencha Salvar escolha na variável (opcional). Ajuste também o Tempo de espera (minutos) (padrão 60). Cada opção vira uma saída própria no quadro, mais as saídas Outro (resposta fora do menu) e Sem resposta.
-
Condição: ramifica o fluxo. Escolha o Dado (por exemplo, Última resposta ou Variável capturada), o Operador (Contém, É igual a, Começa com, entre outros) e o Valor. O passo tem as saídas Sim e Não.
-
Ligue os passos: arraste da bolinha de saída de um passo até a entrada do próximo. Para editar qualquer passo, dê duplo clique nele (ou clique no ícone de lápis); para removê-lo, use Remover passo no painel ou selecione-o e pressione Delete.
-
Clique em Salvar na barra do topo.
Resultado esperado
O quadro mostra os passos conectados por linhas, cada um com um resumo do que foi configurado. As perguntas, menus e condições criam caminhos diferentes conforme o que o contato responde.
Erros comuns
- Sintoma: um passo fica "solto" e nunca acontece. Solução: todo passo precisa estar ligado a uma saída anterior; conecte-o ao fluxo.
- Sintoma: a Condição sempre cai no Não. Solução: confira o Dado e o Valor: para comparar a mensagem do contato, use o dado Última resposta com o operador Contém.
- Sintoma: o menu não reconhece a escolha. Solução: oriente o contato a responder com o número da opção; respostas fora da lista seguem pela saída Outro.
Artigos relacionados
- Configurar o gatilho que inicia o chatbot
- Publicar, pausar e acompanhar o chatbot
- Criar um agente de IA no builder
- Transferir um atendimento entre agentes ou equipes
- Passo "Transferir atendimento": atendente fixo ou rodízio por porcentagem
Disparar o chatbot proativamente a partir do CRM
Faça o chatbot começar a conversa por conta própria (quando um card entra numa etapa do CRM, por exemplo) em vez de esperar o contato falar primeiro.
🧩 Este recurso faz parte do módulo Chatbots. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja Planos e módulos.
Objetivo
Disparar um chatbot a partir de um evento do CRM, usando uma automação com o passo Iniciar chatbot.
Pré-requisitos
- Perfil Administrador.
- Um chatbot já criado, com o fluxo montado. Veja Criar um chatbot no builder visual, sem código e Usar os nós: enviar mensagem, pergunta, menu e condição.
- Um canal oficial (Meta) com um modelo de mensagem aprovado, usado como abertura. Veja Conectar WhatsApp Oficial (API da Meta) e Criar um modelo de mensagem (WhatsApp Oficial).
Tempo estimado
5 minutos.
Caminho de acesso
Bots → Automação CRM
💻 O builder de automações é uma tela de computador (desktop).
Passo a passo
- O disparo proativo não sai de um botão dentro do chatbot: ele vem de uma automação. Abra Bots → Automação CRM e crie (ou abra) uma automação. Veja Criar sua primeira automação.
- Configure o gatilho da automação com o evento que deve iniciar a conversa, por exemplo, Card mudou de etapa. Veja Definir gatilhos e condições.
- Em Adicionar passo, adicione a ação Iniciar chatbot ao fluxo: a janela de configuração abre sozinha.
- Em Canal, escolha o canal por onde a mensagem sai.
- Em Chatbot, selecione o chatbot que vai assumir a conversa depois da abertura. Os ainda não publicados aparecem marcados como "(rascunho)" e os pausados como "(pausado)". Só um chatbot publicado é iniciado.
- Em Modelo de abertura (HSM), escolha um modelo aprovado para aquele canal e preencha as variáveis que aparecerem (texto fixo ou uma variável do card, como
{{primeiro_nome}}). - Ligue as saídas do passo (Iniciado e Falha) aos próximos passos, se quiser tratar cada caso. Clique em Salvar e ativar para deixar a automação funcionando.
Resultado esperado
Quando o evento acontece, a automação cria a conversa no canal, envia o modelo de abertura e, assim que o contato responde, entrega o atendimento ao chatbot escolhido, que segue o fluxo montado no builder.
Erros comuns
- Sintoma: o campo Modelo de abertura (HSM) diz "Nenhum modelo aprovado para este canal". Solução: o disparo proativo exige um canal oficial (Meta) com modelo aprovado; sincronize/aprove o modelo em Ajustes → Mensagens Prontas. Veja Criar um modelo de mensagem (WhatsApp Oficial).
- Sintoma: o passo cai na saída Falha com "Não iniciado: o chatbot ... está em rascunho" (ou "está pausado"). Solução: publique o chatbot. O modelo de abertura não é enviado enquanto ele não estiver publicado. Veja Publicar, pausar e acompanhar o chatbot.
- Sintoma: o passo cai na saída Falha por outro motivo. Solução: confira se o canal está conectado e se o contato tem um número válido; acompanhe o motivo pelo Histórico. Veja Publicar, pausar e acompanhar o chatbot.
- Sintoma: o chatbot foi pausado depois do disparo e o contato respondeu. Solução: esperado, a conversa segue o fluxo normal do canal (outros chatbots ativos ou a fila de atendimento), sem o chatbot pausado.
Artigos relacionados
- Nó "Iniciar chatbot"
- Criar sua primeira automação
- Publicar, pausar e acompanhar o chatbot
- Encadear ações e acompanhar as execuções
Passo "Transferir atendimento": atendente fixo ou rodízio por porcentagem
Passe a conversa do chatbot para uma equipe ou para um atendente: sempre a mesma pessoa, ou várias em rodízio, por porcentagem ou uma para cada (Sequencial).
🧩 Este recurso faz parte do módulo Chatbots. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja Planos e módulos.
Objetivo
Encaminhar a conversa do chatbot para uma equipe ou para um atendente, fixo ou em rodízio entre várias pessoas.
Pré-requisitos
- Perfil Administrador.
- Um chatbot com o gatilho já configurado. Veja Configurar o gatilho que inicia o chatbot.
- Os atendentes já cadastrados. Veja Convidar novos usuários por e-mail e Criar uma equipe e atribuir agentes.
Tempo estimado
5 minutos.
Caminho de acesso
Bots → Chatbots → abra o chatbot → Adicionar passo → seção Atendimento → Transferir atendimento
💻 O builder de chatbots é uma tela de computador (desktop).
Passo a passo
- Adicione o passo Transferir atendimento ao fluxo e dê duplo clique nele (ou clique no ícone de lápis).
- Em Equipe, escolha Equipe padrão do canal, Não alterar equipe ou uma equipe específica.
- Em Atribuição, escolha:
- Atendente fixo: a conversa vai sempre para a mesma pessoa (ou fica na fila da equipe, se você não escolher ninguém);
- Por porcentagem: as conversas se alternam entre as pessoas da lista, na proporção que você definir;
- Sequencial: as conversas vão uma para cada pessoa da lista, na vez de cada uma, mesmo para quem está offline.
- Em Por porcentagem, no bloco Atendentes e pesos, clique em Adicionar atendente, escolha a pessoa e digite o Peso. À direita de cada linha, o editor mostra a porcentagem que a pessoa vai receber: quatro pesos 1 mostram 25% cada. Uma linha sem pessoa ou com peso 0 mostra fora do rodízio.
- Em Sequencial, no bloco Atendentes, clique em Adicionar atendente e escolha a pessoa. Não há peso: todos da lista recebem a mesma quantidade.
- Clique em Salvar na barra do topo.
Como o rodízio funciona
- Só para quem está online (opção da conta): em Ajustes → Regras de atendimento, seção Distribuição de atendimentos, o administrador escolhe se o rodízio deixa de fora quem está offline. Desligada (o padrão), todos da lista recebem na sua vez, online ou não, e a conversa espera quem está offline voltar. Ligada, só recebe quem está Disponível ou Ausente na porcentagem: quem fica offline perde a vez e não recupera depois. Vale para todos os chatbots e automações da conta. No Sequencial a opção não conta.
- Pesos iguais: cada pessoa recebe uma conversa por vez. Com quatro atendentes de peso 1, cada quatro conversas dão uma para cada um. Não há sorteio.
- Pesos diferentes: a proporção é cumprida a cada rodada, com as pessoas intercaladas. Com pesos 1, 2 e 7, cada dez conversas dão 1, 2 e 7, e quem tem peso 7 não recebe as sete seguidas.
- Sequencial: cada pessoa da lista recebe uma conversa por vez, mesmo Offline ou Indisponível. Com três atendentes, cada três conversas dão uma para cada um, de dia ou de noite. O status não conta: só o Modo férias tira a pessoa da vez.
- A ordem entre as pessoas é definida pelo sistema e não segue a ordem da lista.
- Modo férias: quem está com o Modo férias ligado fica de fora, nos dois modos. Ao voltar, a pessoa entra na sua vez, sem receber de uma vez as conversas que perdeu.
- Status do atendente (só na porcentagem, com a opção da conta ligada): só recebe quem está Disponível ou Ausente. Quem está Indisponível, Offline ou Invisível fica de fora e, ao voltar, entra na sua vez. Offline quer dizer que o AtendeBot está fechado ou que o navegador suspendeu a aba.
- Ninguém Disponível ou Ausente (só na porcentagem com a opção da conta ligada, por exemplo fora do expediente): com a caixa Se ninguém estiver online, distribuir mesmo assim marcada (o padrão, logo abaixo dos pesos), o rodízio segue entre todos da lista que não estão de férias, para a conversa não ficar sem responsável. Desmarcada, a conversa espera na equipe, sem responsável, até alguém assumir. No Sequencial essa caixa não existe, porque todos da lista já recebem.
- Ninguém pode receber (todos de férias ou, na porcentagem, ninguém online com a caixa desmarcada): a conversa fica na equipe, sem responsável.
- Mudar pessoas ou pesos não zera o rodízio: entre pessoas de mesmo peso, quem estava esperando continua na frente; quem ganhou peso maior pode receber antes. Para ausências de um ou dois dias, prefira o Modo férias em vez de tirar a pessoa da lista.
- Cada passo tem o seu rodízio. Se as mesmas pessoas aparecem em dois passos Transferir atendimento (por exemplo, um em cada opção de um menu), cada passo conta separado.
- A conversa chega na aba Novos da pessoa escolhida e espera o aceite. Veja Transferir um atendimento entre agentes ou equipes.
Resultado esperado
As conversas novas chegam aos atendentes na proporção definida. Para conferir, abra Relatórios → Atendimentos → Equipe: a coluna Recebidos e o bloco Distribuição automática mostram quanto cada pessoa deveria ter recebido e quanto recebeu, com um cartão para cada passo Transferir atendimento em porcentagem ou sequencial. Esperadas conta só quem podia receber em cada momento: fica de fora quem estava de férias e, na porcentagem com a opção da conta ligada, quem estava offline enquanto havia alguém online.
Erros comuns
- Sintoma: com pesos iguais, uma pessoa recebe bem menos que as outras. Solução: a conta está com Só distribuir para quem está online ligada, e ela ficou Offline ou Indisponível parte do tempo e perdeu essas vezes. Para dividir igual, desligue a opção em Ajustes → Regras de atendimento ou use Sequencial.
- Sintoma: as contagens de duas pessoas com o mesmo peso não batem. Solução: confira se alguém esteve de férias, Indisponível ou Offline no período (essa pessoa ficou de fora enquanto isso), se houve conversas atribuídas ou transferidas à mão (elas não entram no rodízio) e se o chatbot tem mais de um passo Transferir atendimento (cada um tem o rodízio próprio). Uma diferença de uma conversa é normal no meio de uma rodada.
- Sintoma: a mesma pessoa recebeu duas conversas seguidas. Solução: com pesos diferentes isso é esperado: quem tem peso maior aparece mais vezes em cada rodada. Com pesos iguais, pode acontecer uma vez quando alguém entra ou sai do Modo férias ou muda de status, quando a lista de pessoas muda, ou entre dois passos Transferir atendimento diferentes.
- Sintoma: uma conversa foi para quem estava Offline ou Indisponível. Solução: no Sequencial e na porcentagem com a opção da conta desligada (o padrão), é o normal: todos da lista recebem, online ou não. Com a opção ligada, é o esperado quando ninguém da lista estava Disponível ou Ausente naquele momento e a caixa Se ninguém estiver online, distribuir mesmo assim está marcada: o rodízio segue entre todos que não estão de férias. Para a conversa esperar na equipe nesse caso, desmarque a caixa no passo. Para tirar alguém do rodízio, ligue o Modo férias dessa pessoa.
- Sintoma: a conversa ficou sem responsável. Solução: ninguém da lista podia receber naquele momento (todos de férias, ou ninguém online com a caixa Se ninguém estiver online, distribuir mesmo assim desmarcada) ou houve uma falha momentânea do sistema. Adicione mais uma pessoa ou desligue o Modo férias de alguém.
Artigos relacionados
- Usar os nós: enviar mensagem, pergunta, menu e condição
- Transferir um atendimento entre agentes ou equipes
- Criar uma equipe e atribuir agentes
- Configurar seu perfil e preferências
Publicar, pausar e acompanhar o chatbot
Coloque o chatbot no ar, pause quando precisar e acompanhe cada atendimento pelo histórico de execução.
🧩 Este recurso faz parte do módulo Chatbots. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja Planos e módulos.
Objetivo
Publicar um chatbot para que ele passe a atender, pausá-lo e acompanhar as execuções.
Pré-requisitos
- Perfil Administrador.
- Um chatbot com gatilho e fluxo montados. Veja Usar os nós: enviar mensagem, pergunta, menu e condição.
Tempo estimado
2 minutos.
Caminho de acesso
Bots → Chatbots → abra o chatbot
💻 O builder de chatbots é uma tela de computador (desktop).
Passo a passo
-
Com o fluxo pronto, clique em Salvar e publicar na barra do topo. O status muda para Publicado e o chatbot começa a atender pelo gatilho configurado.
-
Para tirá-lo do ar temporariamente, clique em Pausar. O status vira Pausado e ele para de responder, sem perder o fluxo. Para religar, clique em Salvar e publicar de novo. Você também pode pausar direto pela lista em Bots → Chatbots.
-
Para acompanhar o que aconteceu, clique em Histórico na barra do topo. O painel Histórico de execução lista os atendimentos recentes, cada um com um status: Concluída, Rodando, Aguardando, Pendente, Falhou ou Cancelada.
-
Clique em uma execução para expandir e ver os passos que rodaram, em ordem. Se algum passo falhou, a mensagem de erro aparece em vermelho, ajudando a identificar onde ajustar o fluxo.
Resultado esperado
O chatbot fica com status Publicado e passa a responder automaticamente. Cada conversa atendida aparece no Histórico de execução, com os passos percorridos.
Erros comuns
- Sintoma: ao publicar, aparece "Defina o gatilho antes de publicar". Solução: volte ao bloco de gatilho, dê duplo clique nele e escolha uma opção em Quando... antes de publicar. Veja Configurar o gatilho que inicia o chatbot.
- Sintoma: ao publicar, aparece "Substituiu o chatbot ... neste canal/gatilho". Solução: normal, só um chatbot pode ficar publicado por canal com os gatilhos Iniciar atendimento pelo canal, Dentro do horário ou Fora do horário, então o anterior é pausado automaticamente. Isso não vale para Palavra-chave: vários chatbots com palavras diferentes podem ficar publicados juntos no mesmo canal.
- Sintoma: o Histórico de execução está vazio ("Nenhuma execução ainda"). Solução: ninguém acionou o gatilho ainda; publique o chatbot e faça um teste real enviando uma mensagem pelo canal.
- Sintoma: publiquei, mas o chatbot não responde. Solução: confira se o gatilho está configurado e se o canal está conectado; abra o Histórico para ver se houve falha.