whatsapp-docs-mcp 1.0.0

package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/hosted_es.md

@@ -0,0 +1,153 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/hosted-es -->
+<!-- Scraped: 2025-12-20T17:49:48.178Z -->
+
+# Cadastro Incorporado Hospedado
+
+Updated: 4 de nov de 2025
+
+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:
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/557247008_1487309905743315_2332288243528054136_n.png?_nc_cat=105&ccb=1-7&_nc_sid=e280be&_nc_ohc=f4sSdPXnL-4Q7kNvwG2zyt1&_nc_oc=AdnvH-I2ZJ-qgVIxMCQe_vCa18YZWDoKyswi0lpLMIoCl2T90LHvlgXWXfDSFjtXUjw&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=a5SvKTsl6BA7cgE4izPyrw&oh=00_AflzqJKxIHn2N36_-KAO8bUVY1BFIIXEzEzx50jmss7oMQ&oe=69611CCA)
+
+## 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](/documentation/business-messaging/whatsapp/webhooks/reference/account_update).-   Os Parceiros de Soluções devem ter uma linha de crédito.
+
+Você também precisará do seguinte:
+
+-   Seu [token do sistema](/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens).-   A chave secreta do app.
+
+## Etapa 1: criar uma configuração do Login do Facebook para Empresas
+
+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:
+
+![](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/556678416_1155934729723662_8909215200649973782_n.png?_nc_cat=101&ccb=1-7&_nc_sid=e280be&_nc_ohc=SU4fbF6M0rwQ7kNvwEbsizN&_nc_oc=AdnXP8FxrrgXTofcW3n82O4wfSSsf7QP5xTSQWR68mO75-V3-B5pUSZ0_gmZCWY7DNQ&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=a5SvKTsl6BA7cgE4izPyrw&oh=00_AfmeJ4YB4i8GnYzbuuySUAuibYZj_dmgUYOuPO7QVrXFBA&oe=69611368)
+
+Ao escolher ativos e permissões, selecione apenas aqueles que você realmente precisará dos seus clientes empresariais.
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/556838067_777912301525569_1334774809437446260_n.png?_nc_cat=103&ccb=1-7&_nc_sid=e280be&_nc_ohc=Y9Gpv_F2t0AQ7kNvwHq-fEJ&_nc_oc=AdnZTqYf561hni7fXlWgzirVZ2a9EUfuZdjHUg5ecCw51xBdJKAPU14tJ2NT6JnBT0Q&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=a5SvKTsl6BA7cgE4izPyrw&oh=00_AfkxsLZNgzI8UjSNLEYVLlfV2kPUmiYQJwXC1wssQLjEtw&oe=69612661)
+
+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**.
+
+![](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/556820792_1873904266492750_8998264804748617024_n.png?_nc_cat=104&ccb=1-7&_nc_sid=e280be&_nc_ohc=P30ohxZgu_kQ7kNvwF2EDNg&_nc_oc=AdlTmreVyXosSKNVZsTcmT0XsjELKAtwmExp4FzkOmxdP5bxDmh8yJnDHPF9LRaJ7yE&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=a5SvKTsl6BA7cgE4izPyrw&oh=00_Afk0FZdLPRXW4AMr17CwoPx_BkRRxu2NI-iQ1zfXmukfeA&oe=69611829)
+
+Encontre o cartão **Sem necessidade de integração**. A URL exibida no cartão é a URL da página de integração:
+
+![](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/556828984_1430417581383742_4223219994357738350_n.png?_nc_cat=101&ccb=1-7&_nc_sid=e280be&_nc_ohc=eGzEsXX7PkMQ7kNvwEski_0&_nc_oc=Adn0dXYNynngzxTD0kT3yb7OPoosLlSSCAclxkGbqaUMa9rriFUVrQENoGig6Ez8nyM&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=a5SvKTsl6BA7cgE4izPyrw&oh=00_Afnmacjzv4Q7I2AlMec78cMVCHXWrWkuNXM5pVZkbVovHQ&oe=696132AB)
+
+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:
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/557247008_1487309905743315_2332288243528054136_n.png?_nc_cat=105&ccb=1-7&_nc_sid=e280be&_nc_ohc=f4sSdPXnL-4Q7kNvwG2zyt1&_nc_oc=AdnvH-I2ZJ-qgVIxMCQe_vCa18YZWDoKyswi0lpLMIoCl2T90LHvlgXWXfDSFjtXUjw&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=a5SvKTsl6BA7cgE4izPyrw&oh=00_AflzqJKxIHn2N36_-KAO8bUVY1BFIIXEzEzx50jmss7oMQ&oe=69611CCA)
+
+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](/documentation/business-messaging/whatsapp/webhooks/reference/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**](/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](/docs/marketing-api/reference/business/system_user_access_tokens#Creating) para obter e capturar o [token da empresa](/documentation/business-messaging/whatsapp/access-tokens#business-integration-system-user-access-tokens) 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](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/phone-number-management-api#Reading) 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.
+
+## Etapa 7: integrar o cliente
+
+Para integrar o cliente empresarial, siga as etapas descritas no guia apropriado abaixo:
+
+-   [Integrar clientes empresariais como Provedor de Tecnologia ou Parceiro de Tecnologia](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-customers-as-a-tech-provider) (pule a etapa 1)-   [Integrar clientes empresariais como Parceiro de Soluções](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-customers-as-a-solution-partner) (pule a etapa 1)
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/implementation.md

@@ -0,0 +1,417 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/implementation -->
+<!-- Scraped: 2025-12-20T17:48:16.496Z -->
+
+# Implementação
+
+Updated: 4 de nov de 2025
+
+Este documento explica como implementar o Cadastro Incorporado v4 e capturar os dados gerados para [integrar clientes comerciais](#onboarding-business-customers) à Plataforma do WhatsApp Business.
+
+## Antes de começar
+
+-   É preciso ser um [Parceiro de Soluções](/documentation/business-messaging/whatsapp/solution-providers/get-started-for-solution-partners) ou [Provedor de Tecnologia](/documentation/business-messaging/whatsapp/solution-providers/get-started-for-tech-providers).-   Caso os clientes da empresa usem seu app para enviar e receber mensagens, você já deve saber como usar a API para fazer isso por meio da sua própria conta do WhatsApp Business e números de telefone comercial. Você também deve saber como criar e gerenciar modelos e ter um ponto de extremidade de retorno de ligação de webhooks devidamente configurado para processar webhooks.-   É preciso assinar o webhook [account\_update](/documentation/business-messaging/whatsapp/webhooks/reference/account_update), já que ele é disparado quando um cliente conclui com sucesso o fluxo de Cadastro Incorporado e contém as informações da empresa necessárias para você.-   Caso você seja um Parceiro de Soluções, já deve ter uma [linha de crédito](https://www.facebook.com/business/help/1684730811624773?id=2129163877102343).-   O servidor que hospeda o Cadastro Incorporado deve ter um certificado SSL válido.
+
+## Etapa 1: adicionar domínios permitidos
+
+Carregue o app no [Painel de Apps](/apps) e acesse **Login do Facebook para Empresas** > **Configurações** > **Configurações de OAuth do cliente**:
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/465708937_913631386932225_3931496644600528212_n.png?_nc_cat=110&ccb=1-7&_nc_sid=e280be&_nc_ohc=4cLZmEZZD8MQ7kNvwFubqgE&_nc_oc=Adm14P9xMMUNMTUfartuVqBw-0-UCl3UlkIoLfotGPHZNhmdjS5jJgKIlU1BxPBpxTw&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=oQSOSuCTU-3MoHIjjGOCxw&oh=00_Afk7I3OU6MvXWA0n6bEct7mKccBjcSN8eXiSC9aAilNOHw&oe=6961190C)
+
+Defina como **Sim** as seguintes opções:
+
+-   **Login do cliente com OAuth**-   **Login do OAuth da web**-   **Aplicar HTTPS**-   **Login com OAuth via navegador incorporado**-   **use o modo restrito para URIs de redirecionamento**-   **Login com o SDK do JavaScript**
+
+O Cadastro Incorporado depende do SDK do JavaScript. Quando um cliente empresarial concluir o fluxo de Cadastro Incorporado, a identificação da conta do WhatsApp Business, a identificação do número de telefone comercial e um código de token que pode ser trocado serão retornados para a janela que gerou o fluxo, mas apenas se o domínio da página que gerou o fluxo estiver listado nos campos **Domínios permitidos** e **URIs de redirecionamento de OAuth válidos**.
+
+Nesses campos, adicione todos os domínios em que você planeja hospedar o Cadastro Incorporado, incluindo domínios de desenvolvimento em que testará o fluxo. Apenas domínios que habilitaram **HTTPS** são compatíveis.
+
+## Etapa 2: criar uma configuração do Login do Facebook para Empresas
+
+Uma configuração do Login do Facebook para Empresas define quais permissões serão pedidas 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**:
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/518383927_1808192009811748_4848992549354412342_n.png?_nc_cat=107&ccb=1-7&_nc_sid=e280be&_nc_ohc=el3DH_YlbqgQ7kNvwEoIvq0&_nc_oc=AdkrA_zxnP9d2IkJz0ZT776ay-DkqbwRxtLyakMawjhFL4aqfzVDp5JQfSu-D6Rk4ZY&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=oQSOSuCTU-3MoHIjjGOCxw&oh=00_Afn1Rlylsau8uGslpW0tz7-g_T6evXRarQlZrzSxJQMj_Q&oe=69611995)
+
+Clique no botão **Criar a partir de modelo** e crie uma configuração a partir do modelo **Configuração do cadastro incorporado do WhatsApp com token de expiração em 60 dias**. Isso gerará uma configuração para as permissões e os níveis de acesso mais usados.
+
+Como alternativa, você pode criar uma configuração personalizada. Para isso, no painel **Configurações**, clique no botão **Criar configuração** e forneça um nome que ajudará você a diferenciar a configuração personalizada de outras que possa criar no futuro. Ao concluir o fluxo, selecione a variação de login do **Cadastro Incorporado do WhatsApp**:
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/575115554_1146352833831127_890815455867347172_n.png?_nc_cat=103&ccb=1-7&_nc_sid=e280be&_nc_ohc=zLZWpPM696AQ7kNvwFNHZKA&_nc_oc=AdkUfAnOhp2OkyLF8kLc95_BB1RECvDYKOSbXsY_UGAooydeBRQr1sFIybLcPAkEXzo&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=oQSOSuCTU-3MoHIjjGOCxw&oh=00_Afn8MDsv8ctC07lVAQiwObTkbFM-RPGzczhBZxMy_DxJfg&oe=69613EC8)
+
+Selecione os produtos que você quer integrar para essa configuração.
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/558628910_1295959538460722_1574440641425438685_n.png?_nc_cat=106&ccb=1-7&_nc_sid=e280be&_nc_ohc=TgQ33So8IGEQ7kNvwGXMNzU&_nc_oc=AdlXoRNSyj7rn2Ls4zdkAZaMb0Z--EdmSktRi5pAH4hidcjaVeRVMMN8p2PnwCb_-nA&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=oQSOSuCTU-3MoHIjjGOCxw&oh=00_AfnzwTHUpuAntTn7iKAwBE6pph1LnVwYdP_e7fDPok0xag&oe=69613268)
+
+Ao escolher ativos e permissões, selecione apenas aqueles que você realmente precisará dos seus clientes empresariais. Os ativos já selecionados são adicionados por padrão.
+
+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 pedirão esclarecimentos.
+
+Ao concluir o fluxo de configuração, capture a identificação da configuração, já que você precisará dela na próxima etapa.
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/557160873_831044982939103_494958342584617069_n.png?_nc_cat=106&ccb=1-7&_nc_sid=e280be&_nc_ohc=awey6kvIC-sQ7kNvwFIWczI&_nc_oc=AdlmEg2t6ei3gc6grdYga2jfVFB2KRZpH8pzCJfJWDF1h5yNc-Ids9Etw5dT1N3QeP4&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=oQSOSuCTU-3MoHIjjGOCxw&oh=00_Afl24oYwvLNsnBkl_BXPODHfixItqe1FWOlUHdY_VbjcZQ&oe=69610EFC)
+
+## Etapa 3: adicionar o Cadastro Incorporado ao seu site
+
+Adicione o seguinte código HTML e JavaScript ao seu site. Esse é o código completo necessário para implementar o Cadastro Incorporado. Cada parte do código será explicada em detalhes abaixo.
+
+```
+<!-- SDK loading -->
+<script async defer crossorigin="anonymous" src="https://connect.facebook.net/en_US/sdk.js"></script><script>
+  // SDK initialization
+  window.fbAsyncInit = function() {
+    FB.init({
+      appId: '<APP_ID>', // your app ID goes here
+      autoLogAppEvents: true,
+      xfbml: true,
+      version: '<GRAPH_API_VERSION>' // Graph API version goes here
+    });
+  };
+
+  // Session logging message event listener
+  window.addEventListener('message', (event) => {
+    if (!event.origin.endsWith('facebook.com')) return;
+    try {
+      const data = JSON.parse(event.data);
+      if (data.type === 'WA_EMBEDDED_SIGNUP') {
+        console.log('message event: ', data); // remove after testing
+        // your code goes here
+      }
+    } catch {
+      console.log('message event: ', event.data); // remove after testing
+      // your code goes here
+    }
+  });
+
+  // Response callback
+  const fbLoginCallback = (response) => {
+    if (response.authResponse) {
+      const code = response.authResponse.code;
+      console.log('response: ', code); // remove after testing
+      // your code goes here
+    } else {
+      console.log('response: ', response); // remove after testing
+      // your code goes here
+    }
+  }
+
+  // Launch method and callback registration
+  const launchWhatsAppSignup = () => {
+    FB.login(fbLoginCallback, {
+      config_id: '<CONFIGURATION_ID>', // your configuration ID goes here
+      response_type: 'code',
+      override_default_response_type: true,
+      extras: {
+        setup: {},
+      }
+    });
+  }
+</script><!-- Launch button  --><button onclick="launchWhatsAppSignup()" style="background-color: #1877f2; border: 0; border-radius: 4px; color: #fff; cursor: pointer; font-family: Helvetica, Arial, sans-serif; font-size: 16px; font-weight: bold; height: 40px; padding: 0 24px;">Login with Facebook</button>
+```
+
+### Carregamento do SDK
+
+Essa parte do código carrega o SDK do Facebook para JavaScript de forma assíncrona:
+
+```
+<!-- SDK loading --><script async defer crossorigin="anonymous" src="https://connect.facebook.net/en_US/sdk.js"></script>
+```
+
+### Inicialização do SDK
+
+Essa parte do código inicializa o SDK. Adicione a identificação do app e a versão mais recente da Graph API neste local.
+
+```
+// SDK initialization
+window.fbAsyncInit = function() {
+  FB.init({
+    appId: '<APP_ID>', // your app ID goes here
+    autoLogAppEvents: true,
+    xfbml: true,
+    version: '<GRAPH_API_VERSION>' // Graph API version here
+  });
+};
+```
+
+Substitua os espaços reservados a seguir pelos seus próprios valores.
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<APP_ID>`
+
+**Obrigatório.**
+
+A identificação do app. Essa informação é exibida na parte superior do Painel de Apps.
+
+`21202248997039`
+
+`<GRAPH_API_VERSION>`
+
+**Obrigatório.**
+
+Versão da Graph API. Indica a versão da Graph API que será chamada se você estiver usando os métodos do SDK para realizar chamadas de API.
+
+No contexto do Cadastro Incorporado, você não dependerá dos métodos do SDK para realizar chamadas de API. Por isso, recomendamos que você configure a versão mais recente da API:
+
+v24.0
+
+v24.0
+
+### Ouvinte de eventos de mensagem de registro da sessão
+
+Essa parte do código cria um ouvinte de eventos de mensagem que captura as seguintes informações essenciais:
+
+-   As identificações de ativos recém-geradas do cliente comercial, se o fluxo foi concluído com sucesso-   O nome da tela que foi abandonada, se o fluxo tiver sido abandonado-   Uma identificação de erro, caso o usuário tenha encontrado um erro e usado o fluxo para denunciá-lo
+
+```
+// Session logging message event listener
+window.addEventListener('message', (event) => {
+  if (!event.origin.endsWith(‘facebook.com’)) return;
+  try {
+    const data = JSON.parse(event.data);
+    if (data.type === 'WA_EMBEDDED_SIGNUP') {
+      console.log('message event: ', data); // remove after testing
+      // your code goes here
+    }
+  } catch {
+    console.log('message event: ', event.data); // remove after testing
+    // your code goes here
+  }
+});
+```
+
+Essas informações serão enviadas em um objeto de evento de mensagem para a janela que gerou o fluxo e serão atribuídas à constante de dados. **Adicione seu próprio código personalizado à declaração try-catch que pode enviar esse objeto para seu servidor.** A estrutura do objeto variará com base na conclusão do fluxo, abandono ou relatório de erros, conforme descrito abaixo.
+
+**Estrutura de conclusão bem-sucedida do fluxo:**
+
+```
+{
+  data: {
+    phone_number_id: '<CUSTOMER_BUSINESS_PHONE_NUMBER_ID>',
+    waba_id: '<CUSTOMER_WABA_ID>',
+    business_id: '<CUSTOMER_BUSINESS_PORTFOLIO_ID>'
+    ad_account_ids?: ['<CUSTOMER_AD_ACCOUNT_ID_1>', '<CUSTOMER_AD_ACCOUNT_ID_2>'],
+    page_ids?: ['<CUSTOMER_PAGE_ID_1>', '<CUSTOMER_PAGE_ID_2>'],
+    dataset_ids?: ['<CUSTOMER_DATASET_ID_1>', '<CUSTOMER_DATASET_ID_2>'],
+  },
+  type: 'WA_EMBEDDED_SIGNUP',
+  event: '<FLOW_FINISH_TYPE>',
+}
+```
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<CUSTOMER_BUSINESS_PHONE_NUMBER_ID>`
+
+Identificação do número de telefone comercial do cliente
+
+`106540352242922`
+
+`<CUSTOMER_WABA_ID>`
+
+Identificação da conta do WhatsApp Business do cliente corporativo.
+
+`524126980791429`
+
+`<CUSTOMER_BUSINESS_PORTFOLIO_ID>`
+
+A identificação do portfólio empresarial do cliente corporativo.
+
+`2729063490586005`
+
+`<CUSTOMER_AD_ACCOUNT_ID>`
+
+A identificação da conta de anúncios do cliente comercial
+
+`4052175343162067`
+
+`<CUSTOMER_PAGE_ID>`
+
+A identificação da Página do Facebook do cliente comercial
+
+`1791141545170328`
+
+`<CUSTOMER_DATASET_ID>`
+
+A identificação do conjunto de dados do cliente comercial
+
+`524126980791429`
+
+`<FLOW_FINISH_TYPE>`
+
+Indica que o cliente concluiu o fluxo com sucesso.
+
+**Valores possíveis:**
+
+-   `FINISH`: indica a conclusão bem-sucedida do [fluxo da API de Nuvem](/documentation/business-messaging/whatsapp/embedded-signup/default-flow).-   `FINISH_ONLY_WABA`: indica que o usuário concluiu o fluxo [sem um número de telefone](/documentation/business-messaging/whatsapp/embedded-signup/bypass-phone-addition).-   `FINISH_WHATSAPP_BUSINESS_APP_ONBOARDING`: indica que o usuário concluiu o fluxo [com um número do WhatsApp Business](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users).
+
+`FINISH`
+
+Estrutura de fluxo abandonado:
+
+```
+{
+  data: {
+    current_step: '<CURRENT_STEP>',
+  },
+  type: 'WA_EMBEDDED_SIGNUP',
+  event: 'CANCEL',
+}
+```
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<CURRENT_STEP>`
+
+Indica qual tela o cliente comercial estava visualizando quando abandonou o fluxo. Consulte [Erros de fluxo de Cadastro Incorporado](/documentation/business-messaging/whatsapp/embedded-signup/errors) para ver uma descrição de cada etapa.
+
+`PHONE_NUMBER_SETUP`
+
+Erros denunciados pelo usuário
+
+```
+{
+  data: {
+    error_message: '<ERROR_MESSAGE>',
+    error_id: '<ERROR_ID>',
+    session_id: '<SESSION_ID>',
+    timestamp: '<TIMESTAMP>',
+  },
+  type: 'WA_EMBEDDED_SIGNUP',
+  event: 'CANCEL',
+}
+```
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<ERROR_MESSAGE>`
+
+O texto de descrição do erro exibido para o cliente empresarial no fluxo de Cadastro Incorporado. Consulte [Erros de fluxo de cadastro incorporado](/documentation/business-messaging/whatsapp/embedded-signup/errors) para ver uma lista de erros comuns.
+
+Seu nome verificado não segue as diretrizes do WhatsApp. Edite esse nome e tente novamente.
+
+`<ERROR_ID>`
+
+A identificação do erro. Inclua esse número se entrar em contato com o suporte.
+
+`524126`
+
+`<SESSION_ID>`
+
+A identificação única da sessão gerada pelo Cadastro Incorporado. Inclua essa identificação se entrar em contato com o suporte.
+
+`f34b51dab5e0498`
+
+`<TIMESTAMP>`
+
+Registro de data e hora UNIX que indica quando o cliente empresarial usou o Cadastro Incorporado para relatar o erro. Inclua esse valor se entrar em contato com o suporte.
+
+`1746041036`
+
+Analise esse objeto no seu servidor para extrair e capturar a identificação de número de telefone do cliente e a identificação da conta do WhatsApp Business ou para determinar qual tela foi abandonada. Confira [Telas de fluxo abandonadas](/documentation/business-messaging/whatsapp/embedded-signup/errors#abandoned-flow-screens) para ver uma lista de valores `<CURRENT_STEP>` possíveis e as telas correspondentes.
+
+A declaração try-catch no código acima tem duas declarações que podem ser usadas para fins de teste:
+
+```
+console.log('message event: ', data); // remove after testing
+
+console.log('message event: ', event.data); // remove after testing
+```
+
+Essas declarações apenas despejam o número de telefone e as identificações da conta do WhatsApp Business retornados ou a string de tela abandonada no console do JavaScript. É possível deixar esse código e manter o console aberto para ver facilmente o que é retornado quando você testa o fluxo. No entanto, remova-o quando terminar o teste.
+
+### Retorno de ligação de resposta
+
+Quando um cliente empresarial concluir o fluxo de Cadastro Incorporado, enviaremos um código de token trocável em uma [resposta JavaScript](https://l.facebook.com/l.php?u=https%3A%2F%2Fdeveloper.mozilla.org%2Fen-US%2Fdocs%2FWeb%2FAPI%2FResponse&h=AT3PUrpaDQbr3A4Us_UUAwFDck81pN-oFkpjhyuB1L_Mp1W2-I_IGzmneSQXVmIq-bsq8XUUsVXxbYgVoVcQr0dsd4ij_LcG__4AU_36ioOh-SUm9tQc4wQnnn5WW4BbnO6G6FEOCu9STQXEpNhTHux6cnw) para a janela que gerou o fluxo.
+
+```
+// Response callback
+const fbLoginCallback = (response) => {
+  if (response.authResponse) {
+    const code = response.authResponse.code;
+    console.log('response: ', code); // remove after testing
+    // your code goes here
+  } else {
+    console.log('response: ', response); // remove after testing
+    // your code goes here
+  }
+}
+```
+
+A função de retorno de ligação atribui o código do token trocável a uma constante `code`.
+
+**Adicione um código personalizado à declaração if-else que envia esse código ao seu servidor** para que você possa trocá-lo pelo token comercial do cliente quando [integrar o cliente empresarial](#onboarding-business-customers).
+
+O código do token trocável tem um tempo de validade de 30 segundos. Por isso, faça a troca pelo token comercial do cliente antes que o código expire. Se você fizer o teste e apenas fizer um dump da resposta no seu console do JavaScript para, em seguida, trocar o código manualmente usando outro app, como o Postman, ou seu terminal com cURL, recomendamos que você configure sua consulta de troca de token antes de começar a testar.
+
+A declaração if-else no código acima tem duas declarações que podem ser usadas para fins de teste:
+
+```
+console.log('response: ', code); // remove after testing
+
+console.log('response: ', response); // remove after testing
+```
+
+Essas declarações apenas despejam o código ou a resposta bruta no console do JavaScript. É possível deixar esse código e manter o console aberto para ver facilmente o que é retornado quando você testa o fluxo. No entanto, remova-o quando terminar o teste.
+
+### Método de inicialização e registro de retorno de ligação
+
+Essa parte do código define um método que pode ser chamado por um evento `onclick` que registra o retorno de chamada da etapa anterior e inicia o fluxo de Cadastro Incorporado.
+
+Adicione a identificação da configuração neste local.
+
+```
+// Launch method and callback registration
+const launchWhatsAppSignup = () => {
+  FB.login(fbLoginCallback, {
+    config_id: '<CONFIGURATION_ID>', // your configuration ID goes here
+    response_type: 'code',
+    override_default_response_type: true,
+    extras: {
+      setup: {},
+    }
+  });
+}
+```
+
+### Botão de iniciar
+
+Essa parte do código define um botão que chama o método de inicialização da etapa anterior quando clicado pelo cliente empresarial.
+
+```
+<!-- Launch button --><button onclick="launchWhatsAppSignup()" style="background-color: #1877f2; border: 0; border-radius: 4px; color: #fff; cursor: pointer; font-family: Helvetica, Arial, sans-serif; font-size: 16px; font-weight: bold; height: 40px; padding: 0 24px;">Login with Facebook</button>
+```
+
+## Teste
+
+Depois de concluir todas as etapas de implementação acima, você poderá testar o fluxo simulando um cliente empresarial com suas próprias credenciais da Meta. Qualquer pessoa adicionada como administrador ou desenvolvedor no seu app (no painel **Painel de Apps** > **Funções do app** > **Funções**) também poderá começar a testar o fluxo usando as próprias credenciais da Meta.
+
+## Como integrar clientes comerciais
+
+O Cadastro Incorporado gera ativos para os clientes da sua empresa e concede acesso a esses ativos para seu app. No entanto, será necessário fazer uma série de chamadas de API para integrar completamente os novos clientes que concluíram o fluxo.
+
+As chamadas de API necessárias para integrar clientes variam entre Parceiros de Soluções e Provedores/Parceiros de Tecnologia.
+
+-   [Como integrar clientes como Parceiro de Soluções](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-customers-as-a-solution-partner)-   [Como integrar clientes como Provedor de Tecnologia](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-customers-as-a-tech-provider)
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)