Como habilitar o WhatsApp com coexistência (API Oficial da Meta)

CRM
1

O que é a coexistência?

A coexistência permite conectar ao PUCA um número que já está ativo no WhatsApp Business App, usando a API oficial da Meta (Cloud API). O app continua funcionando no celular e as mensagens passam a ser espelhadas no monitor do módulo Social.

Pré-requisitos

  • Número já em uso no WhatsApp Business App (versão 2.24.17 ou superior)
  • Conta Facebook Business / Meta Business da empresa, com acesso ao número
  • Usuário com a permissão puca-crm-api-whatsapp-admin (Administração do Monitor WhatsApp), necessária para acessar o Whatsapp Monitor e concluir o cadastro
  • Pop-ups e redirecionamentos habilitados somente para o domínio do PUCA da empresa ([[domain]]). Sem isso, a janela de cadastro da Meta não abre. Siga o passo a passo em Como habilitar pop-ups e redirecionamentos no navegador para o PUCA

1. Fluxo a partir do PUCA

  1. No PUCA, no módulo Social, abra Whatsapp Monitor.
  2. Clique para criar uma nova conexão.
  3. Em vez de criar a conexão “comum”, escolha Conectar via API Oficial (Meta).
  4. Na tela Conectar WhatsApp, confirme que o número já está ativo no WhatsApp Business App e clique em Conectar com a Meta.
  5. Será aberta a janela de cadastro incorporado (Embedded Signup) da Meta.

Sem a permissão puca-crm-api-whatsapp-admin, o menu Whatsapp Monitor não aparece e não é possível gerenciar conexões nem iniciar a coexistência.

2. Se você já usa o WhatsApp Business

Este fluxo é exatamente para quem já atende pelo WhatsApp Business no celular e quer manter o app funcionando enquanto integra o número à API oficial no PUCA.

Não é necessário desativar o WhatsApp Business App. A ideia da coexistência é manter os dois lados ativos: celular + monitor no módulo Social.

3. Passo a passo na janela da Meta (Embedded Signup)

Na janela que a Meta abre:

  1. Faça login com a conta Facebook / Meta Business da empresa (não use uma conta pessoal sem acesso ao Business Manager, se for o caso da sua operação).
  2. Siga o fluxo de autorização e permissões solicitadas pela Meta.
  3. Quando aparecer a opção, clique em Conectar um app do WhatsApp Business.
  4. Informe / selecione o telefone que já está ativo no WhatsApp Business App (o mesmo número que você usa no celular).
  5. Confirme os dados da conta WhatsApp Business e avance até a etapa de verificação.

4. Escanear o QR Code

  1. A Meta vai pedir a verificação no aparelho (via QR Code e/ou código no WhatsApp Business App).
  2. Abra o WhatsApp Business no celular vinculado ao número.
  3. Escaneie o QR Code exibido na tela (ou informe o código, se a Meta mostrar essa alternativa).
  4. Aguarde a confirmação de que a verificação foi concluída.
  5. Volte ao PUCA: a tela deve indicar que a conexão foi criada com sucesso em modo coexistência.

Pronto: o WhatsApp Business App continua no celular e o Whatsapp Monitor passa a receber as novas mensagens em tempo real.

Dicas e observações

  • Use sempre a conta Business correta da empresa no login da Meta.
  • O número precisa já estar ativo no WhatsApp Business App antes de iniciar o fluxo.
  • Para acessar Whatsapp Monitor e Config. WhatsApp, o usuário precisa da permissão puca-crm-api-whatsapp-admin. A permissão puca-crm-api-whatsapp-user libera apenas Meu Whatsapp (conversas do usuário), sem gerenciar conexões.
  • Conversas anteriores ao onboarding podem não aparecer de imediato no monitor; as novas mensagens (recebidas e enviadas pelo celular) passam a ser espelhadas após a conexão.
  • Se a janela da Meta for fechada no meio do processo, volte em Whatsapp Monitor e inicie novamente Conectar via API Oficial (Meta).
  • Se a janela da Meta não abrir, o navegador provavelmente bloqueou o pop-up. Libere pop-ups só para [[domain]] (tutorial) e tente de novo.