verified Como conectar o WhatsApp Business

Orientações para o administrador da clínica antes, durante e depois de clicar em "Iniciar Conexão com Facebook".

1 Pré-requisitos (antes de iniciar)

Conta Facebook pessoal ativa — a mesma que abrirá no popup do login.
Acesso a um Business Manager (BM) em business.facebook.com. Se ainda não tiver, o próprio fluxo Embedded Signup cria um — mas é mais rápido entrar com um já criado.
Número de telefone "limpo" — esse é o ponto que mais reprova:
- O número NÃO pode estar logado no WhatsApp comum nem no WhatsApp Business app. Se estiver, abra o app no celular → Configurações → Conta → Excluir minha conta antes de iniciar.
- Precisa receber SMS ou ligação (Meta envia o código de verificação).
- Pode ser fixo (Meta liga) ou celular (SMS/ligação).
- Não pode já estar registrado em outra conta WABA Meta — nem da sua empresa, nem de terceiros.

Atenção: tentar conectar um número ainda ativo no WhatsApp app é a causa #1 de falha. Exclua a conta antes — leva 30 segundos.

2 Durante o popup do Facebook

Após clicar em "Iniciar Conexão com Facebook", o popup abrirá e guiará você por estes passos:

Faça login no Facebook com sua conta pessoal.
Selecione (ou crie) o Business Manager da sua clínica.
Ex.: "Hunab Clínica" — pode ser qualquer nome comercial seu.
Crie a WhatsApp Business Account (WABA). Nome livre.
Defina o nome de exibição do perfil (ex.: "Hunab Clínica"). Meta valida — usar o nome real do negócio.
Adicione o número de telefone que será conectado.
Receba o código por SMS ou ligação e digite-o no campo solicitado.
O popup fecha sozinho — o DataMarcada conclui o resto (assinatura do webhook + finalização).

Sucesso: ao voltar para a tela "Conectar WhatsApp", clique em Atualizar e o número aparecerá listado como Ativo.

3 Depois da conexão (recomendado)

Verificar o Business Manager em business.facebook.com → Configurações → Centro de Segurança → enviar CNPJ + comprovante.
Sem verificação, o número fica em tier 250 conversas/dia com clientes não-engajados. Com verificação sobe para 1k → 10k → 100k conforme uso.
Configurar cobrança WhatsApp (a partir de ~1.000 conversas/mês a Meta começa a cobrar): em WhatsApp Manager → Configurações de cobrança → cadastrar cartão.

Boa notícia: as primeiras 1.000 conversas iniciadas pelo cliente em cada janela de 30 dias são gratuitas. A cobrança Meta só aparece se a clínica passar desse volume.

4 O que você NÃO precisa fazer

Cadastrar webhook, tokens de acesso, App Domains ou URLs OAuth — já está pronto pelo lado do DataMarcada (app NativeNubaiAPI).
Submeter o app Meta para revisão — o DataMarcada é Tech Provider verificado da Meta; sua clínica entra como cliente final, sem revisão.
Criar templates de mensagem manualmente — o DataMarcada já provisiona os templates necessários (confirmação de agendamento, lembrete, etc.) automaticamente.
Configurar permissões de WhatsApp Manager — o token gerado pelo Embedded Signup já vem com os escopos corretos.

5 Problemas comuns e como resolver

"O número já está em uso" — o número ainda está registrado no app do WhatsApp no celular (WhatsApp comum ou WhatsApp Business app). No próprio celular, abra o app → Configurações → Conta → Apagar minha conta. Aguarde uns 5 minutos e clique de novo em "Iniciar Conexão". (Isso não é feito no site da Meta — é no aplicativo do celular.)
"Esse número já está sendo usado por outro sistema" — um número de WhatsApp só pode estar ligado a um sistema por vez. Se o seu já está em outra ferramenta, é preciso liberá-lo antes de trazer para cá:
- Se quem cuida do número hoje é outra empresa ou agência: peça para ela "liberar" o seu número (soltar do sistema dela) e desligar a trava de segurança chamada "verificação em duas etapas" (o PIN de 6 dígitos). Assim que liberarem, volte aqui e clique de novo em "Iniciar Conexão" — vamos enviar um código por SMS ou ligação só para confirmar que o número é seu.
- Se o número já é da sua própria conta do Facebook/WhatsApp Business: abra o painel da Meta no botão abaixo, encontre o seu número na lista, clique em Configurações (⚙️) → Verificação em duas etapas e desligue essa trava. Depois é só voltar aqui e clicar em "Iniciar Conexão".
  👉 Abrir o WhatsApp Manager
  Você precisa estar logado no Facebook da sua empresa. O link abre a lista dos seus números; a partir dela são os 2 cliques acima.
Fique tranquilo: depois de liberado pode levar alguns minutos, e suas mensagens automáticas são recriadas sozinhas — você não perde nada.
"Falha na verificação por SMS" — peça verificação por ligação (botão alternativo na tela Meta). Funciona inclusive para fixos.
Popup foi bloqueado — verifique no navegador (ícone na barra de endereço) e marque "Sempre permitir popups de datamarcada.com". Depois clique de novo em "Iniciar Conexão".
Tier de mensagens muito baixo — verifique o Business Manager (passo 3 acima). Sem verificação, 250 msgs/dia é o limite.