Se você é uma pessoa, esta página não é para você ler. Mande este endereço para o seu Claude e diga o que quer — conectar o WhatsApp da empresa ao Ploomes, ou incluir mais um atendente. Ele lê o resto e conduz. Você só precisa estar por perto, com a sua senha e o celular do atendente à mão.

Funciona com um Claude que consiga abrir o navegador: a extensão do Claude para Chrome ou o app do Claude na aba Code.

Instruções para o assistente

Você vai configurar a Integração WhatsApp Coex de uma empresa: o WhatsApp Business continua funcionando no celular do atendente e as mensagens passam a virar registros de interação no Ploomes. A configuração alterna entre o painel da Meta e o Ploomes.

Antes de abrir qualquer tela, pergunte à pessoa qual é o caso e siga só a parte correspondente:

Primeira vez na empresa — faça a Parte A e depois a Parte B.
Incluir, reconectar ou trocar um atendente numa conta que já funciona — faça só a Parte B.

1) Regras que você não quebra

Você não digita a senha do Facebook, não resolve CAPTCHA e não aceita termos de uso. Nesses pontos, pare, diga exatamente o que apareceu na tela e devolva o teclado para a pessoa.
Você não mexe no celular do atendente. Instrua, aguarde a confirmação e só então siga.
Um passo por vez. Mostre a tela e confirme antes de clicar em qualquer coisa que grave.
Nunca adicione o número por «Adicionar telefone», no Gerenciador do WhatsApp ou nas Configurações do negócio. Esse caminho usa o registro comum: a conta fica offline, o QR Code não aparece e o número não pode mais ser aproveitado. O número entra só pelo cadastro incorporado, na Parte B.
Uma conta do WhatsApp por atendente. Duas pessoas no mesmo número não funciona.

2) Parte A — a primeira configuração

Oito passos, uma única vez. As telas com imagem estão no guia completo; aqui está o que fazer e o que conferir.

Portfólio empresarial (Meta). Em business.facebook.com, crie o portfólio com nome, endereço, site e e-mail da empresa. Avise a pessoa: a verificação leva de 3 a 5 semanas, não trava a configuração, mas empresa não verificada fica limitada a dois números. Com três atendentes ou mais, diga para iniciar a verificação agora.
App (Meta). No Painel de Apps, Criar app, caso de uso Conectar-se com clientes através do WhatsApp, e o portfólio do passo 1.
Conta do WhatsApp Business (Meta). Na página Quickstart, Começar a usar a API; selecione a conta existente ou crie uma. Guarde o WABA ID — você vai usar no passo 8 e na conferência final. Nenhum número entra aqui.
Permissões (Meta). Em WhatsApp > Permissões e recursos, adicione business_management, whatsapp_business_management e whatsapp_business_messaging. Sem este passo, business_management não aparece na hora de gerar o token e o token nasce incompleto.
Credenciais (Meta). Business ID em Configurações > Informações da Empresa; App ID e App Secret em Configurações do app > Básico. O botão Mostrar pede a senha do Facebook — pare e peça. Trate o App Secret como senha: não repita o valor na conversa nem o grave em arquivo.
Usuário de sistema e token (Meta). Em Configurações do Negócio > Usuários do sistema, crie o usuário com papel Admin. Atribua os ativos primeiro — o app com acesso total e a conta de mensagens com acesso total — e só então Gerar token, sem expiração, com as três permissões do passo 4. O token aparece uma única vez; peça para a pessoa guardá-lo.
Ativação (Ploomes). Na área de integrações plug and play, abra a Integração WhatsApp Coex e informe Business ID, App ID, App Secret e o token. O Ploomes devolve a URL de callback e o Verify Token.
Webhook (Meta). Em WhatsApp > Configuração > Webhook > Editar: a Callback URL é a URL inteira; o Verify Token é só o código do fim dela. Os dois campos ficam um embaixo do outro — confira antes de salvar. Depois, em Campos do webhook, assine os quatro: messages, smb_message_echoes, history e smb_app_state_sync.

A ordem do passo 6 é irreversível. O token congela as permissões no instante em que nasce. Atribuir ativos ou habilitar permissão depois não conserta o token já emitido — tem que gerar outro.

E não saia do passo 8 com um campo só. Com apenas messages assinado, tudo parece funcionar: a mensagem do cliente chega. O que o atendente responde pelo celular, o histórico e os contatos ficam de fora, e ninguém percebe por semanas. Confirme os quatro em voz alta antes de sair da tela.

3) Parte B — conectar um atendente

Ligue a coexistência no seletor. No app da Meta, Casos de uso > Conectar no WhatsApp > Configurador de cadastro incorporado, seção Início do Cadastro incorporado > Diálogo do cadastro incorporado. Deixe Versão do cadastro incorporado em 4 ou superior e Tipo de recurso em Integração do app WhatsApp Business.
Confira o seletor de novo, na tela, logo antes de clicar. Recarregar a página devolve o Tipo de recurso para Nenhum, e o parâmetro feature_type no endereço não o restaura. Em Nenhum, o fluxo roda como cadastro comum: o QR Code não aparece e o número não entra em coexistência.
Abra o cadastro incorporado. Entrar com o Facebook — a janela é do Facebook e a senha é da pessoa. Depois: o número do atendente, a confirmação dos dados da conta e o portfólio empresarial.
Mande o atendente abrir a câmera antes de você gerar o QR Code. No WhatsApp Business dele: três pontinhos, Configurações > Conta > Plataforma de Negócios > Continuar, aceitar compartilhar o histórico de conversas, e a câmera abre. Espere ele confirmar que a câmera está aberta.
Só então avance até o QR Code e mostre a imagem para ele escanear. O código vence em poucos minutos: gerado antes da hora, ele expira e o fluxo recomeça do início.
Inscreva o número (Ploomes). Na tela da integração, Gerenciar números e Inscrição no número recém-vinculado. Sem essa etapa a Meta não envia nada, e a tela não avisa.
Teste de ponta a ponta. Peça uma mensagem de outro celular e confirme que o registro de interação aparece no Ploomes, vinculado ao contato e ao responsável.

Um erro no fim é esperado e não significa falha. Quando o app e o portfólio pertencem à mesma empresa, a última tela pode exibir «<número> não é uma identificação da empresa válida». O passo que falha é compartilhar a conta com o próprio app, que já é dono dela. A vinculação já foi gravada — não repita o fluxo, confirme pela seção 4.

4) Confirme pela API, não pela tela

Os indicadores da Meta enganam em coexistência: o status alterna entre Conectado e Desconectado só por o aplicativo estar aberto ou fechado no celular, e é normal o número constar como não verificado. Use o token do passo 6:

curl -s "https://graph.facebook.com/v23.0/<WABA_ID>/phone_numbers?fields=display_phone_number,platform_type,throughput" -H "Authorization: Bearer <TOKEN>"

Número em coexistência responde platform_type: CLOUD_API e throughput.level: STANDARD. Em ON_PREMISE, a vinculação não concluiu: refaça a Parte B.

5) Quando der errado

O celular mostra «Something went wrong. Please try again».
Troque o QR Code pelo código digitado: no rodapé da tela do QR há o link «Em vez disso, use um código de acesso», que gera um código curto para a pessoa digitar no aplicativo. Esse caminho costuma passar onde o QR falha. Peça também a versão do WhatsApp Business — precisa ser 2.24.17 ou superior — e sugira trocar o Wi-Fi corporativo pelos dados do celular.

O atendente não consegue escanear o QR Code.
Mesmo link, mesmo código digitado.

O QR Code expirou.
Gere outro, mas só depois de confirmar que a câmera está aberta de novo.

A conta aparece como offline e o QR Code não apareceu.
Ou o número foi adicionado por «Adicionar telefone», ou o Tipo de recurso estava em Nenhum. Confira o seletor e refaça a Parte B.

O número foi vinculado, mas nenhuma mensagem chega.
Falta a inscrição: confira em Gerenciar números se ele consta como Inscrito.

Chega mensagem de todo mundo, menos de uma pessoa.
O telefone dela deve aparecer uma única vez no cadastro de usuários do Ploomes. Com o mesmo número em dois cadastros, a mensagem chega e não sabe onde entregar.

As mensagens de um número pararam depois de semanas.
A Meta encerra a coexistência quando o aplicativo fica cerca de 14 dias sem uso no celular principal, ou 30 num dispositivo vinculado. Refaça a Parte B; a inscrição continua válida — e é isso que engana, porque o número segue aparecendo como Inscrito.

6) Feche com um resumo

Ao terminar, diga à pessoa, em uma linha cada: quais números ficaram em CLOUD_API, qual teste de ponta a ponta você confirmou, e o que ficou pendente do lado dela — verificação da empresa, atendentes que faltam, qualquer passo que ela precise refazer sozinha.

Telas com imagem, limites e casos de exceção estão no guia completo: Integração WhatsApp Coex. O passo a passo manual de atendentes: Incluir, reconectar e remover atendentes.

Configurar a Integração WhatsApp Coex com a ajuda do Claude