embedded signuponboardingtech providerwhatsapp business api

Embedded Signup: onboarding sem fricção na WhatsApp API

Como onboardar clientes na WhatsApp Business API com Embedded Signup: fluxo, pré-requisitos de Tech Provider, pontos de fricção e como reduzir abandono.

Vitor FonteneleFundador da WhatsApp Founders · Engenheiro pelo ITA

20/06/2026 8 min de leitura

Onboarding é conversão.

Cada passo entre o cliente clicar “Conectar WhatsApp” e o número ficar pronto para enviar mensagem é um ponto onde alguém desiste. Se o seu fluxo pede print de Business Manager, criação de WABA (WhatsApp Business Account) na mão e verificação de número por conta própria, você está perdendo gente que já queria pagar.

E aqui vem a parte contraintuitiva: quase ninguém abandona por não querer a API.

Abandona porque o SMS não chegou. Porque escolheu a Business Manager errada na lista. Porque faltou uma permissão no App Review que era responsabilidade sua, não dele. Tudo isso é falha de encanamento. E tudo isso acontece depois de o cliente já ter dito sim.

O Embedded Signup é a resposta da Meta. Um fluxo completo de cadastro, embutido no seu produto, que conecta a conta do cliente à WhatsApp Business API em minutos, sem ninguém sair da sua tela.

Para quem onboarda cliente (Tech Provider ou Solution Partner), é a diferença entre um onboarding de dias e um de cinco minutos.

flowchart LR A["CTA Conectar"] --> B["Facebook Login"] B --> C{"Tem BM?"} C -->|Sim| D["Escolhe BM"] C -->|Não| E["Cria BM"] D --> F["WABA"] E --> F F --> G["Número"] G --> H["SMS / voz"] H --> I["Callback + code"] I --> J["Backend grava token"]

Embedded Signup é um fluxo da Meta baseado em Facebook Login, renderizado dentro da sua aplicação. Em uma única sessão, o cliente:

cria ou seleciona o Business Portfolio (Business Manager);
cria ou seleciona a WABA;
adiciona e verifica um número de telefone;
concede ao seu app as permissões para gerenciar e enviar mensagens.

No fim, o seu backend recebe via callback o WABA ID e o phone number ID do cliente. Você troca o code por um token, registra o número, e a operação está de pé.

Ele substitui o onboarding manual: compartilhar BM por convite, criar WABA na mão, trocar ID por e-mail. O que era fricção humana vira fluxo guiado, em contexto.

Onboarding é a primeira métrica de produto que importa para um Tech Provider. Menos passos entre o clique e o número ativo, mais clientes ativando. O Embedded Signup existe para encurtar essa distância.

O fluxo, passo a passo

Do ponto de vista do cliente, é assim que roda:

Clique no CTA. O cliente clica em “Conectar WhatsApp” no seu produto. O SDK do Facebook abre o diálogo de login.
Facebook Login. Ele autentica na conta Meta dele. Aqui é onde muita gente hesita: vale explicar que isso não dá acesso ao Facebook pessoal.
Business Portfolio. Seleciona um Business Manager existente ou cria um novo na hora.
WABA. Cria ou seleciona a WhatsApp Business Account sob esse portfolio.
Número de telefone. Adiciona o número que vai virar canal oficial.
Verificação. Confirma a posse do número por SMS ou ligação.
Permissões. Concede ao seu app o acesso para gerenciar a WABA e enviar/receber mensagens.
Callback. Seu app recebe o code e os identificadores (WABA ID, phone number ID). O backend troca o code por um token de sistema e registra o número para começar a operar.

O passo 8 é seu, não do cliente. E é onde o onboarding de fato termina. Antes de registrar o número e enviar a primeira mensagem (via template aprovado), a conexão existe mas não produz valor nenhum.

Coexistência também passa por aqui

Se o cliente quer manter o WhatsApp Business no celular e usar a API no mesmo número, isso é Coexistência. Existem variantes do Embedded Signup para esse caminho (em geral via QR Code, com regras de elegibilidade próprias).

Entenda o trade-off antes de escolher: veja Cloud ou Coexistência para decidir qual modelo oferecer.

Pré-requisitos do builder

Antes de colocar o Embedded Signup na frente do primeiro cliente, o seu lado precisa estar montado. Esse setup você faz uma vez:

Pré-requisito	O que é
App Meta com produto WhatsApp	Um app do tipo Business no Meta for Developers, com o produto WhatsApp adicionado.
Configuração de Tech Provider	App vinculado a uma Business Manager verificada, configurado para onboardar terceiros.
Permissões	`whatsapp_business_management` e `whatsapp_business_messaging` (e, na prática, `business_management` para acessar a BM do cliente).
Advanced Access	As permissões acima aprovadas em App Review. Sem isso, o fluxo falha por falta de acesso.
Facebook Login for Business	Configurado no app, com o diálogo de login habilitado.
Configuration ID	Um `config_id` do Embedded Signup, criado em Facebook Login > Settings, que você passa no `FB.login`.

Detalhe que economiza semanas: peça todas as permissões de uma vez no App Review. Submissão fragmentada atrasa aprovação e gera inconsistência.

E se você ainda não decidiu entre Tech Provider e Solution Partner, decida agora. O papel define o que você consegue fazer no fluxo.

Onde o fluxo trava (e o que fazer)

O Embedded Signup é guiado. Não é à prova de fricção. Os pontos de abandono mais comuns:

Verificação de negócio pendente. Se a Business Manager do cliente não está verificada, certas ações ficam bloqueadas. Detecte cedo e oriente o cliente a concluir a verificação na própria BM antes de seguir.
SMS não chega. O código de verificação atrasa mais do que se espera. Ofereça verificação por ligação como fallback imediato e cheque DDI e portabilidade do número. Número portado para outra operadora é causa clássica de SMS que some.
Confusão na seleção de Business Portfolio. Clientes com múltiplas BMs escolhem a errada. Se você já sabe qual é a correta, pré-preencha os dados do negócio no extras do fluxo.
Erro de permissão. Se o cliente não é admin da BM, o fluxo falha, às vezes silenciosamente. Detecte a ausência de authResponse e mostre uma mensagem clara: “Você precisa ser administrador do Business Manager para conectar o WhatsApp.” Esse erro também aparece quando faltou Advanced Access do seu lado.
Display name reprovado. O nome de exibição da WABA passa por revisão da Meta. Nome genérico demais, com promessa indevida ou que não bate com o negócio, é reprovado. Oriente o cliente a usar o nome real da empresa.

Medir o funil separa quem otimiza de quem chuta. Instrumente cada etapa do signup (login, seleção de BM, verificação, callback) e você vê onde o dinheiro vaza.

Se der para instrumentar só uma, instrumente a verificação. É o passo com a maior distância entre “o cliente quer” e “o cliente consegue”. E é o único da lista que já tem fallback pronto esperando você ligar.

Por que isso é problema de founder, não só de engenharia

É tentador tratar o Embedded Signup como “mais uma integração”. Não é.

É o ponto onde a sua promessa de produto encontra a realidade. E onde a maioria dos leads decide se fica ou some.

Então mude a leitura: cada etapa do signup é dinheiro parado, não tarefa de engenharia. Menos passos. Erro legível quando falha. Fallback já implementado.

Depois que o número conecta, o jogo continua. Registrar o número, aprovar um template de boas-vindas, cuidar do quality rating para não acabar com número limitado ou banido. Mas nada disso acontece se o cliente travou no passo 4.

Perguntas frequentes

Preciso de App Review aprovado para testar o Embedded Signup? Para o fluxo completo em produção, sim: as permissões de WhatsApp exigem Advanced Access via App Review. Em desenvolvimento, você consegue testar com contas e papéis associados ao app antes da aprovação. Confirme o estado atual das regras na doc oficial, porque a Meta muda os requisitos de acesso com frequência.

O cliente precisa ter uma Business Manager antes de começar? Não. O Embedded Signup permite criar o Business Portfolio durante o fluxo. Ter uma BM verificada acelera (e evita bloqueios em algumas ações), mas não é pré-condição para iniciar.

Posso pular criação de BM e WABA quando o cliente já tem tudo? Sim. Há uma variante de compartilhamento que assume que a WABA já existe e só conecta ela ao seu app, útil para reduzir passos com clientes que já estão na plataforma. O nome e o comportamento exato dessa opção podem mudar; valide na doc da Meta.

O Embedded Signup serve para Coexistência ou só para Cloud? Os dois cenários são endereçáveis por variantes do fluxo, mas com requisitos diferentes (Coexistência tem elegibilidade própria, normalmente via QR Code). A escolha do modelo é uma decisão de produto: veja o comparativo Cloud vs Coexistência.

A Meta atualiza o fluxo, as permissões e os requisitos de acesso do Embedded Signup com frequência. Antes de implementar, valide sempre na fonte oficial: documentação de Embedded Signup da Meta.

Conteúdo da comunidade WhatsApp Founders 🇧🇷. Independente, sem vínculo oficial com o WhatsApp ou a Meta.