🧩 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)](/books/comece-por-aqui/page/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 1. Abra **Bots → Chatbots** e clique em **Novo chatbot**, no canto superior direito.🧩 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](/books/chatbots/page/criar-um-chatbot-no-builder-visual-sem-codigo). ## 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 1. 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**. 2. 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. 3. Se escolher **Palavra-chave**, preencha o campo **Palavras-chave (separadas por vírgula)**, por exemplo, `orçamento, preço, valor`. 4. 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**. 5. 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](/books/chatbots/page/criar-um-chatbot-no-builder-visual-sem-codigo) - [Usar os nós: enviar mensagem, pergunta, menu e condição](/books/chatbots/page/usar-os-nos-enviar-mensagem-pergunta-menu-e-condicao) - [Publicar, pausar e acompanhar o chatbot](/books/chatbots/page/publicar-pausar-e-acompanhar-o-chatbot) - [Disparar o chatbot proativamente a partir do CRM](/books/chatbots/page/disparar-o-chatbot-proativamente-a-partir-do-crm) - [Configurar fuso horário e horário de atendimento](/books/conta-e-preferencias/page/configurar-fuso-horario-e-horario-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](/books/chatbots/page/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 1. 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. 2. **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. 3. **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**. 4. **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**. 5. **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**. 6. 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**. 7. 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](/books/chatbots/page/configurar-o-gatilho-que-inicia-o-chatbot) - [Publicar, pausar e acompanhar o chatbot](/books/chatbots/page/publicar-pausar-e-acompanhar-o-chatbot) - [Criar um agente de IA no builder](/books/agentes-de-ia/page/criar-um-agente-de-ia-no-builder) - [Transferir um atendimento entre agentes ou equipes](/books/atendimentos/page/transferir-um-atendimento-entre-agentes-ou-equipes) - [Passo "Transferir atendimento": atendente fixo ou rodízio por porcentagem](/books/chatbots/page/passo-transferir-atendimento-atendente-fixo-ou-rodizio-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](/books/chatbots/page/criar-um-chatbot-no-builder-visual-sem-codigo) e [Usar os nós: enviar mensagem, pergunta, menu e condição](/books/chatbots/page/usar-os-nos-enviar-mensagem-pergunta-menu-e-condicao). - Um canal oficial (Meta) com um **modelo de mensagem** aprovado, usado como abertura. Veja [Conectar WhatsApp Oficial (API da Meta)](/books/canais-e-integracoes/page/conectar-whatsapp-oficial-api-da-meta) e [Criar um modelo de mensagem (WhatsApp Oficial)](/books/modelos-tags-e-classificacoes/page/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 1. 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](/books/automacoes/page/criar-sua-primeira-automacao). 2. 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](/books/automacoes/page/definir-gatilhos-e-condicoes). 3. Em **Adicionar passo**, adicione a ação **Iniciar chatbot** ao fluxo: a janela de configuração abre sozinha.
🧩 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](/books/chatbots/page/configurar-o-gatilho-que-inicia-o-chatbot). - Os atendentes já cadastrados. Veja [Convidar novos usuários por e-mail](/books/equipes-usuarios-e-permissoes/page/convidar-novos-usuarios-por-e-mail) e [Criar uma equipe e atribuir agentes](/books/equipes-usuarios-e-permissoes/page/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 1. Adicione o passo **Transferir atendimento** ao fluxo e dê duplo clique nele (ou clique no ícone de lápis). 2. Em **Equipe**, escolha **Equipe padrão do canal**, **Não alterar equipe** ou uma equipe específica. 3. 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. 4. 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**. 5. Em **Sequencial**, no bloco **Atendentes**, clique em **Adicionar atendente** e escolha a pessoa. Não há peso: todos da lista recebem a mesma quantidade. 6. 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](/books/atendimentos/page/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](/books/chatbots/page/usar-os-nos-enviar-mensagem-pergunta-menu-e-condicao) - [Transferir um atendimento entre agentes ou equipes](/books/atendimentos/page/transferir-um-atendimento-entre-agentes-ou-equipes) - [Criar uma equipe e atribuir agentes](/books/equipes-usuarios-e-permissoes/page/criar-uma-equipe-e-atribuir-agentes) - [Configurar seu perfil e preferências](/books/comece-por-aqui/page/configurar-seu-perfil-e-preferencias) # 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](/books/chatbots/page/usar-os-nos-enviar-mensagem-pergunta-menu-e-condicao). ## Tempo estimado 2 minutos. ## Caminho de acesso **Bots → Chatbots** → abra o chatbot💻 O builder de chatbots é uma tela de computador (desktop).
## Passo a passo 1. 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. 2. 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**. 3. 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**. 4. 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](/books/chatbots/page/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. ## Artigos relacionados - [Criar um chatbot no builder visual, sem código](/books/chatbots/page/criar-um-chatbot-no-builder-visual-sem-codigo) - [Configurar o gatilho que inicia o chatbot](/books/chatbots/page/configurar-o-gatilho-que-inicia-o-chatbot) - [Usar os nós: enviar mensagem, pergunta, menu e condição](/books/chatbots/page/usar-os-nos-enviar-mensagem-pergunta-menu-e-condicao) - [Disparar o chatbot proativamente a partir do CRM](/books/chatbots/page/disparar-o-chatbot-proativamente-a-partir-do-crm)