Nesta página
O que você precisa
O app WhatsApp Business no celular, versão 2.24.17 ou mais recente, com o número que você quer conectar. O WhatsApp comum (pessoal) não serve: instale o WhatsApp Business no mesmo celular e, na configuração inicial, aceite usar o número e trazer as conversas.
Uma conta do Facebook com acesso de administrador ao portfólio empresarial (Business Manager) da sua empresa.
O computador com a XBASE aberta e o celular por perto: a conexão termina com o app lendo um QR code na tela.
Permissão para gerenciar integrações na XBASE. Se não tiver, peça a quem administra a conta.
Saber o que muda no app depois de conectar: listas de transmissão, mensagens temporárias, mensagens de visualização única e localização em tempo real deixam de funcionar. Os detalhes estão em Coexistência do WhatsApp: regras e limites.
Passo a passo
Passo 1 de 10
Abra o WhatsApp nas integrações
Na XBASE, abra Integrações no menu e encontre o card WhatsApp (Meta Oficial).
Passo 2 de 10
Comece a conexão
Clique em Conectar Integração. Se a empresa já tem um número conectado, o botão se chama Adicionar número. Abre uma janela da Meta.
Passo 3 de 10
Entre com o Facebook
Entre com a sua conta do Facebook, se a Meta pedir, e clique em Continuar na tela de boas-vindas.
Passo 4 de 10
Digite o número do WhatsApp Business
Na tela "Adicione seu número de telefone do WhatsApp", deixe marcado "Insira um novo número de telefone", escolha BR +55 e digite o número exatamente como ele aparece no WhatsApp Business (DDD + número). Clique em Avançar. Mesmo com a opção "novo número", a Meta reconhece sozinha que o número já está no app.
Se a Meta pedir um código por SMS ou ligação, pare e feche a janela. Isso quer dizer que ela não reconheceu o número no WhatsApp Business, e concluir por esse caminho tiraria o número do celular.
Passo 5 de 10
Confira o perfil
A Meta mostra o perfil do seu WhatsApp Business (nome, número e catálogo). Confira e clique em Avançar.
Passo 6 de 10
Escolha o portfólio da sua empresa
Escolha o portfólio empresarial da sua empresa (o seu, não o da XBASE) e clique em Avançar.
Passo 7 de 10
Leia o QR code com o celular
Aparece um QR code. No celular, abra a mensagem da conta oficial do Facebook Business no WhatsApp Business e toque em Conectar: o app pede para ler o QR code da tela. Se a mensagem não aparecer, vá em Configurações → Conta → Business Platform no app.
Para trazer as conversas antigas, autorize o compartilhamento do histórico quando o app perguntar.
Passo 8 de 10
Confirme a conta
Confira o nome da conta e o fuso horário e clique em Avançar.
Passo 9 de 10
Conclua na Meta
Na tela "Sua conta está conectada", clique em Concluir. A janela da Meta fecha.
Passo 10 de 10
Escolha quem vai atender
A XBASE pergunta qual agente de IA vai atender o número. Escolha agora ou feche e configure depois.
O que esperar no final
A XBASE mostra "WhatsApp conectado! O número continua funcionando no seu celular." e o número aparece em Integrações. Em WhatsApp API → Números, o card do número traz o bloco Sincronização com o celular, com o selo Também no celular e o andamento dos contatos e do histórico.
Alguns minutos depois, as conversas de texto dos últimos 6 meses aparecem no Chatcenter, com as datas originais, e os contatos do app entram na XBASE. Daí em diante, toda conversa nova aparece nos dois lugares.
Problemas comuns
Não aparece nenhuma opção para conectar a conta do WhatsApp Business
É normal: não existe um botão separado. Digite o seu número na tela "Adicione seu número de telefone do WhatsApp" (passo 4) e a Meta reconhece que ele está no WhatsApp Business.
A Meta pediu um código por SMS ou ligação
Ela não reconheceu o número no app. Feche a janela sem concluir, porque seguir por esse caminho tira o número do celular. Confira se o número está no WhatsApp Business (não no WhatsApp comum), se o app está atualizado e se você digitou o número igual ao do app.
Meu número já está conectado à XBASE pela API
Nesse caso ele não está no app do celular, e não dá para conectar assim direto. Fale com o suporte: o número precisa sair da API, ser ativado no WhatsApp Business e ser conectado de novo.
As conversas antigas não apareceram
Elas chegam alguns minutos depois da conexão. Só entram conversas dos últimos 6 meses, sem grupos, e só se você autorizou compartilhar o histórico no celular. Se a autorização foi recusada ou o pedido falhou, nas primeiras 24 horas o bloco Sincronização com o celular (em WhatsApp API → Números) mostra o botão Importar histórico: clique e aceite no celular. Depois desse prazo, desconecte pelo app e conecte de novo.
Respondi pelo celular e o agente parou de responder aquele cliente
É o esperado: a conversa ganhou a etiqueta "Atendimento Humano", e o agente fica quieto enquanto ela estiver lá. Remova a etiqueta para o agente voltar a responder.