Chatbot de atendimento (atendente virtual com IA)

O chatbot do FlakeDesk é um atendente virtual com IA que faz o primeiro atendimento aos SEUS clientes no WhatsApp: dá boas-vindas, responde dúvidas com base no conhecimento da sua empresa, qualifica o interesse (nome, necessidade) e transfere para a sua equipe quando necessário. Disponível nos planos Premium e Platinum.

Como ativar (passo a passo)

  1. Pré-requisitos: plano Premium ou Platinum e o WhatsApp conectado (Administração → Configurações → WhatsApp → "Conectar com a Meta"). Sem número conectado o bot não tem por onde responder.
  2. Acesse Administração → Configurações → Chatbot de atendimento (URL: /admin/settings/chatbot). Somente admins da organização veem esta tela.
  3. Na aba Geral, ligue os canais desejados: WhatsApp (responde as mensagens do número conectado) e/ou Chat do site (o widget instalado no seu site vira uma conversa com o bot).
  4. Na aba Persona e mensagens, escreva:
    • Instruções de tom e comportamento — quem é o bot e como deve falar. Ex.: "Seja simpático e objetivo. Nosso público são clínicas odontológicas. Nunca dê valores de tratamento; peça para aguardar a equipe."
    • Mensagem de saudação e mensagem de transferência (enviada quando o bot passa a conversa para a equipe).
    • Palavras-chave de transferência — se a mensagem do cliente contiver alguma (ex.: "atendente", "humano", "cancelar"), o bot transfere imediatamente, sem tentar responder.
  5. (Opcional) Na aba Geral, configure o horário de atendimento: ligando "Bot somente fora do horário de atendimento", o bot só responde fora dos dias/horários marcados (noites, fins de semana) — dentro deles, as conversas ficam com a equipe. O horário usa o fuso de Brasília.
  6. Clique em Salvar configurações.
  7. Alimente a base de conhecimento em Administração → Configurações → Assistentes de IA, aba Base de conhecimento (/admin/settings/ai): produtos, serviços, preços, horários, endereço, políticas de troca e cancelamento, perguntas frequentes. Marque a audiência de cada documento como Só clientes ou Equipe e clientes; documentos "Só a equipe" (o padrão) nunca chegam ao chatbot. A tela do chatbot mostra quantos documentos estão visíveis ao cliente. O bot não recebe a documentação (central de ajuda) do FlakeDesk nem dados do CRM: só o que a sua organização cadastrou para clientes. Este passo define a qualidade do bot: ele responde SOMENTE com o que estiver na base de conhecimento da sua organização; o que não estiver lá, ele transfere para a equipe em vez de inventar. Opcionalmente, a busca na web (veja a seção abaixo) permite que ele complemente com informações públicas da internet.
  8. Teste sem gastar WhatsApp: aba Testar o bot — converse com o bot como se fosse o cliente (dry-run com a configuração salva; tem cota própria pequena e não consome a cota do bot). Depois valide de verdade: envie uma mensagem de WhatsApp de outro número para o número da empresa. O bot responde em alguns segundos (ele espera ~8 segundos após a última mensagem para agrupar mensagens enviadas em sequência).

Como o bot decide o que fazer

  • Conversas novas (sem histórico de atendimento humano) são atendidas pelo bot automaticamente enquanto o canal estiver ligado.
  • Conversas que já tiveram atendente humano continuam com a equipe — o bot não se intromete.
  • O bot transfere para a equipe quando: o cliente pede uma pessoa; detecta palavra-chave de transferência; o assunto foge do conhecimento da base; há sinais de reclamação/cancelamento/negociação; ou a cota mensal do plano acabou. Na transferência ele envia a mensagem configurada e a conversa passa a "atendimento humano".
  • O bot entende mensagens de texto e, no WhatsApp, mensagens de voz: o áudio é transcrito automaticamente e o bot responde ao que foi dito, como se fosse escrito (inclusive para agendar um horário). Se o cliente manda um áudio e logo depois um texto, o bot espera a transcrição e considera os dois. Se o áudio não puder ser transcrito (transcrição desligada, limite do mês atingido, áudio de mais de 5 minutos ou falha temporária), o bot responde "Recebi seu áudio, mas não consigo ouvir por aqui. Vou passar para a nossa equipe te responder." e passa a conversa para a equipe. Detalhes em "WhatsApp no FlakeDesk", seção "Transcrição das mensagens de voz".
  • Foto, vídeo ou documento sem legenda: o bot não lê o arquivo; ele responde "Recebi seu arquivo. Vou passar para a nossa equipe te responder." e passa a conversa para a equipe (antes, ele ficava sem responder). Com legenda, o bot responde à legenda. Figurinhas e reações não recebem resposta.
  • O bot nunca acessa dados do seu CRM (contatos, negócios, outros clientes) — só a base de conhecimento e a própria conversa. Isso é uma proteção de privacidade por design.

Agendamento automático (opcional)

Com o Agendamento automático ligado (/admin/settings/chatbot → aba Geral → card "Agendamento automático"), quando o cliente pedir um horário o bot não transfere para a equipe: ele consulta a agenda da equipe, oferece horários livres e registra o pedido de reunião. Vale para o WhatsApp e para o chat do site.

Como funciona:

  1. O bot entende o motivo (serviço desejado) e oferece alguns horários livres na agenda da equipe, poucos de cada vez, priorizando os mais próximos ou os do dia e período que o cliente pediu. Ele sabe que dia é hoje, então "amanhã à tarde" ou "sexta de manhã" funcionam.
  2. Se o cliente pedir um horário que não está livre, o bot avisa e oferece os mais próximos. Ele nunca confirma um horário ocupado.
  3. O bot confirma com o cliente ("Posso confirmar quinta, 14/08, às 15h?") antes de concluir.
  4. Confirmado, o FlakeDesk confere a agenda de novo naquele instante e registra o pedido como follow-up no cadastro do cliente, na agenda da pessoa que vai atender. Ele aparece no Calendário do FlakeDesk e no perfil do contato.
  5. A equipe é avisada no sino de notificações (seção "Chatbot agendou horários", com nome do cliente, data e hora e motivo) e por e-mail. O e-mail vai para quem ficou com o pedido e para os administradores e gestores da organização. Membros comuns que não cuidam desse cliente não recebem.

De onde vêm os horários livres

O bot usa a agenda do FlakeDesk, a mesma do agendamento de reuniões:

  • o horário de trabalho de cada pessoa, configurado em Perfil → aba Agenda (quem não configurou usa o padrão: segunda a sexta, das 9h às 18h);
  • menos o que já ocupa a agenda dessa pessoa no FlakeDesk: reuniões marcadas e follow-ups previstos dos clientes dela (cada follow-up ocupa 30 minutos).

Detalhes:

  • Cada pedido ocupa 30 minutos. O bot oferece horários cheios (9:00, 10:00...), com pelo menos 2 horas de antecedência, para os próximos 14 dias.
  • Essas regras valem também na hora de registrar: se o cliente insistir num horário fora delas (daqui a uma hora, daqui a um mês, 15h30), o FlakeDesk não grava o pedido, mesmo que a pessoa esteja livre. O bot avisa o cliente e transfere para a equipe.
  • Se o card "Horário de atendimento" estiver configurado, o horário oferecido também precisa caber nele.
  • Compromissos que existem só no Google Agenda ou no Outlook não são considerados. Se a sua equipe marca reuniões direto no Google ou no Outlook, registre-as também no FlakeDesk (menu Calendário ou botão "Agendar reunião" no contato), ou confirme o horário com o cliente antes de dar o pedido como certo.

Quem atende o pedido

  • Cliente que já tem responsável (o campo "Responsável" do contato): o bot usa só a agenda dessa pessoa. Se ela não tiver horário livre, o bot avisa o cliente que a equipe vai entrar em contato e transfere a conversa.
  • Cliente sem responsável (é o caso dos clientes que o bot cadastra sozinho pelo WhatsApp e pelo chat do site): o bot usa a escala de agendamento. Um horário entra na lista se pelo menos uma pessoa da escala estiver livre.
  • Quem fica com o pedido passa a ser o responsável pelo cliente. Se mais de uma pessoa da escala estiver livre, fica quem tem menos compromissos naquele dia.

Para montar a escala:

  1. Abra Administração → Configurações → Chatbot, aba Geral.
  2. No card Agendamento automático, ligue "Bot pode registrar pedidos de reunião".
  3. Em "Quem atende os pedidos", marque as pessoas da equipe que podem receber esses pedidos. Se ninguém estiver marcado, vale a equipe toda.
  4. Clique em Salvar configurações.

Quem é inativado na equipe, ou tem a conta bloqueada, sai da escala sozinho.

Regras e proteções

  • É um pedido de reunião: o bot deixa claro ao cliente que a equipe vai confirmar. A equipe pode ajustar ou excluir o follow-up normalmente pelo cadastro do contato.
  • Datas no passado ou inválidas nunca são registradas. Se o horário for ocupado enquanto o cliente decidia, ou em qualquer outra falha, o bot avisa o cliente e transfere para a equipe em vez de fingir que agendou.
  • No chat do site, o bot pede nome e telefone antes de registrar o pedido: o cliente é cadastrado automaticamente e o pedido fica vinculado a ele. Se o telefone informado já for de um cliente seu (no cadastro ou no WhatsApp dele), o bot não registra o pedido pelo chat do site: o visitante não é verificado, então ele transfere para a equipe confirmar quem é (veja "Chatbot no site (widget)" abaixo).
  • Um pedido em aberto por cliente. Se o cliente já tem um pedido do bot que ainda não aconteceu e que a equipe não concluiu nem excluiu, um segundo pedido (ou uma remarcação) vai para a equipe: o bot avisa o cliente e transfere a conversa, e quem atende vê o pedido que já existe.
  • Cliente retido pelo limite de contatos do plano não recebe pedido pelo bot: a conversa vai para a equipe.
  • Desligar o agendamento, mudar a escala ou o horário de atendimento vale na hora, inclusive para uma conversa em andamento: o FlakeDesk relê a configuração no momento de gravar o pedido.
  • Para evitar abuso, o bot registra no máximo 30 pedidos por hora em cada organização. Passado esse número, ele avisa o cliente que a equipe vai confirmar o horário e transfere a conversa.
  • Google Agenda e Outlook: o pedido também é criado na agenda Google e/ou Outlook da pessoa que ficou com ele, se ela tiver conectado a agenda em Perfil → aba Calendários. Sem agenda conectada, fica só no FlakeDesk.
  • O bot não vê nomes nem compromissos da agenda: ele recebe só a lista de horários livres. Os dados dos seus clientes continuam fora do alcance dele.
  • Teste na aba Testar o bot: o playground consulta a agenda de verdade e mostra o horário que o bot registraria, sem criar nada no CRM.

Problemas comuns

  • "O bot diz que não há horário livre." Confira o horário de trabalho das pessoas da escala (Perfil → aba Agenda) e se elas estão ativas na equipe. Se o cliente já tem responsável, só a agenda dele conta.
  • "O bot ofereceu um horário em que eu tinha reunião." Essa reunião provavelmente existe só no Google ou no Outlook. Registre-a no FlakeDesk para ela ocupar a agenda.
  • "Não recebi o e-mail." O e-mail vai para quem ficou com o pedido e para administradores e gestores. Membros comuns que não cuidam do cliente só ficam sabendo quando o cliente passa a ser deles.

Busca na web (opcional)

Por padrão o bot responde somente com a base de conhecimento. Se quiser, você pode permitir que ele busque na internet as perguntas que a base não cobre — útil para informações públicas (ex.: conteúdo do site da sua empresa) sem precisar copiar tudo para a base.

Como configurar: /admin/settings/chatbot → aba Geral → card Busca na web. Três modos:

  • Desligada (padrão) — o bot usa só a base de conhecimento.
  • Somente sites autorizados (recomendado) — o bot busca apenas nos domínios que você listar (até 10; ex.: minhaempresa.com.br). Digite o domínio e pressione Enter; salve as configurações.
  • Web aberta — o bot pode buscar em qualquer site público. Use com cautela: a internet pode conter informações desatualizadas ou incorretas.

Regras de segurança (valem em qualquer modo):

  • A busca na web só acontece quando a base de conhecimento não tem a resposta — a sua base sempre tem prioridade.
  • Ao usar informação da web, o bot cita a fonte (ex.: "segundo o site...").
  • O bot nunca afirma preços, prazos ou condições da sua empresa com base na web — isso só sai da base de conhecimento; na dúvida, ele transfere para a equipe.
  • Há um limite diário de buscas por organização (proteção de custo); estourando, o bot volta a responder só com a base.

Provedor de busca (padrão ou sua própria conta)

Com a busca ligada, o box Provedor de busca permite escolher quem executa as buscas:

  • Padrão FlakeDesk — usa o provedor mantido pela plataforma, sem configurar nada.
  • Tavily (minha chave) ou Brave (minha chave) — a busca roda na SUA conta do provedor, com a sua chave de API. A chave fica criptografada no banco e nunca é exibida de volta (o campo mostra só uma máscara, ex.: tvly...9x2a); para trocar, basta colar uma nova. Onde criar a chave: Tavily em app.tavily.com (plano gratuito com 1.000 buscas/mês) e Brave em api-dashboard.search.brave.com (2.000 buscas/mês grátis).

Regras: ao escolher Tavily/Brave, a chave é obrigatória (o salvar avisa se faltar); trocar de provedor exige informar a chave do novo (a anterior é descartada); voltar para "Padrão FlakeDesk" remove a sua chave do banco. Se o aviso "o provedor padrão do FlakeDesk não está disponível neste ambiente" aparecer, escolha Tavily ou Brave com a sua própria chave — a busca funciona normalmente por ela.

Chatbot no site (widget)

Com o canal Chat do site ligado, o widget de WhatsApp que você já instala no seu site (Administração → Configurações → WhatsApp → "Chat do WhatsApp no seu site") muda automaticamente de um formulário para uma janela de conversa com o bot — o mesmo endereço de script, sem trocar nada no site (a mudança aparece em até 5 minutos, pelo cache do script).

  • Antes da primeira mensagem, o widget pede nome e e-mail (os dois são obrigatórios), para sua equipe ter como retornar o contato. Quem já conversou e volta ao site continua a conversa sem preencher de novo. O nome e o e-mail aparecem no cabeçalho da conversa no Atendimento. Eles ficam só na conversa: não criam contato no CRM nem gastam o limite de contatos do plano, e, como não são verificados, nunca abrem o cadastro de um cliente que já exista. O bot não precisa mais perguntar o nome; no momento oportuno ele pede o WhatsApp — ao informar um telefone NOVO, um lead é criado automaticamente no CRM.
  • Telefone que já é de um cliente seu não é vinculado sozinho. O visitante do site é anônimo e o telefone digitado não é verificado: qualquer pessoa poderia digitar o número de um cliente. Por isso a conversa guarda o telefone informado, mas não abre o cadastro nem o histórico desse cliente. Vale tanto para o telefone do cadastro quanto para o número de WhatsApp com que o cliente já conversou com você (inclusive com ou sem o 55 e o nono dígito), mesmo que o cadastro mostre outro telefone depois de uma mesclagem de duplicados. Antes de tratar a pessoa como o mesmo cliente, confirme a identidade (por exemplo, continuando a conversa pelo WhatsApp dele). Mensagens do formulário do site aparecem no Atendimento com a etiqueta "via site · telefone não verificado" pelo mesmo motivo. Quando o número digitado no formulário já é de um contato seu, a mensagem entra no histórico dele marcada como "[Telefone não verificado]", não conta como atividade (a "última interação" do contato não muda) e não dispara automações, porque nada prova que foi o cliente quem escreveu.
  • O link "Continuar no WhatsApp" leva o visitante ao aplicativo com um código #ref_... na primeira mensagem: quando ela chega, o CRM vincula a conversa do site à conversa de WhatsApp e o bot continua de onde parou (sem fazer o cliente repetir tudo).
  • Quando o bot transfere um atendimento do site para a equipe, sua equipe responde o visitante direto pelo Atendimento (a conversa do site aparece lá com o selo "Chat do site"), e a resposta chega na janelinha do site em segundos. O visitante também pode migrar para o WhatsApp pelo link, se preferir.
  • A conversa do site usa a mesma base de conhecimento e a mesma cota mensal de mensagens do bot.
  • Nome exibido pelo bot: o assistente se apresenta com o nome verificado da sua conta Meta (o mesmo do cabeçalho do widget); se não houver, usa o nome da organização (Administração → Configurações → Organização, aba Organização). Para personalizar totalmente, escreva sua própria mensagem de saudação na aba Persona. Atenção: a saudação fica gravada na sessão do visitante. Depois de mudar nome ou saudação, teste em uma janela anônima (a sessão antiga do seu navegador mantém a saudação antiga).

Como o bot assina as mensagens

Toda mensagem do chatbot no WhatsApp, Instagram e Messenger sai assinada como "Assistente virtual" na primeira linha (em negrito no WhatsApp). Assim o cliente sabe que está falando com um atendente virtual, e percebe a troca quando alguém da equipe assume, porque as respostas humanas saem com o primeiro nome do atendente. O interruptor "Assinar as respostas do Atendimento" (Administração → Configurações → Organização, aba Organização) desliga só a assinatura das respostas da equipe: a do chatbot não desliga.

O que o chatbot não pode fazer (regras de uso)

O chatbot usa inteligência artificial de provedores como o Google Cloud, e a seção 5.1 dos Termos de Uso repassa à sua organização as regras desses provedores. Elas valem para o WhatsApp, o Instagram, o Messenger e o chat do site:

  • Público menor de 18 anos: não ligue o bot. O chatbot não pode atender em site, número ou canal voltado a menores de idade, ou que provavelmente seja usado por eles, como o canal de alunos de uma escola ou de um curso para adolescentes. Nesses canais, deixe o bot desligado e atenda com a equipe.
  • Saúde: só informação administrativa. Em clínicas, consultórios e laboratórios o bot pode informar endereço, horários, convênios e serviços oferecidos, e pode agendar. Ele não pode dar diagnóstico, fazer triagem, orientar sobre sintomas, remédios ou tratamento, nem substituir o profissional de saúde. Deixe isso claro nas Instruções de tom e comportamento (por exemplo: "Não responda perguntas sobre sintomas, remédios ou tratamento; transfira para a equipe.") e não coloque orientação de saúde nos documentos da base de conhecimento visíveis aos clientes.
  • O bot não se passa por pessoa. Não peça nas instruções que o bot diga que é humano nem que negue ser um assistente virtual quando o cliente perguntar. A assinatura "Assistente virtual" (seção anterior) identifica o bot em toda mensagem e não pode ser desligada.
  • Conteúdo proibido. Nada de mensagens enganosas, golpes, discriminação, assédio ou conteúdo que viole direitos de terceiros. Também não use o bot para levantar dados sensíveis dos clientes (como saúde, religião, orientação sexual ou opinião política) sem base legal.
  • O bot pode errar. Ele responde com o que você cadastrou, mas a IA pode interpretar mal uma pergunta. Teste na aba Testar o bot, acompanhe as conversas no Atendimento e corrija a base de conhecimento quando achar uma resposta errada. A sua organização responde pelas informações e instruções que cadastra para o bot.

O que acontece se uma regra não for seguida: o FlakeDesk pode suspender na hora os recursos de IA da organização, no todo ou em parte, avisando o administrador, e em casos graves a própria conta (Termos de Uso, seções 5 e 12). Essas regras vêm dos termos dos provedores de IA que o FlakeDesk usa, e descumpri-las põe em risco o serviço de IA de todos os clientes.

Alerta quando o bot transfere para a equipe

Sempre que o bot transfere uma conversa para atendimento humano, aparece um alerta no sino de notificações (topo do menu): seção "Chatbot pediu atendimento humano", com o nome do cliente e a última mensagem. Clique para abrir a conversa direto na inbox. O alerta some sozinho quando alguém da equipe responde (ou quando a conversa é devolvida ao bot) e é criado de novo se o bot transferir outra vez. Assumir a conversa manualmente pelo botão não gera alerta — você já está ciente.

Por que o bot não respondeu esta conversa?

Regra de ouro: conversa com histórico humano fica com o humano — depois que alguém da equipe responde (ou assume), o bot para de responder naquela conversa e nunca reassume sozinho. O estado fica visível no topo da conversa aberta:

  • Selo roxo "Bot atendendo": o bot responde esta conversa; o botão "Assumir conversa" passa para a equipe.
  • Selo cinza "Bot desligado (atendimento humano)": a equipe conduz; o bot não responde. O botão "Devolver ao bot" reativa o assistente nesta conversa — disponível nos quatro canais (WhatsApp, Instagram, Messenger e chat do site).

Outros motivos para o bot não responder: canal desativado na configuração do chatbot, modo "somente fora do horário de atendimento" dentro do horário da equipe, cota mensal esgotada — e, no caso de Instagram/Messenger, o canal desconectado (aviso âmbar no card "Instagram & Messenger" em Configurações; sem conexão, a mensagem nem chega ao FlakeDesk).

Inbox unificada, fila de espera e atribuição

A tela Atendimento (menu Comunicação → Atendimento) mostra os canais juntos: conversas de WhatsApp, Instagram Direct, Messenger e do chat do site (selo azul "Chat do site" 🌐). Para responder um visitante do site, basta selecionar a conversa e digitar: a mensagem aparece na janelinha do site dele em alguns segundos (só texto; sem mídia nem templates, que são recursos do WhatsApp). Responder no chat do site, no Instagram e no Messenger é recurso dos planos Premium e Platinum, os mesmos do chatbot. Se a organização voltar a um plano menor, as conversas continuam visíveis para leitura, mas no lugar do campo de resposta aparece o aviso para alterar o plano (para quem não é administrador, o aviso orienta pedir a troca ao administrador). Nesses planos menores, o botão Devolver ao bot também não aparece, porque não há bot para atender.

  • Fila de espera: conversas que o bot transferiu e ainda não receberam resposta ficam no topo da lista, destacadas em âmbar com o ícone de mão ✋ ("Aguardando atendimento").
  • Atribuição: o botão "Atribuir a mim" marca você como responsável pela conversa (e responder uma conversa do site sem responsável atribui automaticamente a você). Assim que alguém assume, a conversa sai do destaque de "aguardando atendente" e o botão passa a mostrar "Remover atribuição", para devolvê-la à fila. Vale para WhatsApp, Instagram, Messenger e chat do site.
  • Transcrição no histórico: quando o bot transfere (ou uma conversa do site é encerrada por inatividade), a transcrição do atendimento do bot é gravada como interação no cadastro do lead — abra o contato para ver o resumo.
  • Encerramento automático: conversas do site paradas há mais de 24 horas são encerradas com uma mensagem de despedida do bot.
  • Depois de encerrada: o widget mostra o botão "Iniciar nova conversa" — o visitante recomeça do zero (nova sessão, nova saudação), sem precisar limpar nada no navegador. Encerrar uma sessão na inbox nunca deixa o visitante sem saída.

Assumir e devolver conversas (inbox)

No Atendimento (menu Comunicação → Atendimento):

  • Conversas conduzidas pelo bot mostram o selo "Bot atendendo" (ícone 🤖 roxo) na lista e no topo da conversa; as mensagens do bot aparecem em roxo com a etiqueta "Bot".
  • Assumir conversa: botão no topo da conversa — o bot silencia na hora. Enviar qualquer mensagem manual (texto, mídia ou template) também silencia o bot automaticamente.
  • Devolver ao bot: botão disponível em conversas em atendimento humano (com o chatbot ligado) — o bot volta a responder as próximas mensagens.

Cota mensal de mensagens

  • Premium: 1.000 · Platinum: 5.000 mensagens de bot por organização por mês. A cota renova todo dia 1º.
  • Contam apenas respostas geradas pelo bot. Mensagens dos seus clientes e da sua equipe não contam.
  • Acompanhe o consumo na aba Consumo da tela do chatbot — que também mostra as métricas do mês: taxa de deflexão (conversas resolvidas sem humano), conversas atendidas, mensagens por canal e transferências por motivo.
  • Ao atingir a cota, o bot para de responder e transfere as novas conversas para a equipe — nenhum cliente fica sem resposta. Para ampliar a cota, fale com o suporte sobre o plano Platinum.

Custos do WhatsApp (Meta)

As respostas do bot são enviadas dentro da janela de 24 horas (o cliente acabou de escrever), portanto sem custo de template da Meta. O bot não envia templates pagos nem inicia conversas.

Problemas comuns

  • O bot não responde: confira, nesta ordem — (1) plano é Premium/Platinum?; (2) o canal (WhatsApp / Instagram / Messenger) está LIGADO em /admin/settings/chatbot?; (3) a conta está conectada e enviando normalmente (teste manual pela inbox)?; (4) a conversa já teve atendente humano? (aí é esperado — use "Devolver ao bot"); (5) a cota mensal acabou? (aba Consumo). Para Instagram/Messenger há um passo extra: se você reconectou a Página/conta recentemente, mande uma mensagem nova — a primeira mensagem após a reconexão religa a conversa à conta atual e o bot volta a responder.
  • O bot respondeu "vou verificar com a equipe" para algo que ele deveria saber: a informação não está na base de conhecimento. Adicione um documento em /admin/settings/ai com o conteúdo e tente de novo (a indexação é imediata ao salvar). Se a informação está pública no seu site, outra opção é ligar a busca na web no modo "Somente sites autorizados" com o seu domínio.
  • O bot demora ~8 segundos para responder: é proposital — ele espera o cliente terminar de digitar mensagens em sequência para responder tudo de uma vez.
  • Quero que o bot pare em uma conversa específica: clique em "Assumir conversa" ou simplesmente responda manualmente.
  • Recebi o alerta "Chatbot pediu atendimento humano": um cliente está esperando uma pessoa. Abra a conversa pelo próprio alerta e responda — o alerta desaparece sozinho ao responder.
  • Quero desligar o bot por completo: /admin/settings/chatbot → aba Geral → desligue o canal WhatsApp. As conversas em andamento passam para a equipe.

Chatbot e automações juntos

O chatbot e o motor de automações podem rodar juntos, mas fazem coisas diferentes:

  • O chatbot conversa com o cliente no canal (WhatsApp, Instagram, Messenger e chat do site), respondendo a cada mensagem que chega.
  • As automações reagem a eventos do CRM (lead capturado, mudou de estágio, sem interação há N dias, entre outros). Elas organizam o CRM (adicionar tag, mover no funil, atribuir responsável, criar follow-up, registrar nota, notificar a equipe) e também podem falar com o cliente por dois caminhos: Enviar template de e-mail e Enviar template de WhatsApp (um template aprovado pela Meta).

Como os dois se encontram:

  • Template de WhatsApp enviado por automação não silencia o bot. Ele não conta como resposta de um atendente: se o cliente responder ao template, o bot continua atendendo a conversa (a menos que alguém da equipe tenha assumido).
  • Cuidado com regras que falam com o cliente na hora em que ele escreve. Uma regra "Lead capturado pelo WhatsApp → enviar template de WhatsApp" sem espera manda o template quase junto com a resposta do bot, e o cliente recebe as duas mensagens. Use o template de WhatsApp para acompanhamento: com espera de alguns dias, ou com o gatilho "Sem interação há N dias". As travas da ação também ajudam: no máximo 1 template automático por contato a cada 24 horas e a opção "Não enviar se o contato respondeu depois que a automação começou", ligada por padrão.
  • As mensagens do bot também viram interação. A resposta do bot no WhatsApp e a transcrição gravada quando o bot transfere a conversa entram no histórico do contato e, como qualquer interação, podem acionar regras com o gatilho "Interação registrada". Se você usa esse gatilho com o chatbot ligado, use condições para a regra não agir a cada mensagem.
  • Não há laço infinito. A interação que a própria automação registra (nota, follow-up, e-mail ou template enviado) não aciona o gatilho "Interação registrada", uma regra nunca dispara de novo pelo que ela mesma causou e cada evento tem um limite de ações.

Na prática: deixe o bot atender e use as automações para organizar o CRM e para os acompanhamentos (lembretes, reativação, cadência pós-proposta). Detalhes da ação no guia "Automações", seção "Enviar template de WhatsApp por automação".

Instagram Direct e Messenger (omnichannel)

Além do WhatsApp e do chat do site, o mesmo chatbot atende no Instagram Direct e no Facebook Messenger (planos Premium/Platinum). É o mesmo cérebro: mesma base de conhecimento, mesma persona, mesma cota mensal de mensagens do bot.

  • Ligar os canais: /admin/settings/chatbot → aba Geral → ligue Instagram Direct e/ou Facebook Messenger. Isso ativa o bot, mas as mensagens só chegam depois de conectar a Página.
  • Conectar a conta: em Configurações → Instagram & Messenger (/admin/settings/channels). São duas conexões independentes (é assim que a Meta organiza hoje): o Facebook habilita o Messenger (via Página do Facebook) e o Instagram habilita o Instagram Direct (via Instagram Business Login, que já não depende da Página). Para atender nos dois canais, faça as duas conexões — cada uma aparece como um cartão separado na tela (um "Página do Facebook" com o Messenger; outro "Instagram Direct" com o Instagram). Cada botão abre um popup e, ao autorizar, a janela fecha sozinha e você permanece no CRM (não há redirecionamento de página). Formas de conectar:
    • Conectar com o Facebook (1 clique) / Conectar com o Instagram (1 clique) — você entra e autoriza; o FlakeDesk cuida do resto (busca as Páginas/conta, vincula e assina os webhooks). Esse é o jeito recomendado. Enquanto o app está em análise na Meta, os botões podem aparecer como "aguardando liberação" — nesse caso, use a conexão manual abaixo.
    • Conexão manual (avançada) — cole o ID da Página e um token de acesso da Página (Page Access Token) gerado no painel de desenvolvedor da Meta (e, opcionalmente, o ID e o token do Instagram para responder no Direct). Nessa tela também dá para ligar/desligar cada canal e desconectar. No cartão da Página, o toggle do Instagram Direct só aparece se houver uma conta do Instagram vinculada àquela Página.
  • Captura de lead: toda mensagem recebida vira um lead automaticamente (com a tag "Captado por Instagram/Messenger"), deduplicado pelo identificador do canal.
  • Inbox unificada: as conversas de Instagram (ícone rosa) e Messenger (ícone azul) aparecem na mesma inbox, a tela Atendimento (/whatsapp), junto do WhatsApp e do chat do site. Sua equipe pode assumir e responder manualmente — respeitando a janela de 24 horas da Meta (só dá para responder manualmente até 24h após a última mensagem do cliente).
  • Limitações do v1: nesses canais o bot responde texto (mídia recebida é registrada, mas o envio de mídia e o agendamento automático ficam para uma próxima versão).
  • Requisitos, regras da Meta e solução de problemas (conta profissional do Instagram, "Permitir acesso às mensagens", popup bloqueado, mensagens que não chegam, janela de 24 h sem template, tokens que expiram): guia "Instagram Direct e Messenger — conexão, regras e solução de problemas".

Endereços úteis

O quê Onde
Configurar o chatbot (e ligar Instagram/Messenger) /admin/settings/chatbot
Conexão do Instagram & Messenger (token de Página) /admin/settings/channels
Base de conhecimento (o que o bot sabe) /admin/settings/ai
Conexão do WhatsApp /admin/settings/whatsapp
Atendimento, a inbox unificada (WhatsApp + site + Instagram + Messenger) /whatsapp

Veja também