whatsapp-docs-mcp 1.0.0

package/docs/recado/precos/pricing_updates_to_pricing.md

@@ -0,0 +1,8 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing/updates-to-pricing -->
+<!-- Scraped: 2025-12-20T17:23:25.752Z -->
+
+## Esta página não está disponível no momento
+
+Isso pode ter ocorrido devido a um erro técnico que estamos trabalhando para corrigir. Tente recarregar esta página.
+
+Recarregar página

package/docs/recado/sobre_a_plataforma/AGENTS.md

@@ -0,0 +1,10 @@
+# Sobre a Plataforma
+
+Documentação sobre a plataforma, tokens de acesso e permissões
+
+## Documentos Disponíveis
+
+- [About The Platform](./about_the_platform.md)
+- [Access Tokens](./access_tokens.md)
+- [Permissions](./permissions.md)
+

package/docs/recado/sobre_a_plataforma/about_the_platform.md

@@ -0,0 +1,217 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform -->
+<!-- Scraped: 2025-12-20T17:22:53.708Z -->
+
+# Sobre a Plataforma do WhatsApp Business
+
+Updated: 4 de nov de 2025
+
+A Plataforma do WhatsApp Business permite que as empresas se comuniquem com os clientes em escala.
+
+Esta documentação é destinada a desenvolvedores que usam as nossas APIs. Para saber mais sobre outras maneiras de usar o WhatsApp para sua empresa, consulte o [site do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2F&h=AT001waIUZz9Fc5T-qM9lo1Z3T5ZDs4ZHFbBm-tTTnV6nplSN-SUBcI4Dm7aVD3y_V9-P5LymWWUuvgfe46kQ-M4zAibbrdEMgAWIt2xsfaWoAEJFEfQVOs2E-7uBnW-ZQwbHx1N_vrRgDGaDazGGOOhehk).
+
+## Principais APIs e recursos
+
+### API de Nuvem do WhatsApp
+
+A API de Nuvem do WhatsApp permite que você envie mensagens e faça ligações de forma programática no WhatsApp. A API de Nuvem pode ser usada para enviar aos usuários diferentes tipos de mensagens, desde SMSs simples a mensagens interativas e de mídia avançada.
+
+A API de Nuvem do WhatsApp inclui o seguinte:
+
+-   **Mensagem:** envie SMSs, mídias avançadas e mensagens interativas-   **Ligações:** faça e receba ligações de clientes-   **Grupos:** crie, gerencie e envie mensagens em conversas em grupo do WhatsApp.
+
+As mensagens do WhatsApp oferecem uma maneira eficiente e privada de interagir com os clientes. Use a API de Nuvem para:
+
+-   Enviar confirmações de pedidos e atualizações sobre o envio.-   Informar a disponibilidade de horários e enviar outros lembretes.-   Gerar oportunidades de upsell e venda cruzada.-   Facilitar as transações do início ao fim, da descoberta do produto até o pagamento.-   Ativar a autenticação multifatorial ou as senhas descartáveis para fazer a confirmação de contas e usuários.-   Fornecer experiências de conversa interativas e personalizadas
+
+[Saiba mais sobre os tipos de mensagens na API de Nuvem do WhatsApp.](/documentation/business-messaging/whatsapp/messages/send-messages)
+
+### API de Gerenciamento de Negócios
+
+A API de Gerenciamento do WhatsApp Business permite gerenciar programaticamente uma conta do WhatsApp Business e os ativos associados.
+
+Gerencie ativos de conta com a API de Gerenciamento do WhatsApp Business, como:
+
+-   **Números de telefone comerciais:** adicione e remova números de telefone associados à sua empresa.-   **Modelos:** crie e modifique modelos de mensagens para mensagens escaláveis.
+
+A API de Gerenciamento do WhatsApp Business também dá acesso a análises da conta, como:
+
+-   **Análise de mensagens:** o número e o tipo de mensagens enviadas e entregues.-   **Análise de preços:** detalhamentos de preços granulares para mensagens entregues.-   **Análise de modelos:** métricas de modelos enviados/lidos/entregues, além de cliques no botão de mensagem do modelo.  
+    -   [Saiba mais sobre modelos de mensagem.](/documentation/business-messaging/whatsapp/templates/overview)-   [Saiba mais sobre como gerenciar números de telefone comerciais.](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers)-   [Saiba mais sobre análises de conta.](/documentation/business-messaging/whatsapp/analytics)
+
+### API de Mensagens de Marketing Lite
+
+A MM Lite é uma API para enviar mensagens de marketing otimizadas no WhatsApp.
+
+Ao enviar mensagens de marketing por meio da API de MM Lite, você pode acessar novos recursos não disponíveis na API de Nuvem e receber otimizações automáticas para que as mensagens de alto engajamento alcancem mais clientes.
+
+A API de MM Lite inclui:
+
+-   **Entrega baseada em qualidade:** até 9% de aumento na entrega de mensagens de marketing via API de Nuvem para conteúdo de alto engajamento.-   **Otimizações de criativos automatizadas:** aprimore automaticamente o criativo de marketing para melhorar o desempenho das mensagens.-   **Referências de desempenho e recomendações:** comparação de taxas de leitura e cliques em relação a modelos semelhantes de empresas na sua região.-   **Métricas de conversão:** mensure as mensagens de marketing que levam os usuários a realizar eventos no app, como "Adicionar ao carrinho", "Finalização de compra iniciada" ou "Comprar".
+
+[Saiba mais sobre a API de Mensagens de Marketing Lite.](/documentation/business-messaging/whatsapp/marketing-messages/overview)
+
+### Webhooks
+
+Os webhooks entregam cargas JSON ao servidor para atualizações de status da mensagem, mensagens recebidas, gerenciamento de erros assíncronos e muitos outros serviços de notificação.
+
+A plataforma depende totalmente dos webhooks. Isso porque o conteúdo de qualquer mensagem enviada por um usuário do WhatsApp ao seu número de telefone comercial é transmitido como um webhook, e todas as atualizações de status de entrega de mensagens enviadas são registradas via webhook.
+
+[Saiba mais sobre webhooks](/documentation/business-messaging/whatsapp/webhooks/overview).
+
+## Fundamentos técnicos
+
+### Protocolo HTTP e pedidos de API
+
+A Plataforma do WhatsApp Business foi desenvolvida com base na [Graph API](/docs/graph-api/overview) e usa o protocolo HTTP. Os pedidos de API incluem parâmetros de caminho, corpo e cabeçalho.
+
+#### Exemplo: como enviar uma mensagem de texto usando cURL
+
+```
+curl 'https://graph.facebook.com/v17.0/106540352242922/messages' \  -H 'Content-Type: application/json' \  -H 'Authorization: Bearer EAAJB...' \  -d '{    "messaging_product": "whatsapp",    "recipient_type": "individual",    "to": "+16505555555",    "type": "text",    "text": {      "preview_url": true,      "body": "Here's the info you requested! https://www.meta.com/quest/quest-3/"    }  }'
+```
+
+[Saiba mais sobre a Graph API.](/docs/graph-api)
+
+### Respostas JSON
+
+As respostas da API são formatadas em JSON.
+
+#### Exemplo: como pedir os metadados de um número de telefone comercial
+
+```
+{  "verified_name": "Lucky Shrub",  "code_verification_status": "VERIFIED",  "display_phone_number": "15550783881",  "quality_rating": "GREEN",  "platform_type": "CLOUD_API",  "throughput": {    "level": "STANDARD"  },  "webhook_configuration": {    "application": "https://www.luckyshrub.com/webhooks"  },  "id": "106540352242922"}
+```
+
+### Autenticação e autorização
+
+A autenticação usa tokens de acesso OAuth (não 2.0), enquanto as permissões restringem o acesso a recursos específicos.
+
+-   [Saiba mais sobre os tokens de acesso.](/documentation/business-messaging/whatsapp/access-tokens)-   [Saiba mais sobre permissões.](/documentation/business-messaging/whatsapp/permissions)
+
+## Principais recursos
+
+### Portfólios empresariais
+
+Com o portfólio empresarial, as organizações podem reunir todos os ativos de negócios da Meta para gerenciá-los em um só lugar. Na Plataforma do WhatsApp Business, um portfólio empresarial serve principalmente como um contêiner para contas do WhatsApp Business (WABA). É preciso ter um portfólio empresarial para usar a plataforma.
+
+Os portfólios empresariais podem ser verificados, e o status de verificação contribui para melhorar a funcionalidade, como maior taxa de transferência de dados e o status de [conta comercial oficial](/documentation/business-messaging/whatsapp/official-business-accounts).
+
+[Saiba mais sobre os portfólios empresariais](https://www.facebook.com/business/help/486932075688253).
+
+### Contas do WhatsApp Business (WABA)
+
+Uma conta do WhatsApp Business representa sua empresa, armazenando metadados e vinculando-a a números de telefone, modelos e análises.
+
+[Saiba mais sobre as contas do WhatsApp Business.](/documentation/business-messaging/whatsapp/whatsapp-business-accounts)
+
+### Números de telefone comerciais
+
+Os números de telefone comerciais, reais ou virtuais, são usados para enviar e receber mensagens do WhatsApp. Eles podem ter nomes de exibição e receber o status de conta comercial oficial.
+
+[Saiba mais sobre números de telefone comercial.](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers)
+
+### Modelos de mensagem
+
+Os modelos são mensagens personalizáveis que você pode criar antes do envio. Em geral, as mensagens de modelo precisam ser aprovadas antes do envio.
+
+Os modelos são úteis para enviar mensagens em escala. Além disso, eles são o único tipo de mensagem que pode ser enviado a usuários do WhatsApp fora da [janela de atendimento ao cliente](/documentation/business-messaging/whatsapp/messages/send-messages#customer-service-windows).
+
+Os modelos têm pontuações de qualidade e estão sujeitos a vários limites de mensagens.
+
+[Saiba mais sobre modelos de mensagem.](/documentation/business-messaging/whatsapp/templates/overview)
+
+### Recursos de teste
+
+Depois que você [começar a usar a API de Nuvem](/documentation/business-messaging/whatsapp/get-started), uma WABA e um número de telefone comercial de teste serão criados automaticamente para você. As WABAs e os números de telefone de teste são úteis para fazer experimentos, já que eles flexibilizaram os limites de mensagens e não exigem uma forma de pagamento registada para enviar mensagens de modelo.
+
+Será possível excluir seu portfólio empresarial e os respectivos recursos de teste se:
+
+-   você for um administrador do portfólio empresarial associada ao app;-   nenhum outro app estiver associado ao portfólio empresarial;-   o portfólio empresarial não estiver associada a nenhuma outra WABA;-   a WABA não estiver associada a nenhum outro número de telefone comercial.
+
+Para excluir seu portfólio empresarial e os respectivos recursos de teste:
+
+-   Acesse **Painel de Apps > WhatsApp > Configuração**.-   Encontre a seção **Conta de teste**.-   Clique no botão **Excluir**.
+
+Recomendamos usar o API Playground ao testar os pontos de extremidade. A área de teste está disponível na seção "Referência da API", na barra lateral esquerda desta página. Em cada referência, existe um botão "Experimentar" que abre o playground.
+
+Além disso, a [coleção Postman](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.postman.com%2Fmeta%2Fwhatsapp-business-platform%2F&h=AT001waIUZz9Fc5T-qM9lo1Z3T5ZDs4ZHFbBm-tTTnV6nplSN-SUBcI4Dm7aVD3y_V9-P5LymWWUuvgfe46kQ-M4zAibbrdEMgAWIt2xsfaWoAEJFEfQVOs2E-7uBnW-ZQwbHx1N_vrRgDGaDazGGOOhehk) é útil para testes.
+
+## Ferramentas e integrações
+
+### Gerenciador do WhatsApp
+
+O Gerenciador do WhatsApp é um app para web que permite o gerenciamento de WABAs, números de telefone, modelos e análises.
+
+[Acessar o Gerenciador do WhatsApp](https://business.facebook.com/wa/manage/home/)
+
+### SDKs de terceiros
+
+Alguns SDKs, como [PyWa](https://l.facebook.com/l.php?u=https%3A%2F%2Fpywa.readthedocs.io%2Fen%2F2.0.1%2F&h=AT001waIUZz9Fc5T-qM9lo1Z3T5ZDs4ZHFbBm-tTTnV6nplSN-SUBcI4Dm7aVD3y_V9-P5LymWWUuvgfe46kQ-M4zAibbrdEMgAWIt2xsfaWoAEJFEfQVOs2E-7uBnW-ZQwbHx1N_vrRgDGaDazGGOOhehk) (wrapper Python), estão disponíveis, mas não são mantidos ou endossados pela Meta.
+
+### Coleção Postman
+
+A coleção Postman oficial permite executar consultas comuns de API.
+
+[Acesse a coleção Postman da Plataforma do WhatsApp Business.](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.postman.com%2Fmeta%2Fwhatsapp-business-platform%2F&h=AT001waIUZz9Fc5T-qM9lo1Z3T5ZDs4ZHFbBm-tTTnV6nplSN-SUBcI4Dm7aVD3y_V9-P5LymWWUuvgfe46kQ-M4zAibbrdEMgAWIt2xsfaWoAEJFEfQVOs2E-7uBnW-ZQwbHx1N_vrRgDGaDazGGOOhehk)
+
+## Segurança e desempenho
+
+### Taxa de transferência de dados
+
+Os números de telefone comercial podem enviar até 80 mensagens por segundo por padrão, com atualizações de capacidade disponíveis.
+
+[Saiba mais sobre taxa de transferência.](/documentation/business-messaging/whatsapp/throughput)
+
+### Criptografia
+
+Com a API de Nuvem, todas as mensagens do WhatsApp continuam sendo protegidas pela criptografia do protocolo Signal desde antes de deixarem o dispositivo. Isso significa que as mensagens com uma WABA são entregues com segurança ao destino escolhido pela empresa.
+
+A API de Nuvem aplica técnicas padrão de criptografia da indústria para proteger dados em trânsito e em repouso. Ela usa a Graph API para enviar mensagens e Webhooks a fim de receber eventos. Ambos operam com HTTPS padrão da indústria protegido por TLS. Consulte o documento técnico Visão Geral da Criptografia para saber mais.
+
+Para saber mais, consulte o [relatório técnico Visão Geral da Criptografia do WhatsApp](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.whatsapp.com%2Fsecurity%2FWhatsApp-Security-Whitepaper.pdf&h=AT001waIUZz9Fc5T-qM9lo1Z3T5ZDs4ZHFbBm-tTTnV6nplSN-SUBcI4Dm7aVD3y_V9-P5LymWWUuvgfe46kQ-M4zAibbrdEMgAWIt2xsfaWoAEJFEfQVOs2E-7uBnW-ZQwbHx1N_vrRgDGaDazGGOOhehk).
+
+### Dimensionamento
+
+A API de Nuvem dimensiona automaticamente o uso dentro dos limites de volume.
+
+### Limites de volume
+
+A plataforma aplica vários limites de volume de mensagens:
+
+-   Testar o limite de volume de mensagens (para WABAs não verificadas)-   Limites de mensagens e classificação de qualidade (para WABAs verificadas)-   Limite de volume de capacidade (para todas as contas)-   Limite de volume de telefonia comercial (por número de telefone)
+
+#### Limites de volume de pareamento
+
+Os números de telefone comercial podem enviar uma mensagem a cada seis segundos para o mesmo usuário do WhatsApp (0,17 mensagem por segundo), o que é equivalente a cerca de dez mensagens por minuto ou 600 por hora. Exceder esse limite gera o [código de erro 131056](/documentation/business-messaging/whatsapp/support/error-codes#throttling-errors) até que você fique dentro da taxa permitida novamente.
+
+É possível enviar até 45 mensagens em um período de seis segundos, mas essa ação tomará "emprestado" parte da sua cota futura. Após um pico no uso, é preciso esperar o tempo equivalente ao que levaria para enviar essas mensagens dentro da taxa normal (por exemplo, uma pico de 20 mensagens requer uma espera de aproximadamente dois minutos para enviar mais mensagens para o usuário).
+
+Para gerenciar a limitação após o pico, se um pedido de envio falhar, tente novamente após 4^X segundos (começando com X=0 e aumentando X em uma unidade após cada falha) até ter sucesso.
+
+## Termos e políticas
+
+### Adesão do usuário
+
+É preciso obter a [aceitação do usuário](/documentation/business-messaging/whatsapp/getting-opt-in) antes de enviar modelos de mensagem A aceitação deve esclarecer o nome e a intenção da empresa.
+
+[Saiba mais sobre a Política de Mensagens do WhatsApp Business.](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.whatsapp.com%2Flegal%2Fbusiness-policy%2F&h=AT001waIUZz9Fc5T-qM9lo1Z3T5ZDs4ZHFbBm-tTTnV6nplSN-SUBcI4Dm7aVD3y_V9-P5LymWWUuvgfe46kQ-M4zAibbrdEMgAWIt2xsfaWoAEJFEfQVOs2E-7uBnW-ZQwbHx1N_vrRgDGaDazGGOOhehk)
+
+### Termos e políticas
+
+O uso da plataforma deve estar em conformidade com os termos e políticas do WhatsApp. É proibido usar ferramentas não autorizadas de terceiros.
+
+-   [Saiba mais sobre termos e políticas.](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.whatsapp.com%2Flegal%2Fbusiness-terms%2F&h=AT001waIUZz9Fc5T-qM9lo1Z3T5ZDs4ZHFbBm-tTTnV6nplSN-SUBcI4Dm7aVD3y_V9-P5LymWWUuvgfe46kQ-M4zAibbrdEMgAWIt2xsfaWoAEJFEfQVOs2E-7uBnW-ZQwbHx1N_vrRgDGaDazGGOOhehk)
+
+## Próximas etapas
+
+[Introdução à Plataforma do WhatsApp Business.](/documentation/business-messaging/whatsapp/get-started)
+
+**Saiba mais**
+
+-   [Nomes de exibição](/documentation/business-messaging/whatsapp/display-names)-   [Números de telefone](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers)-   [Preços](/documentation/business-messaging/whatsapp/pricing)-   [Webhooks](/documentation/business-messaging/whatsapp/webhooks/overview)
+
+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/recado/sobre_a_plataforma/access_tokens.md

@@ -0,0 +1,110 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens -->
+<!-- Scraped: 2025-12-20T17:23:01.110Z -->
+
+# Tokens de acesso
+
+Updated: 6 de nov de 2025
+
+A plataforma é compatível com os seguintes tipos de token de acesso. O tipo de token depende de quem usará seu app e se você é ou não um parceiro de solução.
+
+-   Caso você seja um **desenvolvedor direto**, ou seja, somente você ou sua empresa acessarão os respectivos dados, use um [token de acesso de usuário do sistema](#system-user-access-tokens).-   Caso você seja um **provedor de tecnologia**, use um [token de acesso de usuário do sistema de integração comercial](#business-integration-system-user-access-tokens).-   Caso você seja um **parceiro de solução**, use [tokens de acesso de usuário do sistema](#system-user-access-tokens) para compartilhar sua linha de crédito com clientes recém-integrados e [tokens de acesso de usuário do sistema de integração comercial](#business-integration-system-user-access-tokens) para o restante.
+
+## Tokens de acesso do usuário do sistema
+
+Os tokens de acesso de usuário do sistema ("tokens do sistema") representam você, sua empresa ou organização ou pessoas dentro da sua empresa ou organização. A principal vantagem desses tokens é que eles têm longa duração e podem representar serviços automatizados dentro da sua empresa que não exigem nenhuma entrada do usuário.
+
+Os tokens do sistema dependem dos usuários do sistema. A maioria dos pontos de extremidade verifica se o usuário identificado pelo token tem acesso ao recurso consultado. Caso o usuário não tenha acesso ao recurso, a solicitação será rejeitada com o código de erro `200`.
+
+Os usuários do sistema podem ser [administradores](#admin-system-users) ou [funcionários](#employee-system-users).
+
+### Usuários do sistema com função administrativa
+
+Por padrão, os usuários do sistema com função de administrador têm acesso total a todas as WABAs e aos respectivos ativos pertencentes ou compartilhados com você ou seu portfólio empresarial.
+
+Esses usuários serão úteis se o app precisar de acesso a todos os ativos do portfólio empresarial, sem precisar conceder manualmente o acesso a cada ativo de negócios que for criado ou compartilhado com seu portfólio.
+
+É possível substituir o acesso padrão aos ativos de negócios de um usuário do sistema com função administrativa concedendo acesso parcial a WABAs. Consulte [Acesso aos ativos de negócios](#business-asset-access) para saber como configurar e substituir acessos.
+
+### Usuários do sistema para funcionários
+
+Os usuários do sistema para funcionários devem ter acesso a WABAs individuais pertencentes ou compartilhadas com seu portfólio empresarial. Se o app precisar acessar apenas algumas WABAs que pertencem a você, um usuário do sistema para funcionários deverá ser suficiente.
+
+Depois de criado, conceda [acessos aos ativos de negócios](#business-asset-access) no nível **parcial** ou **total** a cada WABA que o usuário do sistema precisar acessar.
+
+### Como gerar tokens de acesso de usuário do sistema
+
+Para gerar um token do sistema, acesse o painel [**Configurações do negócio**](https://business.facebook.com/settings/) e clique em **Usuários do sistema**:
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/465045103_469826065488878_468932947489962332_n.png?_nc_cat=105&ccb=1-7&_nc_sid=e280be&_nc_ohc=0vqMaqhbNgwQ7kNvwErdatg&_nc_oc=AdkKUCPhl4lQbpLwQ9K0ftTx4PyQ1ZzvHVBJtOa17sM8Lcj8wcJUmscS6Wi133Y0FOQ&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=vk86kFR7Y1AnuqA8X-Avew&oh=00_AfmO1cbDCQ2lfoFm3mtbH6IOPzyZlji718juTjCvIKgDIg&oe=6961073E)
+
+Clique no botão **+Adicionar** e, na janela **Criar usuário do sistema**, digite o nome do usuário do sistema e atribua a ele a função **Administrador** ou **Funcionário**:
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/465150702_510049308508353_7881035250572985544_n.png?_nc_cat=107&ccb=1-7&_nc_sid=e280be&_nc_ohc=DxS4zO8voCUQ7kNvwGIDCw1&_nc_oc=AdnkcTUn87hwDtf6G4SclwntGqqF46xRCnQX9gL7lJulHQxOXXpCm_ggkYPtSk9fnLI&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=vk86kFR7Y1AnuqA8X-Avew&oh=00_Afk_MFIT4AgELGNmM69xgT3s4zyi6Z22htJBL9d_WDBZwQ&oe=69610DCE)
+
+Depois de criado, ele aparecerá na lista de usuários do sistema. Clique no nome do usuário do sistema para exibir a sobreposição de atribuição de ativos:
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/465056956_862633796067178_7287331611550335065_n.png?_nc_cat=111&ccb=1-7&_nc_sid=e280be&_nc_ohc=p3m1UUWrfZQQ7kNvwGbqTAk&_nc_oc=AdnFiOXBI8UjAlir5UITKxjGbxS8UUNCSpzg8jsKoBkZ4ngHh7G0PxhdKcosMOBWsdw&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=vk86kFR7Y1AnuqA8X-Avew&oh=00_AfnAO-eCK7zWR61FBZe-Tniwe6n5aER12yzlOkTd1o_X-g&oe=69611656)
+
+Clique no botão **Atribuir ativos** para exibir a janela **Selecionar ativos e atribuir permissões**:
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/465238023_523683013888319_4402098107854849013_n.png?_nc_cat=111&ccb=1-7&_nc_sid=e280be&_nc_ohc=GJqMxjgJPk4Q7kNvwHaAdCs&_nc_oc=AdkQXn0-O1R2LD-39J1dn-gWu0fI4ZJ4Y7RW0jWEYQtR-P9O2tvCK_ZJlFeTDUSWrJg&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=vk86kFR7Y1AnuqA8X-Avew&oh=00_AfltFKtUDpgjvQxwJfi3Vr2Oqha6hFoA3GLsRasgg6adpw&oe=6961277F)
+
+Selecione seu app e conceda ao usuário do sistema a permissão **Gerenciar app**. Depois, clique no botão **Atribuir ativos** para confirmar e dispensar a janela.
+
+De volta ao painel **Usuários do sistema**, recarregue a página para confirmar que foi concedido **Controle total** do app ao seu usuário do sistema. Pode demorar alguns minutos até que as permissões sejam concedidas; por isso, caso seu app não apareça como um ativo atribuído, recarregue a página após alguns minutos. Depois que o ativo for atribuído, o menu terá esta aparência:
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/465048557_1084025226566535_5772232306997286547_n.png?_nc_cat=111&ccb=1-7&_nc_sid=e280be&_nc_ohc=Bh4ylY1lqPMQ7kNvwGgMbHi&_nc_oc=Adms-5EmJwyQjpUEGBt4iWie6fkEVylIWDJcCF0pL1bIB-0EMReh05TrK3_wXSEVIs8&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=vk86kFR7Y1AnuqA8X-Avew&oh=00_Afm_KNcmlOgE8FoIawUe1MA__FBjVGiJwUT_nQWzuEh0cQ&oe=69611CD8)
+
+Quando constatar que foi concedido o controle total do app ao usuário do sistema, clique no botão **Gerar token** na sobreposição de atribuição de ativo. Na janela que for exibida, selecione seu app, escolha uma preferência para expiração do token e atribua ao app estas três permissões da Graph API:
+
+-   `business_management`-   `whatsapp_business_management`-   `whatsapp_business_messaging`
+
+Você pode pesquisar o termo "empresas" para encontrar essas permissões rapidamente:
+
+![](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/465115001_533379429601225_2797461055613545929_n.png?_nc_cat=104&ccb=1-7&_nc_sid=e280be&_nc_ohc=lpIsdVX_IQoQ7kNvwEUWlG1&_nc_oc=AdmZtYG4DX9M_G9ZTXLKdHcubAe_tLA4nyDXtHO5lKwkLTmUGOxEjXGBlyToboJFcSE&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=vk86kFR7Y1AnuqA8X-Avew&oh=00_AfluEfgjpR1H9aUAnonZh67Am-YaamIs4iIduTnOk5Oumg&oe=69613399)
+
+Clique no botão **Gerar token** e copie o token que for exibido.
+
+## Tokens de acesso do usuário do sistema de integração comercial
+
+Os tokens de acesso de usuário do sistema de integração comercial ("tokens comerciais") têm como escopo clientes individuais e devem ser usados por Provedores de Tecnologia e parceiros de soluções ao acessar dados de clientes integrados.
+
+Esses tokens são úteis para apps que realizam ações programáticas e automatizadas nas WABAs dos clientes, sem precisar depender da entrada de um usuário do app nem exigir uma nova autenticação no futuro.
+
+Para gerar tokens de acesso de usuário do sistema de integração comercial, será preciso implementar o Cadastro Incorporado (configurado com o Login do Facebook para Empresas) e trocar o código retornado a você quando um cliente concluir o fluxo.
+
+Consulte os documentos sobre [Cadastro Incorporado](/documentation/business-messaging/whatsapp/embedded-signup/overview) e [tokens de acesso de usuário do sistema de integração comercial](/docs/facebook-login/facebook-login-for-business#business-integration-system-user-access-tokens) para saber mais sobre esses tokens e entender como eles são gerados.
+
+## Tokens de acesso do usuário
+
+Embora os tokens de acesso do usuário sejam compatíveis e possam ser usados por todos os desenvolvedores de apps, você provavelmente os usará apenas quando acessar o Painel de Apps pela primeira vez para [enviar sua primeira mensagem](/documentation/business-messaging/whatsapp/get-started). No entanto, ao desenvolver seu app, a tendência é que você mude para um token de acesso de usuário do sistema (e, eventualmente, para um token de acesso de usuário do sistema de integração comercial, caso você seja um provedor de tecnologia ou parceiro de solução). Isso ocorre porque os tokens de acesso do usuário expiram rapidamente, o que significa que você terá que gerar um novo em intervalos de poucas horas.
+
+Existem várias maneiras de gerar um token de acesso do usuário:
+
+-   Acesse **Painel de Apps** > **WhatsApp** > **Configuração da API**. Esse painel gera um novo token de acesso do usuário sempre que você o visita. O token tem escopo automático para seu usuário, já que você fez login com sua conta de desenvolvedor ao acessar o painel.-   Use o [Explorador da Graph API](/tools/explorer).-   Implemente o [Login do Facebook](/docs/facebook-login).
+
+## Como usar tokens em solicitações
+
+Ao fazer solicitações de API, inclua o token no cabeçalho da solicitação de autorização, antecedido por `Bearer`. Por exemplo:
+
+```
+curl 'https://graph.facebook.com/v18.0/102290129340398/message_templates' \-H 'Authorization: Bearer EAAJB...' \
+```
+
+## Acesso aos ativos de negócios
+
+Depois de criar um usuário do sistema, você precisa definir os níveis de acesso aos ativos de negócios. Muitos pontos de extremidade exigem que o usuário do sistema com o token incluído nas solicitações de API tenha acesso **parcial** ou **total** aos ativos de negócios da WABA consultada (ou aos ativos relacionados). Caso não tenha acesso, os pontos de extremidade retornarão o código de erro `200`.
+
+Lembre-se de que, ao definir o acesso aos ativos de negócios de um usuário do sistema em uma WABA como **parcial**, você poderá restringir ainda mais o acesso a determinados ativos ou ações na conta em questão. Por exemplo, se você tem uma empresa grande e quer que um departamento específico tenha apenas acesso de leitura ao modelo de uma WABA e aos dados do número de telefone comercial, crie um usuário do sistema para esse departamento e defina o acesso detalhado para somente visualização.
+
+Para definir o acesso a ativos de negócios em uma WABA:
+
+-   Entre no [Meta Business Suite](https://business.facebook.com).-   Encontre o portfólio empresarial no menu suspenso exibido no canto superior esquerdo. Depois, clique em **Configurações** (ícone de engrenagem).-   Navegue até **Contas** > **Contas do WhatsApp**.-   Selecione a WABA desejada.-   Selecione a aba **Acesso à conta do WhatsApp**.-   Clique no botão **Adicionar pessoas**.-   Selecione o usuário do sistema apropriado e atribua os níveis de acesso adequados na WABA.
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/458274092_845026414442989_6944264004016403962_n.png?_nc_cat=103&ccb=1-7&_nc_sid=e280be&_nc_ohc=V5VnM5zsZB0Q7kNvwFC-um9&_nc_oc=AdmA1uWY7HraC80SxlrLa9N8kI0qRONiSdpLvy1lsz9RnEtmOXLwejZlVroK8pTGHYw&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=vk86kFR7Y1AnuqA8X-Avew&oh=00_AflEdvOqc_nEgADKC5vHMFuQS4zW-ZJ-XU-sYw5GgitqSQ&oe=696119AE)
+
+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/recado/sobre_a_plataforma/permissions.md

@@ -0,0 +1,55 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/permissions -->
+<!-- Scraped: 2025-12-20T17:23:09.562Z -->
+
+# Permissões
+
+Updated: 5 de nov de 2025
+
+Os pontos de extremidade da plataforma são protegidos por permissões. As referências de cada ponto de extremidade indicam quais permissões são necessárias. Em geral, você precisará do seguinte:
+
+-   [whatsapp\_business\_management](/docs/permissions#whatsapp_business_management): necessário para acessar os metadados da sua conta comercial do WhatsApp, gerenciar modelos, obter os números de telefone comerciais associados à sua WABA, consultar todas as análises e receber webhooks que notificam sobre alterações na sua conta comercial do WhatsApp.-   [whatsapp\_business\_messaging](/docs/permissions#whatsapp_business_messaging): necessário para enviar qualquer tipo de mensagem a usuários do WhatsApp, bem como para receber webhooks de mensagem recebida e de status da mensagem.
+
+Dependendo das suas necessidades comerciais, talvez você precise destas permissões:
+
+-   [business\_management](/docs/permissions#business_management): necessária apenas se você precisar acessar o portfólio empresarial de forma programática (isso é raramente necessário, já que é possível acessar o portfólio usando o [Meta Business Suite](https://business.facebook.com/)).-   [whatsapp\_business\_manage\_events](/docs/permissions#whatsapp_business_manage_events): necessária apenas se você estiver enviando modelos de marketing com a [API de Mensagens de Marketing Lite](/documentation/business-messaging/whatsapp/marketing-messages/overview), em conjunto com a [API de Conversões](/docs/marketing-api/conversions-api), para rastreamento de eventos.-   [ads\_read](/docs/permissions#ads_read): necessária apenas se você estiver usando a [API de Mensagens de Marketing Lite](/documentation/business-messaging/whatsapp/marketing-messages/overview) em conjunto com a [API de Insights](/docs/marketing-api/insights) para receber métricas de conversão.
+
+## Análise do App
+
+Caso você seja um [provedor de soluções](/documentation/business-messaging/whatsapp/solution-providers/overview) e outras empresas usem seu app para acessar os próprios dados, o app precisará passar pelo [processo de análise](/documentation/business-messaging/whatsapp/solution-providers/app-review), e você deverá receber aprovação para **acesso avançado** a todas as permissões necessárias. Se o acesso avançado a determinada permissão não for aprovado, os usuários não poderão conceder essa permissão ao seu app.
+
+Se você for desenvolvedor direto e acessar apenas os dados da sua própria empresa, não será necessário realizar a Análise do App nem ter acesso avançado a permissões.
+
+## Como obter permissões
+
+Os usuários devem conceder permissões individuais ao app. Caso seja um desenvolvedor direto e estiver usando um token do sistema, quando criar um [token do sistema](/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens), você deverá criar um usuário do sistema e usá-lo para conceder permissões individuais ao seu app como parte do processo de criação do token do sistema:
+
+![](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/465115001_533379429601225_2797461055613545929_n.png?_nc_cat=104&ccb=1-7&_nc_sid=e280be&_nc_ohc=lpIsdVX_IQoQ7kNvwEUWlG1&_nc_oc=AdmZtYG4DX9M_G9ZTXLKdHcubAe_tLA4nyDXtHO5lKwkLTmUGOxEjXGBlyToboJFcSE&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=gydEzmV7nGrD9HtkPvxd8Q&oh=00_AfnmrVcqJjjLpqLXXYtDAWMBinoEFdmsBbWZ1HVHZdxerg&oe=69613399)
+
+Caso seja um [provedor de soluções](/documentation/business-messaging/whatsapp/solution-providers/overview) que usa [tokens comerciais](/documentation/business-messaging/whatsapp/access-tokens#business-integration-system-user-access-tokens), a [tela de autorização](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#authorization-screen) do Cadastro incorporado permitirá que o usuário conceda ao seu app as permissões para as quais você tem aprovação de acesso avançado:
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/464191580_1337884324044562_8279151817864174578_n.png?_nc_cat=107&ccb=1-7&_nc_sid=e280be&_nc_ohc=nDDrvqzrvxAQ7kNvwF3ADL9&_nc_oc=AdmVu6rD_VwVStlwMgwitBPtvZ1ayL1gipe2X1OsAiIQDyKNh0FQCSvJC0cTeKNCVSY&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=gydEzmV7nGrD9HtkPvxd8Q&oh=00_AfnyewCmn56soglXKnBBQ5L7BcrOauWfEtzE8DJFCH6pRw&oe=696128D7)
+
+## Como verificar as permissões concedidas
+
+Use o ponto de extremidade **debug\_token** para ver quais permissões foram concedidas ao seu app pelo detentor do token. Como alternativa, use a ferramenta [depurador de token de acesso](/tools/debug/accesstoken/), que retorna as mesmas informações.
+
+### Sintaxe da solicitação
+
+```
+curl 'https://graph.facebook.com/<API_VERSION>/debug_token?input_token=<ACCESS_TOKEN_TO_CHECK>' \
+-H 'Authorization: Bearer <ACCESS_TOKEN>'
+```
+
+### Sintaxe da resposta
+
+As permissões concedidas são atribuídas à propriedade `scopes`.
+
+```
+{    "data": {        "app_id": "634974688087057",        "type": "SYSTEM_USER",        "application": "Lucky Shrub",        "data_access_expires_at": 0,        "expires_at": 0,        "is_valid": true,        "issued_at": 1712099387,        "scopes": [            "whatsapp_business_management",            "whatsapp_business_messaging"        ],        "granular_scopes": [            {                "scope": "whatsapp_business_management"            },            {                "scope": "whatsapp_business_messaging"            }        ],        "user_id": "104169029247128"    }}
+```
+
+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/referencia/AGENTS.md

@@ -0,0 +1,92 @@
+# Referência da API
+
+Documentação completa de todos os endpoints da WhatsApp Business API.
+
+## Visão Geral
+
+Esta seção contém a referência técnica completa de todos os endpoints disponíveis, organizados por funcionalidade.
+
+## Endpoints Principais
+
+### Autenticação e Configuração
+- **Tokens de Acesso**: Ver [Solução do WhatsApp Business > Access Token API](./solucao_do_whatsapp_business/access_token_api.md)
+
+### Mensagens
+- **Enviar Mensagem**: `POST /v23.0/{PHONE_NUMBER_ID}/messages`
+  - Ver [Telefone do WhatsApp Business > Message API](./telefone_do_whatsapp_business/message_api.md)
+
+### Mídia
+- **Upload**: `POST /v23.0/{PHONE_NUMBER_ID}/media`
+  - Ver [Telefone do WhatsApp Business > Media Upload API](./telefone_do_whatsapp_business/media_upload_api.md)
+- **Download**: `GET /v23.0/{MEDIA_ID}`
+  - Ver [Mídias > Media Download API](./midias/media_download_api.md)
+
+### Gerenciamento de Conta
+- **Listar Contas**: Ver [Business > WhatsApp Business Accounts API](./business/whatsapp_business_accounts_api.md)
+- **Obter Conta**: Ver [Conta do WhatsApp Business > WhatsApp Business Account API](./conta_do_whatsapp_business/whatsapp_business_account_api.md)
+
+### Gerenciamento de Números
+- **Listar Números**: Ver [Telefone do WhatsApp Business > Phone Number API](./telefone_do_whatsapp_business/phone_number_api.md)
+- **Registrar Número**: Ver [Telefone do WhatsApp Business > Register API](./telefone_do_whatsapp_business/register_api.md)
+
+### Templates
+- **Listar Templates**: Ver [Conta do WhatsApp Business > Template API](./conta_do_whatsapp_business/template_api.md)
+
+## Base URL
+
+Todas as requisições devem ser feitas para:
+```
+https://graph.facebook.com/v23.0
+```
+
+## Autenticação
+
+Todas as requisições requerem um token de acesso:
+```
+Authorization: Bearer {ACCESS_TOKEN}
+```
+
+## Versão da API
+
+A versão atual documentada é **v23.0**. Verifique sempre a versão mais recente disponível.
+
+## Subpastas
+
+- [Inscrição](./inscricao/) - APIs relacionadas à inscrição e criação de apps
+- [Business](./business/) - APIs de gerenciamento de negócios
+- [Conta do WhatsApp Business](./conta_do_whatsapp_business/) - APIs da conta principal
+- [Telefone do WhatsApp Business](./telefone_do_whatsapp_business/) - APIs de gerenciamento de números
+- [Mídias](./midias/) - APIs de upload e download de mídia
+- [Grupo](./grupo/) - APIs de gerenciamento de grupos
+- [Webhooks](./webhooks/) - Referência de webhooks
+- [Usuário](./usuario/) - APIs relacionadas a usuários
+- [Histórico de Mensagens](./historico_de_mensagens/) - APIs de histórico
+
+## Recursos Adicionais
+
+- **Postman Collection**: Coleção oficial do Postman disponível no Meta Developer Portal
+- **Graph API Explorer**: Ferramenta interativa para testar endpoints
+- **Rate Limits**: Ver documentação de limites em [Mensagens > Limites](../mensagens/limites_de_mensagens/)
+
+## Documentos Disponíveis
+
+- [Changelog](./changelog.md)
+
+## Subpastas
+
+- [Bot do WhatsApp Business](./bot_do_whatsapp_business/)
+- [Business](./business/)
+- [Conta do WhatsApp Business](./conta_do_whatsapp_business/)
+- [Grupo](./grupo/)
+- [Histórico de Mensagens](./historico_de_mensagens/)
+- [Inscrição](./inscricao/)
+- [Intenção de Migração da Conta do WhatsApp Business](./intencao_de_migracao_da_conta_do_whatsapp_business/)
+- [Mídias](./midias/)
+- [Número da Conta do WhatsApp](./numero_da_conta_do_whatsapp/)
+- [Perfil do WhatsApp Business](./perfil_do_whatsapp_business/)
+- [Solução do WhatsApp Business](./solucao_do_whatsapp_business/)
+- [Telefone do WhatsApp Business](./telefone_do_whatsapp_business/)
+- [Telefone Pré-Verificado do WhatsApp Business](./telefone_pre_verificado_do_whatsapp_business/)
+- [Usuário](./usuario/)
+- [Webhooks](./webhooks/)
+

package/docs/referencia/bot_do_whatsapp_business/AGENTS.md

@@ -0,0 +1,8 @@
+# Bot do WhatsApp Business
+
+API do bot do WhatsApp Business
+
+## Documentos Disponíveis
+
+- [Bot Details Api](./bot_details_api.md)
+