whatsapp-docs-mcp 1.0.0

package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/manage_system_users.md

@@ -0,0 +1,106 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/manage-system-users -->
+<!-- Scraped: 2025-12-20T17:52:17.884Z -->
+
+# Gerenciar usuários do sistema
+
+Updated: 14 de nov de 2025
+
+Adicionar o usuário do sistema a contas do WhatsApp Business compartilhadas permite gerenciar contas de forma programada. Neste guia, abordaremos as ações que os BSPs (provedores de soluções de negócios) talvez precisem executar para gerenciar esses usuários.
+
+-   Para criar um usuário do sistema, consulte [Usuários do sistema, Recuperar e atualizar um usuário do sistema](/docs/marketing-api/system-users/create-retrieve-update).-   Consulte [Usuários do sistema, Instalar aplicativos e Gerar tokens](/docs/marketing-api/system-users/install-apps-and-generate-tokens#generate-token) para obter ajudar na geração do token de acesso de usuário do sistema.
+
+## Recuperar números de identificação do usuário do sistema
+
+É possível armazenar em cache números de identificação do usuário do sistema para uso futuro.
+
+### Solicitação
+
+```
+curl -i -X GET "https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_ACCOUNT_ID>/system_users
+  ?access_token=<SYSTEM_USER_ACCESS_TOKEN>"
+```
+
+Para encontrar a identificação de uma empresa, acesse [**Gerenciador de Negócios**](https://business.facebook.com/) > **Configurações do negócio** > **Informações da empresa**. Nessa área, você verá informações sobre a empresa, incluindo o número de identificação.
+
+### Resposta
+
+```
+{  "data": [    {      "id": "1972555232742222",      "name": "My System User",      "role": "EMPLOYEE"    }  ]}
+```
+
+## Adicionar usuários do sistema a uma conta comercial do WhatsApp
+
+Para esta chamada de API, **você precisa usar o token de acesso de um usuário do sistema com permissões de administrador**.
+
+### Sintaxe da solicitação
+
+No exemplo abaixo, use a identificação da WABA atribuída.
+
+```
+curl -i -X POST "https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_ACCOUNT_ID>/assigned_users
+  ?user=<ASSIGNED_USER_ID>
+  &tasks=['<ASSIGNED_USERS_TASKS_AND_PERMISSIONS>']
+  &access_token=<SYSTEM_USER_ACCESS_TOKEN>"
+```
+
+Para encontrar o ID de uma conta do WhatsApp Business, acesse [**Gerenciador de Negócios**](https://business.facebook.com/) > **Configurações do negócio** > **Contas** > **Contas do WhatsApp Business**. Encontre a conta que você quer usar e clique nela. Um painel é aberto, contendo as informações sobre a conta, inclusive a ID.
+
+  
+
+Para `<ASSIGNED_USER_ID>`, use a identificação do usuário do sistema retornada da [chamada `/<WHATSAPP_BUSINESS_ACCOUNT_ID>/system_users`](#retrieve-system-user-ids).
+
+### Permissões
+
+Nome
+
+Descrição
+
+`MANAGE`
+
+Fornece acesso de administrador.
+
+Os usuários podem ter acesso de administrador em uma conta do WhatsApp Business compartilhada com permissões desse tipo.
+
+Observação: se você é um parceiro de soluções e está tentando adicionar um usuário a uma conta do WhatsApp Business que é compartilhada com você por meio de uma [solução multiparceiro](/documentation/business-messaging/whatsapp/solution-providers/multi-partner-solutions), você precisa levar em conta os seguintes cenários:
+
+-   Caso você não tenha a permissão para `MESSAGING` na solução, será necessário escolher quais tarefas granulares são necessárias ao adicionar o usuário à conta do WhatsApp Business compartilhada: `DEVELOP`, `MANAGE_TEMPLATES`, `MANAGE_PHONE`, `VIEW_COST`, `MANAGE_EXTENSIONS`, `VIEW_PHONE_ASSETS`, `MANAGE_PHONE_ASSETS`, `VIEW_TEMPLATES`, `VIEW_INSIGHTS`, `MANAGE_USERS` e `MANAGE_BILLING`.-   Neste cenário, `MANAGE_BILLING` é necessária para compartilhar uma linha de crédito.-   MANAGE somente funcionará se você receber acesso total à solução, ou seja, incluindo `MESSAGING`.
+
+`DEVELOP`
+
+Fornece acesso de desenvolvedor. Os usuários podem ter acesso de desenvolvedor em uma conta do WhatsApp Business compartilhada com permissões padrão.
+
+### Resposta
+
+```
+{  "success": true}
+```
+
+## Recuperar usuários designados
+
+Busque usuários designados da conta do WhatsApp Business para confirmar se foram adicionados. Essa etapa não é obrigatória, mas auxilia o processo de validação.
+
+### Sintaxe da solicitação
+
+No exemplo abaixo, use a identificação da WABA atribuída.
+
+```
+curl -i -X GET "https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_ACCOUNT_ID>/assigned_users
+  ?business=<WHATSAPP_BUSINESS_ACCOUNT_ID>
+  &access_token=<SYSTEM_USER_ACCESS_TOKEN>"
+```
+
+### Resposta
+
+```
+{  "data": [    {      "id": "1972385232742142",      "name": "Anna Flex",      "tasks": [        "MANAGE"      ]    },    {      "id": "1972385232752545",      "name": "Jasper Brown",      "tasks": [        "DEVELOP"      ]    }  ]}
+```
+
+## Veja também
+
+-   Referência: [conta do WhatsApp Business](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api)
+
+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/gerenciamento/gerenciar_ativos_do_cliente/manage_webhooks.md

@@ -0,0 +1,277 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/manage-webhooks -->
+<!-- Scraped: 2025-12-20T17:52:36.322Z -->
+
+# Como gerenciar Webhooks
+
+Updated: 5 de nov de 2025
+
+As contas do WhatsApp Business (WABAs, pelas iniciais em inglês) e os respectivos ativos são objetos no gráfico social do Facebook. Quando um evento é disparado para um desses objetos, o Facebook envia uma notificação para a URL de webhook especificada no painel do app do Facebook.
+
+No caso de cadastros incorporados, você pode usar os webhooks para receber notificações sobre alterações a WABAs, números de telefone, modelos de mensagem e mensagens enviadas aos seus telefones.
+
+**Você precisa [assinar individualmente cada WABA](#subscribe) para a qual deseja receber Webhooks.** Depois de obter a identificação da WABA, assine seu app com a identificação para começar a receber Webhooks.
+
+Consulte [Webhooks for WhatsApp Business Accounts](/docs/graph-api/webhooks/getting-started/webhooks-for-whatsapp) para saber mais sobre como assinar Webhooks.
+
+[](#subscribe-to-a-whatsapp-business-account)
+
+## Como assinar webhooks na WABA de um cliente corporativo
+
+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 empresarial. 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>'
+```
+
+### Resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{  "success": true}
+```
+
+Repita esse processo nas outras WABAs sobre as quais você quer receber notificações de webhooks. Se o app assinar webhooks de várias WABAs, todas as notificações serão enviadas ao URL de retorno de chamada especificado no painel do produto **Webhooks** do Painel de Apps, a menos que você [substitua webhooks](/documentation/business-messaging/whatsapp/webhooks/override).
+
+## Obter todas as assinaturas em uma WABA
+
+Para obter a lista dos apps inscritos em webhooks de uma WABA, envie uma solicitação GET ao ponto de extremidade `subscribed_apps` da WABA:
+
+### Sintaxe da solicitação
+
+```
+GET https://graph.facebook.com/<API_VERSION>/<WABA_ID>/subscribed_apps
+```
+
+Uma resposta bem-sucedida inclui uma matriz de apps que assinaram a WABA com as propriedades link, nome e ID de cada um.
+
+### Exemplo de solicitação
+
+```
+curl \
+'https://graph.facebook.com/v24.0/102289599326934/subscribed_apps' \
+-H 'Authorization: Bearer EAAJi...'
+```
+
+### Exemplo de resposta
+
+```
+{  "data" : [    {      "whatsapp_business_api_data" : {        "id" : "67084...",        "link" : "https://www.facebook.com/games/?app_id=67084...",        "name" : "Jaspers Market"      }    },    {      "whatsapp_business_api_data" : {        "id" : "52565...",        "link" : "https://www.facebook.com/games/?app_id=52565...",        "name" : "Jaspers Fresh Finds"      }    }  ]}
+```
+
+## Cancelar a assinatura da WABA
+
+Para cancelar a assinatura do app dos webhooks em uma conta do WhatsApp Business, envie uma solicitação DELETE ao ponto de extremidade `subscribed_apps` da WABA.
+
+### Sintaxe da solicitação
+
+```
+DELETE https://graph.facebook.com/<API_VERSION>/<WABA_ID>/subscribed_apps
+```
+
+### Exemplo de solicitação
+
+```
+curl -X DELETE \
+'https://graph.facebook.com/v24.0/102289599326934/subscribed_apps' \
+-H 'Authorization: Bearer EAAJi...'
+```
+
+### Exemplo de resposta
+
+```
+{   "success" : true}
+```
+
+## Como substituir o URL de retorno de chamada
+
+Consulte [Substituições de Webhooks](/documentation/business-messaging/whatsapp/webhooks/override).
+
+## Configurar notificações
+
+É possível configurar webhooks para receber notificações quando houver alterações nas suas contas assinadas do WhatsApp Business. Veja os tipos de notificação que você pode assinar:
+
+### Campos de assinatura disponíveis
+
+Nome do campo
+
+Descrição
+
+[account\_alerts](/documentation/business-messaging/whatsapp/webhooks/reference/account_alerts)
+
+O webhook **account\_alerts** notifica você sobre alterações no [limite de mensagens](/documentation/business-messaging/whatsapp/messaging-limits), [perfil empresarial](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#business-profiles) e status da [](/documentation/business-messaging/whatsapp/whatsapp-business-accounts#official-business-account)conta comercial oficial de um número de telefone comercial.
+
+[account\_review\_update](/documentation/business-messaging/whatsapp/webhooks/reference/account_review_update)
+
+O webhook **account\_review\_update** envia uma notificação quando uma conta do WhatsApp Business é analisada em relação às nossas diretrizes de política.
+
+[account\_update](/documentation/business-messaging/whatsapp/webhooks/reference/account_update)
+
+O webhook **account\_update** notifica sobre alterações no envio da [verificação da empresa conduzida pelo parceiro](/documentation/business-messaging/whatsapp/solution-providers/partner-led-business-verification) de uma conta do WhatsApp Business, na qualificação para a [taxa internacional de autenticação](/documentation/business-messaging/whatsapp/pricing/authentication-international-rates) ou no ponto comercial principal, quando é compartilhado com um [provedor de soluções](/documentation/business-messaging/whatsapp/solution-providers/overview), em caso de [violações de políticas ou termos](/documentation/business-messaging/whatsapp/policy-enforcement) ou quando é excluída.
+
+[automatic\_events](/documentation/business-messaging/whatsapp/webhooks/reference/automatic_events)
+
+O webhook **automatic\_events** envia uma notificação quando detectamos um evento de compra ou lead em uma conversa entre você e um usuário do WhatsApp que entrou em contato por meio do seu anúncio de clique para o WhatsApp, se você tiver aceitado a geração de relatórios de [Eventos automáticos](/documentation/business-messaging/whatsapp/embedded-signup/automatic-events-api).
+
+[business\_capability\_update](/documentation/business-messaging/whatsapp/webhooks/reference/business_capability_update)
+
+O webhook **business\_capability\_update** notifica você sobre alterações de capacidade da conta do WhatsApp Business ou do portfólio empresarial ([limites de mensagens](/documentation/business-messaging/whatsapp/messaging-limits#increasing-your-limit), [limites de número de telefone](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#registered-number-cap) etc.).
+
+[history](/documentation/business-messaging/whatsapp/webhooks/reference/history)
+
+O webhook de **history** é usado para sincronizar o [histórico de conversas do app WhatsApp Business](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users) de um cliente empresarial integrado por um provedor de soluções.
+
+[message\_template\_components\_update](/documentation/business-messaging/whatsapp/webhooks/reference/message_template_components_update)
+
+O webhook **message\_template\_components\_update** notifica você sobre as alterações nos componentes de um modelo.
+
+[message\_template\_quality\_update](/documentation/business-messaging/whatsapp/webhooks/reference/message_template_quality_update)
+
+O webhook **message\_template\_quality\_update** notifica você sobre alterações na [pontuação de qualidade](/documentation/business-messaging/whatsapp/templates/template-quality) de um modelo.
+
+[message\_template\_status\_update](/documentation/business-messaging/whatsapp/webhooks/reference/message_template_status_update)
+
+O webhook **message\_template\_status\_update** notifica você sobre as alterações no status de um modelo existente.
+
+[messages](/documentation/business-messaging/whatsapp/webhooks/reference/messages)
+
+O webhook **messages** descreve as mensagens enviadas de um usuário do WhatsApp para uma empresa, bem como o status das mensagens enviadas por uma empresa para um usuário do WhatsApp.
+
+[partner\_solutions](/documentation/business-messaging/whatsapp/webhooks/reference/partner_solutions)
+
+O **webhook partner\_solutions** descreve as alterações no status de uma [solução multiparceiro](/documentation/business-messaging/whatsapp/solution-providers/multi-partner-solutions).
+
+[payment\_configuration\_update](/documentation/business-messaging/whatsapp/webhooks/reference/payment_configuration_update)
+
+O webhook **payment\_configuration\_update** envia uma notificação sobre as alterações nas configurações de pagamento da [API de Pagamentos Índia](/documentation/business-messaging/whatsapp/payments/payments-in/overview) e da [API de Pagamentos Brasil](/documentation/business-messaging/whatsapp/payments/payments-br/overview).
+
+[phone\_number\_name\_update](/documentation/business-messaging/whatsapp/webhooks/reference/phone_number_name_update)
+
+O webhook **phone\_number\_name\_update** notifica você sobre os resultados da [verificação do nome de exibição](/documentation/business-messaging/whatsapp/display-names#display-name-verificationn) do número de telefone comercial.
+
+[phone\_number\_quality\_update](/documentation/business-messaging/whatsapp/webhooks/reference/phone_number_quality_update)
+
+O webhook **phone\_number\_quality\_update** fornece notificações sobre as alterações de [nível de taxa de transferência de dados](/documentation/business-messaging/whatsapp/throughput) de um número de telefone comercial.
+
+[security](/documentation/business-messaging/whatsapp/webhooks/reference/security)
+
+O webhook **security** notifica você sobre alterações nas configurações de segurança de um número de telefone comercial.
+
+[smb\_app\_state\_sync](/documentation/business-messaging/whatsapp/webhooks/reference/smb_app_state_sync)
+
+O webhook **smb\_app\_state\_sync** é usado para sincronizar contatos de [usuários do app WhatsApp Business que foram integrados](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users) por meio de um provedor de soluções.
+
+[smb\_message\_echoes](/documentation/business-messaging/whatsapp/webhooks/reference/smb_message_echoes)
+
+O webhook **smb\_message\_echoes** avisa você sobre as mensagens enviadas por meio do app WhatsApp Business ou um [dispositivo adicional ("conectado")](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users#linked-devices) por um cliente empresarial que fez a [integração com a API de Nuvem](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users) por meio de um provedor de soluções.
+
+[template\_category\_update](/documentation/business-messaging/whatsapp/webhooks/reference/template_category_update)
+
+O webhook **template\_category\_update** envia uma notificação sobre as alterações na [categoria](/documentation/business-messaging/whatsapp/templates/template-categorization) do modelo.
+
+[user\_preferences](/documentation/business-messaging/whatsapp/webhooks/reference/user_preferences)
+
+O webhook **user\_preferences** notifica você sobre as alterações nas [preferências de mensagens de marketing](/documentation/business-messaging/whatsapp/templates/marketing-templates#user-preferences-for-marketing-messages) de um usuário do WhatsApp.
+
+Consulte a documentação [Webhooks for WhatsApp Business Accounts](/docs/graph-api/webhooks/getting-started/webhooks-for-whatsapp) para saber mais.
+
+## Formato dos Webhooks
+
+Você receberá as notificações no seguinte formato geral:
+
+```
+{  "object": "whatsapp_business_account",  "entry": [    { // entry object, containing changes      "changes": [        { // changes object, containing value          "value": {            // value object          }        }      ]    }  ]}
+```
+
+Veja mais detalhes sobre cada campo:
+
+-   [`object`](/documentation/business-messaging/whatsapp/webhooks/overview)-   [`entry`](/documentation/business-messaging/whatsapp/webhooks/overview)-   [`changes`](/documentation/business-messaging/whatsapp/webhooks/overview)-   [`value`](/documentation/business-messaging/whatsapp/webhooks/overview)
+
+## Exemplos
+
+### Cliente corporativo integrado
+
+Um webhook **account\_update** é disparado com `event` definido como `PARTNER_ADDED` quando um cliente corporativo conclui com sucesso o fluxo de cadastro incorporado.
+
+#### Sintaxe
+
+```
+{
+  "entry": [
+    {
+      "id": "<BUSINESS_PORTFOLIO_ID>",
+      "time": <WEBHOOK_SENT_TIMESTAMP>,
+      "changes": [
+        {
+          "value": {
+            "event": "<EVENT>",
+            "waba_info": {
+              "waba_id": "<CUSTOMER_WABA_ID>",
+              "owner_business_id": "<CUSTOMER_BUSINESS_PORTFOLIO_ID>"
+            }
+          },
+          "field": "account_update"
+        }
+      ]
+    }
+  ],
+  "object": "whatsapp_business_account"
+}
+```
+
+#### Exemplo
+
+```
+{  "entry": [    {      "id": "35602282435505",      "time": 1731617831,      "changes": [        {          "value": {            "event": "PARTNER_ADDED",            "waba_info": {              "waba_id": "495709166956424",              "owner_business_id": "942647313864044"            }          },          "field": "account_update"        }      ]    }  ],  "object": "whatsapp_business_account"}
+```
+
+### Atualizações de número de telefone
+
+#### Atualização de nome recebida
+
+```
+{  "object": "whatsapp_business_account",  "entry": [    {      "id": "495709166956424",      "time": 1731617831,      "changes": [        {          "field": "phone_number_name_update",          "value": {            "display_phone_number": "124545784358810",            "decision": "APPROVED",            "requested_verified_name": "WhatsApp",            "rejection_reason": null          }        }      ]    }  ]}
+```
+
+#### Atualização de qualidade recebida
+
+```
+{  "object": "whatsapp_business_account",  "entry": [    {      "id": "495709166956424",      "time": 1731617831,      "changes": [        {          "field": "phone_number_quality_update",          "value": {            "display_phone_number": "124545784358810",            "event": "FLAGGED",            "current_limit": "TIER_10K"          }        }      ]    }  ]}
+```
+
+### Atualizações da WABA
+
+#### Número de sandbox atualizado para conta verificada
+
+```
+{  "object": "whatsapp_business_account",  "entry": [    {      "id": "495709166956424",      "time": 1731617831,      "changes": [        {          "field": "account_update",          "value": {            "phone_number": "124545784358810",            "event": "VERIFIED_ACCOUNT"          }        }      ]    }  ]}
+```
+
+#### Conta do WhatsApp Business banida
+
+```
+{  "object": "whatsapp_business_account",  "entry": [    {      "id": "495709166956424",      "time": 1731617831,      "changes": [        {          "field": "account_update",          "value": {            "event": "DISABLED_UPDATE"            "ban_info": {              "waba_ban_state": ["SCHEDULE_FOR_DISABLE", "DISABLE", "REINSTATE"],              "waba_ban_date": "DATE"            }          }        }      ]    }  ]}
+```
+
+#### Análise da conta do WhatsApp Business concluída
+
+```
+{  "object": "whatsapp_business_account",  "entry": [    {      "id": "495709166956424",      "time": 1731617831,      "changes": [        {          "field": "account_review_update",          "value": {            "decision": "APPROVED"          }        }      ]    }  ]}
+```
+
+### Atualizações no modelo de mensagem
+
+#### Aprovado
+
+```
+{  "entry": [    {      "id": "495709166956424",      "time": 1731617831,      "changes": [        {          "value": {            "event": "APPROVED",            "message_template_id": 64244916695,            "message_template_name": "Summer 20 Template",            "message_template_language": "en_US",            "reason": "NONE"          },          "field": "message_template_status_update"        }      ]    }  ],  "object": "whatsapp_business_account"}
+```
+
+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/gerenciamento/gerenciar_ativos_do_cliente/numeros_de_telefone/AGENTS.md

@@ -0,0 +1,9 @@
+# Números de Telefone
+
+Gerenciar números de telefone
+
+## Documentos Disponíveis
+
+- [Manage Phone Numbers](./manage_phone_numbers.md)
+- [Registering Phone Numbers](./registering_phone_numbers.md)
+

package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/numeros_de_telefone/manage_phone_numbers.md

@@ -0,0 +1,248 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/manage-phone-numbers -->
+<!-- Scraped: 2025-12-20T17:52:01.487Z -->
+
+# Números de telefone de clientes empresariais
+
+Updated: 4 de nov de 2025
+
+Este documento descreve os números de telefone de clientes empresariais, seus requisitos e os pontos de extremidade comumente usados para gerenciar números de telefone comerciais.
+
+## Noções básicas
+
+Seus clientes empresariais precisam de um número dedicado para usar o WhatsApp. Números de telefone já usados com o app WhatsApp não são aceitos, mas números utilizados com o app WhatsApp Business [podem ser registrados](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users).
+
+Os clientes empresariais podem ter vários números de telefone associados à [conta comercial da Meta](https://business.facebook.com/settings/). Dessa forma, é possível [adicionar outro número para usá-lo com a API](#adding-more-phone-numbers) se desejarem.
+
+Ao concluir o flow Cadastro incorporado, os clientes empresariais devem usar o número de telefone e o nome de exibição que desejam ver no app do WhatsApp. É altamente desaconselhável fazer o cadastro com um número pessoal ou de teste, assim como um nome de exibição provisório, pois será difícil alterar essas informações.
+
+-   Para obter informações mais detalhadas sobre os números de telefone e a Plataforma do WhatsApp Business, consulte [Números de telefone](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers).-   Para obter informações sobre como migrar um número já registrado no WhatsApp, consulte [Números de telefone comercial](/documentation/business-messaging/whatsapp/solution-providers/support/migrating-phone-numbers-among-solution-partners-via-embedded-signup).
+
+## Instruções para clientes empresariais
+
+Esta seção destina-se a clientes do cadastro incorporado e fornece instruções sobre ações relacionadas a números de telefone.
+
+### Adicionar números de telefone a uma conta comercial do WhatsApp
+
+Há duas formas de adicionar números de telefone a uma WABA (conta comercial do WhatsApp):
+
+-   **\[Recomendado\]** Passe pelo fluxo de cadastro incorporado, selecione o Gerenciador de Negócios e a WABA, adicione o número e verifique-o.-   No **Gerenciador de Negócios**, acesse a aba **Números de telefone** no **Gerenciador do WhatsApp**. Depois, selecione **Adicionar número de telefone**. Ao usar essa opção, o parceiro de soluções precisa verificar manualmente o número, pois esse recurso não está disponível no Gerenciador de Negócios. Por isso, recomendamos que as empresas sigam o fluxo de cadastro incorporado para adicionar números.
+
+## Instruções para parceiros de soluções
+
+Esta seção destina-se a parceiros de soluções e fornece instruções sobre o gerenciamento de números de telefone e certificados de clientes.
+
+### Como obter números de telefone
+
+Use o ponto de extremidade [GET /<WABA\_ID>/phone\_numbers](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/phone-number-management-api#Reading) para obter uma lista de números de telefone comercial na WABA de um cliente corporativo.
+
+#### Solicitação
+
+```
+curl 'https://graph.facebook.com/<API_VERSION>/<CUSTOMER_WABA_ID>/phone_numbers' \
+-H 'Authorization: Bearer <CUSTOMER_BUSINESS_TOKEN>'
+```
+
+#### Resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{
+  "data": [
+    {
+      "verified_name": "<VERIFIED_DISPLAY_NAME>",
+      "code_verification_status": "<VERIFICATION_STATUS>",
+      "display_phone_number": "<DISPLAY_PHONE_NUMBER>",
+      "quality_rating": "<QUALITY_RATING>",
+      "platform_type": "CLOUD_API",
+      "throughput": {
+        "level": "<THROUGHPUT_LEVEL>"
+      },
+      "webhook_configuration": {
+        "application": "<WEBHOOK_CALLBACK_URL>"
+      },
+      "id": "<BUSINESS_PHONE_NUMBER_ID>"
+    }
+  ],
+  "paging": {
+    "cursors": {
+      "before": "<BEFORE_CURSOR>",
+      "after": "<AFTER_CURSOR>"
+    }
+  }
+}
+```
+
+### Registrar números de telefone
+
+Após concluir a verificação do fluxo de cadastro incorporado, o registro é concluído com uma chamada de API ao [`register`ponto de extremidade](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/register-api#Creating). Para isso, forneça um `code_method` (`sms`
+
+`voice`). Como o número de telefone já foi verificado, não é preciso se preocupar com o código de registro.
+
+Como alternativa, **é possível verificar previamente os números de telefone** e oferecê-los aos clientes no novo flow Cadastro incorporado. Assim, eles não precisam entrar em contato com você para receber uma senha descartável durante o processo de integração. Consulte [Números de telefone pré-verificados](/documentation/business-messaging/whatsapp/embedded-signup/pre-verified-numbers).
+
+**É necessário** registrar um número de telefone até 14 dias após o flow Cadastro incorporado. Se o número não for cadastrado nesse período, será preciso realizar o flow novamente antes de fazer o registro.
+
+### Obter metadados do smartphone
+
+O ponto de extremidade `phone_numbers` permite que você veja o status do nome de exibição de um número de telefone e outros metadados.
+
+#### Exemplo de solicitação
+
+No exemplo abaixo, use a identificação da WABA atribuída.
+
+```
+curl -i -X GET "https://graph.facebook.com/<API_VERSION>/<WABA_ID>/phone_numbers
+  ?fields=
+    display_phone_number,
+    certificate,
+    name_status,
+    new_certificate,
+    new_name_status
+  &access_token=<SYSTEM_USER_ACCESS_TOKEN>"
+```
+
+Para encontrar o ID de uma conta do WhatsApp Business, acesse [**Gerenciador de Negócios**](https://business.facebook.com/) > **Configurações do negócio** > **Contas** > **Contas do WhatsApp Business**. Encontre a conta que você quer usar e clique nela. Um painel é aberto, contendo as informações sobre a conta, inclusive a ID.
+
+#### Exemplo de resposta
+
+```
+{
+  "data": [
+    {
+      "id": "1972385232742141",
+      "display_phone_number": "+1 631-555-1111",
+      "last_onboarded_time": "2023-08-22T19:05:53+0000",
+      "certificate": "AbCdEfGhIjKlMnOpQrStUvWxYz",
+      "new_certificate": "123AbCdEfGhIjKlMnOpQrStUvWxYz",
+      "name_status": "APPROVED",
+      "new_name_status": "APPROVED",
+    }
+  ]
+}
+```
+
+### Parâmetros da resposta
+
+Nome
+
+Descrição
+
+`name_status`
+
+O status de análise da atual solicitação de nome de exibição. Opções disponíveis:
+
+-   `APPROVED`: o nome foi aprovado. Baixe seu certificado agora.-   `DECLINED`: o nome não foi aprovado. Não é possível baixar o certificado.-   `EXPIRED`: o certificado expirou e você não pode baixá-lo.-   `PENDING_REVIEW`: a solicitação de nome está em análise. Não é possível baixar o certificado.-   `NONE`: nenhum certificado disponível.
+
+`new_name_status`
+
+O status da análise de uma solicitação de alteração do nome de exibição. Este campo retorna dados apenas se houver uma solicitação de alteração do nome de exibição.
+
+`certificate`
+
+Retorna o certificado atual do número de telefone.
+
+`new_certificate`
+
+O certificado de um novo nome de exibição, depois que a alteração foi aprovada. Este campo retorna dados apenas se a solicitação de alteração do nome de exibição tiver sido aprovada e ficará disponível até que o número de telefone tenha sido registrado com o novo certificado.
+
+### Obter o status de senha descartável do número de telefone
+
+Para ver se um número de telefone foi verificado via senha descartável, confira o campo `code_verification_status` desse número. Primeiro, faça uma chamada `GET` para o ponto de extremidade `/{whatsapp-business-account-id}/phone_numbers`:
+
+```
+curl -i -X GET \
+"https://graph.facebook.com/<API_VERSION>/<WABA_ID>/phone_numbers
+  ?access_token=<ACCESS_TOKEN>"
+```
+
+A resposta inclui o code\_verification\_status com uma das opções a seguir: `VERIFIED` ou `NOT_VERIFIED`. A resposta será semelhante a esta:
+
+```
+[
+  {
+    "code_verification_status": "NOT_VERIFIED",
+    "id": "1754951608042154"
+  }
+]
+```
+
+Como alternativa, obtenha o status chamando a ID de um número de telefone:
+
+```
+curl -i -X GET \
+"https://graph.facebook.com/<API_VERSION>/<PHONE_NUMBER_ID>
+  ?access_token=<ACCESS_TOKEN>"
+```
+
+Use o ponto de extremidade [Conta do WhatsApp Business > Números de telefone](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/phone-number-management-api#Reading) para obter o ID de um número de telefone. Consulte [Recuperar números de telefone](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#get-all-phone-numbers) para saber mais sobre o uso.
+
+### Filtrar números de telefone por modo de conta
+
+Consulte e filtre números de telefone com base em `account_mode`. Use os parâmetros abaixo na solicitação.
+
+#### Parâmetros de solicitação
+
+Nome
+
+Descrição
+
+`field`
+
+Contém o campo que está sendo usado para filtragem. Nesse exemplo, use `account_mode`.
+
+`operator`
+
+Contém o modo que você quer usar para filtrar as contas. Nesse exemplo, use `EQUAL`.
+
+`value`
+
+Contém o modo da conta que você está procurando. Valores compatíveis:
+
+-   `SANDBOX`: a conta não foi verificada.
+    -   `LIVE`: a conta não se qualifica para a experiência de avaliação não verificada ou foi atualizada para verificada.
+    
+
+#### Exemplo de solicitação
+
+No exemplo abaixo, use a identificação da WABA atribuída.
+
+```
+curl -i -X GET "https://graph.facebook.com/<API_VERSION>/<WABA_ID>/phone_numbers
+  ?filtering=[{
+    "field":"account_mode",
+    "operator":"EQUAL",
+    "value":"SANDBOX"}]
+  &access_token=<SYSTEM_USER_ACCESS_TOKEN>"
+```
+
+#### Exemplo de resposta
+
+```
+{
+  "data": [
+    {
+      "id": "1972385232742141",
+      "display_phone_number": "+1 631-555-1111",
+      "verified_name": "John’s Cake Shop",
+      "quality_rating": "UNKNOWN",
+    }
+  ],
+  "paging": {
+  "cursors": {
+    "before": "abcdefghij"
+    "after": "klmnopqr"
+  }
+   }
+}
+```
+
+## Saiba mais
+
+-   [Números de telefone: visão geral da Plataforma do WhatsApp Business](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers)-   [Números de telefone: migrar número já registrado](/documentation/business-messaging/whatsapp/solution-providers/support/migrating-phone-numbers-among-solution-partners-via-embedded-signup)-   Referência: [Conta do WhatsApp Business](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api)
+
+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)