Cadastro incorporado

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

Ocorreu um erro

Estamos tendo problemas ao reproduzir este vídeo.

Saiba mais

O fluxo do 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.

Os clientes integrados via cadastro incorporado são proprietários de todos os seus ativos do WhatsApp e podem aproveitar esses ativos com outras soluções da Meta, como Anúncios de clique para o WhatsApp.

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 fluxo.

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
• conceder ao seu app acesso aos ativos do WhatsApp
• selecionar um portfólio empresarial existente ou criar um novo
• selecionar uma Conta do WhatsApp Business (WABA, na sigla em inglês) 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 retornará, para a janela que gerou o fluxo, o ID da WABA do cliente, o número de telefone comercial e um código token trocável. 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 no 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.

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. Se você precisar integrar mais de 200 clientes por semana, inscreva-se para se tornar um Parceiro de Negócios da Meta.

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

• Os números de telefone comercial só podem ser registrados para uso com a API de Nuvem.
• Os números de telefone comercial já registrados para uso com a API Local, ou em uso com o WhatsApp ou app do WhatsApp Business não são compatíveis.
• Os clientes empresariais integrados via cadastro incorporado começam com limites padrão de números de telefone comercial.

Fluxo padrão

Consulte Default Flow 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.

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

Tokens de acesso

O cadastro incorporado gera tokens de acesso ao sistema de integração comercial ("tokens empresariais"). Quando um cliente empresarial conclui o fluxo de cadastro incorporado, um código de token trocá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, e 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 solicitar a maioria das permissões dos clientes da sua empresa, mas provavelmente você precisará apenas de:

• 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.

Observe que, 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 de administrador, 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 fluxo.

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.

Números de telefone comercial 555

Clientes empresariais com empresas verificadas ou empresas que tiveram um aumento no limite de mensagens da API de Nuvem estão qualificados para até dois números de telefone comercial 555.

Esses números se comportam da mesma maneira que os números de telefone comercial padrão (têm nomes de exibição que devem ser revisados ​​e aprovados, estão sujeitos a regras de preços baseados em conversa, são afetados pelas classificações de qualidade e assim por diante), com as seguintes diferenças principais:

• 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

Caso seus clientes comerciais estejam qualificados para números 555 e queiram registrar um como um número adicional, instrua-os a implementar novamente o cadastro incorporado. Quando forem solicitados a selecionar um número de telefone comercial, eles verão automaticamente a opção para incluir um número 555:

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.

Auxiliar de integração

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 fluxo
• ver dados que são retornados quando um cliente empresarial conclui o fluxo
• 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 fluxo

Você pode acessar o auxiliar de integração acessando Painel de Apps > WhatsApp > Integração de ES.

Webhooks

Como parte do processo de integração, você deve inscrever seu app no webhook na WABA de cada cliente empresarial que concluir o fluxo 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 os 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 fluxo de cadastro incorporado está disponível em 30 idiomas. O fluxo 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.