Se não quiser implementar o Cadastro incorporado adicionando um código JavaScript ao seu site ou portal do cliente, você poderá usar um link que, quando clicado, exibe uma página da web descrevendo as etapas de integração e um botão que inicia o fluxo de Cadastro incorporado:

Limitações

O Cadastro incorporado hospedado ("ES hospedado") só pode ser usado para integrar clientes empresariais à API de Nuvem, e o fluxo não pode ser personalizado.

Requisitos

Você deve concluir as etapas para se tornar um Parceiro de Soluções ou Provedor de Tecnologia.

Se o app for de mensagens, será necessário enviar mensagens, gerenciar modelos e ter um ponto de extremidade de webhook de produção devidamente configurado.

É preciso inscrever seu app no webhook account_update.

Os Parceiros de Soluções devem ter uma linha de crédito.

Você também precisará do seguinte:

Seu token do sistema.

A chave secreta do app.

Se você ainda não tiver uma configuração do Login do Facebook para Empresas, crie uma. Uma configuração do Login do Facebook para Empresas define quais permissões serão solicitadas e quais informações adicionais serão coletadas dos clientes empresariais que acessarem o Cadastro incorporado.

Navegue até Login do Facebook para Empresas > Configurações e clique no botão + Criar configuração para acessar o fluxo de configuração.

Use um nome que ajude a diferenciar essa configuração de outras que você possa criar no futuro. Ao concluir o fluxo, selecione a variação de login do Cadastro incorporado do WhatsApp:

Ao escolher ativos e permissões, selecione apenas aqueles que você realmente precisará dos seus clientes empresariais.

Por exemplo, se você selecionar o ativo Catálogos sem necessidade de acesso aos catálogos dos clientes, eles provavelmente abandonarão o fluxo na tela de seleção de catálogo e solicitarão esclarecimentos.

Etapa 2: conseguir a URL do Cadastro incorporado hospedado

Navegue até o painel WhatsApp > Início rápido e clique no botão Ver integração.

Encontre o cartão Sem necessidade de integração. A URL exibida no cartão é a URL da página de integração:

Clique no botão Copiar para copiar a URL para a área de transferência. Mapeie essa URL para um botão no seu site ou portal do cliente que, quando clicado, abre a URL em uma nova janela do navegador.

Para ver como isso acontece, carregue a URL em uma nova janela ou aba do navegador ou clique no ícone azul "nova janela", que faz a mesma coisa.

A página de integração fica assim:

Clique no botão Começar. Esse é o fluxo que será visto pelos clientes empresariais que clicarem no botão no seu site ou portal do cliente. Conclua o fluxo, se desejar.

Etapa 3: capturar IDs de ativos de cliente

Quando um cliente empresarial concluir o fluxo, um webhook account_update será disparado com event definido como PARTNER_ADDED. Capture a identificação da conta do WhatsApp Business e a identificação do portfólio empresarial do cliente a partir da carga do webhook.

Etapa 4: gerar um hash HMAC-SHA256

Gere um hash HMAC-SHA256 da chave secreta do app e do token do sistema.

Exemplo de bash para Linux e macOS

echo -n "<SYSTEM_TOKEN>" | openssl dgst -sha256 -hmac "<APP_SECRET>"

<SYSTEM_TOKEN> – Seu token do sistema.

<APP_SECRET> – A chave secreta do app (Painel de Apps > Configurações do app > Básico)

Etapa 5: conseguir um token da empresa

Use o ponto de extremidade POST /<BUSINESS_PORTFOLIO_ID>/system_user_access_tokens para obter e capturar o token da empresa do cliente. (Faça o direcionamento para a identificação do portfólio empresarial do cliente, não para a sua).

Sintaxe da solicitação

curl 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PORTFOLIO_ID>/system_user_access_tokens' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Authorization: Bearer <SYSTEM_TOKEN>' \
-d 'appsecret_proof=<APPSECRET_PROOF>' \
-d 'fetch_only=true'

<API_VERSION> – Versão da API.

<APPSECRET_PROOF> – Hash HMAC-SHA256 da chave secreta do app e do token do sistema.

<BUSINESS_PORTFOLIO_ID> – A identificação do portfólio empresarial do cliente.

<SYSTEM_TOKEN> – Seu token do sistema.

Sintaxe da resposta

Caso a solicitação seja bem-sucedida:

{
  "access_token": "<BUSINESS_TOKEN>"
}

<BUSINESS_TOKEN> – O token empresarial do cliente.

Etapa 6: conseguir o ID do número de telefone comercial do cliente

Use o ponto de extremidade GET /<WHATSAPP_BUSINESS_ACCOUNT_ID>/phone_numbers para obter e capturar a identificação de número de telefone comercial do cliente.

Sintaxe da solicitação

curl 'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_ACCOUNT_ID>/phone_numbers' \
-H 'Authorization: Bearer <BUSINESS_TOKEN>'

<API_VERSION> – Versão da API.

<BUSINESS_TOKEN> – Token empresarial do cliente.

<WABA_ID> – Identificação da conta do WhatsApp Business do cliente empresarial.

Sintaxe da resposta

{
  "data": [
    {
      "verified_name": "<VERIFIED_NAME>",
      "code_verification_status": "<CODE_VERIFICATION_STATUS>",
      "display_phone_number": "<DISPLAY_PHONE_NUMBER>",
      "quality_rating": "<QUALITY_RATING>",
      "platform_type": "<PLATFORM_TYPE>",
      "throughput": {
        "level": "<THROUGHPUT_LEVEL>"
      },
      "last_onboarded_time": "<LAST_ONBOARDED_TIME>",
      "webhook_configuration": {
        "application": "<WEBHOOK_CALLBACK_URL>"
      },
      "id": "<BUSINESS_PHONE_NUMBER_ID>"
    }
  ]
}

<BUSINESS_PHONE_NUMBER_ID> – Identificação do número de telefone comercial.

<CODE_VERIFICATION_STATUS> – Status de verificação do número de telefone comercial.

<DISPLAY_PHONE_NUMBER> –– Número de telefone comercial para exibição.

<LAST_ONBOARDED_TIME> – Registro de data e hora UNIX que indica quando o número foi adicionado à conta do WhatsApp Business do cliente empresarial (basicamente, quando o cliente concluiu o fluxo com sucesso).

<PLATFORM_TYPE> – Plataforma.

<QUALITY_RATING> – Classificação de qualidade do número de telefone comercial.

<THROUGHPUT_LEVEL> – Nível de taxa de transferência de dados.

<VERIFIED_NAME> – Nome verificado do número de telefone comercial.

<WEBHOOK_CALLBACK_URL> – URL de retorno de ligação do webhook associada ao número.