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á logado no WhatsApp ou WhatsApp Business app. Abra o app → Configurações → Conta → Excluir minha conta. Aguarde 5 minutos e tente de novo.
"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.