O Cadastro Incorporado é uma interface compatível com computador e com dispositivos móveis para autenticação e autorização que ajuda ainda mais os clientes da sua empresa a gerarem os ativos necessários para integrá-los com sucesso à Plataforma do WhatsApp Business.

O flow de Cadastro Incorporado reúne informações relacionadas com o negócio dos clientes da sua empresa, gera automaticamente todos os ativos do WhatsApp necessários para a plataforma e concede ao seu app acesso a esses ativos para que você possa fornecer de modo rápido serviços de mensagens do WhatsApp aos seus clientes empresariais.

Como funciona

O Cadastro Incorporado faz uso do Login do Facebook para Empresas e do SDK do JavaScript. Depois de configurado, você pode adicionar um link ou botão ao seu site ou portal que lança o flow.

Os clientes empresariais que clicarem no link ou botão verão uma nova janela onde poderão:

autenticar sua identidade usando as Credenciais de Negócios do Facebook ou da Meta

aceitar os Termos de Serviço da API de Nuvem, do WhatsApp Business, da Meta, da API de Mensagens de Marketing Lite e das Ferramentas da Meta para Empresas

selecionar várias APIs do WhatsApp e aceitar os Termos de Serviço

conceder acesso aos ativos do WhatsApp para seu app

selecionar um portfólio empresarial existente ou criar um novo

selecionar uma Conta do WhatsApp Business (WABA) ou criar uma nova

inserir e verificar seu número de telefone comercial (informado por eles ou fornecido por você)

inserir um nome de exibição que pode aparecer no lugar do número no cliente do WhatsApp

Após a conclusão bem-sucedida, o Cadastro Incorporado fornecerá a identificação da WABA do cliente, o número de telefone comercial e um código de token fungível na janela que gerou o flow. Você deve enviar esses dados para seu servidor e usá-los em uma chamada entre servidores para:

trocar o código por um token empresarial no escopo do cliente

registrar o número de telefone comercial do cliente para uso da API de Nuvem

inscrever seu app em webhooks na WABA do cliente

compartilhar sua linha de crédito com o cliente (apenas parceiros de soluções)

Quando essas etapas estiverem concluídas, se você for um parceiro de soluções ou tiver uma parceria com um, o cliente poderá começar a usar seu app ou o do seu parceiro para enviar mensagens imediatamente. Se você não for um parceiro de soluções ou não tem parceria com um, o cliente deverá primeiro adicionar uma forma de pagamento à WABA antes de poder começar a enviar mensagens.

Estamos testando uma nova experiência no flow de Cadastro Incorporado para todas as versões. O flow em si não foi alterado, mas, depois da conclusão, você poderá ver um novo botão Ver seu guia de configuração. Ao clicar nessa opção, você acessará uma nova página de orientação de configuração no Gerenciador do WhatsApp, que oferece as próximas etapas sobre:

Verificação da empresa

Resolver problemas de integridade e acessar a Página Inicial do Suporte para Empresas

Enviar a primeira mensagem por meio de uma solução de parceiro

Enviar mensagens iniciadas pela empresa usando modelos

Propriedade de ativo

Os clientes empresariais integrados via Cadastro Incorporado são proprietários dos respectivos ativos do WhatsApp e podem utilizar esses ativos com outras soluções da Meta, como Anúncios de clique para o WhatsApp⁠.

Também têm acesso total ao Gerenciador do WhatsApp⁠, que pode ser usado para acessar os ativos. Não é possível restringir o acesso. Consulte os ativos disponíveis neste link.

Limitações

Limites da integração

Por padrão, você pode integrar até 10 novos clientes empresariais em uma janela de 7 dias consecutivos. Somente clientes recém-integrados contam para esse limite. É possível ver a contagem atual de clientes integrados em Gerenciador do WhatsApp > Visão geral do parceiro. Você receberá uma notificação por email se chegar perto desse limite.

Se você concluir a verificação da empresa, a análise do app e a verificação de acesso, aumentaremos automaticamente seu limite para 200 novos clientes empresariais em uma janela de 7 dias consecutivos. Caso seja preciso integrar mais de 200 clientes por semana, inscreva-se para se tornar um Parceiro de Negócios da Meta⁠.

Observação: contas do WhatsApp Business (WABAs) existentes que foram criadas originalmente por meio do app do desenvolvedor não podem ser selecionadas ou integradas diretamente por meio do flow de Cadastro Incorporado.

Limites de mensagens para clientes empresariais

Os clientes empresariais integrados via Cadastro Incorporado começam com limites de mensagens padrão, que podem ser aumentados por meio do uso da API.

Limites de número de telefone comercial de clientes

Números de telefone comercial só poderão ser registrados para uso com a API de Nuvem.

Números de telefone comercial já em uso com o app WhatsApp Business⁠ são aceitos, mas exigem que você personalize o flow para habilitar a integração de usuários do app WhatsApp Business (também conhecida como "coexistência").

Os clientes empresariais integrados por meio do Cadastro Incorporado começam com limites de mensagens padrão.

Flow da API de Nuvem

Consulte Flow da API de Nuvem para ver a descrição de cada tela que será apresentada aos seus clientes empresariais como parte da implementação padrão do Cadastro Incorporado.

Se você souber informações sobre a empresa do cliente, poderá inserir esses dados, o que pode reduzir significativamente o número de telas com as quais os clientes têm que interagir.

Tokens de acesso

O Cadastro Incorporado gera tokens comerciais. Quando um cliente empresarial conclui o flow de Cadastro Incorporado, um código de token fungível será retornado como um evento de mensagem e capturado pelo SDK do JavaScript. Você precisará trocar o código por um token empresarial fazendo uma chamada de servidor para servidor.

Se você for um Provedor de Tecnologia, usará exclusivamente tokens empresariais.

Caso você seja um parceiro de soluções, usará seu token de acesso de usuário do sistema ("token do sistema") para compartilhar sua linha de crédito com os clientes empresariais integrados, além de tokens empresariais para todo o resto. Observe que o usuário do sistema representado pelo token deve ter concedido ao seu app a permissão business_management e deve ter recebido a função de administrador ou editor financeiro no seu portfólio empresarial para poder compartilhar sua linha de crédito.

Permissões

O Cadastro Incorporado pode ser configurado para oferecer suporte a produtos de mensagens da empresa para seus clientes. Caso você tenha interesse apenas no flow da API de Nuvem, precisará provavelmente apenas das seguintes permissões:

whatsapp_business_management: necessária caso seu app precise de acesso às configurações da Conta do WhatsApp Business e aos modelos de mensagens do cliente integrado.

whatsapp_business_messaging: necessária caso seu app precise acessar as configurações de número de telefone comercial do cliente integrado ou se ele for usado pelos clientes para enviar e receber mensagens.

Você pode especificar de quais permissões seu app precisa durante o processo de implementação.

Enquanto seu app estiver em modo de desenvolvimento, essas permissões aparecerão na tela de autorização do Cadastro Incorporado para qualquer pessoa que tenha uma função deadmin, desenvolvedor ou testador no seu app. No entanto, assim que mudar seu app para o modo publicado, apenas as permissões que foram aprovadas para acesso avançado no processo de Análise do App aparecerão no flow.

Cobrança

Parceiros de soluções

Se você for um parceiro de soluções, já deverá ter uma linha de crédito⁠ e ter aceitado os termos da API de Alocação de Crédito no painel Configurações do negócio > Pagamentos na Meta Business Suite. Além disso, você deve compartilhar sua linha de crédito com qualquer cliente como parte do processo de integração.

Provedores e parceiros de tecnologia

Se você for um provedor ou parceiro de tecnologia, os clientes empresariais integrados deverão adicionar uma forma de pagamento à conta do WhatsApp Business deles. Eles podem fazer isso seguindo as etapas descritas no artigo Como adicionar um cartão de crédito à sua conta da Plataforma do WhatsApp Business⁠ da Central de Ajuda.

Contas de sandbox

É possível testar o flow Cadastro incorporado usando sua própria conta do Facebook, mas isso pode gerar portfólios empresariais, WABAs e números de telefone comerciais adicionais. Caso você não queira sobrecarregar sua conta do Facebook com dados de teste, solicite uma conta de teste de sandbox para simular um cliente empresarial concluindo o flow.

Quando você concluir o flow usando a conta de sandbox, a identificação da WABA e do número de telefone comercial, além de um código de token que pode ser trocado, serão retornados, como se fosse um cliente real.

Limitações da conta de sandbox

Elas são válidas por 30 dias. Depois desse período, serão desativadas e deverão ser recuperadas para serem usadas novamente.

Esse tipo de conta não pode ser usado para criar portfólios empresariais de sandbox, WABAs ou números de telefone comerciais adicionais. Os ativos são gerados automaticamente e aparecerão no flow Cadastro Incorporado.

A conta de sandbox está associada ao administrador do app. Para que os ativos da conta de sandbox apareçam no flow Cadastro Incorporado, o administrador do app deve estar conectado à conta de desenvolvedor da Meta.

O portfólio empresarial da conta de sandbox não aparecerá no Meta Business Suite nem no Gerenciador do WhatsApp.

Você pode trocar o código de token retornado pelo token empresarial da conta de sandbox e usá-lo para consultar dados sobre a identificação da WABA, mas o número de telefone comercial não pode ser utilizado para enviar nem receber mensagens.

Reivindicar contas de sandbox

Para reivindicar uma conta de sandbox:

Acesse Painel de Apps > WhatsApp > Início rápido.

Encontre a seção Integrações de teste.

Clique no botão Reivindicar conta de sandbox.

Excluir contas de sandbox

A funcionalidade de exclusão de contas de sandbox será lançada de forma gradual nas próximas semanas, a partir de 25 de junho de 2025.

Caso você tenha encerrado os testes e queira manter seu ambiente de teste limpo, será possível excluir a conta de sandbox. A exclusão é irreversível e removerá todos os dados de teste associados. Se você excluir sua conta de sandbox por engano, mas precisar testar novamente, será necessário solicitar uma nova.

Para excluir uma conta de sandbox:

Acesse Painel de Apps > WhatsApp > Início rápido.

Encontre a seção Integrações de teste para localizar sua conta de sandbox.

Clique no botão Excluir conta da sua conta de sandbox.

Números de telefone comerciais 555

Clientes empresariais podem receber até dois números de telefone comerciais 555. Esses números têm o mesmo comportamento de telefones comerciais tradicionais (sujeitos às regras de preços, afetados pelas classificações de qualidade, entre outros), mas precisam receber aprovação do nome de exibição antes de enviar mensagens. Além disso, os números 555:

Têm um código de chamada de país dos Estados Unidos (+1)

Têm um código de área 555

São verificados automaticamente

Não podem ser migrados para outra conta do WhatsApp Business nem usados fora da plataforma

Se os seus clientes empresariais estiverem qualificados, a tela para adicionar números de telefone mostrará de forma automática a opção de escolher um número 555:

Migração de ativos do WhatsApp

O Cadastro Incorporado pode ser usado de diversas maneiras para migrar ativos de clientes empresariais integrados. Consulte o artigo Como migrar ativos de clientes empresariais.

Análise do app

Você não conseguirá integrar clientes empresariais até que seu app tenha sido aprovado para acesso avançado para cada uma das permissões necessárias.

Consulte Análise do App para saber mais sobre esse tópico e o que você deve fornecer para concluir o processo com sucesso.

O Auxiliar de integração de Cadastro Incorporado é uma ferramenta de configuração e teste no Painel de Apps. Com a ferramenta, você pode:

lançar o Cadastro Incorporado em várias configurações de flow

ver dados que são retornados quando um cliente empresarial conclui o flow

gerar um código de implementação e consultas de integração, que você pode copiar e colar no seu site, portal de clientes empresariais e servidor

enviar consultas de API para pontos de extremidade que você precisará usar ao integrar clientes que concluem o flow

Você pode acessar o auxiliar de integração navegando até Painel de Apps > WhatsApp > Configurador de Cadastro Incorporado.

Observação: o Auxiliar de integração de Cadastro Incorporado está disponível apenas para apps empresariais. Veja o tipo de app na parte superior do Painel de Apps.

Webhooks

Como parte do processo de integração, você deve inscrever seu app no webhook na WABA de cada cliente empresarial que concluir o flow de Cadastro Incorporado.

Webhooks serão disparados e enviados para o URL de retorno de chamada configurado no seu app, de acordo com os campos de webhook que você assinou. Isso significa que todos os webhooks para todos seus clientes empresariais integrados serão enviados para o URL de retorno de ligação do seu app. Contudo, você pode substituir o URL de retorno de ligação em uma Conta do WhatsApp Business ou número de telefone comercial individual. Consulte Substituições de webhook para saber como fazer isso.

Localização

O flow de Cadastro Incorporado está disponível em 30 idiomas. O flow localizado é disparado automaticamente com base no idioma em que o cliente empresarial usa o Facebook.

Árabe, tcheco, dinamarquês, grego, inglês (Reino Unido), espanhol (Espanha), espanhol, finlandês, francês (França), hebraico, hindi, húngaro, indonésio, italiano, japonês, coreano, norueguês (bokmal), holandês, polonês, português (Brasil), português (Portugal), romeno, russo, sueco, tailandês, turco, vietnamita, chinês simplificado (China), chinês tradicional (Hong Kong), chinês tradicional (Taiwan).

Próximas etapas

Saiba como implementar o Cadastro Incorporado no seu site ou portal.

Você achou esta página útil?