Seu cliente final conecta o WhatsApp Business dele sem sair do seu produto e sem nunca ver a dashboard do WaBlast. Você chama nossa API, abre um popup, e no fim tem uma conexão WhatsApp ativa disparando pela sua chave.
O fluxo em resumo
Seu backend cria uma sessão de onboarding, você abre a embed_url para o cliente e recebe um webhook account.connected quando a conexão fica ativa.
Sem isso, a alternativa seria mandar cada cliente criar conta no WaBlast — o que na prática mata a revenda.
O onboarding embutido do WaBlast é o fluxo para desenvolvedores e empresas que querem oferecer WhatsApp oficial dentro do próprio produto, usando o WaBlast como infraestrutura.
Você não embute nada da Meta: o SDK do Facebook, o config_id e a chamada do Embedded Signup rodam na nossa página. O cliente final autentica com a conta Facebook dele, cria ou escolhe o portfólio de negócios, cadastra o número e recebe o código de verificação. No fim, nosso servidor troca o código, cria a conexão, inscreve os webhooks da WABA e carimba o seu external_ref.
Leia antes de decidir se o modelo serve para você.
Todos os contatos, campanhas e templates dos seus clientes ficam sob a sua conta, sem isolamento entre eles na nossa interface. Por isso você não deve dar login da dashboard do WaBlast ao seu cliente final — ele veria dados dos outros.
O logo do WaBlast aparece no popup da Meta. White-label real exigiria você virar Tech Provider com app próprio na Meta — não é o que este fluxo faz.
Sub-contas isoladas por cliente final não existem. É o motivo de o modelo ser API-only.
Se a sua assinatura ficar em atraso, todos os seus clientes finais param juntos — e nós não temos canal com eles para avisar. O relacionamento é seu.
O caminho tradicional de virar provedor de tecnologia da Meta desaparece. Nada disso entra no seu caminho:
O Embedded Signup roda na nossa página, com o nosso app. Você não cria nem mantém aplicativo nenhum no App Dashboard da Meta.
Nenhuma permissão sua passa por revisão da Meta — quem passa por esse processo é o nosso app, não o seu.
Você não vira Tech Provider. A verificação de negócio como provedor de tecnologia é nossa, não sua.
O SDK do Facebook, o config_id e a chamada do Embedded Signup rodam na nossa página. Nenhuma URL sua entra na configuração da Meta.
Sua API autenticada por wak_ roda em api.wablastmessage.com; a página que o cliente final abre roda em app.wablastmessage.com. Confundir os dois hosts é o erro mais comum da integração.
Do seu servidor (nunca do navegador), chame POST /v1/onboarding/sessions com o external_ref do cliente. A resposta traz a embed_url, válida por 10 minutos e de uso único.
POST /v1/onboarding/sessions Redirect no servidor ou window.open. É uma página nossa, sem indexação, que cuida de todo o fluxo com a Meta.
window.open(embed_url, "_blank") Ele autentica com a conta Facebook dele, cria ou escolhe o portfólio de negócios, cadastra o número e recebe o código de verificação — tudo sem ver a dashboard do WaBlast.
O webhook account.connected chega com external_ref, waba_id, número e account_id. Como fallback, faça polling em GET /v1/onboarding/sessions/{id} — nunca trate o redirect do navegador como confirmação.
GET /v1/onboarding/sessions/{id} Comunicar essas fricções antes — em vez de escondê-las — evita cancelamento na primeira semana.
Quem clica no popup precisa ser administrador do portfólio de negócios do próprio negócio. Se não existir portfólio, ele é criado dentro do popup.
O número a conectar recebe um código de verificação. O cliente precisa do aparelho ao lado durante o fluxo.
Somos Tech Provider, não Solution Partner: o cliente final precisa cadastrar forma de pagamento na própria WABA (WhatsApp Manager → Pagamentos) antes de enviar qualquer mensagem. É a cobrança de conversas da Meta, não nossa.
Negócio ainda não verificado pela Meta começa limitado a 250 destinatários novos por 24h. Comunique isso ao cliente antes do primeiro envio.
Mitos desfeitos: página do Facebook não é necessária, conta de anúncios não é necessária, e o portfólio de negócios é criado dentro do popup — não precisa existir antes.
Rodar o Embedded Signup no domínio do parceiro não é oferecido: o popup parte da nossa página. O modo suportado não é atingido pela cláusula de revenda dos Tech Provider Terms da Meta, justamente porque o cliente final aceita os termos da Meta diretamente.
account.connect_failed não é entregue hoje, e account.connected pode não chegar quando um slot é reciclado. O onboarding funciona normalmente — mas mantenha o polling da sessão como fallback, não como opcional.
Hoje ele volta no webhook account.connected e aparece no painel /developers/onboarding. Para listar contas por cliente via API, guarde o mapeamento external_ref → account_id do seu lado no momento do onboarding.
Preencha rapidinho: você cai direto numa conversa com o nosso comercial já com o seu contexto preenchido — sem precisar reexplicar nada.
Fale com o nosso comercial para entender o modelo de parceiros, ou vá direto para a referência técnica dos endpoints de onboarding.