Plataforma do WhatsApp Business

Primeiros passos

Este documento descreve as etapas e os requisitos necessários para você integrar o fluxo de Cadastro Incorporado ao seu site ou portal do cliente.

Antes de começar

Para começar a integração do fluxo de Cadastro Incorporado, primeiro é preciso configurar um Gerenciador de Negócios e um app da Meta.

Gerenciador de Negócios

Você precisa de uma conta do Gerenciador de Negócios para gerenciar sua linha de crédito e as contas do WhatsApp Business (WABAs, pelas iniciais em inglês) de clientes integrados. Para ver mais informações sobre como criar uma conta empresarial, consulte Criar um Gerenciador de Negócios. Assim que o Gerenciador de Negócios estiver configurado, faça a verificação da sua empresa.

App da Meta

Na conta de desenvolvedor da Meta, crie um app do tipo Empresa. No painel Apps, é possível acessar todos os seus apps da Meta para controlar configurações e solicitar permissões.

Os apps do tipo Empresa são automaticamente aprovados para o acesso padrão a todas as permissões e recursos disponíveis. Dessa maneira, você pode desenvolver e testar o app nesse nível de acesso.

Efetivamente, o nível padrão restringe os apps de empresa, que só poderão acessar os dados de propriedade de usuários que tiverem uma função no app ou na empresa. Para ser lançado, o app da Meta precisa passar pela análise e solicitar acesso avançado à permissão whatsapp_business_management. Recomendamos iniciar esse processo o mais rápido possível. Para fazer isso, não é preciso esperar pela implementação completa do Cadastro Incorporado.

Você também precisa solicitar a permissão whatsapp_business_messaging para a API de Nuvem do WhatsApp porque ela é necessária para as chamadas de API.

É altamente recomendável que você não solicite outras permissões além dessas duas, já que isso atrasará o processo de cadastro.

Tokens de acesso

É possível usar os tokens de acesso de usuário do sistema de integração comercial e os tokens de acesso de usuário do sistema para acessar dados de clientes integrados. O tipo de token usado depende se o Cadastro Incorporado está sendo configurado com o Login do Facebook ou com o Login do Facebook para Empresas e se você é um provedor de tecnologia ou um parceiro de solução.

Provedores de tecnologia

O token de acesso de usuário do sistema de integração comercial é a opção preferencial para provedores de tecnologia, já que esse token tem como escopo clientes individuais. Para obter esses tokens, troque o código retornado a você quando um cliente conclui o Cadastro Incorporado configurado com o Login do Facebook para Empresas. Se você estiver usando o Cadastro Incorporado com o Login do Facebook (o que não é recomendado), opte pelo token de acesso de usuário do sistema.

Caso você esteja usando um token de acesso de usuário do sistema, o usuário do sistema deverá conceder ao seu app a permissão whatsapp_business_management.

Parceiros de soluções

É preciso usar um token de acesso de usuário do sistema para compartilhar sua linha de crédito com clientes integrados. Para todas as outras solicitações, a solução preferencial é usar um token de acesso do usuário do sistema de integração comercial.

Para obter um token de acesso do usuário do sistema de integração comercial, troque o código retornado quando um cliente conclui o Cadastro Incorporado configurado com o Login do Facebook para Empresas. Se você estiver usando o Cadastro Incorporado com o Login do Facebook (o que não é recomendado), opte pelo token de acesso de usuário do sistema.

Para tokens de acesso de usuário do sistema, o usuário do sistema deve conceder ao seu app a permissão whatsapp_business_management (que pode ser concedida ao gerar o token). Além disso, o usuário precisa receber a função de editor financeiro para poder compartilhar sua linha de crédito com clientes integrados.

Para atribuir a função de editor financeiro ao usuário do sistema:

  1. Acesse o Meta Business Suite.
  2. Encontre a conta empresarial no menu suspenso exibido no canto superior esquerdo. Clique em Configurações (ícone de engrenagem).
  3. Clique em Configurações do negócio.
  4. Navegue até Usuários > Usuários do sistema.
  5. Edite o usuário e conceda a função de editor financeiro.

Linha de crédito

Você precisa configurar uma linha de crédito para enviar mensagens com a Plataforma do WhatsApp Business. Essa linha de crédito será compartilhada com seus clientes. Por isso, verifique se você aceitou os termos da API de Alocação de Crédito em Configurações do negócio > Pagamentos no Gerenciador de Negócios.

Para informações sobre o compartilhamento da sua linha de crédito por meio do Gerenciador de Negócios (em vez de pela API), consulte Como compartilhar acesso ao faturamento mensal.

Cliente da API Local da Plataforma do WhatsApp Business

Ao usar a API Local, verifique se você está executando uma versão válida do cliente da WhatsApp Business API.

Processo de integração

Como parte do processo de integração, o app da Meta precisa passar pela análise e solicitar acesso avançado à permissão whatsapp_business_management. Recomendamos iniciar esse processo o mais rápido possível. Para fazer isso, não é preciso esperar pela implementação completa do Cadastro Incorporado.

1. Incorporar o fluxo de cadastros

Configure o SDK do Facebook para JavaScript e o Login do Facebook para incorporar o fluxo de cadastro ao seu site ou portal do cliente. Incorpore o fluxo em todos os seus sites e portais.

2. Integrar os pontos de extremidade

Após incorporar o fluxo de cadastro, faça a integração com os pontos de extremidade da API necessários para concluir o processo. Para prosseguir, você deve ser capaz de fazer o seguinte:

Quando o registro estiver concluído, use o ponto de extremidade message_templates para obter modelos de mensagem pré-aprovados e namespaces para que as empresas possam começar a enviar mensagens.

Você precisa usar um ponto de extremidade seguro (HTTPS). Para saber mais, consulte Segurança no login.

3. Registrar as WABAs para receber webhooks

Assim que as empresas tiverem concluído o cadastro, você poderá registrar todas as WABAs que devem receber webhooks. Configure os webhooks para notificarem você quando:

  • o nome de um número de telefone for atualizado;
  • o status de qualidade de um número de telefone for atualizado;
  • uma conta for analisada, atualizada ou banida.

Opcional

Se quiser, você pode fazer o seguinte:

Veja também