Embedded Signup é um fluxo da Meta exibido dentro da experiência de onboarding de um provedor. Ele permite que sua empresa autorize a configuração de conta e número sem entregar ao provedor seu login pessoal da Meta.
Quem deve iniciar o Embedded Signup?
Use o login da Meta do proprietário do portfólio empresarial ou de um administrador com permissão para gerenciar os ativos WhatsApp. A pessoa que completa o fluxo aprova o que o provedor pode conectar.
Mantenha o administrador no controle da conta da Meta. Pedir a um provedor que se passe por esse administrador arrisca a perda de controle dos ativos e permissões. O proprietário da empresa deve revisar os ativos, as permissões e os termos no diálogo da Meta antes de confirmar.
Quais ativos o fluxo conecta?
O fluxo pode conectar um portfólio empresarial da Meta, uma WhatsApp Business Account e um número de telefone à integração do provedor. As opções exatas dependem de você criar uma conta nova ou selecionar uma existente.
| Ativo | Confirme antes de continuar |
|---|---|
| Portfólio empresarial | A empresa e o administrador estão corretos |
| WhatsApp Business Account | A conta é a que sua equipe pretende operar |
| Número de telefone | O número está disponível para a configuração WhatsApp selecionada |
| Conexão com o provedor | O provedor e o espaço de trabalho que recebem a conexão estão corretos |
O provedor pode operar os ativos conectados. Sua empresa continua responsável pelas políticas da conta, pela permissão do cliente e pelo conteúdo das mensagens. Revise a política de negócios do WhatsApp da Meta antes de autorizar o acesso.
O que acontece durante o fluxo?
O provedor abre o diálogo de Embedded Signup da Meta em seu painel. Você faz login, escolhe ou cria os ativos empresariais, fornece os detalhes de negócio solicitados e autoriza a conexão com o provedor.
A verificação do telefone pode ser uma etapa separada. Siga as verificações de número no guia de número WhatsApp do Bird antes de começar, caso você não tenha certeza se o número candidato pode ser conectado.
O que ainda está incompleto quando o diálogo fecha?
Quando o diálogo fecha, a verificação, a conexão e o envio ainda podem estar incompletos. O fluxo do navegador retornou, mas a Meta pode ainda estar processando os ativos.
A operação de conclusão do Bird funciona apenas pelo painel. Uma solicitação de backend não consegue reproduzir o consentimento e a seleção de ativos do administrador, então não construa uma integração pública via API em torno dela.
No Bird, leia os campos status, next e finish_setup_url do número conectado. status é um enum aberto. Ele inclui awaiting_signup, banned, connected, deleted, disconnected, failed, flagged, migrated, pending, preparing, rate_limited e restricted; aceite um valor não reconhecido. O campo separado error explica por que a conexão falhou pela última vez. next reporta a próxima ação enquanto a conexão está incompleta. Enquanto o signup aguarda uma etapa no navegador, finish_setup_url aparece apenas para awaiting_signup; abri-lo completa o fluxo do painel porque a etapa não pode ser executada pela API. Consulte o recurso após completar o fluxo em vez de tratar o redirecionamento como um teste de envio bem-sucedido.
Estados sinalizados, restritos e banidos podem afetar o acesso de envio de um número conectado.
Como verifico a prontidão para o signup?
Antes do fluxo, confirme:
- O administrador consegue acessar o portfólio empresarial correto da Meta.
- Os detalhes da empresa e a titularidade da conta estão prontos para revisão.
- O número de telefone está disponível para este caminho de conexão.
- O espaço de trabalho do provedor é o que deve receber a conta.
Após o fluxo, confirme a conta, o status do número, o resultado da verificação e um envio de teste real. Mantenha registrados o proprietário da conta da Meta e o contato de suporte do provedor para recuperação.
Em resumo
Traga o administrador certo.
O proprietário ou um administrador do portfólio empresarial da Meta deve completar as etapas de consentimento e ativos.
Prepare o número e a empresa.
Tenha o portfólio empresarial, os detalhes da WhatsApp Business Account e um número prontos para o fluxo de conexão do provedor.
Espere trabalho após o signup.
Fechar o diálogo não comprova verificação, conexão do número ou prontidão para envio. Siga o status reportado.
Mantenha a titularidade clara.
Confirme qual portfólio empresarial, conta e número o provedor conecta antes de você autorizar o fluxo.