whatsapp-docs-mcp 1.0.0

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

@@ -0,0 +1,332 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-customers-as-a-tech-provider -->
+<!-- Scraped: 2025-12-20T17:48:24.579Z -->
+
+# Integrar clientes empresariais como Provedor de Tecnologia ou Parceiro de Tecnologia
+
+Updated: 14 de nov de 2025
+
+Este documento descreve as etapas que os Provedores e Parceiros de Tecnologia devem executar para integrar novos clientes empresariais que concluíram o fluxo de Cadastro incorporado.
+
+Caso seja um Provedor ou Parceiro de Tecnologia, qualquer cliente empresarial que concluir sua implementação do fluxo de Cadastro incorporado não poderá usar seu app para acessar ativos do WhatsApp ou enviar e receber mensagens (se estiver oferecendo serviços de mensagens) até que você conclua estas etapas.
+
+## O que será preciso
+
+-   ID da WABA do cliente empresarial (retornado via [registro de sessão](/documentation/business-messaging/whatsapp/embedded-signup/implementation#session-logging-message-event-listener) ou [solicitação de API](/documentation/business-messaging/whatsapp/solution-providers/manage-accounts#get-shared-waba-id-with-access-token))-   ID do número de telefone comercial do cliente empresarial (retornado via [registro de sessão](/documentation/business-messaging/whatsapp/embedded-signup/implementation#session-logging-message-event-listener) ou [solicitação de API](/documentation/business-messaging/whatsapp/solution-providers/manage-phone-numbers#getting-phone-numbers))-   ID do app (exibido na parte superior do **Painel de Apps**)-   a chave secreta do app (exibida em **Painel de Apps** > **Configurações do app** > **Básico**)
+
+Além disso, se você deseja testar os recursos de mensagens usando o número de telefone comercial do cliente, precisará de um número de telefone do WhatsApp que já possa enviar e receber mensagens de outros números do WhatsApp.
+
+Execute todas as solicitações descritas abaixo usando solicitações de servidor para servidor. Não use solicitações do cliente.
+
+## Etapa 1: trocar o código do token por um token da empresa
+
+Use o ponto de extremidade **GET /oauth/access\_token** para trocar o código de token [retornado](/documentation/business-messaging/whatsapp/embedded-signup/implementation#session-logging-message-event-listener) pelo Cadastro incorporado por um token de acesso de usuário do sistema de integração comercial ("token comercial").
+
+### Solicitação
+
+```
+curl --get 'https://graph.facebook.com/v21.0/oauth/access_token' \
+-d 'client_id=<APP_ID>' \
+-d 'client_secret=<APP_SECRET>' \
+-d 'code=<CODE>'
+```
+
+### Parâmetros de solicitação
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<APP_ID>`
+
+**Obrigatório.**
+
+O ID do app. Exibido na parte superior do **Painel de Apps**.
+
+`236484624622562`
+
+`<APP_SECRET>`
+
+**Obrigatório.**
+
+A chave secreta do app. Você pode encontrá-la em **Painel de Apps** > **Chave secreta do app** > **Básico**.
+
+`614fc2afde15eee07a26b2fe3eaee9b9`
+
+`<CODE>`
+
+**Obrigatório.**
+
+O código [retornado pelo Cadastro incorporado](/documentation/business-messaging/whatsapp/embedded-signup/implementation#session-logging-message-event-listener) quando o cliente concluiu o fluxo com sucesso.
+
+`AQBhlXsctMxJYbwbrpybxlo9tLPGy-QAmjBJA03jxLos43wxlBlrYozY5C33BXJULd133cOJf_5y6EkJZYMrAmW-EMj3Wdap9-NUM2nS4s8tC-ES7slBhh6QpCFM7-SzpI-iqsjqTGyxbUUW3AeaEyLkeZFIkBgcQ_SOxo9HShm20SDR5_n7AT9ZJ5dcgpqBQykNT-pQ8V7Ne9-sr6RLAWtJMF7-Zx6ABudRcWIN53tUTtquDVNuq3lrco4BlVQAv-54tR83Ae0ODN9Uet6j-BVLuetXhQCM3sz9RdgedlbxkidMbkztvYX1j7baOrJxyLyYGWYgbnUrKRQKCtWTsO5ekIGFgtbpS8UPJNqV6j8E5XKPJ8QA7ZFqzkB0s2O__J5FrjHzc_rDo1EuRbw98ihHDzQnvuXeHapEyfhLDJct0A`
+
+### Resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+<BUSINESS_TOKEN>
+```
+
+### Parâmetros da resposta
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<BUSINESS_TOKEN>`
+
+O [token comercial](/documentation/business-messaging/whatsapp/access-tokens#business-integration-system-user-access-tokens) do cliente.
+
+`EAAAN6tcBzAUBOwtDtTfmZCJ9n3FHpSDcDTH86ekf89XnnMZAtaitMUysPDE7LES3CXkA4MmbKCghdQeU1boHr0QZA05SShiILcoUy7ZAb2GE7hrUEpYHKLDuP2sYZCURkZCHGEvEGjScGLHzC4KDm8tq2slt4BsOQE1HHX8DzHahdT51MRDqBw0YaeZByrVFZkVAoVTxXUtuKgDDdrmJQXMnI4jqJYetsZCP1efj5ygGscZBm4OvvuCYB039ZAFlyNn`
+
+## Etapa 2: assinar webhooks na WABA do cliente
+
+Use o ponto de extremidade [POST /<WABA\_ID>/subscribed\_apps](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/subscribed-apps-api#post-version-waba-id-subscribed-apps) para assinar webhooks na WABA do cliente comercial. Se quiser que os webhooks do cliente sejam enviados para um URL de retorno de ligação diferente do definido no seu app, você terá várias opções de [substituição de webhook](/documentation/business-messaging/whatsapp/webhooks/override).
+
+### Solicitação
+
+```
+curl -X POST 'https://graph.facebook.com/<API_VERSION>/<WABA_ID>/subscribed_apps' \
+-H 'Authorization: Bearer <ACCESS_TOKEN>'
+```
+
+### Parâmetros de solicitação
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<API_VERSION>`
+
+_String_
+
+**Opcional.**
+
+Versão da Graph API.
+
+v24.0
+
+`<BUSINESS_TOKEN>`_String_
+
+**Obrigatório.**
+
+O [token da empresa](/documentation/business-messaging/whatsapp/access-tokens#business-integration-system-user-access-tokens) do cliente.
+
+`EAAAN6tcBzAUBOwtDtTfmZCJ9n3FHpSDcDTH86ekf89XnnMZAtaitMUysPDE7LES3CXkA4MmbKCghdQeU1boHr0QZA05SShiILcoUy7ZAb2GE7hrUEpYHKLDuP2sYZCURkZCHGEvEGjScGLHzC4KDm8tq2slt4BsOQE1HHX8DzHahdT51MRDqBw0YaeZByrVFZkVAoVTxXUtuKgDDdrmJQXMnI4jqJYetsZCP1efj5ygGscZBm4OvvuCYB039ZAFlyNn`
+
+`<WABA_ID>`_String_
+
+**Obrigatório.**
+
+É a identificação da conta do WhatsApp Business.
+
+`102290129340398`
+
+### Resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{  "success": true}
+```
+
+## Etapa 3: registrar o número de telefone do cliente
+
+Use o ponto de extremidade [POST /<BUSINESS\_PHONE\_NUMBER\_ID>/register](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/register-api) e cadastre o número de telefone comercial do cliente para uso com a API de Nuvem.
+
+### Solicitação
+
+```
+curl 'https://graph.facebook.com/v21.0/<BUSINESS_CUSTOMER_PHONE_NUMBER_ID>/register' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer <BUSINESS_TOKEN>' \
+-d '
+{
+  "messaging_product": "whatsapp",
+  "pin": "<DESIRED_PIN>"
+}'
+```
+
+### Parâmetros de solicitação
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<BUSINESS_CUSTOMER_PHONE_NUMBER_ID>`_String_
+
+**Obrigatório.**
+
+Identificação do número de telefone comercial do cliente.
+
+`106540352242922`
+
+`<BUSINESS_TOKEN>`_String_
+
+**Obrigatório.**
+
+O [token da empresa](/documentation/business-messaging/whatsapp/access-tokens#business-integration-system-user-access-tokens) do cliente.
+
+`EAAAN6tcBzAUBOwtDtTfmZCJ9n3FHpSDcDTH86ekf89XnnMZAtaitMUysPDE7LES3CXkA4MmbKCghdQeU1boHr0QZA05SShiILcoUy7ZAb2GE7hrUEpYHKLDuP2sYZCURkZCHGEvEGjScGLHzC4KDm8tq2slt4BsOQE1HHX8DzHahdT51MRDqBw0YaeZByrVFZkVAoVTxXUtuKgDDdrmJQXMnI4jqJYetsZCP1efj5ygGscZBm4OvvuCYB039ZAFlyNn`
+
+`<DESIRED_PIN>`_String_
+
+**Obrigatório.**
+
+Defina esse valor como um número de seis dígitos. Este será o PIN de confirmação em duas etapas do número de telefone comercial.
+
+`581063`
+
+### Resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{  "success": true}
+```
+
+## Etapa 4: enviar uma mensagem de teste
+
+_Esta etapa é opcional._
+
+Se você quiser testar os recursos de mensagens do número de telefone comercial do cliente comercial, envie uma mensagem para o número do cliente a partir do seu próprio número do WhatsApp (isso abrirá uma [janela de atendimento ao cliente](/documentation/business-messaging/whatsapp/messages/send-messages#customer-service-windows), permitindo responder com qualquer tipo de mensagem).
+
+Depois, use o ponto de extremidade [POST /<BUSINESS\_PHONE\_NUMBER\_ID>/messages](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api) para enviar uma mensagem de texto como resposta.
+
+### Solicitação
+
+```
+curl 'https://graph.facebook.com/v21.0/<BUSINESS_CUSTOMER_PHONE_NUMBER_ID>/messages' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer <BUSINESS_TOKEN>' \
+-d '
+{
+  "messaging_product": "whatsapp",
+  "recipient_type": "individual",
+  "to": "<WHATSAPP_USER_NUMBER>",
+  "type": "text",
+  "text": {
+    "body": "<BODY_TEXT>"
+  }
+}'
+```
+
+### Parâmetros de solicitação
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<BODY_TEXT>`_String_
+
+**Obrigatório.**
+
+Texto do corpo da mensagem. Compatível com URLs.
+
+Tamanho máximo de 4096 caracteres.
+
+`Message received, loud and clear!`
+
+`<BUSINESS_CUSTOMER_PHONE_NUMBER_ID>`_String_
+
+**Obrigatório.**
+
+Identificação do número de telefone comercial do cliente.
+
+`106540352242922`
+
+`<BUSINESS_TOKEN>`_String_
+
+**Obrigatório.**
+
+O [token da empresa](/documentation/business-messaging/whatsapp/access-tokens#business-integration-system-user-access-tokens) do cliente.
+
+`EAAAN6tcBzAUBOwtDtTfmZCJ9n3FHpSDcDTH86ekf89XnnMZAtaitMUysPDE7LES3CXkA4MmbKCghdQeU1boHr0QZA05SShiILcoUy7ZAb2GE7hrUEpYHKLDuP2sYZCURkZCHGEvEGjScGLHzC4KDm8tq2slt4BsOQE1HHX8DzHahdT51MRDqBw0YaeZByrVFZkVAoVTxXUtuKgDDdrmJQXMnI4jqJYetsZCP1efj5ygGscZBm4OvvuCYB039ZAFlyNn`
+
+`<WHATSAPP_USER_NUMBER>`_String_
+
+**Obrigatório.**
+
+Seu número de telefone do WhatsApp que pode enviar e receber mensagens de outros números do WhatsApp.
+
+Não pode ser um número de telefone comercial já registrado para uso com a API de Nuvem ou a API Local.
+
+`+16505551234`
+
+### Resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{
+  "messaging_product": "whatsapp",
+  "contacts": [
+    {
+      "input": "<WHATSAPP_USER_NUMBER>",
+      "wa_id": "<WHATSAPP_USER_ID>"
+    }
+  ],
+  "messages": [
+    {
+      "id": "<WHATSAPP_MESSAGE_ID>"
+    }
+  ]
+}
+```
+
+### Parâmetros da resposta
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<WHATSAPP_MESSAGE_ID>`
+
+ID da mensagem do WhatsApp.
+
+`wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA`
+
+`<WHATSAPP_USER_ID>`
+
+Seu número de identificação do usuário do WhatsApp.
+
+`16505551234`
+
+`<WHATSAPP_USER_NUMBER>`
+
+Seu número de telefone do WhatsApp para o qual a mensagem foi enviada.
+
+`+16505551234`
+
+Se você conseguiu enviar e receber mensagens com sucesso usando o número de telefone comercial do cliente e se os webhooks das **mensagens** foram disparados [descrevendo a mensagem inicial que você enviou](/documentation/business-messaging/whatsapp/webhooks/reference/messages), bem como o [status de entrega](/documentation/business-messaging/whatsapp/webhooks/reference/messages/status) da mensagem enviada em resposta, o número de telefone comercial do cliente está funcionando corretamente.
+
+## Etapa 5: instruir o cliente a adicionar uma forma de pagamento
+
+Instrua seu cliente a usar o Gerenciador do WhatsApp para adicionar uma forma de pagamento. Você pode fornecer o seguinte link da Central de Ajuda:
+
+[https://www.facebook.com/business/help/488291839463771](https://www.facebook.com/business/help/488291839463771)
+
+Como alternativa, você pode instruir o cliente a:
+
+-   acessar o painel do **Gerenciador do WhatsApp** > **Visão geral** em [https://business.facebook.com/wa/manage/home/](https://business.facebook.com/wa/manage/home/)-   clicar no botão **Adicionar forma de pagamento**-   concluir o fluxo
+
+Depois que o cliente adicionar uma forma de pagamento, ele estará totalmente integrado à plataforma do WhatsApp Business e poderá começar a usar seu app para acessar os ativos do WhatsApp, além de enviar e receber mensagens (se você estiver fornecendo esse serviço).
+
+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/overview.md

@@ -0,0 +1,168 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/overview -->
+<!-- Scraped: 2025-12-20T17:48:08.234Z -->
+
+# Cadastro Incorporado
+
+Updated: 5 de nov de 2025
+
+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.
+
+O fluxo 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 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-   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 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
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/531995822_1112262264200439_63249353490863536_n.png?_nc_cat=105&ccb=1-7&_nc_sid=e280be&_nc_ohc=hJsPBhvHLBsQ7kNvwGCf9Np&_nc_oc=AdkYuVkj7j08r6sjdYHf--vRkw27Xl_bt-jOWEozw4tkDPojQRPzCVIfEOCssftytQg&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=8jPV4iMiSTQQleiBOxzLpQ&oh=00_AfkJwzmB3vjRcAsVt_fjdxLdnYvNzollfhq7-SnqWGzCtg&oe=69613680)
+
+Após a conclusão bem-sucedida, o Cadastro Incorporado retornará, para a janela que gerou o fluxo, a identificação da WABA do cliente, o número de telefone comercial e um código de token fungí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 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.
+
+## Propriedade de ativo
+
+Os clientes empresariais integrados via Cadastro Incorporado são proprietários de todos seus ativos do WhatsApp e podem aproveitar esses ativos com outras soluções da Meta, como [Anúncios de clique para o WhatsApp](https://www.facebook.com/business/help/447934475640650).
+
+Também têm acesso total ao [Gerenciador do WhatsApp](https://business.facebook.com/wa/manage/), que pode ser usado para acessar os ativos. Não é possível restringir o acesso. Consulte os ativos disponíveis [neste link](/documentation/business-messaging/whatsapp/embedded-signup/version-4).
+
+## 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](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fpartners%2Fbecome-a-partner&h=AT34JZcxdggQpVM_5grrJpoiHhY_n76aY89Na0RkQWu5h6TpwtLZ7wdi8ErVeW7dswmHi-E0ypoGq4-DLwGezzFOIPgpFDnW5vZchHoq_ptyVIjLlvT56Dm0sKNKA_1gAmQP4QXTWtbPajJ_EoAhjxhtB30).
+
+**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 fluxo de Cadastro Incorporado.
+
+### Limites de mensagens para clientes empresariais
+
+Os clientes empresariais integrados via Cadastro Incorporado começam com [limites de mensagens](/documentation/business-messaging/whatsapp/messaging-limits) 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 comerciais só poderão ser registrados para uso com a API de Nuvem.-   Números de telefone comerciais já registrados para uso com a API Local, ou usados no WhatsApp, não são aceitos.-   Números de telefone comercial já em uso com o [app WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fproducts%2Fbusiness-app&h=AT34JZcxdggQpVM_5grrJpoiHhY_n76aY89Na0RkQWu5h6TpwtLZ7wdi8ErVeW7dswmHi-E0ypoGq4-DLwGezzFOIPgpFDnW5vZchHoq_ptyVIjLlvT56Dm0sKNKA_1gAmQP4QXTWtbPajJ_EoAhjxhtB30) são aceitos, mas exigem que você personalize o fluxo para habilitar a [integração de usuários do app WhatsApp Business](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users) (também conhecida como "coexistência").-   Os clientes empresariais integrados por meio do Cadastro Incorporado começam com [limites de mensagens](/documentation/business-messaging/whatsapp/messaging-limits) padrão.
+
+## Fluxo da API de Nuvem
+
+Consulte [Cloud API Flow](/documentation/business-messaging/whatsapp/embedded-signup/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.
+
+Se você souber informações sobre a empresa do cliente, poderá [inserir esses dados](/documentation/business-messaging/whatsapp/embedded-signup/pre-filled-data), 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](/documentation/business-messaging/whatsapp/access-tokens#business-integration-system-user-access-tokens). Quando um cliente empresarial conclui o fluxo 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](/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens) ("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 oferecer suporte a produtos de mensagens da empresa para seus clientes. Caso você tenha interesse apenas no fluxo 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.
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/557723935_1324509125987117_1998262003463700459_n.png?_nc_cat=102&ccb=1-7&_nc_sid=e280be&_nc_ohc=VgsIa2oehTIQ7kNvwEuQsah&_nc_oc=AdmzTNVZARccgxC9rMvf9Wao0TLiCdsZxJXElisJUTpQsPTKuSrzFiDSlwUQdObVivY&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=8jPV4iMiSTQQleiBOxzLpQ&oh=00_AfmWc0hpW4TOI27q14UbsicVtT8je1pm5eu4bflZT94RwQ&oe=6961355F)
+
+Você pode especificar de quais permissões seu app precisa durante o processo de [implementação](/documentation/business-messaging/whatsapp/embedded-signup/implementation).
+
+Enquanto seu app estiver em modo de desenvolvimento, essas permissões aparecerão na [tela de autorização](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#authorization-screen) do Cadastro Incorporado para qualquer pessoa que tenha uma função de**admin**, **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](/documentation/business-messaging/whatsapp/solution-providers/app-review) 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](https://www.facebook.com/business/help/1684730811624773?id=2129163877102343) 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](https://www.facebook.com/business/help/488291839463771) 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 fluxo.
+
+Quando você concluir o fluxo usando a conta de sandbox, a [identificação da WABA e do número de telefone comercial](/documentation/business-messaging/whatsapp/embedded-signup/implementation#session-logging-message-event-listener), além de um [código de token que pode ser trocado](/documentation/business-messaging/whatsapp/embedded-signup/implementation#response-callback), 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, elas 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](/apps) > **WhatsApp** > **Início rápido**.-   Encontre a seção **Integrações de teste**.-   Clique no botão **Reivindicar conta de sandbox**.
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/513080744_1153803566552470_4289383978669775503_n.png?_nc_cat=109&ccb=1-7&_nc_sid=e280be&_nc_ohc=PPOWHdDExiEQ7kNvwFcj1Hj&_nc_oc=Adlm_0UgDN1VjeHpu5J0wA2ekP8pBtt4YbXs6rd7N21qr2lwkVYvPwm1Ly_8kAxeV8U&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=8jPV4iMiSTQQleiBOxzLpQ&oh=00_AflaOLFZg_86yQpAtQuMztY1CK8a-zif3RZXdrdYXABSmg&oe=69612253)
+
+### 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](/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.
+
+![](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/511293188_1404444270796306_3723440624353556557_n.png?_nc_cat=101&ccb=1-7&_nc_sid=e280be&_nc_ohc=EmA8oOMutXYQ7kNvwG0PQud&_nc_oc=AdmmUlUQCxu3sStyFwXcCyqBpkdgc9YI00W5_wlq1mYkDra8nwAxd_8KpdR4UpQydv4&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=8jPV4iMiSTQQleiBOxzLpQ&oh=00_AfkauW1MP4TxzBDrgSrmhgaC6Pc5RF8d_IzANb3hHWcRsQ&oe=696111AC)
+
+## 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](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#phone-number-addition-screen) mostrará de forma automática a opção de escolher um número 555:
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/557624038_1991414544970922_7818680630707794930_n.png?_nc_cat=110&ccb=1-7&_nc_sid=e280be&_nc_ohc=pxCujGjgVhwQ7kNvwGJp06M&_nc_oc=Adn8cKtBaexlJ0elx2Xs8pIwiC6wIEd1RGMDA8JwLPwh0HvQi_oLAvyD7Fh5RR0EXCo&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=8jPV4iMiSTQQleiBOxzLpQ&oh=00_AfkysMeJvFbPUpQ0YB7xk1zuUTvJ-5F0pi3b_KYYWBCDUg&oe=69613060)
+
+## 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](/documentation/business-messaging/whatsapp/solution-providers/support#migrating-business-customer-assets).
+
+## 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](/documentation/business-messaging/whatsapp/solution-providers/app-review) para saber mais sobre esse tópico e o que você deve fornecer para concluir o processo com sucesso.
+
+## Auxiliar de integração de Cadastro Incorporado
+
+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 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 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 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. Veja [Substituições de webhook](/documentation/business-messaging/whatsapp/webhooks/override) 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](/documentation/business-messaging/whatsapp/embedded-signup/implementation) no seu site ou portal.
+
+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)