WhatsApp Embedded Signup para os seus clientes: a sua própria app Tech Provider ou uma página alojada
Um SaaS pode ligar os números da app WhatsApp Business dos seus clientes à Cloud API através do Embedded Signup da Meta, de duas formas. Pode tornar-se ele próprio Meta Tech Provider, o que implica verificação da empresa, App Review com dois vídeos e uma implementação própria do Embedded Signup, ou enviar os clientes para uma página alojada do Embedded Signup gerida por um fornecedor que já é Tech Provider, e receber a ligação concluída.
A easyCoexistence executa o Embedded Signup da Meta com Coexistence numa página alojada que tem o seu nome, para que os seus clientes liguem os números sem que o seu negócio tenha de se tornar Tech Provider.
Novos clientes empresariais que um Tech Provider pode integrar por cada período rolante de 7 dias: 10 por predefinição, 200 após verificação e revisão.
Gravações de ecrã que o App Review pede a um Tech Provider: uma mensagem enviada e recebida, e um template a ser criado.
Tempo médio de resposta anunciado pela Meta para o App Review de uma app WhatsApp.
A versão mais antiga da app WhatsApp Business que um cliente pode ligar através do Coexistence.
Durante quanto tempo o código devolvido pelo Embedded Signup continua válido para o servidor o trocar pelo token empresarial do cliente.
Quais são as duas formas de integrar os números dos seus clientes?
Ambas usam o Embedded Signup da Meta com Coexistence e terminam no mesmo ponto: o número do cliente na Cloud API, a funcionar ainda na app WhatsApp Business, e o seu backend a guardar o token empresarial próprio do cliente. A diferença está em quem assume os requisitos da Meta e o código em torno da janela 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 exige a Meta para se tornar Tech Provider?
A Meta lista os passos no seu guia Become a Tech Provider, que o App Dashboard abre em Tech Provider onboarding do caso de uso WhatsApp:
- Uma app Meta com o caso de uso WhatsApp, ligada ao seu portefólio empresarial.
- Verificação da empresa, que vem primeiro: a Meta só inicia o App Review para uma empresa verificada.
- Definições da app, como um ícone, uma política de privacidade e uma categoria.
- Acesso avançado a
whatsapp_business_messagingewhatsapp_business_management, concedido através do App Review com uma explicação escrita e uma gravação de ecrã para cada um. - Duas gravações no total: uma mensagem enviada da sua app e recebida no WhatsApp, e a sua app a criar um template de mensagem.
O que constrói depois da aprovação?
O próprio onboarding, que os guias do Embedded Signup da Meta descrevem passo a passo:
- O fluxo no seu site, através do Facebook Login for Business e do SDK JavaScript da Meta, em domínios HTTPS que permita na app.
- Coexistence ativado na configuração do fluxo, com registo das sessões, exigido pela Meta para o efeito.
- Uma chamada ao servidor que troca o código devolvido pelo token empresarial do cliente em 30 segundos.
- Webhooks: a sua app subscrita à conta de cada cliente, com os campos
account_update, history,smb_app_state_syncesmb_message_echoes. - A sincronização de contactos e histórico em 24 horas após o onboarding; depois disso, o cliente tem de se desligar e voltar a executar o fluxo.
O que assume a página alojada?
Toda a parte do pop-up. A easyCoexistence executa o Embedded Signup com Coexistence através da sua própria app Meta como Tech Provider, numa página em easycoexistence.com que mostra o seu nome. A troca do token, a subscrição dos webhooks e o pedido de histórico acontecem aí, e o seu backend recebe um id de ligação. Com um webhook_url na sessão, a Meta entrega as mensagens do número diretamente ao seu servidor, juntamente com a importação única dos contactos e, quando o cliente a partilha, até 180 dias de conversas. O seu código chama então a Graph API da Meta diretamente com o token do cliente, enquanto a easyCoexistence acompanha o número e envia eventos assinados quando ele muda.
O que vê o seu cliente?
Uma página com o seu nome e um só botão Connect. Antes de abrir o pop-up da Meta, uma lista de verificação pede ao cliente que confirme cinco coisas: uma app WhatsApp Business atualizada, um número em uso real há pelo menos 7 dias, nenhum outro fornecedor de API ou ferramenta de automação nele, nenhuma app não oficial e o telemóvel à mão com um início de sessão no Facebook. Não lhe é pedida nenhuma conta, e-mail ou cartão.
O que acontece dentro do pop-up da Meta?
O fluxo da Meta inicia sessão do cliente com o Facebook, pede-lhe que autorize a app e que introduza o número, e mostra o perfil da app WhatsApp Business desse número para confirmar. Depois, o cliente escolhe ou cria um portefólio empresarial e digitaliza um código QR a partir da própria app WhatsApp Business; a Meta envia também ao número uma mensagem WhatsApp com uma ligação para o código. Na app, toca em Connect e escolhe se partilha o histórico de conversas. Por fim, fornece o nome da conta, um fuso horário e aceita os termos da Meta. A ordem pode variar enquanto a Meta lança o seu fluxo centrado no número de telefone.
De quem é o nome que aparece no pop-up da Meta?
O nome da app que pede acesso. Na página alojada é o da easyCoexistence, que não pode ser alterado, enquanto a página em redor do pop-up mostra o seu nome, vindo de partner_name. Uma app Tech Provider própria mostra o nome da sua app, ao custo da verificação, da revisão e da implementação descritas acima.
O que é a regra dos 14 dias?
A Meta desliga um número Coexistence quando o telemóvel que tem a app WhatsApp Business esteve inativo durante cerca de 14 dias, e indica o motivo como PRIMARY_INACTIVITY. O cliente volta a ligar ao executar de novo o fluxo com o mesmo número. Através da página alojada, a easyCoexistence acompanha cada número e envia ao seu URL de eventos connection.disconnected com esse motivo, para que uma nova hiperligação de Connect enviada ao cliente possa repor o número.
Erros comuns
- Construir com o Embedded Signup v2 ou v3. A Meta descontinuou ambas a 15 de outubro de 2026 e responde aos pedidos para elas como v4.
- Pedir permissões que a app não usa. A Meta indica as permissões desnecessárias como um motivo frequente de rejeição de uma submissão no App Review.
- Gravar um vídeo para as duas permissões. A Meta quer uma gravação de ecrã e uma explicação escrita separadas para cada uma, e pode rejeitar um vídeo que mostre várias.
- Pedir aos clientes que liguem a partir do telemóvel que tem o número. O pop-up da Meta abre aí num novo separador, e esse mesmo telemóvel tem de digitalizar o código QR, por isso um computador é mais fácil.
O seu backend recebe o token próprio de cada cliente, a Meta entrega as mensagens diretamente ao seu webhook, e as quedas chegam-lhe como eventos assinados. De US$ 9 a US$ 0,75 por ligação por mês, descendo à medida que se adicionam ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Preciso de ser Meta Tech Provider para integrar os números WhatsApp dos seus clientes?
Só para executar o Embedded Signup a partir da sua própria app Meta. Enviar os clientes para uma página alojada gerida por um Tech Provider liga os números deles sem verificação da empresa própria nem App Review.
Quanto tempo demora o App Review da Meta para uma app WhatsApp?
A Meta situa a média em cerca de 24 horas. A verificação da empresa tem de estar concluída antes de a revisão poder começar, e cada submissão rejeitada acrescenta mais uma ronda.
O cliente continua a usar a app WhatsApp Business?
Sim. A app continua a funcionar no telemóvel dele ao lado da API, e as mensagens são espelhadas entre as duas. Algumas funcionalidades mudam: as listas de difusão passam a ser só de leitura, e as mensagens temporárias e de visualização única ficam desativadas.
Quem paga à Meta pelas mensagens?
O cliente. A Meta fatura as mensagens enviadas pela API à conta WhatsApp Business do próprio cliente, com um método de pagamento que este adiciona lá, enquanto as mensagens enviadas a partir da app WhatsApp Business continuam gratuitas.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em