Embedded Signup: conectar seu número do WhatsApp sem sair do site

Embedded Signup é o fluxo oficial da Meta para conectar um número de WhatsApp à Cloud API sem sair do site da plataforma. Tudo acontece em uma janela pop-up da própria Meta: você entra com a sua conta do Facebook Business, escolhe ou cria a empresa, escolhe ou cadastra o número e volta com a conexão pronta.

Por que isso importa

Antes do cadastro incorporado, conectar um número exigia criar aplicativos no painel da Meta, gerar tokens de acesso e mandá-los para o fornecedor — normalmente por e-mail ou chat. Além de lento, era inseguro: um token de sistema circulando fora de qualquer cofre.

No fluxo incorporado a autorização é feita pela Meta e entregue diretamente ao servidor da plataforma. Você nunca vê nem copia um token, e o acesso concedido pode ser revogado a qualquer momento no Business Manager.

O que acontece em cada etapa

1. Login e escolha do negócio — você entra com a conta que administra a empresa no Meta Business Manager, ou cria uma na hora.
2. WhatsApp Business Account — a WABA que vai guardar seus números, templates e a classificação de qualidade. Ela nasce no nome da sua empresa.
3. Número — cadastrar um novo (com verificação por SMS ou chamada) ou migrar um que já existe.
4. Confirmação — a janela fecha e a plataforma finaliza: identifica a WABA, inscreve os webhooks para receber mensagens e registra o número na Cloud API.

Terminado isso, a caixa de entrada começa a receber. Se alguém escrever para o número, a mensagem aparece em tempo real.

Coexistência: manter o app do celular

Se o número já é usado no aplicativo WhatsApp Business, existe uma alternativa à migração pura: o modo de coexistência. Nele você escaneia um QR code dentro do fluxo oficial e o número passa a funcionar nos dois lugares — o app continua no celular da equipe e as mesmas conversas aparecem na plataforma.

Uma diferença técnica importante: números em coexistência não passam pela etapa de registro na Cloud API, porque o vínculo com o aplicativo já cumpre esse papel. Se algo pedir "registrar" um número em coexistência, é sinal de configuração errada.

Erros comuns e o que fazer

"Este número já está em uso" — o número está ativo no WhatsApp comum ou no app Business e precisa ser liberado antes. Apagar a conta dentro do aplicativo libera o número em alguns minutos; ou use coexistência, que não exige apagar nada.

A janela não abre — o navegador bloqueou o pop-up. O clique precisa vir de uma ação direta do usuário; se o bloqueador barrou, libere o domínio e tente de novo.

"Não foi possível concluir a conexão" — normalmente a empresa ainda não está verificada no Business Manager, ou quem está logado não é administrador dela. A verificação de negócio é um processo da Meta e leva de horas a alguns dias.

Nenhuma mensagem chega depois de conectar — os webhooks não ficaram inscritos, ou o número não foi registrado. Reconectar pelo mesmo fluxo resolve na maior parte dos casos.

Depois de conectar

Com o número ativo, os próximos passos costumam ser criar os primeiros templates, convidar a equipe com papéis e, se fizer sentido, dar acesso a um agente de IA. Antes disso, vale entender a janela de 24 horas — é ela que define o que pode ser enviado e quando.