Embedded Signup do WhatsApp: cadastro em poucos cliques
·7 min de leitura
Resposta rápida
O Embedded Signup é um fluxo que a Meta disponibiliza para que o cliente conecte o WhatsApp dele ao seu produto sem sair da sua página: ele autoriza numa janela da própria Meta e a conta comercial, o número e o token voltam para o seu sistema. Serve a quem constrói produto sobre a API — não a quem só quer usar a API para a própria empresa.
Se você usa a API para a sua própria empresa, este artigo não é para você — a configuração manual, feita uma vez, resolve. O Embedded Signup existe para quem tem clientes que precisam conectar o WhatsApp deles ao seu produto.
Sem ele, cada novo cliente significa dias de ida e volta: criar portfólio, criar conta comercial, conceder acessos, registrar número, esperar aprovação de nome. Com ele, isso vira uma janela e alguns cliques.
O problema que ele resolve
| Cadastro manual | Embedded Signup | |
|---|---|---|
| Quem executa | Seu time, guiando o cliente | O cliente, sozinho |
| Tempo típico | Dias, com ida e volta | Minutos |
| Onde acontece | Painel da Meta | Dentro do seu produto |
| Erro humano | Alto — muitos passos manuais | Baixo — a Meta conduz |
| Escala | Cada cliente é um projeto | Autoatendimento |
O Embedded Signup não simplifica a API. Ele simplifica o onboarding — que é o gargalo real de quem vende software sobre a API.
Como o fluxo funciona
- 1
O cliente clica em conectar, no seu produto
Um botão na sua interface abre uma janela hospedada pela Meta. Nada do que acontece ali passa pelo seu servidor — inclusive as credenciais do Facebook do cliente, que você nunca vê.
- 2
Ele escolhe ou cria o portfólio comercial
Se a empresa já anuncia no Facebook ou no Instagram, o portfólio já existe e aparece na lista. Senão, é criado ali mesmo.
- 3
Ele cria a conta comercial e registra o número
A conta comercial do WhatsApp (WABA) nasce no portfólio do cliente, com você entrando como parceiro. O número é confirmado por código, como em qualquer registro.
- 4
A janela devolve um código para o seu sistema
No fim do fluxo você recebe um código de autorização, que é trocado por um token de acesso no seu servidor. Com o token vêm os identificadores da conta comercial e do número.
- 5
Você assina o webhook e está pronto
Registrar a assinatura de webhook para aquela conta é o último passo. A partir daí, mensagens do cliente chegam no seu endpoint — ver webhooks.
O que a Meta exige de quem oferece
Não é um recurso que se ativa numa chave. Há requisitos, e eles levam tempo.
| Requisito | O que significa |
|---|---|
| App de tipo Business | Com o produto WhatsApp adicionado, no painel de desenvolvedores |
| Empresa verificada | A sua empresa, não a do cliente. Documentos e análise da Meta |
| Revisão de permissões | whatsapp_business_management e whatsapp_business_messaging passam por análise do app |
| Configuração do produto | URLs de retorno e domínios autorizados declarados no app |
| Papel de parceiro técnico | Sua empresa figura como parceira nas contas dos clientes |
O token, e o cuidado com ele
O que volta do fluxo é uma credencial que dá acesso à conta de outra empresa. O tratamento precisa ser proporcional a isso.
- Troque o código por token no servidor, nunca no navegador — o segredo do app não pode existir no lado do cliente.
- Guarde criptografado, com o mesmo cuidado de uma senha de banco de dados.
- Um token por cliente. Nada de credencial compartilhada entre contas.
- Trate revogação. O cliente pode remover seu acesso a qualquer momento pelo painel dele; seu sistema precisa lidar com o erro 190 sem quebrar.
- Registre o consentimento — data, quem autorizou e quais permissões. É o que sustenta a relação de operador de dados sob a LGPD.
- 1
Cliente autoriza
Na janela da Meta, fora do seu domínio
- 2
Código volta
Para o seu front-end
- 3
Servidor troca por token
Com o segredo do app, no back-end
- 4
Assina o webhook
E a conta do cliente entra em operação
O que continua sendo responsabilidade do cliente
O Embedded Signup acelera a conexão, não elimina as exigências da plataforma. Depois do fluxo, ainda são do cliente:
| Item | Por quê |
|---|---|
| Verificação da empresa dele | Sem ela, a conta fica na faixa inicial de envio |
| Nome de exibição | Passa por revisão da Meta e pode ser recusado |
| Método de pagamento | Sem ele o envio para com erro 131042 |
| Qualidade do número | Depende de como ele usa, não de como você integrou |
| Aprovação de templates | Cada conta aprova os seus |
Um bom onboarding mostra esses cinco itens como uma lista de pendências dentro do seu produto, com o estado de cada um. É a diferença entre suporte reativo e cliente que se resolve sozinho.
Antes de oferecer Embedded Signup
- Sua empresa verificada no Meta Business.
- App de tipo Business criado, com o produto WhatsApp adicionado.
- Permissões submetidas à revisão, com vídeo do fluxo funcionando.
- URLs de retorno e domínios autorizados declarados no app.
- Troca de código por token acontecendo no servidor.
- Token armazenado criptografado, um por cliente.
- Tratamento de revogação: erro 190 não pode derrubar o sistema.
- Assinatura de webhook registrada automaticamente ao fim do fluxo.
- Interface mostrando as pendências que continuam sendo do cliente.
- Registro de consentimento com data e permissões concedidas.
A alternativa enquanto a revisão não sai
A revisão de permissões leva semanas, e o produto não precisa esperar por ela para receber cliente. O caminho intermediário é o onboarding guiado: em vez de o cliente fazer tudo sozinho numa janela, ele segue um passo a passo dentro do seu produto e concede acesso ao seu portfólio como parceiro.
| Onboarding guiado | Embedded Signup | |
|---|---|---|
| Depende de revisão da Meta | Não | Sim |
| Tempo do cliente | 30 a 60 minutos | Minutos |
| Seu time envolvido | Sim, em suporte | Não |
| Escala | Limitada | Autoatendimento |
| Conta comercial | Do cliente, se você orientar certo | Do cliente, por construção |
Se optar pelo guiado, documente o passo a passo com telas e mantenha a mesma regra de ouro: a conta comercial nasce no portfólio do cliente. Facilidade de implantação não justifica assumir a propriedade da conta dele.
Perguntas frequentes
O que é o Embedded Signup do WhatsApp?
Um fluxo hospedado pela Meta que permite ao cliente conectar o WhatsApp dele a um produto de terceiro sem sair dele. Ao final, o produto recebe um token e os identificadores da conta comercial e do número, e a conta nasce no portfólio do próprio cliente.
Preciso de Embedded Signup para usar a API na minha empresa?
Não. Se a API é para o seu próprio negócio, a configuração manual no Meta Business resolve, é feita uma vez e não exige revisão de app. O Embedded Signup serve a quem conecta contas de clientes.
A conta comercial fica com quem?
Com o cliente. O fluxo cria a conta no portfólio dele e coloca você como parceiro — que é exatamente o arranjo recomendado, porque mantém a portabilidade do lado de quem contratou.
Quanto tempo leva para habilitar?
O que define o prazo é a verificação da sua empresa e a revisão das permissões do app, que costuma pedir demonstração em vídeo. Some semanas ao cronograma, não dias.
O que acontece se o cliente revogar o acesso?
Suas chamadas passam a devolver erro 190. O sistema precisa tratar isso como estado normal — desativar a integração daquele cliente e avisar, não quebrar.
O cliente precisa ter conta no Facebook?
Precisa de um perfil para autorizar, porque o fluxo usa o login da Meta. Não precisa ter página nem anunciar — mas se a empresa já anuncia, o portfólio comercial dela aparece pronto na lista, o que encurta o processo.
Posso guardar o token no navegador?
Não. A troca do código por token exige o segredo do app e precisa acontecer no servidor. Token no front-end é credencial de acesso à conta de outra empresa exposta ao público.
Termos deste artigo
- Embedded Signup
- Fluxo em que o cliente autoriza o uso do WhatsApp dele dentro do site de um fornecedor, sem sair da página. Reduz o cadastro na API oficial de um processo de dias para alguns cliques.
- Conta comercial do WhatsApp(WABA)
- WhatsApp Business Account — o objeto dentro do Meta Business que agrupa os números de telefone, os templates e os limites de envio de uma empresa na API oficial. Deve ficar no Meta Business da própria empresa, não no do fornecedor.
- Cloud API
- Versão da API oficial do WhatsApp hospedada pela própria Meta, sem custo de hospedagem. É o caminho atual para integrar o WhatsApp a um sistema; a alternativa antiga, On-Premises, foi descontinuada.
- Provedor de solução(BSP)
- Business Solution Provider — empresa autorizada pela Meta a revender e operar a API do WhatsApp para outras empresas. Cobra mensalidade ou margem sobre a tarifa da Meta, e é onde mora a diferença entre o preço oficial e o preço final.
- Webhook
- URL pública onde a Meta entrega os eventos do seu número: mensagem recebida, confirmação de entrega e de leitura. Não existe consulta sob demanda na API do WhatsApp — receber mensagem exige um servidor sempre no ar.
Resumo
- É onboarding, não API simplificada: serve a quem conecta contas de clientes.
- A conta comercial nasce no portfólio do cliente, com você como parceiro.
- Exige empresa verificada e revisão de permissões do app — semanas, não dias.
- Troque o código por token no servidor. Nunca no navegador.
- Trate revogação: o erro 190 é estado esperado, não falha.
- Verificação, nome de exibição, pagamento e templates continuam sendo do cliente.
Referências oficiais
- WhatsApp Business Platform — Embedded Signup — consultado em 16 de outubro de 2026
- Meta for Developers — revisão de app e permissões — consultado em 16 de outubro de 2026
- Cloud API — webhooks — consultado em 16 de outubro de 2026
Leia também
Meta Business: como configurar para o WhatsApp do zero
A etapa que trava todo projeto de API antes de começar: conta comercial, WABA, número, nome de exibição e verificação da empresa, na ordem que funciona.
22 de setembro de 2026 · 7 min
API oficial do WhatsApp (Cloud API): guia para começar
O que é a API oficial do WhatsApp, quando ela vale a pena, o que a Meta exige, como enviar a primeira mensagem e os limites que derrubam projeto no começo.
1 de agosto de 2026 · 8 min
Webhooks do WhatsApp: como receber mensagens no seu sistema
Como configurar o webhook da Cloud API, o que a Meta envia, como validar a assinatura, por que mensagens chegam repetidas e o que fazer quando o endpoint cai.
12 de setembro de 2026 · 5 min