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)
- 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.
- Acesse Administração → Configurações → Chatbot de atendimento (URL:
/admin/settings/chatbot). Somente admins da organização veem esta tela. - 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).
- 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.
- (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.
- Clique em Salvar configurações.
- 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. - 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:
- 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.
- 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.
- O bot confirma com o cliente ("Posso confirmar quinta, 14/08, às 15h?") antes de concluir.
- 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.
- 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:
- Abra Administração → Configurações → Chatbot, aba Geral.
- No card Agendamento automático, ligue "Bot pode registrar pedidos de reunião".
- Em "Quem atende os pedidos", marque as pessoas da equipe que podem receber esses pedidos. Se ninguém estiver marcado, vale a equipe toda.
- 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 emapp.tavily.com(plano gratuito com1.000 buscas/mês) e Brave em2.000 buscas/mês grátis).api-dashboard.search.brave.com(
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/aicom 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
- WhatsApp no FlakeDesk: Inbox, janela de 24 horas e avisos de mensagem nova.
- Instagram Direct e Messenger: Conexão, regras e problemas dos dois canais.
- Automações: Regras do tipo "se X então Y".
- Assistente de IA: O botão Perguntar ao FlakeDesk e as sugestões de IA.