whatsapp-docs-mcp 1.0.0

package/docs/ativos_da_conta/outros_ativos/display_names.md

@@ -0,0 +1,108 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/display-names -->
+<!-- Scraped: 2025-12-20T17:24:37.432Z -->
+
+# Nomes de exibição
+
+Updated: 31 de out de 2025
+
+É preciso fornecer um nome de exibição ao [registrar](#registering-business-phone-numbers) um número de telefone comercial. O nome de exibição aparece no perfil do WhatsApp do seu número de telefone comercial:
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/507127951_698062976515521_2852142619234157074_n.png?_nc_cat=110&ccb=1-7&_nc_sid=e280be&_nc_ohc=pbMww2NEdikQ7kNvwFBkSWG&_nc_oc=AdmldPwNHM8XO8PWwN_Ig9eRq0mQaHt17-BlGny3M1ZgxwUKEtxeToxI6rfs_J0cYPk&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=VkFKTMDRA9mDsrYP-ywO-w&oh=00_AfmXJ_jCHPHm6MdM9OoYES4xyxRSiu1CjClUMZ-34qyKEw&oe=69610969)
+
+Esse nome também poderá aparecer no topo de **conversas individuais** e da **lista de conversas** se o número de telefone comercial for aprovado por meio da [verificação de nome de exibição](#display-name-verification). Observe que, se um usuário editar seu nome de perfil no cliente do WhatsApp, o nome definido por ele será exibido em vez do seu.
+
+## Diretrizes para nomes de exibição
+
+Consulte nosso artigo [Diretrizes para nomes de exibição na Plataforma do WhatsApp Business](https://www.facebook.com/business/help/757569725593362) da Central de Ajuda para saber mais sobre a nomenclatura.
+
+## Verificação do nome de exibição
+
+Quando você atinge um [limite de mensagens superior](/documentation/business-messaging/whatsapp/messaging-limits), o nome de exibição do seu número de telefone comercial será automaticamente submetido à verificação com base nas nossas [diretrizes para nomes de exibição](https://www.facebook.com/business/help/757569725593362). Ao final do processo, um webhook [phone\_number\_name\_update](/documentation/business-messaging/whatsapp/webhooks/reference/phone_number_name_update) e uma notificação do Meta Business Suite serão disparados.
+
+Caso seu nome de exibição seja aprovado, o webhook terá `decision` definido como `APPROVED`, e o campo `name_status` no seu número de telefone comercial será definido como `APPROVED`.
+
+Se o nome for rejeitado, o webhook terá `decision` definido como `REJECTED`, e o campo `name_status` no seu número de telefone comercial será definido como `DECLINED`. Em caso de rejeição, recomendamos que você leia novamente nossas [diretrizes](https://www.facebook.com/business/help/757569725593362) e [edite o nome de exibição](https://www.facebook.com/business/help/378834799515077) se necessário ou faça uma apelação via [Suporte ao desenvolvedor](/documentation/business-messaging/whatsapp/support#developer-support) ou [Suporte para desenvolvedores empresariais](/documentation/business-messaging/whatsapp/support#enterprise-developer-support).
+
+## Como ver o nome de exibição no Gerenciador do WhatsApp
+
+O nome de exibição do seu número de telefone comercial é exibido na coluna **Nome** no painel [Gerenciador do WhatsApp](https://business.facebook.com/latest/whatsapp_manager/) > **Ferramentas da conta** > **Números de telefone**.
+
+## Como receber o nome de exibição e o status do nome via API
+
+Solicite os campos `verified_name` e `name_status` na identificação do seu número de telefone comercial do WhatsApp para receber o nome de exibição e o status dele. Para conferir uma lista de valores retornáveis ​​e os respectivos significados, consulte a referência [GET /<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-phone-number-api#Reading).
+
+O valor `verified_name` não indica se o nome de exibição foi aprovado ou não; ele apenas representa a string do nome de exibição que será submetida à verificação quando estiver qualificada. O campo `name_status` indica o status de aprovação.
+
+### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v24.0/106540352242922?fields=verified_name%2Cname_status' \
+-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{  "verified_name": "Lucky Shrub",  "name_status": "APPROVED",  "id": "106540352242922"}
+```
+
+## Como atualizar o nome de exibição via Gerenciador do WhatsApp
+
+Para atualizar seu nome de exibição via Gerenciador do WhatsApp:
+
+-   Acesse [Gerenciador do WhatsApp](https://business.facebook.com/latest/whatsapp_manager/) > **Ferramentas da conta** > **Números de telefone**.-   Selecione seu número de telefone comercial.-   Clique na aba **Perfil**.-   Na seção **Nome de exibição**, clique no botão **Editar** e complete o fluxo.
+
+Após concluir o fluxo, seu nome de exibição passará pelo [processo de verificação](#display-name-verification) novamente.
+
+Essas informações também estão disponíveis no artigo da Central de Ajuda [Como alterar o nome de exibição no WhatsApp Business](https://www.facebook.com/business/help/378834799515077).
+
+## Como atualizar o nome de exibição via API
+
+Use o campo `new_display_name` do ponto de extremidade <WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>POST /[](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-phone-number-api#Updating) para atualizar seu nome de exibição via API.
+
+### Exemplo de solicitação
+
+```
+curl -X POST 'https://graph.facebook.com/v24.0/106540352242922?new_display_name=Lucky%20Shrub' \
+-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{  "success": true}
+```
+
+Em caso de sucesso, seu nome de exibição passará pelo [processo de verificação](#display-name-verification). Se você quiser conferir o status da verificação, solicite os campos `new_display_name` e `new_name_status` na identificação do seu número de telefone comercial:
+
+### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v23.0/106540352242922?fields=new_display_name,new_name_status' \-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{  "new_display_name": "New Lucky Shrub",  "new_name_status": "PENDING_REVIEW",  "id": "106540352242922"}
+```
+
+Se o novo nome de exibição for aprovado, os campos `verified_name` e `name_status` do número de telefone comercial serão atualizados para refletir esse nome e o respectivo status. Além disso, os webhooks **phone\_number\_name\_update** serão disparados.
+
+## Saiba mais
+
+Os artigos a seguir da Central de Ajuda fornecem mais informações sobre nomes de exibição.
+
+-   [Sobre o nome de exibição do WhatsApp Business](https://www.facebook.com/business/help/338047025165344)-   [Como alterar o nome de exibição no WhatsApp Business](https://www.facebook.com/business/help/378834799515077)
+
+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/ativos_da_conta/outros_ativos/official_business_accounts.md

@@ -0,0 +1,123 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/official-business-accounts -->
+<!-- Scraped: 2025-12-20T17:24:44.918Z -->
+
+# Contas comerciais oficiais
+
+Updated: 13 de nov de 2025
+
+Uma conta comercial oficial (OBA, nas iniciais em inglês) é um número de telefone comercial de propriedade de uma empresa que foi verificada como uma marca autêntica e notável, de acordo com [critérios](#criteria) específicos. Os números de telefone comerciais da conta comercial oficial exibem uma marca de seleção azul ao lado do nome na visualização de contatos.
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/456954377_453386597161620_5745766558871976538_n.png?_nc_cat=100&ccb=1-7&_nc_sid=e280be&_nc_ohc=KglYN_0VuU8Q7kNvwFi3X7Q&_nc_oc=AdmZGf4eVc2hFsStkRME6IX68pTwPlHXe5vT2ccJm3i0gs_dHwbjcU_tfIyieuJ4EYY&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=_hS4UAVodFHO3i8jvKkK1g&oh=00_AfkY09UHv3Q_X7fNScU8dhZ0Zb39gOlv8k4ymBQjn2vodQ&oe=696137F3)
+
+Você pode solicitar o status de OBA de um número de telefone comercial usando o Gerenciador do WhatsApp ou a API. Depois de analisarmos sua solicitação, você receberá uma notificação informando se o número de telefone da sua empresa recebeu o status de "Número da OBA" ou não. Se a solicitação for rejeitada, será possível enviar uma nova após 30 dias.
+
+Não concedemos status de OBA a funcionários de empresas, contas de teste nem números de telefone do app WhatsApp Business.
+
+## Qualificação
+
+Para se qualificar para uma OBA, os seguintes critérios devem ser atendidos:
+
+-   As empresas precisam estar em conformidade com a [Política de Mensagens do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fpolicy&h=AT0cB76kzfbsk0YFNuyFAUZD926K791-Ih9YyAWc-YO742w2WBtTslYM599nxFhU-fwb_9FG0EFH9AF0WrP_m8ua4Yjr4yzKxg3KyktSLNoDJdzZggrXK7RFhSCzazvffMNL_nzReY7Pv5YY-jlKZLOqjeM).-   A empresa deve estar registrada na Plataforma do WhatsApp Business há pelo menos 30 dias.-   A empresa precisa representar uma empresa, marca ou entidade [notável](#notability), bem conhecida e frequentemente pesquisada.-   O portfólio empresarial proprietário do número deve ter sido verificado por meio da [verificação da empresa](https://www.facebook.com/business/help/2058515294227817).-   O número de telefone comercial deve ter ativado a [confirmação em duas etapas](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#two-step-verification).-   O nome de exibição do número de telefone comercial precisa ter sido [aprovado](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#display-name-verification).
+
+Se você atende aos critérios acima, mas não vê uma opção para se candidatar a uma OBA no [Gerenciador do WhatsApp](http://business.facebook.com/wa/manage/), fale com o seu ponto de contato da Meta, o suporte do Provedor de Soluções ou o Suporte da Meta para verificar se você se qualifica para o processo de inscrição.
+
+**Observação:** se o número de telefone comercial não for uma conta comercial oficial (OBA, nas iniciais em inglês), ele não aparecerá nos resultados da pesquisa quando os usuários o procurarem no app WhatsApp. No entanto, se um usuário adicionar o número aos próprios contatos, o nome de exibição aparecerá nos resultados de pesquisa. Para facilitar a descoberta, recomendamos que você solicite o status de OBA.
+
+## Notabilidade
+
+A notabilidade exige que uma empresa represente uma marca ou entidade bastante conhecida ou pesquisada. Ela não deve ser interpretada como um sinal de autenticidade do negócio.
+
+Por outro lado, a notabilidade reflete uma presença significativa em artigos de notícias online. Ela é avaliada com base na presença de uma conta em publicações de grandes públicos. Para fins de análise, não são considerados os conteúdos pagos nem promocionais, incluindo listas de empresas e apps.
+
+O status de "Número da OBA" é emitido no nível do número de telefone comercial e do nome de exibição. Avaliamos a notabilidade do nome de exibição do número de telefone comercial que solicita o status. Se o nome de exibição for alterado depois de receber o status de número de OBA, será necessário reavaliar o novo nome de exibição em relação à notabilidade e à [conformidade com o nome de exibição](https://www.facebook.com/business/help/338047025165344).
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/457272592_1239953843829647_8265325653823058853_n.png?_nc_cat=109&ccb=1-7&_nc_sid=e280be&_nc_ohc=sIr4KkXZZmMQ7kNvwGBm1uL&_nc_oc=AdnEXFzNXr6GdYFADEYjEtkk0fgfka8TZIcnH303_uYfnCf4XA-N5S_eJ9PdYPmtHoY&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=_hS4UAVodFHO3i8jvKkK1g&oh=00_AfmPnreGk6RC9ncz_ytfalnvlnPsXM6Gi7kpdHtyXbo2oA&oe=696118D1)
+
+Além disso, aprovações anteriores de status de OBA para outros números de telefone comerciais de propriedade de uma determinada conta do WhatsApp Business não garantem a aprovação de todos os números pertencentes a essa mesma conta. Se a WABA tiver uma marca principal e o número de telefone associado atender aos requisitos de notabilidade, recomendamos que você atualize os nomes de exibição das marcas secundárias da seguinte forma: {{sub-brand name}} por {{notable name}}.
+
+## Solicitações negadas
+
+Uma solicitação negada significa que nossa equipe analisou sua conta e determinou que ela não está qualificada para o status de número da OBA. No momento, não é possível fazer uma apelação dessa decisão. Você pode continuar a expandir sua presença empresarial e esperar 30 dias antes de enviar outra solicitação.
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/457031264_766028162210302_4155505657500024802_n.png?_nc_cat=109&ccb=1-7&_nc_sid=e280be&_nc_ohc=3OnMMngfOPYQ7kNvwG_c0IS&_nc_oc=AdmtC979XjY0I2eqfZXqC0SmBDK0u8cnZjer-sCRM19v6LhdIAxMs7gJ1cMIp1alWec&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=_hS4UAVodFHO3i8jvKkK1g&oh=00_Afkxc5R0C1B1y0UBhks1W6GDHXhGb5QnqX6b-Fybph0Avg&oe=69613602)
+
+Entretanto, essa decisão não limita a capacidade de compartilhar as informações da empresa. Cada número de telefone comercial também tem um perfil empresarial com foto, email, site e descrição da empresa. Esses campos podem ser editados a qualquer momento.
+
+## Como solicitar status de OBA por meio do Gerenciador do WhatsApp
+
+![Image](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/564126920_1339318217926829_3878332681973573854_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=e280be&_nc_ohc=RVut-uwBOEMQ7kNvwH1Kylv&_nc_oc=Adl-Lc8ssASTqoARGxC7y3ieFnZF-R1xc4uBb_vrgELx9gxkP46h3GjEqzDMASn6b1Y&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=_hS4UAVodFHO3i8jvKkK1g&oh=00_AflRvPm_cIyjVzLxf296oxcc6IrZB9QuiGgIHuEo1znUng&oe=69611B7F)
+
+-   Acesse [**Gerenciador do WhatsApp**](https://business.facebook.com/latest/whatsapp_manager/) > **Visão geral** e clique no número de telefone comercial:
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/456997811_1368661294090266_2491166291934528895_n.png?_nc_cat=106&ccb=1-7&_nc_sid=e280be&_nc_ohc=9VySOnhT4GIQ7kNvwFrFOFR&_nc_oc=AdkZCRi2KMSsB1P0RArh6y4OGtemT3vmobiAUzmEeGrdRiA177NXv_oYd02UYrbivnU&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=_hS4UAVodFHO3i8jvKkK1g&oh=00_AfkpEXyxCNSHG1cEc7EcF1ZobkrhwLiiOFnSWaoejHVmtw&oe=69612244)
+
+-   Habilite a confirmação em duas etapas caso o recurso ainda não tenha sido ativado.
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/456954365_532463442507497_4571397701593651380_n.png?_nc_cat=110&ccb=1-7&_nc_sid=e280be&_nc_ohc=Ymz5SdlecPYQ7kNvwFRtAYt&_nc_oc=Adn7d9m_0eY0DN2pDfs_4EVBE0Gx1QYTsIv-laq7aUf1Abnx2__9PEy5jXk1L-423OY&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=_hS4UAVodFHO3i8jvKkK1g&oh=00_AfnM1n9AC-vNjy8fZaBtR9OHE9l3Uu3hluSoiIGhfYJG-g&oe=696134A2)
+
+-   Clique no botão **Enviar solicitação** e preencha o formulário.
+    -   Para comprovar que sua empresa é notável, é possível enviar até 5 links de publicações renomadas (por exemplo, India Today, Economic Times, Wall Street Journal, Reuters, Wikipedia, Business Insider).-   Campos como país de operação, empresa ou marca principal (em especial para marcas conhecidas) e idioma contribuem ao nosso entendimento sobre sua marca e a elegibilidade para OBA.
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/457106823_1745186199576875_630331601567021999_n.png?_nc_cat=109&ccb=1-7&_nc_sid=e280be&_nc_ohc=5r375aEanrEQ7kNvwGde7WG&_nc_oc=AdlFmbqt1NMwOpUUm07jKq4kMDxSAAWsi9uxxhdTj4VXt54r1OYPQAolZ4XI-8DdOjs&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=_hS4UAVodFHO3i8jvKkK1g&oh=00_AfnQGznThX2gQGTNXrVLv6F2MNjdZikP7XxQQBKRaTYXEw&oe=696113CE)
+
+## Como solicitar status de OBA via API
+
+Use o ponto de extremidade [POST /<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>/official\_business\_account](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-official-business-account-status-api#Creating) para enviar uma solicitação de status de OBA para seu número de telefone comercial.
+
+### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v24.0/106540352242922/official_business_account' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer EAAJB...' \
+-d '
+{
+  "additional_supporting_information": "We are also featured in Planet Succulent and Prickly Digest",
+  "business_website_url": "https://www.luckyshrub.com",
+  "parent_business_or_brand": "Lucky Shrub LLC",
+  "primary_country_of_operation": "United States of America",
+  "primary_language": "English",
+  "supporting_links": [
+    "https://www.retailreview.com/gardening/2025/lucky-shrub",
+    "https://www.faster-company.com/2025/online-nursies-are-making-green-waves",
+    "https://www.succulentscene.com/2025/new-online-retailers",
+    "https://www.pricklypages.com/2025/succullents/where-to-buy",
+    "https://www.spinyliving.com/2025/latest-news"
+  ]
+}'
+```
+
+### Exemplo de resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{  "success": true}
+```
+
+Observe que `true` não indica aprovação, apenas envio bem-sucedido.
+
+## Como receber o status de OBA via API
+
+Use o ponto de extremidade [GET /<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-official-business-account-status-api#Reading) para solicitar o campo `official_business_account` no seu número de telefone comercial para receber o status de uma solicitação de OBA.
+
+### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v24.0/106540352242922?fields=official_business_account' \
+-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{  "official_business_account": {    "oba_status": "NOT_STARTED"  },  "id": "106540352242922"}
+```
+
+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/ativos_da_conta/outros_ativos/qr_codes.md

@@ -0,0 +1,198 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/qr-codes -->
+<!-- Scraped: 2025-12-20T17:25:01.589Z -->
+
+# QR codes e links curtos
+
+Updated: 31 de out de 2025
+
+Os QR codes e links curtos do WhatsApp criam uma porta de entrada digital para as empresas. Dessa forma, elas podem manter a conexão com clientes atuais e interagir com públicos novos. Para iniciar uma conversa, as pessoas só precisam ler o QR code com a câmera do próprio dispositivo móvel ou digitar o link curto. Não é necessário inserir o número de telefone.
+
+Veja, crie, edite e exclua QR codes e links curtos na [API de Gerenciamento do WhatsApp Business](/documentation/business-messaging/whatsapp/qr-codes) ou na [interface do usuário do Gerenciador de Negócios](https://www.facebook.com/business/help/890732351439459).
+
+### Limitações
+
+-   Um número de telefone da conta do WhatsApp Business (WABA, pelas iniciais em inglês) não pode ser associado a mais de dois mil QR codes e links curtos.
+    -   A leitura do QR code pode iniciar uma mensagem preenchida automaticamente com até 140 caracteres de texto.
+    -   As análises não estão disponíveis para QR codes e links curtos, já que limitamos a quantidade de dados registrada para proteger a privacidade dos usuários.
+    
+
+## Criar QR code
+
+Para criar um QR code, envie uma solicitação POST ao ponto de extremidade [Número de telefone do WhatsApp Business > Qrdls de mensagens](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-qr-code-management-api).
+
+No corpo do post, inclua um objeto com uma propriedade `prefilled_message` definida como a mensagem de texto, assim como uma propriedade `generate_qr_image` definida como o formato de imagem de sua preferência (`SVG` ou `PNG`).
+
+### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v24.0/106540352242922/message_qrdls' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer EAAJB...' \
+-d '
+{
+  "prefilled_message": "Cyber Monday",
+  "generate_qr_image": "SVG"
+}'
+```
+
+### Exemplo de resposta
+
+```
+{  "code": "4O4YGZEG3RIVE1",  "prefilled_message": "Cyber Monday 1",  "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1",  "qr_image_url": "https://scontent-iad3-2.xx.fbcdn.net/..."}
+```
+
+## Ver uma lista de QR codes e links curtos
+
+Para ver uma lista de todos os QR codes em um número de telefone comercial, envie uma solicitação GET ao ponto de extremidade [Número de telefone do WhatsApp Business > Qrdls de mensagens](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-qr-code-management-api). Acesse o [artigo da Central de Ajuda](https://www.facebook.com/business/help/890732351439459) para ver como obter uma lista de códigos QR por meio do Gerenciador de Negócios.
+
+### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v24.0/106540352242922/message_qrdls' \
+-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta
+
+```
+{  "data": [    {      "code": "4O4YGZEG3RIVE1",      "prefilled_message": "Cyber Monday",      "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1"    },    {      "code": "WOMVT6TJ2BP7A1",      "prefilled_message": "Tell me more about your production workshop",      "deep_link_url": "https://wa.me/message/WOMVT6TJ2BP7A1"    }  ]}
+```
+
+## Obter um QR code
+
+Para ver informações sobre um QR code específico, envie uma solicitação GET ao ponto de extremidade [Número de telefone do WhatsApp Business > Qrdls de mensagens](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-qr-code-management-api) e adicione o ID do QR code como parâmetro de caminho.
+
+### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v24.0/106540352242922/message_qrdls/4O4YGZEG3RIVE1' \
+-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta
+
+```
+{  "data": [    {      "code": "4O4YGZEG3RIVE1",      "prefilled_message": "Cyber Monday",      "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1"    }  ]}
+```
+
+## Atualizar um QR code
+
+Para atualizar um QR code, envie uma solicitação POST ao ponto de extremidade [Número de telefone do WhatsApp Business > Qrdls de mensagens](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-qr-code-management-api).
+
+No corpo do post, inclua uma propriedade `code` definida como o ID do QR code que você quer atualizar, assim como uma propriedade `prefilled_message` definida como novo texto do QR code.
+
+### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v24.0/106540352242922/message_qrdls' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer EAAJB...' \
+-d '
+{
+    "code": "4O4YGZEG3RIVE1",
+    "prefilled_message": "Cyber Tuesday"
+}'
+```
+
+### Exemplo de resposta
+
+```
+{  "code": "4O4YGZEG3RIVE1",  "prefilled_message": "Cyber Tuesday",  "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1"}
+```
+
+### Excluir QR code
+
+Os QR codes não expiram automaticamente. Para excluir um QR code, envie uma solicitação DELETE ao ponto de extremidade [Número de telefone do WhatsApp Business > Qrdls de mensagens](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-qr-code-management-api) e adicione o ID do QR code que você quer desativar como parâmetro de caminho. Acesse a [Central de Ajuda](https://www.facebook.com/business/help/890732351439459) para ver como excluir códigos QR por meio do Gerenciador de Negócios.
+
+### Exemplo de solicitação
+
+```
+curl -X DELETE 'https://graph.facebook.com/v24.0/106540352242922/message_qrdls/4O4YGZEG3RIVE1' \
+-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta
+
+```
+{  "success": true}
+```
+
+## Mensagens preenchidas automaticamente
+
+Os QR codes e links curtos podem ser programados para preencher mensagens automaticamente. As mensagens preenchidas de maneira automática podem ter até 140 caracteres de texto. Esse tipo de mensagem é totalmente personalizado e pode ser atualizado ou excluído a qualquer momento.
+
+## Experiência do usuário
+
+Situação do usuário
+
+Comportamento esperado
+
+O usuário tenta acessar um código ou link que foi excluído.
+
+O usuário vê uma mensagem de erro que diz: "Este código QR (link curto) expirou".
+
+O usuário faz a leitura de um QR code ou digita um link curto de uma empresa que ele bloqueou anteriormente.
+
+O usuário recebe um aviso perguntado se ele quer desbloquear a empresa e enviar uma mensagem.
+
+O usuário clica em um link curto em um navegador desktop.
+
+O cliente para computador é aberto com a mensagem preenchida na conversa. Se não houver um cliente instalado, o usuário deverá realizar essa ação.
+
+## Boas práticas
+
+### Formato
+
+Recomendamos que o código QR seja gerado como um gráfico vetorial escalonável (`.svg`). Você pode redimensionar um código QR para aprimorar a embalagem, a sinalização e outras características do produto.
+
+### Aparência
+
+Não temos um recurso nativo para personalizar códigos QR. No entanto, é possível baixar e editar códigos no software da sua preferência. Recomendamos não personalizar a cor, a aparência nem o aspecto do código em si, para não comprometer a legibilidade.
+
+## Perguntas frequentes
+
+**Como faço para criar um QR code ou um link curto?**
+
+Veja, crie, edite e exclua QR codes e links curtos na [API de Gerenciamento do WhatsApp Business](/documentation/business-messaging/whatsapp/qr-codes) ou na [interface do usuário do Gerenciador de Negócios](https://www.facebook.com/business/help/890732351439459).
+
+**Quantos QR codes e links curtos posso criar?**
+
+Um número de telefone da conta do WhatsApp Business (WABA, pelas iniciais em inglês) não pode ser associado a mais de dois mil QR codes e links curtos.
+
+**Qual é o melhor formato para otimizar a qualidade de impressão dos QR codes?**
+
+Para obter a melhor qualidade possível em materiais impressos, recomendamos usar o formato de arquivo `.svg`.
+
+**Qual é a melhoria dos links curtos em relação aos links wa.me atuais?**
+
+Com os novos links curtos, será possível editar ou excluir a qualquer momento as mensagens preenchidas automaticamente que estiverem associadas a um link. Além disso, a sintaxe da URL será reduzida a um código aleatório. Isso eliminará a necessidade de incorporar mensagens à URL e ocultará o telefone.
+
+**O que acontecerá se um usuário clicar em um link curto no desktop?**
+
+Se o usuário tiver instalado o cliente do WhatsApp para computador, uma conversa com sua empresa será aberta. Caso contrário, o usuário receberá um comando interativo para instalar o cliente.
+
+**O que acontecerá se um usuário ler um QR code ou clicar em um link curto que foi excluído?**
+
+Caso um usuário tente acessar um QR code ou um link curto que foi excluído, uma mensagem de erro será exibida para indicar que esse código/link expirou.
+
+**Qual é a diferença em relação aos QR codes gerados atualmente no meu ambiente de desenvolvimento?**
+
+Agora, é possível gerar e gerenciar QR codes diretamente na API de Gerenciamento do WhatsApp Business. Os usuários podem fazer a leitura do QR code com a câmera do WhatsApp, do iOS ou do Android.
+
+Além disso, os QR codes do WhatsApp trazem as seguintes vantagens:
+
+-   As mensagens preenchidas automaticamente são totalmente personalizáveis e podem ser alteradas ou excluídas a qualquer momento.-   Os usuários sempre acessam o app diretamente, sem passar por uma página intersticial.-   Em caso de QR code expirado, a experiência no app enviará uma mensagem vazia ao usuário.
+
+**Como posso garantir que os usuários leiam o código no idioma certo?**
+
+Você é responsável por usar um QR code adequado à localização e ao idioma provável dos usuários.
+
+**Será possível usar análises para monitorar as leituras de QR codes?**
+
+As análises não estão disponíveis para QR codes e links curtos, já que limitamos a quantidade de dados registrada para proteger a privacidade dos usuários.
+
+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/ativos_da_conta/outros_ativos/whatsapp_business_accounts.md

@@ -0,0 +1,99 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/whatsapp-business-accounts -->
+<!-- Scraped: 2025-12-20T17:24:52.688Z -->
+
+# Contas do WhatsApp Business
+
+Updated: 30 de out de 2025
+
+As contas do WhatsApp Business ("WABAs") representam uma empresa na Plataforma do WhatsApp Business. É preciso ter uma WABA para enviar e receber mensagens de usuários do WhatsApp, bem como criar e gerenciar modelos.
+
+Veja diferentes maneiras de criar uma WABA descritas abaixo. Depois de criar a conta, recomendamos [conectar um número de telefone](https://www.facebook.com/business/help/456220311516626) e [configurar uma forma de pagamento](https://www.facebook.com/business/help/2225184664363779).
+
+## Limitações
+
+-   Uma conta do WhatsApp Business (WABA) pode ter até 250 modelos de mensagem.-   Inicialmente, as contas comerciais da Meta podem ter dois números de telefone comerciais registrados. Entretanto, é possível aumentar esse limite para até 20. Consulte [Limites de números registrados](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#registered-number-limits).-   Há um limite inicial de 20 contas do WhatsApp Business para contas comerciais da Meta.-   A WABA precisa pertencer a apenas um Gerenciador de Negócios. Não é possível ter dois ou mais Gerenciadores de Negócios como proprietários de uma conta do WhatsApp Business.-   Não é possível editar o fuso horário e a moeda da conta do WhatsApp Business depois que uma linha de crédito é anexada. Não é possível migrar uma conta do WhatsApp Business de uma empresa para outra.
+
+## Criar uma conta do WhatsApp Business via Painel de Apps
+
+Caso você queira usar a API de Nuvem para enviar e receber mensagens, siga as etapas no documento [Introdução à API de Nuvem](/documentation/business-messaging/whatsapp/get-started). Depois de concluir as etapas mencionadas, você terá uma conta do WhatsApp Business e um número comercial de teste. Além disso, terá acesso à interface **Painel de Apps** > **WhatsApp** > **Configuração da API**.
+
+A opção **Configuração da API** permite adicionar um número de telefone comercial de produção, o que gera uma nova WABA que é então associada ao número.
+
+## Criar uma WABA via provedor de soluções
+
+Se estiver trabalhando com uma empresa que oferece serviços de mensagens do WhatsApp para você por meio da API, esse provedor de soluções fornecerá as instruções. Normalmente, isso envolve a conclusão do fluxo de cadastro incorporado, que reúne informações sobre sua empresa e gera uma conta do WhatsApp Business para você. Depois, basta usar o app do provedor para acessar a conta do WhatsApp Business criada e os ativos relacionados.
+
+Para saber mais, consulte o artigo da Central de Ajuda [Como criar uma conta do WhatsApp Business com provedores de soluções do WhatsApp Business](https://www.facebook.com/business/help/524220081677109).
+
+## Criar uma WABA via Meta Business Suite
+
+Esse recurso será lançado de forma gradual nas próximas semanas e pode não estar disponível para você imediatamente. No momento, não há disponibilidade para portfólios empresariais com endereço no Brasil ou na Índia.
+
+Você pode criar uma conta do WhatsApp Business usando o [Meta Business Suite](https://business.facebook.com). Use esse método se estiver trabalhando com um provedor de soluções que fornece serviços relacionados a mensagens do WhatsApp por meio do Meta Business Suite em vez da API de Nuvem.
+
+Para criar uma WABA usando o Meta Business Suite:
+
+-   Acesse [https://business.facebook.com/](https://business.facebook.com/) e crie um portfólio empresarial ou entre na sua conta e selecione o portfólio existente, caso já tenha um.-   Vá para o painel **Configurações** (ícone de engrenagem) > **Contas** > **Contas do WhatsApp**.-   Clique no botão azul **+Adicionar** e, no menu suspenso, selecione **Crie uma nova conta do WhatsApp Business**.-   Depois, complete o fluxo na janela **Criar uma conta do WhatsApp Business** (imagem abaixo).
+
+## Compartilhar a WABA com um provedor de soluções
+
+Você pode compartilhar a WABA (ou qualquer um dos seus ativos de negócios) com um provedor de soluções verificado pela empresa (também conhecido como "parceiro") usando o Meta Business Suite. Após o compartilhamento, o parceiro poderá usar o Meta Business Suite para acessar sua WABA e fornecer serviços.
+
+### Observações
+
+-   Se estiver compartilhando a WABA com um provedor de soluções (um tipo de parceiro que tem uma linha de crédito), receba primeiro a linha de crédito dele para que você possa usar o app fornecido por ele para enviar mensagens.-   É possível compartilhar uma WABA com até dois parceiros.
+
+### Se você ainda não tiver compartilhado um ativo com o parceiro
+
+-   Peça ao parceiro que informe a identificação do portfólio empresarial dele. Você precisará dessa informação para concluir as etapas restantes.-   Entre no [Meta Business Suite](https://business.facebook.com). Caso você tenha vários portfólios empresariais, use o menu suspenso no canto superior esquerdo para selecionar uma opção.-   Vá para o painel **Configurações** (ícone de engrenagem) > **Contas** > **Contas do WhatsApp**.-   Na lista de WABAs, selecione sua conta ou clique no link **Detalhes**.-   Na sobreposição de detalhes que aparece à direita (imagem abaixo), clique no botão **Atribuir parceiro**.-   Na sobreposição **Compartilhar essa conta do WhatsApp com um parceiro**, insira a identificação do portfólio empresarial do parceiro e use os botões de alternância para definir quais permissões conceder. Depois, clique no botão **Atribuir**.-   Se a WABA for compartilhada com o parceiro, você verá a mensagem **Parceiro adicionado**. Clique no botão **Concluir** para ignorá-la.-   De volta à sobreposição de detalhes, clique na aba **Parceiros**.-   Na aba **Parceiros**, confirme se o nome do parceiro aparece com as permissões apropriadas.-   Informe ao parceiro que você compartilhou a WABA. Se apropriado, peça para ele compartilhar a linha de crédito, conforme explicado acima.
+
+### Se você já tiver compartilhado um ativo com o parceiro
+
+-   Entre no [Meta Business Suite](https://business.facebook.com). Caso você tenha vários portfólios empresariais, use o menu suspenso no canto superior esquerdo para selecionar uma opção.-   Vá para o painel **Configurações** (ícone de engrenagem) > **Usuários** > **Parceiros**.-   Na lista de parceiros, clique em um nome ou no link **Detalhes**.-   Na sobreposição de detalhes que aparece à direita (imagem abaixo), clique no botão **Atribuir ativos**.-   Na janela **Atribuir ativos e permissões**, clique no tipo de ativo **Contas do WhatsApp**.-   Marque a caixa de seleção ao lado da sua WABA, use os botões de alternância para definir quais permissões conceder ao parceiro e clique no botão **Atribuir**.-   Em caso de sucesso, você verá a mensagem **Ativos atribuídos**. Clique no botão **Concluir** para ignorar a janela.-   Confirme que a WABA exibida na aba **Ativos que você atribuiu** tem as permissões adequadas.-   Informe ao parceiro que você compartilhou a WABA. Se apropriado, peça para ele compartilhar a linha de crédito, conforme explicado acima.
+
+## Obter dados da conta do WhatsApp Business por meio da API
+
+Use o ponto de extremidade [GET /<WHATSAPP\_BUSINESS\_ACCOUNT\_ID>](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api#Reading) para obter dados em uma conta do WhatsApp Business. Use o parâmetro `fields` para pedir campos específicos em uma conta do WhatsApp Business ou omita-o para obter campos padrão retornados pelo ponto de extremidade.
+
+### Exemplo de pedido
+
+```
+curl 'https://graph.facebook.com/v24.0/102290129340398?fields=name,status,currency,country,business_verification_status' \
+-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta
+
+```
+{  "name": "Lucky Shrub",  "status": "ACTIVE",  "currency": "USD",  "country": "US",  "business_verification_status": "verified",  "id": "102290129340398"}
+```
+
+## Acessar a WABA com o Gerenciador do WhatsApp
+
+Você pode acessar sua WABA no Gerenciador do WhatsApp para ver informações básicas, como status do número de telefone comercial e métricas de mensagens. Também é possível executar tarefas simples, como criação e edição de modelos.
+
+Para acessar sua conta do WhatsApp Business no Gerenciador do WhatsApp:
+
+-   Entre no [Meta Business Suite](https://business.facebook.com). Caso você tenha vários portfólios empresariais, use o menu suspenso no canto superior esquerdo para selecionar uma opção.-   Vá para o painel **Configurações** (ícone de engrenagem) > **Contas** > **Contas do WhatsApp**.-   Na lista de WABAs, selecione sua conta ou clique no link **Detalhes**.-   Na aba **Resumo**, clique no botão **Gerenciador do WhatsApp**.
+
+## Webhooks
+
+Assine o webhook [account\_update](/documentation/business-messaging/whatsapp/webhooks/reference/account_update) para receber notificações sobre alterações no status de uma conta do WhatsApp Business, incluindo mudanças devido a violações de políticas e termos.
+
+Sempre que sua conta do WhatsApp Business violar uma política, você receberá uma notificação semelhante a esta:
+
+```
+{  "object": "whatsapp_business_account",  "entry": [    {      "id": "whatsapp-business-account-id",      "time": 1604703058,      "changes": [        {          "field": "account_update",          "value": {            "phone_number": "16505551111",            "event": "ACCOUNT_VIOLATION",            "violation_info": {              "violation_type": "ALCOHOL",            }          }        }      ]    }  ]}
+```
+
+Para ver uma lista de violações de política, consulte o documento [Violações de políticas da plataforma do WhatsApp Business](/documentation/business-messaging/whatsapp/policy-enforcement-violations). Se uma restrição tiver sido imposta, um webhook **account\_update** será disparado, descrevendo a violação.
+
+## Enviar mensagens em nome do cliente
+
+O modelo de propriedade da conta do WhatsApp Business "Em nome de" está obsoleto e não é mais possível. Consulte [descontinuação do modelo OBO](/documentation/business-messaging/whatsapp/solution-providers/obo-model-deprecation) para mais detalhes.
+
+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/ativos_da_conta/telefones_comerciais/AGENTS.md

@@ -0,0 +1,11 @@
+# Telefones Comerciais
+
+Gerenciamento de telefones comerciais
+
+## Documentos Disponíveis
+
+- [Conversational Components](./conversational_components.md)
+- [Phone Numbers](./phone_numbers.md)
+- [Registration](./registration.md)
+- [Two Step Verification](./two_step_verification.md)
+