For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/faq/messaging/sync-whatsapp-business-data.md.
  • Português
  • Como trazer meus contatos e conversas do WhatsApp Business para o Clickmax?

    Abra o número conectado em Configurações → Conexões e clique em Sincronizar. Você escolhe o que trazer: Dados da conta, Templates, Contatos e Histórico de conversas.

    A parte que não dá para desfazer: Contatos e Histórico de conversas são trazidos uma única vez, dentro de um prazo que começa a correr assim que a conexão do número termina. Se o prazo fechar sem você pedir, só refazendo a conexão do número.

    Antes de começar: o número precisa estar conectado e ter entrado em modo de convivência — aquele em que você continua usando o WhatsApp Business no celular normalmente. Se o número não entrou nesse modo, as linhas de Contatos e Histórico aparecem desativadas com o motivo.

    O que dá para trazer

    ItemDá para repetir?O que vem
    Dados da contaSim, quando quiserNome, foto e informações do perfil.
    TemplatesSim, quando quiserModelos de mensagem aprovados na Meta.
    ContatosNão — sincronização únicaA agenda do WhatsApp Business, para revisão antes de virar lead.
    Histórico de conversasNão — sincronização únicaAs conversas anteriores, para revisão antes de entrar no Live Chat.

    Contatos e histórico não entram direto: eles ficam aguardando a sua revisão antes de virarem leads e conversas.

    Passo a passo

    1. Vá em Configurações → Conexões e clique no número do WhatsApp.
    2. No card Sincronizar com o WhatsApp, clique em Sincronizar.
    3. Marque o que quer trazer. Contatos e Histórico de conversas já vêm marcados, com o selo Sincronização única e quanto tempo ainda falta.
    4. Clique em Sincronizar. O resultado aparece item por item — é normal um item dar certo e outro não; o que falhou não impede o resto.

    Desmarcar não queima a chance: enquanto o prazo estiver aberto, você pode voltar a esta tela e pedir o item que deixou de fora. O que não volta é o prazo — depois que ele fecha, nem o que você desmarcou nem o que esqueceu podem ser trazidos.

    Revisar antes de virar lead e conversa

    Nada do que vem entra sozinho. Quando os contatos e as conversas chegam — o que leva de alguns minutos a algumas horas, porque o WhatsApp entrega em blocos —, a tela do número mostra um aviso para cada um.

    Contatos. Clique em Revisar contatos e escolha quem deve virar lead. Quem já é lead aparece marcado como tal e não é duplicado; o rodapé mostra quantos leads novos serão criados. Ao aprovar, o que ficou de fora da seleção é descartado — e a confirmação lista quem são, para você conferir antes.

    Conversas. Clique em Revisar conversas. Aqui a decisão é do bloco inteiro, sem escolher conversa a conversa. O resumo mostra o período coberto, quantas conversas e mensagens vieram, e a informação que costuma gerar dúvida: quantas dessas conversas já existem no seu Live Chat e vão apenas receber o que faltava, e quantas são novas. Nada é duplicado — as mensagens que você já tem continuam únicas.

    As conversas importadas entram com as datas originais e não disparam automações, fluxos nem mensagens automáticas. Elas entram no histórico como já aconteceram.

    Você tem prazo para decidir: 30 dias para os contatos e 14 dias para as conversas, contados de quando cada um chega. Depois disso o que não foi aprovado é descartado.

    Ao conectar um número novo

    Durante a conexão de um número novo, a mesma escolha aparece como um passo antes de você ir para a tela da Meta. Ali nada é trazido na hora: o Clickmax guarda a sua escolha e aplica sozinho assim que a conexão é confirmada.

    Vale decidir nesse momento. O prazo de contatos e histórico começa a correr no fim da conexão, sem ninguém na tela para avisar — se você pular o passo, ainda dá para usar o botão Sincronizar na tela do número enquanto houver prazo.

    Se não funcionou

    • "Prazo encerrado. Só refazendo a conexão do número." — o prazo daquele item passou. Contatos e histórico não podem ser pedidos de novo; a única saída é refazer a conexão do número.
    • "Este número não subiu em modo coexistência." — o número não entrou no modo de convivência quando foi conectado. Dados da conta e templates continuam funcionando normalmente.
    • "Aguardando a confirmação da Meta." — a Meta ainda não confirmou o número. Aguarde e abra a tela de novo; veja o que acontece após vincular o WhatsApp Business.
    • "Já sincronizado · N aguardando revisão" — o item já foi trazido e há itens esperando você revisar antes de virarem leads ou conversas.
    • "Não foi possível carregar o estado da sincronização." — recarregue a página. Enquanto o Clickmax não consegue ler o estado, o botão fica bloqueado de propósito, para não gastar uma das chances sem saber o que já foi feito.

    Relacionados