WhatsApp no FlakeDesk
O FlakeDesk integra com o WhatsApp Business Platform (Cloud API oficial da Meta) — as conversas do número oficial da sua organização chegam na inbox do CRM e viram leads automaticamente.
Conectar o número
A conexão do número oficial está disponível nos planos Starter, Premium e Platinum (no período de teste você já pode conectar — o trial dá a experiência Premium completa). No plano Free a tela mostra um aviso com o atalho para upgrade; se a organização voltar ao Free depois, o histórico de conversas continua visível — apenas conectar e responder ficam bloqueados.
Antes de conectar: escolha o caminho conforme o seu número. Se ele já está no aplicativo WhatsApp Business do celular (o aplicativo verde com a letra B) e você quer continuar usando o celular, veja a seção "Trazer as conversas do celular (coexistência)" mais abaixo. Se ele está no WhatsApp comum ou você prefere um número só para a API oficial, use outro número (fixo ou chip novo, que só precisa receber um código por SMS ou ligação) ou exclua a conta no aplicativo antes de conectar (faça backup antes). Nos dois caminhos você precisa ser administrador do Portfólio empresarial (Business Manager) da empresa na Meta. Detalhes e problemas comuns de conexão no guia "WhatsApp e Meta — guia prático".
Um administrador acessa Administração → Configurações → WhatsApp. Quando disponível no ambiente, o caminho recomendado é a Conexão rápida com a Meta: clique em "Conectar com a Meta", conclua o cadastro na página segura da própria Meta (login, escolha do negócio e verificação do número por SMS) e volte ao FlakeDesk já conectado — sem copiar credenciais. Se o número já tinha PIN de verificação em duas etapas, a tela pede o PIN de 6 dígitos para concluir o registro.
Alternativamente, o modo avançado (bloco recolhido na mesma tela, para empresas com app Meta próprio) permite informar as credenciais manualmente: WABA ID, Phone Number ID, token de acesso e segredo do app — tudo criptografado. Nesse modo a tela mostra a URL de webhook a cadastrar no painel da Meta e um passo a passo; o caminho completo de cada valor no painel atual da Meta está no guia "WhatsApp e Meta — guia prático", seção "Modo avançado: onde encontrar cada valor na Meta".
Guia detalhado de configuração na Meta
Dúvidas de configuração do lado da Meta — criar modelo de mensagem (com URLs e passo a passo), redefinir PIN de duas etapas, forma de pagamento, limites/qualidade do número e problemas comuns — estão no guia "WhatsApp e Meta — guia prático (passo a passo detalhado)".
Trazer as conversas do celular (coexistência)
Se você já atende pelo aplicativo WhatsApp Business no celular, dá para conectar o mesmo número ao FlakeDesk sem desligar o aplicativo e sem perder as conversas: o celular continua funcionando e, aqui, aparecem as conversas individuais dos últimos 6 meses e a lista de contatos do número. É opcional: quem prefere um número só para a API oficial segue o caminho de "Conectar o número" acima. Quando a sua organização ainda não tem número conectado, a tela de conexão faz a pergunta "O número está no aplicativo WhatsApp Business do celular?" e mostra só o caminho que vale para a sua resposta.
Antes de começar
- O número precisa estar no aplicativo WhatsApp Business (o aplicativo verde com a letra B, não o WhatsApp comum), atualizado na versão mais recente da loja do seu celular.
- Deixe o celular com você: durante a conexão a Meta pede para ler um código no aplicativo.
- Você precisa ser administrador da organização no FlakeDesk e da empresa na Meta (Portfólio empresarial).
- Plano Starter, Premium ou Platinum (ou período de teste), como na conexão normal.
- Página do Facebook e Instagram ligados ao aplicativo: se o WhatsApp Business do celular estiver ligado a uma Página do Facebook ou a um Instagram (no aplicativo, em Configurações → Ferramentas comerciais → Facebook e Instagram), a Meta coloca a conta no portfólio dono dessa Página. Ligue o aplicativo só à Página da sua própria empresa. Se ele estiver ligado à Página de outra empresa (de uma agência, por exemplo), desligue antes de conectar.
Passo a passo
- No FlakeDesk, abra Administração → Configurações → WhatsApp e entre na aba Conexão.
- Responda Sim, já uso o aplicativo à pergunta "O número está no aplicativo WhatsApp Business do celular?". No cartão Conectar o número do aplicativo WhatsApp Business, leia os avisos e clique em Conectar o aplicativo WhatsApp Business. Abre uma janela da Meta (se nada abrir, libere pop-ups para o FlakeDesk).
- Na janela da Meta, entre com a sua conta do Facebook e clique em Continuar.
- Na tela Adicione seu número de telefone do WhatsApp, deixe Insira um novo número de telefone, informe o número do seu aplicativo e clique em Avançar. A tela mostra as opções SMS e ligação, mas, como o número está no aplicativo, a Meta reconhece isso e passa para a confirmação pelo aplicativo.
- Confira os dados do perfil do número e avance.
- Na tela Selecione os ativos de negócios, confira o Portfólio empresarial: ele tem que ser o da sua empresa. Se aparecer o portfólio de outra empresa, ou se ele vier travado num portfólio que não é o seu, veja o erro comum "A tela de portfólio vem travada" abaixo.
- A Meta mostra um código QR: no celular, abra o WhatsApp Business, toque no menu, escolha a opção de conectar a uma plataforma de negócios e leia o código.
- Quando a Meta perguntar se deseja compartilhar o histórico de conversas, escolha compartilhar (a opção de não compartilhar também conecta, mas não traz nada do passado).
- Confira o nome da conta e o fuso horário e conclua a janela. O FlakeDesk mostra "Conectado" e o cartão passa a acompanhar o histórico.
O que aparece depois
- Os contatos do número chegam primeiro e, em seguida, as conversas. O cartão mostra o andamento em porcentagem. Costuma levar de alguns minutos a algumas horas, conforme o tamanho do histórico; você pode usar o FlakeDesk normalmente enquanto isso.
- Cada conversa trazida vira um contato (lead) marcado com a etiqueta Importado do WhatsApp, para você filtrar depois. Conversas antigas não geram aviso no sino, nem som, nem resposta do atendente virtual, nem automações: elas só ficam disponíveis para consulta.
- Fotos, áudios, vídeos e documentos vêm apenas dos últimos 14 dias e são baixados aos poucos, em segundo plano. Mensagens mais antigas chegam só com o texto.
- O que você escrever pelo celular passa a aparecer na conversa do FlakeDesk com o selo Enviada pelo aplicativo, e a conversa passa para atendimento humano (o atendente virtual não responde por cima de você).
O que muda no aplicativo do celular
- Grupos não aparecem no FlakeDesk e continuam só no celular.
- Mensagens temporárias e de visualização única ficam desativadas nas conversas individuais.
- As listas de transmissão do aplicativo ficam somente para leitura.
- O WhatsApp Web e outros aparelhos vinculados são desconectados; você pode vinculá-los de novo depois.
Limite do plano: como cada conversa vira um contato, o limite de contatos do seu plano vale aqui. O que passar do limite fica guardado e bloqueado, sem ser apagado, e volta sozinho quando você fizer upgrade.
Significado de cada estado do cartão
- Histórico ainda não solicitado: a conexão foi feita, mas o pedido ao histórico ainda não saiu.
- Histórico solicitado. Aguardando a Meta enviar: o pedido foi feito; a Meta costuma começar a enviar em poucos minutos.
- Importando histórico: N%: em andamento.
- Histórico importado: terminou.
- Você escolheu não compartilhar o histórico: veja o primeiro erro comum abaixo.
- Não foi possível pedir o histórico à Meta: o pedido falhou. O botão Tentar de novo aparece nesse caso, no de recusa e quando o pedido está sem resposta há muitas horas.
Prazo de 24 horas: a Meta só aceita o pedido de histórico nas primeiras 24 horas depois de conectar. Se o prazo passar, o botão "Tentar de novo" não resolve; faça o procedimento do erro "passou de 24 horas".
Erros comuns e como resolver
- Escolhi não compartilhar o histórico (estado "recusado"): a Meta não pergunta duas vezes. No celular, abra o WhatsApp Business e vá em Configurações → Conta → Plataforma de negócios, desconecte a conta, volte ao FlakeDesk e repita o passo a passo, desta vez escolhendo compartilhar o histórico.
- Passou de 24 horas e o histórico não veio: o mesmo caminho, desconectar pelo celular em Configurações → Conta → Plataforma de negócios e conectar de novo no FlakeDesk. O pedido é refeito do zero e o que já tinha chegado não é duplicado.
- "A Meta não aceitou o pedido do histórico" (ao clicar em Tentar de novo): tente de novo em alguns minutos. Se já passaram 24 horas da conexão, siga o item anterior.
- A Meta diz que o número está no WhatsApp comum, ou não reconhece o aplicativo: instale o WhatsApp Business, migre a conta para ele e atualize o aplicativo; depois tente de novo. Se o número já estava conectado só à API oficial (sem aplicativo no celular), desconecte-o na tela do FlakeDesk, volte a usar o número no WhatsApp Business e refaça a conexão por este caminho.
- "Este número já está registrado na API oficial do WhatsApp": o número não está no aplicativo WhatsApp Business (por exemplo, já é usado só pela API em outro lugar). Nada foi alterado no número. Use um número que esteja no aplicativo, ou, para um número só da API, o botão Conectar com a Meta da conexão rápida.
- A Meta diz que o número não está qualificado (erro 3441045): a Meta só libera a coexistência para números com uso real e recente no aplicativo WhatsApp Business. Um número recém-criado ou parado pode ser recusado por alguns dias. Use o aplicativo normalmente, trocando mensagens com clientes, e tente de novo depois.
- A tela de portfólio vem travada num portfólio que não é o da sua empresa (às vezes seguida do erro 1690130, "não é uma identificação da empresa válida"): a conta do número ficou associada ao portfólio de outra empresa, quase sempre porque o aplicativo foi ligado a uma Página do Facebook ou a um Instagram dela. Feche a janela e, no celular: (1) em Configurações → Ferramentas comerciais → Facebook e Instagram, desligue a Página e o Instagram que não são da sua empresa; (2) em Configurações → Conta → Plataforma de negócios, desconecte. Se o número aparecer nas contas do WhatsApp desse outro portfólio (Configurações da empresa → Contas → Contas do WhatsApp, no Business Suite), quem o administra precisa removê-lo de lá. Espere 15 minutos e repita o passo a passo, escolhendo o portfólio da sua empresa.
- O QR não é lido: aumente o brilho da tela, aproxime o celular e confira se o aplicativo está atualizado.
- Aviso "WhatsApp desconectado" no sino: alguém desconectou a conta pelo celular. O FlakeDesk deixa a conexão desativada e avisa os administradores; para voltar, conecte de novo pela aba Conexão.
- Aviso "Mensagens do WhatsApp fora do Atendimento" no sino: a conexão foi desligada no FlakeDesk (botão Desconectar), mas o número continua ligado ao FlakeDesk na Meta, então as mensagens dos clientes continuam chegando e não aparecem no Atendimento. O aviso chega aos administradores uma vez por dia enquanto isso acontecer. Para voltar a receber, conecte de novo pela aba Conexão. Se a intenção era desligar de vez, desconecte também no celular (Configurações → Conta → Plataforma de negócios). As mensagens continuam no aplicativo do celular.
- Conversas que não aparecem: confira se não são grupos, e se o seu plano não passou do limite de contatos (contatos guardados voltam com o upgrade).
Reconectar: em uma conta conectada por coexistência a tela não mostra o botão "Reconectar" da conexão rápida, porque ele tentaria registrar o número na API e tiraria o número do aplicativo. Para refazer a conexão, desconecte pelo celular (Configurações → Conta → Plataforma de negócios) e conecte de novo pelo cartão da coexistência.
Desconectar ou trocar de tipo de conexão: na aba Conexão, o cartão Desconectar o WhatsApp (no fim da aba) encerra a conexão atual. O FlakeDesk apaga as credenciais e, na coexistência, os nomes de contatos sincronizados; o histórico de conversas continua no CRM. Só existe uma conta de WhatsApp ativa por organização: conectar outro número também desativa a anterior, e conectar de novo o mesmo número apenas atualiza a conta. Na coexistência, o aplicativo WhatsApp Business do celular continua funcionando depois de desconectar. Desconectar no FlakeDesk não desliga o número na Meta: as mensagens que chegarem depois disso deixam de entrar no Atendimento, e os administradores recebem no sino o aviso "Mensagens do WhatsApp fora do Atendimento". Para desligar de vez, desconecte também no celular (Configurações → Conta → Plataforma de negócios). Já um número da conexão rápida continua registrado na API oficial da Meta depois de desconectar no FlakeDesk; para devolvê-lo ao aplicativo do celular, é preciso fazer isso na Meta.
Disponibilidade: a opção aparece na tela de conexão conforme a liberação gradual feita pela equipe FlakeDesk. Se você usa o aplicativo WhatsApp Business e não vê a pergunta, fale com o suporte.
Inbox
A tela Atendimento (menu Comunicação → Atendimento) lista as conversas do número conectado e, com o chatbot ligado, também as conversas do chat do site (selo "Chat do site"), que você responde na mesma tela; as conversas de Instagram e Messenger também aparecem ali. Se o telefone do remetente já existir nos seus contatos, a conversa é vinculada ao contato existente: a comparação ignora formatação, o código do país (55) e o nono dígito de celulares brasileiros. Só quando não há contato correspondente é criado um novo, marcado como lead. Cada conversa mostra o histórico com texto, mídia (imagens, áudio, vídeo, documentos), reações e recibos de entrega e leitura. Áudios e vídeos tocam na própria conversa: aperte o play no player da mensagem. O link abaixo do player baixa o arquivo para o computador. O mesmo áudio também aparece, com player, no histórico de interações do contato. Em conversas longas a tela abre nas mensagens mais recentes; para ler o começo, clique em "Carregar mensagens anteriores" no topo da conversa (cada clique traz mais 100), o que vale também para Instagram, Messenger e chat do site. No topo da conversa, o menu ⋯ ("Mais ações") reúne as ações secundárias: "Abrir lead" leva ao contato e "Adicionar ao funil" coloca o lead da conversa em um ou mais funis existentes, escolhendo o estágio de entrada em cada um (funis onde ele já está aparecem marcados com o estágio atual). Funciona também nas conversas do chat do site que já viraram lead. Em conversas de Instagram e Messenger o mesmo menu traz "Encerrar conversa". O que muda o andamento do atendimento (assumir a conversa, devolver ao bot, atribuir a você) fica sempre visível na barra, sem menu.
A lista da esquerda tem um filtro por canal no topo: o filtro ativo aparece com o nome (por exemplo "Todos 12"), e os demais aparecem como ícone + contagem — passe o mouse para ver o nome do canal.
Transcrição das mensagens de voz
Nos planos Starter, Premium e Platinum (e no teste grátis), as mensagens de voz que os clientes mandam pelo WhatsApp são transcritas automaticamente: o texto aparece na conversa, embaixo do player do áudio, com o rótulo Transcrição. A equipe lê o que foi dito sem precisar ouvir, e o chatbot entende o pedido falado como se fosse escrito (inclusive para agendar um horário, quando o agendamento automático está ligado).
Como funciona:
- A transcrição começa sozinha quando o áudio chega. Enquanto ela roda, a conversa mostra "Transcrevendo…"; em poucos segundos o texto aparece (a tela atualiza sozinha; se demorar, clique em Atualizar).
- Só a mensagem de voz do cliente é transcrita (o áudio gravado no próprio WhatsApp). Arquivo de áudio anexado (MP3, M4A), áudios enviados pela sua equipe e mensagens trazidas do celular pela coexistência não são transcritos automaticamente.
- Áudios de até 5 minutos. Mais longos que isso continuam tocando normalmente, com o aviso "Áudio longo demais para transcrever (mais de 5 minutos): ouça pelo player".
- O texto também entra no histórico de interações do contato ("WhatsApp (áudio): ...") e é usado pelos botões de IA da conversa (resumo e sugestão de resposta).
- Áudio sem fala reconhecida (silêncio, ruído, música) aparece como "Sem fala reconhecida no áudio".
Botão "Transcrever": aparece em áudios recebidos que ficaram sem transcrição, por exemplo áudios que chegaram antes do recurso existir, os trazidos do celular pela coexistência e os que não foram transcritos por limite ou falha temporária. Clique nele e aguarde alguns segundos.
Limites: cada organização tem um teto de minutos de áudio transcritos por mês, conforme o plano (hoje: Starter 300 minutos, Premium 1.500 minutos, Platinum 5.000 minutos; no teste grátis vale o do Premium), e um teto de 30 áudios transcritos por contato a cada 24 horas, para proteger contra excesso de mensagens de um mesmo número. Passado o teto, o áudio continua tocando e a conversa mostra o motivo ("Limite de minutos de transcrição do mês atingido"); o botão Transcrever volta a funcionar quando o limite renova. Os áudios também contam no teto mensal de uso de IA da organização.
Ligar e desligar: o recurso vem ligado. Um administrador da organização pode desligar em Administração → Organização, aba Organização, interruptor Transcrever mensagens de voz do WhatsApp (e clicar em Salvar). Ele também fica desligado quando a IA da organização está desligada (Administração → Configurações → Assistentes de IA, interruptor Assistente de IA ativo nesta organização). Com a transcrição desligada, o chatbot passa as conversas com áudio para a equipe.
Privacidade: o áudio é transcrito pela IA da plataforma (Google Cloud Vertex AI, na conta do FlakeDesk, sem uso para treinar modelos), mesmo quando a sua organização usa a própria chave de IA (Claude ou ChatGPT) no assistente. A transcrição fica guardada com a conversa e segue as mesmas regras das mensagens. Detalhes na política de privacidade: https://flakedesk.com/privacidade.
Problemas comuns:
- A transcrição não aparece: confira se o interruptor está ligado (Administração → Organização) e se a IA da organização está ligada; veja se a conversa mostra algum motivo embaixo do áudio.
- "Limite de minutos de transcrição do mês atingido": o teto do plano acabou. Ele renova no início do mês; para um teto maior, um administrador pode trocar o plano em Administração → Plano e cobrança.
- "O serviço de transcrição não respondeu": falha temporária do provedor de IA. Clique em Transcrever de novo em alguns minutos.
Assinatura nas respostas
Cada resposta enviada ao cliente pelo Atendimento sai com o primeiro nome de quem respondeu antes da mensagem, como os atendimentos de grandes empresas fazem:
*Luciane:*
Por nada, bom final de semana!
- No WhatsApp o nome aparece em negrito; no Instagram e no Messenger aparece em texto simples (esses canais não têm negrito).
- Quando quem responde é o chatbot, a assinatura é "Assistente virtual" — o cliente sabe que está falando com um robô e percebe quando um atendente assume.
- O nome vem do cadastro do usuário (Perfil): é usado o primeiro nome.
- Na tela do Atendimento a mensagem aparece sem a assinatura, porque a equipe já vê quem enviou.
- Templates aprovados do WhatsApp não levam assinatura (a Meta exige o texto exatamente como aprovado). Em foto ou documento, a assinatura vai na legenda; sem legenda, sai sem assinatura.
- Para desligar a assinatura da equipe: Administração → Configurações → Organização, aba Organização, interruptor "Assinar as respostas do Atendimento" (só administradores). Vale para toda a organização. A assinatura "Assistente virtual" do chatbot continua mesmo com o interruptor desligado: o cliente precisa saber quando fala com um robô.
Avisos de mensagem nova
Quando chega mensagem em qualquer canal do Atendimento (WhatsApp, Instagram Direct, Messenger e chat do site), o FlakeDesk avisa na hora — sem precisar atualizar a página:
- Sino (topo direito): grupo "Mensagens recebidas", com o canal indicado pelo ícone. Clicar no item abre a conversa. Mensagem longa aparece cortada com "…" — passe o mouse em cima para ler o conteúdo completo. Marcar todas como lidas tira o destaque e zera os contadores; Limpar tudo remove os itens da lista (notificações novas voltam a aparecer normalmente).
- Badge no menu Atendimento: número de mensagens ainda não abertas.
- Contador na aba do navegador:
(2) FlakeDesk, estilo WhatsApp Web. - Aviso na tela (toast) com o nome do contato, um trecho da mensagem e o botão "Abrir conversas".
- Som e notificação do navegador, que você liga em Perfil → aba Notificações.
O aviso só é dispensado quando você está de fato usando o Atendimento: a tela está na aba ativa, a janela em foco e você mexeu no mouse ou teclado nos últimos 30 segundos. Se o FlakeDesk estiver atrás de outra janela, em outro monitor, ou até aberto na sua frente mas com você longe do computador (ex.: no celular), o aviso acontece normalmente.
Ao entrar no Atendimento, a conversa mais recente abre sozinha só para você não ver a tela vazia; isso não marca nada como lido. Para marcá-la como lida, clique nela na lista, mesmo que ela já esteja aberta no painel. Uma conversa deixa de contar como não lida quando você a abre de propósito, com a aba visível, a janela em foco e uma interação com mouse, teclado ou toque nos últimos 30 segundos. Se você deixar a conversa aberta e se afastar do computador, as mensagens novas continuam avisando; ao voltar a interagir, a conversa aberta passa a lida. Clicar no aviso individual do navegador também marca a mensagem daquele aviso como lida e abre a conversa.
Ligar som e notificação do navegador
- Clique no menu da sua conta (canto superior direito) e escolha Meu Perfil.
- Abra a aba Notificações.
- Ligue Tocar um som e/ou Notificação do navegador. Ao ligar a segunda opção, o navegador vai perguntar se autoriza — clique em Permitir.
- Use Testar alerta para conferir.
Essas duas opções valem só no navegador em que você as ligou (é o navegador que dá a permissão, não a sua conta) — se você usa o FlakeDesk em mais de um computador, ligue em cada um.
Não recebo a notificação do navegador. Se a tela mostrar "as notificações estão bloqueadas para este site", a permissão foi negada antes: clique no cadeado ao lado do endereço → Notificações → Permitir, recarregue a página e ligue de novo. O aviso do sistema aparece quando a janela do FlakeDesk está sem foco ou quando você está há 30 segundos sem interagir, mesmo com a janela à frente. Enquanto você usa outra tela do CRM ativamente, aparece o aviso na tela. Ativar a notificação do navegador não desliga os contadores do título, do menu ou do sino; eles também continuam funcionando se o navegador não conseguir exibir o pop-up.
Não ouço o som. O navegador só libera áudio depois que você interage com a página: clique em qualquer lugar do FlakeDesk uma vez após abrir a aba. Confira também se a aba não está no mudo (botão direito na aba → "Reativar som do site").
Janela de 24 horas
Pela regra da Meta, respostas em texto livre só podem ser enviadas até 24 horas após a última mensagem do cliente. Fora da janela, o FlakeDesk oferece o envio de template aprovado (crie templates no painel da Meta e cadastre-os em Templates de mensagem). Templates com cabeçalho de mídia pedem o arquivo no envio.
No envio, o FlakeDesk consulta a definição aprovada na Meta e monta as variáveis exatamente no formato aprovado — funciona tanto com variáveis numeradas ({{1}}, {{2}}) quanto com variáveis nomeadas ({{nome}}, {{empresa}}), que é o formato padrão do criador de templates atual da Meta. Os valores são preenchidos automaticamente pelo contexto da conversa: nome/name → nome do contato; empresa/company → empresa do contato; telefone/phone → WhatsApp do contato; meu_nome/my_name → seu nome; minha_empresa/organization → nome da sua organização. Variáveis com outros nomes seguem a ordem de posição (1ª = nome do contato, 2ª = empresa do contato, 3ª = seu nome, 4ª = sua organização, 5ª = telefone). No cadastro do template no CRM, o corpo pode usar {{1}} ou o mesmo nome usado na Meta — o formato de envio é decidido pela definição aprovada.
Erro "parâmetros do template" ao enviar? Confira se o template ainda está APROVADO no Gerenciador do WhatsApp, se o idioma escolhido no envio é o mesmo da versão aprovada (ex.: pt_BR) e se o nome cadastrado no CRM é idêntico ao da Meta.
Opt-out: quando o cliente pede para não receber mensagens automáticas
Quando uma automação manda um template de WhatsApp sozinha (sem um atendente clicar em enviar), o cliente pode pedir para parar de receber esse tipo de mensagem — isso é o opt-out. Ele não afeta o atendimento feito por uma pessoa: um atendente continua podendo enviar um template manualmente pela inbox, mesmo para um contato em opt-out (com um aviso na tela, para você decidir com cuidado).
Como o cliente entra em opt-out Basta responder, na conversa do WhatsApp, com exatamente uma destas palavras (sem mais nada no texto):
- SAIR, PARAR ou CANCELAR (português)
- STOP ou UNSUBSCRIBE (inglês)
- BAJA (espanhol)
Uma frase como "quero sair do grupo da obra" não conta como opt-out — só a palavra sozinha é reconhecida. Isso evita que uma mensagem comum do cliente seja interpretada por engano.
O que o cliente recebe Uma confirmação automática, assinada "Assistente virtual", no idioma da palavra usada — por exemplo: "Pronto, você não vai mais receber mensagens automáticas. Para voltar, envie VOLTAR." O chatbot de atendimento não responde a essa mensagem (ela não aciona o bot).
A confirmação e o silêncio do chatbot valem para organizações com o recurso de automações (Premium, Platinum ou trial). Em outros planos o pedido é registrado do mesmo jeito — o contato fica em opt-out e o selo aparece no detalhe —, mas nenhuma confirmação é enviada e a mensagem segue o atendimento normal (inclusive o chatbot, se estiver ligado). Assim, se a organização passar a usar automações depois, quem já pediu para sair continua fora.
Como o cliente volta a receber Respondendo VOLTAR (português), START (inglês) ou ALTA (espanhol) — também como palavra única. Ele recebe a confirmação de volta e passa a receber mensagens automáticas normalmente.
Marcar ou desmarcar pela tela (sem o cliente precisar escrever nada) No detalhe do contato, a chave "Receber mensagens automáticas do WhatsApp" liga e desliga o opt-out manualmente — útil quando o cliente pede por telefone, e-mail ou pessoalmente. Quem pode editar o contato pode usar essa chave.
Onde aparece na tela
- No detalhe do contato em opt-out, um selo vermelho "Não recebe mensagens automáticas do WhatsApp", com a data e a origem ("pediu pelo WhatsApp" ou "marcado pela equipe").
- Ao mesclar contatos duplicados, se qualquer um dos dois estava em opt-out, o contato que fica continua em opt-out (com a data do pedido mais antigo). O selo aparece mesmo se o contato não tiver telefone; a chave para mudar só aparece quando há telefone.
- Na inbox, ao tentar enviar um template manual para um contato em opt-out, aparece o aviso "Este contato pediu para não receber mensagens automáticas. O envio manual continua permitido." — é só um alerta, o envio continua liberado.
- Mensagens enviadas por uma automação aparecem na inbox com o rótulo "Automação", para diferenciar de uma resposta digitada por um atendente ou pelo chatbot.
O que não muda O opt-out nunca bloqueia: o histórico da conversa, o atendimento manual, o chatbot de atendimento (fora da própria mensagem de opt-out/retorno) ou respostas dentro da janela de 24 horas.
Chatbot de atendimento (atendente virtual)
Nos planos Premium e Platinum, um chatbot com IA pode fazer o primeiro atendimento das conversas: ele responde automaticamente com base na base de conhecimento da organização e transfere para a equipe quando necessário. Na inbox, conversas do bot mostram o selo "Bot atendendo"; os botões Assumir conversa e Devolver ao bot trocam quem conduz — e responder manualmente também silencia o bot na conversa. Configuração em Administração → Configurações → Chatbot de atendimento; guia completo em "Chatbot de atendimento (atendente virtual com IA)".
IA na conversa
No topo da conversa, dois botões de ícone com a estrela de IA (✨) e o balão de resposta: Resumir conversa gera um resumo estruturado (intenção do cliente, urgência, pendências e próximo passo) — útil para assumir um atendimento. Sugerir resposta escreve uma resposta pronta; o botão "Usar resposta" preenche o campo de mensagem e o envio continua manual, sempre sob seu controle.
Widget para o seu site
Em Administração → Configurações → WhatsApp está o widget do site (disponível a partir do plano Starter): um pequeno script que você cola no seu site e exibe um botão de WhatsApp com um formulário de chat. As mensagens dos visitantes entram direto na inbox do CRM (marcadas como "via site · telefone não verificado", também na notificação do celular e, na versão mais recente do aplicativo, na conversa) e criam o lead automaticamente. O botão tem IDs de CSS próprios (#flakedesk-whatsapp-widget, #flakedesk-whatsapp-button, #flakedesk-whatsapp-panel) para você posicionar e estilizar como quiser; o ícone é responsivo. Se o visitante informar um telefone que já tem conversa no CRM, a mensagem do site entra na mesma conversa (não cria uma duplicada) — e, se a janela de 24h dessa conversa estiver aberta por uma mensagem real de WhatsApp, a resposta pode ser em texto livre. Sem conversa anterior (ou com a janela fechada), a primeira resposta é feita por template, pois mensagem de site não abre a janela de 24h da Meta. Nos planos Premium e Platinum, com o chatbot e o canal "Chat do site" ligados, esse mesmo widget vira uma conversa com o atendente virtual — ver o guia "Chatbot de atendimento (atendente virtual com IA)".
Enviar arquivos na conversa (do computador ou dos Documentos)
O clipe ao lado do campo de mensagem envia um arquivo ao cliente. Ele funciona nas conversas de WhatsApp; Instagram, Messenger e chat do site ainda não têm anexo. Como qualquer resposta em texto livre, o envio só é possível com a janela de 24 horas aberta (ver acima).
- Abra a conversa em Comunicação → Atendimento.
- Clique no clipe (📎) ao lado do campo de mensagem. Aparecem duas opções:
- Do computador: abre a janela do seu computador para escolher o arquivo, como sempre funcionou.
- Dos documentos do FlakeDesk: abre a lista dos arquivos que já estão no módulo Documentos, sem precisar baixar e enviar de novo.
- Na lista dos documentos, a aba Deste contato mostra os arquivos guardados no contato da conversa. A aba Todos os documentos mostra tudo o que você pode ver em Documentos: pastas gerais, outros contatos e empresas. Digite parte do nome no campo de busca para achar um arquivo.
- Clique no arquivo. Ele aparece num cartão abaixo do campo de mensagem, com o aviso "dos documentos do FlakeDesk". Para desistir, clique no X do cartão.
- Se quiser, escreva um texto: ele vai como legenda do arquivo (até 1.024 caracteres). Clique em Enviar.
Regras do envio pelos Documentos:
- Só aparecem arquivos que você já pode abrir em Documentos. Na visibilidade restrita, isso quer dizer os documentos dos contatos e empresas atribuídos a você, além das pastas gerais. Documento na lixeira não aparece.
- PDF, Word (DOCX), Excel (XLSX), PowerPoint (PPTX), TXT e CSV vão como documento. Imagens JPG, PNG e WebP de até 5 MB vão como foto. Imagem acima de 5 MB aparece na lista sem poder ser escolhida, com o motivo: reduza a imagem e envie pelo computador.
- O FlakeDesk guarda uma cópia do arquivo no histórico da conversa. Se o documento for apagado de Documentos depois, a mensagem enviada continua mostrando o arquivo. Todos que veem a conversa (administradores, gestores e o responsável pelo contato) também veem o arquivo enviado.
- Ao trocar de conversa, o documento escolhido é descartado, para que o arquivo de um cliente não siga por engano para outro.
- Cada atendente pode enviar até 60 documentos a cada 15 minutos por esse caminho.
Erros comuns:
| Mensagem | O que fazer |
|---|---|
| "Este documento não está mais disponível. Ele pode ter ido para a lixeira ou você não tem mais acesso a ele." | O arquivo foi para a lixeira, foi apagado ou saiu do seu escopo entre a escolha e o envio. Abra o seletor de novo e escolha outro arquivo, ou fale com o gestor da equipe. |
| "O arquivo deste documento não foi encontrado. Fale com o suporte para tentar recuperá-lo." | O documento continua em Documentos, mas o arquivo dele não está mais no armazenamento, então nada foi enviado ao cliente e o anexo continua escolhido. Fale com o suporte informando o nome do documento, ou envie o arquivo Do computador. |
| "Imagem acima de 5 MB: o WhatsApp não aceita. Reduza a imagem e envie do computador." | O WhatsApp só aceita fotos de até 5 MB. Reduza a imagem e use Do computador. |
| "Muitos documentos enviados em pouco tempo. Aguarde alguns minutos e tente de novo." | O limite de 60 documentos a cada 15 minutos foi atingido. Espere alguns minutos. |
| "Este contato ainda não tem documentos." | Não há arquivo guardado no contato. Clique em Ver todos os documentos ou envie o arquivo pela tela Documentos (ver o guia "Documentos"). |
Limites de mídia
Envio pela inbox a partir do computador: imagens JPEG/PNG/WebP até 5 MB; áudio (AAC, MP4, MP3, OGG), vídeo MP4 e documento PDF até 16 MB (regras da Meta). GIF, DOC/XLS/PPT e ZIP não são aceitos: converta para PDF/MP4/JPEG ou envie um link. A partir dos Documentos do FlakeDesk: PDF, DOCX, XLSX, PPTX, TXT e CSV como documento e JPG/PNG/WebP até 5 MB como foto, no limite de cada arquivo em Documentos (25 MB). Recebimento: arquivos até 25 MB; acima disso a mensagem chega sem o arquivo.
Problemas e códigos de erro
Mensagens que não chegam, erros ao conectar (PIN, número já em uso, popup bloqueado), falhas de envio com o código da Meta (131042, 131026, 131047, 131049 e outros), templates recusados e restrições da conta estão detalhados no guia "WhatsApp e Meta — guia prático (passo a passo detalhado)". Para Instagram Direct e Messenger, veja "Instagram Direct e Messenger — conexão, regras e solução de problemas".