A janela de 24h grátis acaba em 1º/out/2026. Veja o que muda e como reduzir custo. Entrar na comunidade

← Voltar aos artigos
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.

8 min de leitura Vitor Fontenele
Mapa de onboarding na WhatsApp Business API com Embedded Signup

Onboarding é conversão. Cada passo entre o cliente clicar “Conectar WhatsApp” e o número estar pronto para enviar mensagem é um ponto onde alguém desiste. Se o seu fluxo de ativação exige trocar print de Business Manager, criar WABA na mão e mandar o cliente verificar número por conta própria, você está perdendo gente que já queria pagar.

O Embedded Signup é a resposta da Meta para isso: um fluxo completo de cadastro, embutido dentro do seu produto, que conecta a conta do cliente à WhatsApp Business API em minutos — sem ninguém sair da sua tela. Para Tech Providers e BSPs, é 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"]

O que é Embedded Signup

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 (WhatsApp Business Account);
  • 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 — aquele de compartilhar BMs por convite, criar WABA na mão e ficar trocando IDs por e-mail. Tudo 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 significam mais clientes ativando — e o Embedded Signup existe exatamente para encurtar essa distância.

O fluxo, passo a passo

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

  1. Clique no CTA. O cliente clica em “Conectar WhatsApp” no seu produto. O SDK do Facebook abre o diálogo de login.
  2. Facebook Login. Ele autentica na conta Meta dele. Aqui é onde muita gente hesita — vale explicar que isso não dá acesso ao Facebook pessoal.
  3. Business Portfolio. Seleciona um Business Manager existente ou cria um novo na hora.
  4. WABA. Cria ou seleciona a WhatsApp Business Account sob esse portfolio.
  5. Número de telefone. Adiciona o número que vai virar canal oficial.
  6. Verificação. Confirma a posse do número por SMS ou ligação.
  7. Permissões. Concede ao seu app o acesso para gerenciar a WABA e enviar/receber mensagens.
  8. 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 ainda não produz valor.

Etapas do onboarding com Business Manager e Embedded Signup
Cada passo do signup é um ponto de abandono — instrumente o funil para ver onde o cliente trava.

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 — e há variantes do Embedded Signup que conduzem esse caminho (tipicamente via QR Code, com requisitos de elegibilidade próprios). Vale entender o trade-off antes de escolher: veja Cloud ou Coexistência para decidir qual modelo oferecer no seu fluxo.

Pré-requisitos do builder

Antes de colocar o Embedded Signup na frente do primeiro cliente, o seu lado precisa estar montado. Esse setup é feito uma vez, pela plataforma:

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ões fragmentadas atrasam aprovação e geram inconsistências. E se você ainda está decidindo se vai operar como Tech Provider, BSP ou Solution Partner, esse é o momento — o papel define o que você consegue fazer no fluxo.

Onde o fluxo trava — e o que fazer

O Embedded Signup é guiado, mas 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 é o que separa quem otimiza de quem chuta. Instrumente cada etapa do signup — login, seleção de BM, verificação, callback — e você vai ver exatamente onde o dinheiro vaza.

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. Um fluxo de ativação que pede menos do cliente, falha com mensagens claras e tem fallback para cada erro comum converte mais. Ponto.

Depois que o número conecta, o jogo continua: registrar o número, aprovar um template de boas-vindas e 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 do signup.

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.