Embedded Signup do WhatsApp para os seus clientes: app próprio de Tech Provider ou página hospedada
Um SaaS pode conectar os números do app do WhatsApp Business dos seus clientes à Cloud API pelo Embedded Signup da Meta de duas formas. Pode se tornar ele mesmo um Meta Tech Provider, o que exige verificação de negócio, App Review com dois vídeos e um Embedded Signup próprio, ou enviar os clientes para uma página hospedada de Embedded Signup, operada por um provedor que já é Tech Provider, e receber a conexão pronta.
A easyCoexistence executa o Embedded Signup da Meta com Coexistência em uma página hospedada que leva o seu nome, então os seus clientes conectam os números sem que você precise se tornar Tech Provider.
Novos clientes empresariais que um Tech Provider pode integrar por janela móvel de 7 dias: 10 por padrão, 200 após verificação e revisão.
Gravações de tela que o App Review pede a um Tech Provider: uma mensagem enviada e recebida, e um template sendo criado.
Prazo médio informado pela Meta para o App Review de um app do WhatsApp.
A versão mais antiga do app do WhatsApp Business que um cliente pode conectar pela Coexistência.
Por quanto tempo fica válido o código devolvido pelo Embedded Signup, para o servidor trocá-lo pelo token de negócio do cliente.
Quais são as duas formas de integrar os números dos seus clientes?
As duas usam o Embedded Signup da Meta com Coexistência e terminam no mesmo lugar: o número do cliente na Cloud API, ainda funcionando no app do WhatsApp Business, e o seu backend guardando o token de negócio próprio do cliente. A diferença está em quem assume os requisitos da Meta e o código em torno do pop-up.
| Your own Tech Provider app | easyCoexistence's hosted page | |
|---|---|---|
| Before the first customer | Business verification, App Review and your own Embedded Signup build | An API key and a card on the account |
| Name in Meta's popup | Your app | easyCoexistence, with your name on the page around it |
| Code you maintain | The popup, the token exchange, webhook subscriptions and the history sync | A session request and a return page |
| The 14-day rule | A PARTNER_REMOVED webhook for your app to handle | connection.disconnected with PRIMARY_INACTIVITY |
| Meta's message charges | On the customer's WhatsApp Business Account | On the customer's WhatsApp Business Account |
O que a Meta exige para se tornar Tech Provider?
A Meta lista os passos no guia para se tornar Tech Provider, que o App Dashboard abre em onboarding de Tech Provider, dentro do caso de uso WhatsApp:
- Um app da Meta com o caso de uso WhatsApp, conectado ao seu Portfólio de Negócios.
- Verificação de negócio, que vem primeiro: a Meta só inicia o App Review para uma empresa verificada.
- Configurações do app, como ícone, política de privacidade e categoria.
- Acesso avançado a
whatsapp_business_messagingewhatsapp_business_management, concedido pelo App Review com uma explicação escrita e uma gravação de tela para cada um. - Duas gravações no total: uma mensagem enviada pelo seu app e recebida no WhatsApp, e o seu app criando um template de mensagem.
O que você constrói depois de aprovado?
O próprio onboarding, que os guias de Embedded Signup da Meta descrevem passo a passo:
- O fluxo no seu site, por meio do Facebook Login for Business e do SDK JavaScript da Meta, em domínios HTTPS que você autoriza no app.
- Coexistência habilitada na configuração do fluxo, com registro de sessão, exigido pela Meta para ela.
- Uma chamada ao servidor que troca o código devolvido pelo token de negócio do cliente em até 30 segundos.
- Webhooks: seu app inscrito na conta de cada cliente, com os campos
account_update, history,smb_app_state_syncesmb_message_echoes. - A sincronização de contatos e histórico em até 24 horas após o onboarding; depois disso, o cliente precisa desconectar e refazer o fluxo.
O que a página hospedada assume?
Todo o lado do pop-up. A easyCoexistence executa o Embedded Signup com Coexistência pelo próprio app da Meta, como Tech Provider, em uma página em easycoexistence.com que mostra o seu nome. A troca de token, a inscrição nos webhooks e a solicitação de histórico acontecem ali, e o seu backend recebe um id de conexão. Com um webhook_url na sessão, a Meta entrega as mensagens do número direto ao seu servidor, junto com a importação única de contatos e, quando o cliente compartilhar, até 180 dias de conversas. Seu código então chama a API Graph da Meta diretamente com o token do cliente, enquanto a easyCoexistence monitora o número e envia eventos assinados quando ele muda.
O que o seu cliente vê?
Uma página com o seu nome e um único botão Conectar. Antes de o pop-up da Meta abrir, uma lista de verificação pede ao cliente que confirme cinco itens: um app do WhatsApp Business atualizado, um número em uso real por pelo menos 7 dias, nenhum outro provedor de API ou ferramenta de automação nele, nenhum app não oficial e o telefone à mão, com um login do Facebook. Não são pedidos conta, e-mail nem cartão.
O que acontece dentro do pop-up da Meta?
O fluxo da Meta faz o cliente entrar com o Facebook, pede que autorize o app e digite o número, e mostra o perfil do app do WhatsApp Business daquele número para ele confirmar. Ele escolhe ou cria um Portfólio de Negócios e então escaneia um QR code de dentro do app do WhatsApp Business; a Meta também envia ao número uma mensagem de WhatsApp com um link para o código. No app, ele toca em Conectar e escolhe se compartilha o histórico de conversas. Por último vêm o nome da conta, um fuso horário e os termos da Meta. A ordem pode variar enquanto a Meta implanta o fluxo com o número de telefone primeiro.
Qual nome o pop-up da Meta mostra?
O nome do app que pede o acesso. Na página hospedada, é o da easyCoexistence, que não pode ser renomeado, enquanto a página em volta do pop-up mostra o seu nome, vindo de partner_name. Um app Tech Provider próprio mostra o nome do seu app, ao custo da verificação, da revisão e da construção descritas acima.
O que é a regra dos 14 dias?
A Meta desconecta um número em Coexistência quando o telefone que tem o app do WhatsApp Business fica inativo por cerca de 14 dias, e informa o motivo como PRIMARY_INACTIVITY. O cliente se reconecta refazendo o fluxo com o mesmo número. Pela página hospedada, a easyCoexistence monitora cada número e envia à sua URL de eventos connection.disconnected com esse motivo, de modo que um novo link de conexão para o cliente pode trazer o número de volta.
Erros comuns
- Construir sobre o Embedded Signup v2 ou v3. A Meta descontinuou as duas em 15 de outubro de 2026 e atende as requisições a elas como v4.
- Pedir permissões que o app não usa. A Meta cita permissões desnecessárias como motivo comum de rejeição no App Review.
- Gravar um vídeo só para as duas permissões. A Meta quer uma gravação de tela e uma explicação escrita separadas para cada uma, e pode rejeitar um vídeo que mostre várias.
- Pedir que o cliente conecte pelo mesmo telefone que tem o número. O pop-up da Meta abre ali em uma nova aba, e esse mesmo telefone precisa escanear o QR code, então um computador é mais fácil.
Seu backend recebe o token de negócio de cada cliente, a Meta entrega as mensagens direto no seu webhook, e as desconexões chegam a você como eventos assinados. De US$ 9 a US$ 0.75 por conexão ao mês, caindo à medida que você adiciona conexões, com os 3 primeiros dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Preciso ser Meta Tech Provider para integrar os números WhatsApp dos meus clientes?
Só para executar o Embedded Signup pelo seu próprio app da Meta. Enviar os clientes a uma página hospedada operada por um Tech Provider conecta os números sem a sua própria verificação de negócio nem App Review.
Quanto tempo leva o App Review da Meta para um app do WhatsApp?
A Meta informa uma média de cerca de 24 horas. A verificação de negócio precisa estar concluída antes que a revisão possa começar, e cada envio rejeitado acrescenta mais uma rodada.
O seu cliente continua usando o app do WhatsApp Business?
Sim. O app segue funcionando no telefone dele ao lado da API, e as mensagens são espelhadas entre os dois. Alguns recursos do app mudam: as listas de transmissão ficam somente leitura, e as mensagens temporárias e de visualização única são desativadas.
Quem paga a Meta pelas mensagens?
O cliente. A Meta cobra as mensagens enviadas pela API na conta WhatsApp Business do próprio cliente, com um método de pagamento que ele adiciona ali, enquanto as mensagens enviadas pelo app do WhatsApp Business continuam gratuitas.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em