Embedded Signup: como conectar o número do cliente à sua plataforma

Embedded Signup é o fluxo que a Meta oferece para conectar o WhatsApp de um cliente dentro do seu produto, sem que ele precise entrar no painel de desenvolvedores, criar aplicativo ou copiar credencial. Ele clica em um botão, entra com o Facebook dele, escolhe a conta e pronto. É esse fluxo que separa uma plataforma que o cliente consegue usar sozinho de uma que exige acompanhamento técnico em cada contratação.

O que o fluxo faz, do lado do cliente

Do lado de quem contrata, a experiência tem quatro momentos:

1. Ele clica no botão de conectar, dentro da sua plataforma.
2. Abre uma janela da Meta, onde ele entra com a conta do Facebook dele.
3. Escolhe o portfólio empresarial e a conta do WhatsApp — ou cria na hora.
4. Confirma o número e autoriza as permissões que a sua plataforma pediu.

Fechada a janela, a sua plataforma recebe o que precisa para operar aquele número: o identificador da conta do WhatsApp, o identificador do número e uma credencial escopada para aquele cliente. A partir daí, você envia e recebe mensagens por ele.

O que precisa estar pronto antes

O fluxo não funciona sozinho. Três coisas precisam existir do seu lado:

• Empresa verificada no Gerenciador de Negócios da Meta.
• Aplicativo revisado, com acesso avançado aprovado para cada permissão que você vai pedir: gerenciar a conta do WhatsApp, enviar e receber mensagens e gerenciar os ativos empresariais.
• Uma configuração de login criada no painel do aplicativo. É ela que define o que o cliente vai ver e autorizar.

O que acontece depois que a janela fecha

A conexão não termina quando o cliente vê a mensagem de sucesso. Faltam três passos do lado do servidor, e pular qualquer um deles deixa a integração pela metade:

1. Trocar o código por uma credencial. A janela devolve um código temporário; o seu servidor troca por uma credencial de longa duração, escopada para os ativos daquele cliente.
2. Registrar o número. É aqui que se define o PIN de seis dígitos. Se o cliente já tinha verificação em duas etapas ativa, o PIN é o dele — e descobrir isso no meio da conexão é um dos motivos mais comuns de falha.
3. Assinar os eventos da conta. Sem esse passo você não recebe nenhuma mensagem daquele cliente. É o esquecimento clássico: o envio funciona, as respostas somem, e o problema só aparece quando alguém reclama que ninguém respondeu.

Vale guardar, por cliente, os dois identificadores e a credencial — e tratar a credencial como senha, nunca como configuração de ambiente compartilhada.

O que o Embedded Signup não faz

Duas expectativas que precisam ser corrigidas antes de desenhar o produto:

Ele não coleta forma de pagamento. O fluxo só conecta o número. Se ninguém cuidar da cobrança, o cliente termina com uma conta ativa que trava no primeiro envio. No arranjo de revenda, a conta do cliente é anexada à linha de crédito da sua empresa — a Meta cobra você, e você cobra o cliente por fora. É exatamente isso que permite o onboarding de um clique, sem cartão internacional na mão do cliente.

Ele não verifica a empresa do cliente. A verificação é um processo separado, do lado dele, e é o que destrava os limites de envio maiores. Dá para conectar antes, mas a operação fica no patamar inicial até a empresa ser verificada.

Os erros que mais travam

A tela de coexistência não aparece

O cliente já usa o número no aplicativo, mas o fluxo só oferece cadastrar número novo. Há duas causas. A primeira é de configuração: se a configuração de login foi criada incluindo o produto de mensagens de marketing, a plataforma ignora o pedido de coexistência. O produto não pode ser trocado depois — é preciso criar uma configuração nova só com a API do WhatsApp. A segunda é de permissão do cliente: o Facebook que ele usou precisa ser administrador do portfólio empresarial, não apenas da Página.

Erro ao parear depois do QR code

Acontece em coexistência, quando o pareamento começa e não conclui. Causas conhecidas: sincronização ainda em curso — esperar e repetir costuma resolver —, aplicativo desatualizado no celular, região sem suporte ao recurso, conflito com a verificação em duas etapas, ou aplicativo sem o status de Tech Provider.

O cliente conecta e nada chega

Quase sempre é a assinatura de eventos que ficou para trás. Confira, por cliente, se o passo foi executado — é comum ele falhar em silêncio quando a credencial ainda não tinha propagado.

Quantos clientes dá para conectar

Concluídas a verificação da empresa, a revisão do aplicativo e a verificação de acesso, o limite é de 200 novos clientes por janela móvel de sete dias. Não há teto para o total acumulado, mas migração em massa precisa ser distribuída no calendário.

Perguntas frequentes