whatsapp-docs-mcp 1.0.0

package/docs/dados_privacidade_e_politica/identity_change.md

@@ -0,0 +1,34 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/identity-change -->
+<!-- Scraped: 2025-12-20T17:55:24.629Z -->
+
+# Alteração de identidade
+
+Updated: 24 de out de 2025
+
+Talvez a empresa queira comunicar informações privadas a um cliente pelo WhatsApp. Para fazer isso com segurança, primeiro ela precisa ter certeza de que está se comunicando com a pessoa certa por meio da autenticação (esse processo é feito fora do WhatsApp no momento).
+
+Uma vez estabelecida a confiança entre uma empresa e uma conta do WhatsApp, a empresa não sabe quando há alteração da pessoa com acesso à conta do WhatsApp.
+
+As empresas que usam a Plataforma do WhatsApp Business podem optar por serem notificadas quando houver uma provável atualização na identidade de um cliente. Isso oferece às empresas um sinal de que a pessoa por trás da conta pode ter mudado.
+
+Nesse caso, a boa prática seria interromper a confiança e autenticar o usuário novamente para restabelecer a confiança antes de continuar a enviar informações pessoais.
+
+Se uma empresa optar por esse recurso, ela será informada quando receber mensagens de usuários cuja propriedade da conta pode ter sido alterada. Nesse caso, a empresa será impedida de enviar mensagens para tais usuários até confirmar que isso é seguro. Esse procedimento protege a empresa e os clientes dela contra o vazamento de informações sensíveis.
+
+## Gatilho
+
+O gatilho para notificar uma empresa é a alteração da identidade de uma conta do WhatsApp.
+
+Quando recebe esse sinal, a empresa pode invocar um fluxo de reautenticação para garantir que as informações pessoais sejam sempre trocadas de maneira segura.
+
+## Fluxo de trabalho recomendado
+
+-   A empresa aceita receber notificações quando o WhatsApp identifica que uma conta com quem a empresa está se comunicando está potencialmente sob o controle de outra pessoa.-   Quando o WhatsApp detecta uma possível mudança na identidade criptográfica do usuário, ele envia uma notificação à empresa.-   A empresa interrompe a confiança com o usuário (por exemplo, desvinculando o WhatsApp como canal confiável no CRM).-   A empresa inicia o fluxo de trabalho de reautenticação (normalmente feito fora do WhatsApp).-   A empresa confirma o recebimento da notificação e continua se comunicando com a conta quando julga ser seguro fazer isso (normalmente após uma autenticação bem-sucedida).
+
+Todas as mensagens para o usuário serão bloqueadas até que a empresa confirme o recebimento da notificação que sinaliza possível mudança da pessoa que controla a conta do WhatsApp. Como é responsabilidade da empresa estabelecer a confiança com o usuário antes de compartilhar informações sensíveis, recomendamos que ela reautentique o usuário (fora do WhatsApp) antes de confirmar a notificação, o que permitiria que a empresa e o usuário continuassem trocando informações pessoais no WhatsApp. O reconhecimento da notificação _não_ implica que o usuário seja "de confiança".
+
+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/dados_privacidade_e_politica/local_storage.md

@@ -0,0 +1,277 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/local-storage -->
+<!-- Scraped: 2025-12-20T17:55:01.079Z -->
+
+# Armazenamento local
+
+Updated: 21 de out de 2025
+
+Com o recurso Armazenamento Local, você tem uma camada adicional de controle no gerenciamento de dados e pode especificar onde os dados das suas mensagens são armazenados em repouso. Caso sua empresa seja de um setor regulamentado (como finanças, organizações governamentais ou serviços de saúde), talvez você prefira que os dados em repouso das mensagens sejam armazenados em um país específico devido às políticas regulatórias ou da empresa.
+
+## Como funciona o armazenamento local
+
+O armazenamento local é controlado por uma configuração habilitada ou desabilitada no nível do número de telefone comercial do WhatsApp. Tanto a API de Nuvem quanto a API de MM Lite são compatíveis com o armazenamento local. A configuração será aplicada a qualquer mensagem enviada por meio dessas APIs, se o armazenamento estiver habilitado.
+
+Quando o armazenamento local está habilitado, as seguintes restrições são aplicadas ao conteúdo de mensagens para um número de telefone comercial:
+
+-   **Dados em uso:** quando o conteúdo da mensagem é enviado ou recebido pela API de Nuvem ou pela API de MM Lite, ele pode ser armazenado nos data centers da Meta em todo o mundo durante o processamento.-   **Dados em repouso:** após o período de dados em uso, o conteúdo da mensagem é excluído dos data centers da Meta fora da região de armazenamento local especificada e persiste apenas nos data centers dentro da região de armazenamento local selecionada. O período de dados em uso é diferente para a API de Nuvem e a API de MM Lite, conforme especificado abaixo:
+    -   Ao usar o armazenamento local na API de Nuvem, o período de dados em uso é de até 60 minutos.-   Ao usar o armazenamento local na API de MM Lite, o período de dados em uso é de até 90 minutos.
+
+O armazenamento local complementa outros [controles de privacidade e segurança da Plataforma do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Ftrust-and-safety%3Ffbclid%3DIwZXh0bgNhZW0CMTEAYnJpZBExNkRZWTlJbDFSMDBUVlRLZwEe2Qq3X5Y-XnlgB832KjRawCRQOBQGgvzV0IgHxrk5kplGc2LAfA7cvutA9ms_aem_HXrl5zwbIRR1MUiy5tf6Cw&h=AT3UHqLwYU7Bb-85xI2Dn-oTHoESdchy9on_IJHUZQ0uMM-cfAnEQKDGbd1L_ao2QGEk9P27-17YpYYjERTwECJ8QSWxw6DeaOIWhJyblTChWN1teIo2QqHpzUZFtuBrlFEGu5gz5J4) e permite que os clientes garantam a conformidade com regulamentos locais de proteção de dados.
+
+## Dados em escopo
+
+O armazenamento local se aplica ao conteúdo de mensagens (texto e mídia) enviadas e/ou recebidas por meio da API de Nuvem e da API de MM Lite. Os seguintes conteúdos de mensagem estão no escopo do recurso de armazenamento local:
+
+-   Mensagens de texto: carga de texto (corpo da mensagem)-   Mensagens de mídia: carga de mídia (áudio, documento, imagem ou vídeo)-   Mensagens de modelo (modelo estático + parâmetros passados na hora de envio da mensagem): componentes com carga de texto/mídia
+
+Além disso, um conjunto limitado de atributos de metadados é incluído no conteúdo da mensagem armazenado localmente. Assim, é possível associar a carga da mensagem criptografada à mensagem originalmente processada e auditar a localização. Os metadados armazenados são protegidos com tokens e criptografia.
+
+## Regiões disponíveis
+
+Para ver quais regiões são compatíveis com o armazenamento local, confira o parâmetro `data_localization_region` na [documentação sobre registro de número de telefone](/documentation/business-messaging/whatsapp/business-phone-numbers/registration#register).
+
+## Limitações
+
+-   Os arquivos de mídia enviados por um número de telefone comercial com armazenamento local habilitado só poderão ser acessados ​​por esse número de telefone específico e não poderão ser compartilhados com outros números associados à empresa.
+
+## Como habilitar o Armazenamento Local
+
+Siga as etapas abaixo para habilitar o Armazenamento Local em um número de telefone comercial não registrado usando a versão 21.0 ou mais recente da API. Se estiver usando uma versão mais antiga da API, consulte [Como habilitar o Armazenamento Local (v20 e versões anteriores)](/documentation/business-messaging/whatsapp/local-storage#enabling-local-storage--v20-and-older-).
+
+### Etapa 1: habilitar o Armazenamento Local no número de telefone
+
+O recurso de Armazenamento Local só poderá ser habilitado ou desabilitado em números de telefone comerciais do WhatsApp que estiverem em um estado não registrado. Caso o número de telefone esteja registrado, será preciso cancelar o registro e registrá-lo novamente com o armazenamento local habilitado.
+
+Use o ponto de extremidade [**POST /<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>/settings**](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/settings-api#Updating) para habilitar o armazenamento local no número de telefone comercial não registrado:
+
+#### Sintaxe da solicitação
+
+```
+POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/settings
+
+{
+  "storage_configuration": {
+    "status": "IN_COUNTRY_STORAGE_ENABLED",
+    "data_localization_region": "<COUNTRY_CODE>"
+  }
+}
+```
+
+Defina `<COUNTRY_CODE>` como o [country code](#available-regions) do local onde os dados em repouso devem ser armazenados.
+
+#### Sintaxe da resposta
+
+```
+{
+  "success": <SUCCESS>
+}
+```
+
+Em caso de sucesso, `<SUCCESS>` será definido como `true`.
+
+#### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v24.0/106540352242922/settings' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer EAAJB...' \
+-d '
+{
+  "storage_configuration": {
+    "status": "IN_COUNTRY_STORAGE_ENABLED",
+    "data_localization_region": "BR"
+  }
+}'
+```
+
+#### Exemplo de resposta
+
+```
+{  "success": true}
+```
+
+### Etapa 2: registrar o número de telefone
+
+Use o ponto de extremidade [**POST /<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>/register**](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/register-api#Creating) para registrar o número de telefone comercial.
+
+#### Sintaxe da solicitação
+
+```
+POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/register
+
+{
+  "messaging_product": "whatsapp",
+  "pin": "<TWO_STEP_PIN>"
+}
+```
+
+Defina `<TWO_STEP_PIN>` como o PIN de verificação em duas etapas desejado para o número de telefone comercial.
+
+#### Sintaxe da resposta
+
+```
+{
+  "success": <SUCCESS>
+}
+```
+
+Em caso de sucesso, `<SUCCESS>` será definido como `true`.
+
+#### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v21.0/v24.0/register' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer EAAJB...' \
+-d '
+{
+  "messaging_product": "whatsapp",
+  "pin": "123456"
+}'
+```
+
+#### Exemplo de resposta
+
+```
+{  "success": true}
+```
+
+## Como obter as configurações do armazenamento local
+
+Use o ponto de extremidade [**GET /<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>/settings**](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/settings-api#Reading) para ver as configurações de armazenamento local em um número de telefone do WhatsApp Business. Por exemplo:
+
+```
+curl 'https://graph.facebook.com/v24.0/179776755229976/settings' \
+-H 'Authorization: Bearer EAAJB...'
+```
+
+Isso retornará um [nó que representa as configurações de armazenamento local](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/settings-api) no número de telefone comercial. Por exemplo:
+
+```
+{  "storage_configuration": {    "status": "IN_COUNTRY_STORAGE_ENABLED",    "data_localization_region": "BR"  }}
+```
+
+## Como desabilitar o Armazenamento Local
+
+Use o ponto de extremidade [**POST /<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>/settings**](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/settings-api#Updating) para desabilitar o armazenamento local em um número de telefone comercial não registrado com a versão 21.0 ou mais recente da API. Se estiver usando uma versão mais antiga da API, consulte [Como desabilitar o Armazenamento Local (v20 e versões anteriores)](#disabling-local-storage--v20-and-older-).
+
+#### Sintaxe da solicitação
+
+```
+POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID/>settings
+
+{
+  "storage_configuration": {
+    "status": "IN_COUNTRY_STORAGE_DISABLED"
+  }
+}
+```
+
+Defina `<COUNTRY_CODE>` como o [country code](#available-regions) do local onde os dados em repouso devem ser armazenados.
+
+#### Sintaxe da resposta
+
+```
+{
+  "success": <SUCCESS>
+}
+```
+
+Em caso de sucesso, `<SUCCESS>` será definido como `true`.
+
+#### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v24.0/106540352242922/settings' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer EAAJB...' \
+-d '
+{
+  "storage_configuration": {
+    "status": "IN_COUNTRY_STORAGE_DISABLED"
+  }
+}'
+```
+
+#### Exemplo de resposta
+
+```
+{  "success": true}
+```
+
+## Como habilitar o Armazenamento Local (v20 e versões anteriores)
+
+Para habilitar o Armazenamento Local em um número de telefone comercial não registrado usando a v20.0 ou versões anteriores da API:
+
+### Etapa 1: consultar o status de verificação
+
+Use o ponto de extremidade [**GET /<WHATSAPP\_BUSINESS\_PHONE\_NUMBER>**](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-phone-number-api#Reading) e solicite o campo `code_verification_status`. Se o status de verificação de código for `VERIFIED`, pule para a etapa 4. Caso contrário, prossiga para a etapa 2.
+
+### Etapa 2: solicitar um código de verificação
+
+Use o ponto de extremidade [**POST /<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>/request\_code**](/documentation/business-messaging/whatsapp/reference/whatsapp-business-pre-verified-phone-number/request-verification-code-api#Creating) para solicitar um código de verificação. Em caso de sucesso, a API responderá com `true`, e um código de verificação será enviado ao número de telefone comercial por meio do método especificado no parâmetro `code_method`.
+
+Por exemplo, esta consulta solicita que um código de verificação seja enviado via SMS em inglês (localidade nos EUA).
+
+```
+curl -X POST 'https://graph.facebook.com/v20.0/110200345501442/request_code?code_method=SMS&language=en_US' \-H 'Authorization: Bearer EAAJB...'
+```
+
+Use o código na mensagem entregue na próxima etapa.
+
+### Etapa 3: verificar o número de telefone comercial
+
+Use o ponto de extremidade [**POST /<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>/verify\_code**](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/verify-code-api#Creating) para verificar o número de telefone comercial utilizando o código incluído na mensagem que você recebeu na etapa anterior.
+
+Por exemplo:
+
+```
+curl -X POST 'https://graph.facebook.com/v20.0/110200345501442/verify_code?code=123830' \-H 'Authorization: Bearer EAAJB...'
+```
+
+### Etapa 4: registrar o número de telefone comercial
+
+Use o ponto de extremidade [**POST /<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>/register**](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/register-api#Creating) para registrar o número de telefone comercial. Indique o país onde os dados em repouso devem ser armazenados usando o parâmetro `data_localization_region`.
+
+Esta solicitação habilita o Armazenamento Local em um número de telefone comercial e define o país onde os dados devem ser armazenados (por exemplo, Índia):
+
+```
+curl 'https://graph.facebook.com/v20.0/110200345501442/register' \-H 'Content-Type: application/json' \-H 'Authorization: Bearer EAAJB...' \-d '{  "messaging_product": "whatsapp",  "pin": "123456",  "data_localization_region": "IN"}'
+```
+
+## Como desabilitar o Armazenamento Local (v20 e versões anteriores)
+
+Use o ponto de extremidade [**POST /<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>/deregister**](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/phone-number-deregister-api#Creating) para desabilitar o armazenamento local em um número de telefone comercial com a versão 20.0 ou versões anteriores da API.
+
+Por exemplo:
+
+```
+curl -X POST 'https://graph.facebook.com/v24.0/110200345501442/deregister' \
+-H 'Authorization: Bearer EAAJB...'
+```
+
+Vale ressaltar que isso cancelará o registro do número de telefone comercial e impedirá o uso dele com a API de Nuvem do WhatsApp. Se quiser continuar usando o número com a API de Nuvem, mas sem o Armazenamento Local habilitado, você deverá registrá-lo novamente sem incluir o parâmetro `data_localization_region`.
+
+## Perguntas frequentes
+
+**P. Quais são os caminhos de migração para mover um número de telefone para a versão da API de Nuvem com Armazenamento Local?**
+
+Aceitamos todos os caminhos de migração para a versão da API de Nuvem com Armazenamento Local, incluindo:
+
+-   Migrar um número existente da API Local para a versão da API de Nuvem com Armazenamento Local-   Migrar um número existente da API de Nuvem para a versão com Armazenamento Local-   Habilitar um número novo na API de Nuvem com Armazenamento Local
+
+Em todos esses casos, é necessário enviar uma solicitação POST ao ponto de extremidade [/register](/documentation/business-messaging/whatsapp/business-phone-numbers/registration#register) para o número de telefone selecionado, especificando o país no qual os dados devem ser localizados em um novo parâmetro `data_localization_region`.
+
+**P. A migração traz algum risco? Haverá um período de inatividade?**
+
+Não existem riscos. Esse processo é semelhante ao da migração da API Local para a API de Nuvem. Consulte nossa [documentação para desenvolvedores neste link](/documentation/business-messaging/whatsapp/support/migrating-from-onprem-to-cloud). Normalmente, o tempo de inatividade é inferior a 5 minutos, e não é preciso verificar o número de telefone comercial novamente.
+
+**P. Há algum tempo de inatividade associado à habilitação do armazenamento local para um número de telefone comercial?**
+
+Se o número de telefone comercial já estiver registrado, será necessário excluí-lo e registrá-lo novamente com o armazenamento local habilitado. Esse processo normalmente demora menos de cinco minutos. Não é necessária uma nova verificação do número de telefone comercial durante esse processo.
+
+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/dados_privacidade_e_politica/no_storage.md

@@ -0,0 +1,132 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/no-storage -->
+<!-- Scraped: 2025-12-20T17:55:08.915Z -->
+
+# Sem armazenamento
+
+Updated: 8 de out de 2025
+
+Esse recurso está disponível apenas para parceiros selecionados que não podem usar o armazenamento local. Se o armazenamento local não for uma opção para você, é possível solicitar a opção Sem armazenamento [abrindo um tíquete no Suporte Direto](https://business.facebook.com/direct-support/) com as seguintes seleções:
+
+-   **Tópico da pergunta**: Cloud API Issues (Problemas na API de Nuvem)-   **Tipo de solicitação:** solicitação para usar a API de Nuvem sem solução de armazenamento
+
+A opção "Sem armazenamento" é uma configuração personalizada do [armazenamento local](/documentation/business-messaging/whatsapp/local-storage) da API de Nuvem, em que os dados em trânsito são armazenados por até uma hora nos data centers da Meta, e os dados não persistem em repouso (ou seja, não ficam armazenados nos data centers da Meta nem em armazenamentos da AWS no país). As mensagens de entrada/saída são armazenadas por, no máximo, uma hora nos data centers da Meta:
+
+-   As mensagens recebidas e enviadas são armazenadas por até uma hora nos data centers da Meta.-   Os blobs de mídia de entrada/saída são armazenados por, no máximo, uma hora nos data centers da Meta.-   É possível definir um TTL personalizado, de uma hora a 30 dias, ao carregar mídias para substituir o prazo de validade de uma hora (isso é especialmente útil para campanhas de marketing que reutilizam a mesma mídia)
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/559308894_1116451836859295_8169970485040161301_n.png?_nc_cat=102&ccb=1-7&_nc_sid=e280be&_nc_ohc=SIXxEE3yo54Q7kNvwEL-Nv1&_nc_oc=AdmkQLLENYR_Rj0TKN9lB8QEGXPtj0fatz215HdvfblW6SK80V13ysq6aFjBqbeQSUw&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=WIztnPPIHBJWt6wfMbE5Qw&oh=00_AfnPLwihObkfrQnzdPUWxB4FcUiKq4AHImP8lOLcp7aD5w&oe=69613815)
+
+## Habilitar a opção "Sem armazenamento"
+
+A permissão de uso desse recurso para um número de telefone comercial deve ser concedida manualmente pela Meta. É preciso fornecer uma lista de números de telefone comerciais a serem ativados. **Trabalhe com seu Gerente de Parceiros para solicitar isso.**
+
+### Sintaxe da solicitação (v21.0 ou posterior)
+
+A ativação do recurso é feita antes do registro por meio do ponto de extremidade [POST /<BUSINESS\_PHONE\_NUMBER\_ID>/settings](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/settings-api#Updating).
+
+```
+curl 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/settings' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer <ACCESS_TOKEN>' \
+-d '
+{
+  "storage_configuration": {
+    "status": "NO_STORAGE_ENABLED",
+    "retention_minutes": 60
+  }
+}'
+```
+
+No momento, apenas o valor `60` é permitido para o parâmetro `retention_minutes`, pois essa é a única duração de retenção compatível.
+
+### Sintaxe da solicitação (v20.0 ou anterior)
+
+A ativação do recurso é feita na solicitação de registro [POST /<BUSINESS\_PHONE\_NUMBER\_ID>/register](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/register-api#Creating).
+
+```
+curl 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/settings' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer <ACCESS_TOKEN>' \
+-d '
+{
+  "messaging_product": "whatsapp",
+  "pin": "123456",
+  "tier": "test",
+  "meta_store_retention_minutes": 60
+}'
+```
+
+-   No momento, apenas o valor 60 é permitido para o parâmetro meta\_store\_retention\_minutes, pois essa é a única duração de retenção compatível.-   `meta_store_retention_minutes` não pode ser usado com `data_localization_region`.
+
+## Desabilitar sem armazenamento
+
+Para desabilitar o recurso, o número de telefone comercial precisa ser excluído usando o ponto de extremidade [POST /<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>/deregister](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/phone-number-deregister-api#Creating) e depois registrado novamente sem o parâmetro `meta_store_retention_minutes`.
+
+### Exemplo de sintaxe de cancelamento do registro
+
+```
+curl -X POST 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/deregister' \
+-H 'Authorization: Bearer <ACCESS_TOKEN>'
+```
+
+## Como substituir o TTL de mídia de saída
+
+Para números de telefone comercial com a opção "Sem armazenamento" habilitada, o TTL padrão de 1 hora também se aplicará à [mídia carregada no número](/documentation/business-messaging/whatsapp/business-phone-numbers/media#upload-media). . Se quiser substituir o TTL padrão de uma hora, inclua o novo parâmetro `ttl_minutes` ao carregar mídias.
+
+### Exemplo de sintaxe
+
+```
+curl 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/media' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer <ACCESS_TOKEN>' \
+-d '
+{
+  "messaging_product": "whatsapp",
+  "file": "file=<FILE_NAME>;type=<FILE_MIME_TYPE>",
+  "ttl_minutes": "120"
+}'
+```
+
+-   O intervalo `ttl_minutes` é de uma hora (`60`) a 30 dias (`43200`).-   No momento, a API não retorna a data de validade da mídia na resposta.
+
+## Webhooks de erro
+
+### Falhas de confirmação de nova tentativa
+
+No caso de falhas de descriptografia no lado do consumidor, as contas de Retenção Limitada não poderão honrar solicitações de novas tentativas se isso acontecer após o TTL de uma hora da mensagem.
+
+Nesses casos, um webhook de [status de mensagens](/documentation/business-messaging/whatsapp/webhooks/reference/messages/status) é disparado com o código de erro `131036`:
+
+#### Exemplo de carga
+
+```
+{  "object": "whatsapp_business_account",  "entry": [{    "id": "102290129340398",    "changes": [{      "field": "messages",      "value": {        "messaging_product": "whatsapp",        "metadata": {          "display_phone_number": "15550783881",          "phone_number_id": "106540352242922"        },        "statuses": [{          "id": "wamid.HBgMNDQ3ODI1MDYzOTQxFQIAERgSN0MzMTg0Nzk2RkMwOEQ5NTQ2AA==",          "status": "failed",          "timestamp": "1712597457",          "recipient_id": "16505551234",          "errors": [{              "code": 131036,              "title": "Message failed to be delivered on at least one of the user's device",              "message": "Message failed to be delivered on at least one of the user's device",              "error_data": {                "details": "Message payload not found"              }            }]        }]      }    }]  }]}
+```
+
+Observações:
+
+-   Esse erro só será enviado se não conseguirmos honrar uma confirmação de nova tentativa enviada pelo dispositivo principal. Se a nova tentativa falhar para um dispositivo secundário, nós o ignoraremos, já que a mensagem será entregue ao sincronizar com o dispositivo principal.-   É possível que a mensagem tenha sido entregue em dispositivos secundários, mas não no dispositivo principal. Nesse caso, o webhook será enviado.
+
+### Falha na entrega de webhooks
+
+Por padrão, a API de Nuvem tenta entregar webhooks (por exemplo, mensagem recebida) por até sete dias. Para contas de retenção limitada, se não conseguirmos entregar o webhook, descartaremos o conteúdo e o substituiremos por uma mensagem de erro informando que não foi possível entregar o webhook.
+
+Nesses casos, um webhook de [mensagens de erro](/documentation/business-messaging/whatsapp/webhooks/reference/messages/errors) é disparado com o código de erro `131035`:
+
+```
+{  "object": "whatsapp_business_account",  "entry": [{    "id": "102290129340398",    "changes": [{      "field": "messages",      "value": {        "messaging_product": "whatsapp",        "metadata": {          "display_phone_number": "15550783881",          "phone_number_id": "106540352242922"        },        "errors": [{            "code": 131035,            "title": "Webhook could not be delivered within data retention limit",            "message": "Webhook could not be delivered within data retention limit",            "error_data": {              "details": "Webhook could not be delivered within data retention limit"            }          }]      }    }]  }]}
+```
+
+## Limites
+
+Quando o recurso de armazenamento desabilitado está habilitado, o conteúdo das mensagens não é armazenado em repouso por 30 dias, como é o caso com a API de Nuvem. Isso traz as seguintes limitações:
+
+-   **Falhas de descriptografia de mensagens**
+    -   Caso uma mensagem falhe em descriptografar do lado do consumidor, a Cloud API só pode tentar enviar novamente a mensagem dentro de uma janela de TTL (tempo de validade) de uma hora.-   Após o período de uma hora, a API de Nuvem não poderá tentar entregar a mensagem novamente. Nesse caso, você receberá um webhook de erro indicando a falha.-   Consulte: [Falhas de confirmação de nova tentativa](#retry-receipt-failures)-   **Falhas na entrega de webhooks**
+    -   Normalmente, a API de Nuvem tenta novamente enviar webhooks não entregues (como mensagens recebidas ou recibos) por até sete dias.-   Se essa opção não estiver habilitada, as novas tentativas de envio de webhooks serão limitadas a uma hora. Se o servidor de webhook ficar indisponível por mais tempo, o webhook (incluindo mensagens recebidas, recibos etc) será perdido permanentemente.-   Consulte: [Falha na entrega de webhooks](#failure-to-deliver-webhooks)-   **Mensagens de mídia recebidas**
+    -   A mídia anexada às mensagens recebidas ficará disponível para baixar por até uma hora.-   Depois de uma hora, a mídia será excluída permanentemente e não poderá ser recuperada.
+
+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/dados_privacidade_e_politica/policy_enforcement.md

@@ -0,0 +1,85 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/policy-enforcement -->
+<!-- Scraped: 2025-12-20T17:54:21.531Z -->
+
+# Política da Plataforma do WhatsApp Business e monitoramento de spam
+
+Updated: 4 de nov de 2025
+
+Para manter a alta qualidade das experiências em escala na Plataforma do WhatsApp Business, o WhatsApp monitorará as contas que violarem repetidamente 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=AT2e9RzN0cBw8mHTmL4QIIzikpOxbtsgmS-MBvVZuoQ6NgNz1P44GTwJszztO9LXZ8UEmLar_wWHgy6FjnsPUo-48-ykKc-AwREmTt6P6OXP654zLi3pwdk_G2BmP-_YUTbAlmvFDt1E0ENxi_Km5_cQza8), a [Política Comercial do WhatsApp](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.whatsapp.com%2Flegal%2Fcommerce-policy%2F&h=AT2e9RzN0cBw8mHTmL4QIIzikpOxbtsgmS-MBvVZuoQ6NgNz1P44GTwJszztO9LXZ8UEmLar_wWHgy6FjnsPUo-48-ykKc-AwREmTt6P6OXP654zLi3pwdk_G2BmP-_YUTbAlmvFDt1E0ENxi_Km5_cQza8) ou os [Termos de Serviço do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.whatsapp.com%2Flegal%2Fbusiness-terms&h=AT2e9RzN0cBw8mHTmL4QIIzikpOxbtsgmS-MBvVZuoQ6NgNz1P44GTwJszztO9LXZ8UEmLar_wWHgy6FjnsPUo-48-ykKc-AwREmTt6P6OXP654zLi3pwdk_G2BmP-_YUTbAlmvFDt1E0ENxi_Km5_cQza8).
+
+Elaboramos este guia para orientar as empresas sobre como esse sistema de monitoramento funciona e apresentar a experiência de produto.
+
+Este documento não inclui informações sobre [limites de mensagens](/documentation/business-messaging/whatsapp/messaging-limits) com base na classificação de qualidade.
+
+## Como funciona
+
+Inicialmente, as contas do WhatsApp Business receberão um aviso com informações sobre a política que foi violada.
+
+Se as contas comerciais seguirem violando os [Termos de Serviço do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.whatsapp.com%2Flegal%2Fbusiness-terms&h=AT2e9RzN0cBw8mHTmL4QIIzikpOxbtsgmS-MBvVZuoQ6NgNz1P44GTwJszztO9LXZ8UEmLar_wWHgy6FjnsPUo-48-ykKc-AwREmTt6P6OXP654zLi3pwdk_G2BmP-_YUTbAlmvFDt1E0ENxi_Km5_cQza8), como envio de spam, classificações incorretas de modelos ou categorias de políticas de alto risco (como conteúdo adulto, venda de álcool e tabaco, drogas, jogos de azar e suplementos perigosos), poderemos aplicar restrições de mensagens que aumentam gradualmente em duração.
+
+As restrições incluem o seguinte:
+
+-   Bloqueio de 1 ou 3 dias no envio de mensagens de modelo de marketing, utilidade e autenticação, bem como na adição de outros números de telefone à conta-   Bloqueio de 5, 7 ou 30 dias no envio de mensagens e na adição de outros números de telefone à conta-   Bloqueio de conta indefinido no envio de mensagens, que só poderá ser removido via apelação-   Desabilitação permanente na Plataforma do WhatsApp Business caso a empresa não faça alterações após receber vários avisos e sofrer limitação de recursos ou bloqueios
+
+Em alguns casos, quando houver evidências de uma violação da política que cause danos graves aos nossos usuários, como exploração infantil, golpes, terrorismo ou venda de drogas ilícitas, o WhatsApp desabilitará a conta comercial imediatamente.
+
+Também poderemos limitar ou remover a empresa do WhatsApp caso sua conta receba um alto volume de feedback negativo dos usuários.
+
+É possível fazer uma apelação ou reconhecer as violações, com base no respectivo tipo e qualificação.
+
+## Experiência de produto
+
+Oferecemos uma experiência de produto abrangente para que empresas e parceiros de soluções possam acessar informações transparentes, detalhadas e implementáveis sobre violações em diversos canais.
+
+### Página inicial do Suporte para Empresas
+
+Quando uma conta comercial viola uma política, os detalhes adicionais da violação ficam disponíveis na seção [Página inicial do Suporte para Empresas](https://business.facebook.com/business-support-home) do Meta Business Suite ou do Gerenciador de Negócios.
+
+Para acessar a **Página inicial do Suporte para Empresas** no Meta Business Suite:
+
+-   Entre no [Meta Business Suite](https://business.facebook.com).-   Clique em **Todas as ferramentas** no menu à esquerda. Depois, clique em **Página inicial do Suporte para Empresas**.-   Clique em **Visão geral da conta** (ícone de velocímetro) no menu à esquerda, se necessário.
+
+Para acessar a **Página inicial do Suporte para Empresas** no Gerenciador de Negócios:
+
+-   Entre no [Gerenciador de Negócios](https://business.facebook.com).-   Clique no ícone **Todas as ferramentas** (três linhas horizontais) no topo da página. Depois, clique em **Página inicial do Suporte para Empresas**.-   Clique em **Visão geral da conta** (ícone de velocímetro) no menu à esquerda, se necessário.
+
+### Como interpretar as violações
+
+As atualizações de violação incluem estas informações:
+
+-   Resumo da política violada e um link para os termos em questão-   Exemplos de conteúdo permitido ou não permitido com base nessa política-   Informações sobre restrições ativas na conta e o que acontece se a violação ocorrer novamente-   Orientações para evitar futuras violações da política e links para recursos úteis-   Explicações sobre como fazer uma apelação
+
+As notificações sobre violações também são:
+
+-   exibidas na **Central de notificações do Gerenciador de Negócios** e como um banner no **Gerenciador do WhatsApp**;-   enviadas como um email a todos os administradores configurados no **Gerenciador de Negócios**;
+    -   Para garantir a entrega adequada das notificações, verifique se as informações do administrador exibidas no Gerenciador de Negócios estão corretas e atualizadas.-   enviadas como [notificações de webhooks](#webhooks) a quem tiver assinado.
+
+### Ações de monitoramento
+
+Dependendo do número e da gravidade dos problemas, as contas podem ser restritas ou desabilitadas. É possível ver os detalhes de cada restrição na [Página inicial do Suporte para Empresas](#business-support-home), além de informações sobre as próximas etapas e como solicitar a análise de um problema de política específico.
+
+Mesmo as contas restritas ou desabilitadas poderão fazer uma apelação ou o reconhecimento de um problema. Se os problemas forem revertidos após a apelação ou reconhecimento, a conta retornará ao status anterior.
+
+## Webhooks
+
+Faça a integração com webhooks para receber notificações instantâneas sobre alterações em uma conta do WhatsApp Business (WABA, pelas iniciais em inglês). Assine o webhook [account\_update](/documentation/business-messaging/whatsapp/webhooks/reference/account_update) para receber notificações em tempo real sempre que uma conta comercial violar uma política e para saber o tipo e a duração da restrição de mensagens quando aplicável. Dessa forma, as empresas podem ajustar rapidamente o comportamento para evitar o recebimento de outros avisos e/ou ações de monitoramento.
+
+## Apelações
+
+Caso uma empresa acredite que está em conformidade com as políticas do WhatsApp, será possível fazer uma apelação da violação solicitando uma análise. Quando uma empresa recebe uma notificação de violação e faz uma apelação, a equipe do WhatsApp a analisa em relação à política de violações para decidir se a apelação deverá ser reconsiderada. Após a análise, a violação poderá ser revertida.
+
+**Observação:** nem sempre é possível fazer uma apelação para uma violação de spam. As empresas podem ter que esperar até o período de restrição terminar para começar a enviar mensagens novamente.
+
+Veja como solicitar a análise de uma decisão:
+
+-   Na **Página inicial do Suporte para Empresas**, clique na conta do WhatsApp Business em questão.-   Escolha uma opção na lista de violações e clique em **Solicitar análise**.-   Um novo diálogo será aberto no Gerenciador de Negócios. Insira os detalhes da solicitação e clique em **Enviar**.-   Após o envio, a solicitação e o problema serão movidos para a aba **Em análise**.-   A decisão referente à apelação será enviada pelo Gerenciador de Negócios. Normalmente, isso ocorre dentro de 24 a 48 horas. O problema analisado permanecerá **Sem alteração** ou será definido como **Revertido**.
+
+## Como evitar violações no futuro
+
+-   Leia a [Política Comercial do WhatsApp](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.whatsapp.com%2Flegal%2Fcommerce-policy%2F&h=AT2e9RzN0cBw8mHTmL4QIIzikpOxbtsgmS-MBvVZuoQ6NgNz1P44GTwJszztO9LXZ8UEmLar_wWHgy6FjnsPUo-48-ykKc-AwREmTt6P6OXP654zLi3pwdk_G2BmP-_YUTbAlmvFDt1E0ENxi_Km5_cQza8) e a [Política do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.whatsapp.com%2Flegal%2Fbusiness-policy%2F&h=AT2e9RzN0cBw8mHTmL4QIIzikpOxbtsgmS-MBvVZuoQ6NgNz1P44GTwJszztO9LXZ8UEmLar_wWHgy6FjnsPUo-48-ykKc-AwREmTt6P6OXP654zLi3pwdk_G2BmP-_YUTbAlmvFDt1E0ENxi_Km5_cQza8). Para obter respostas para as perguntas frequentes sobre essas políticas, consulte [este artigo](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2Fgeneral%2Fwhatsapp-business-api%2Fhow-to-comply-with-the-whatsapp-business-and-commerce-policies&h=AT2e9RzN0cBw8mHTmL4QIIzikpOxbtsgmS-MBvVZuoQ6NgNz1P44GTwJszztO9LXZ8UEmLar_wWHgy6FjnsPUo-48-ykKc-AwREmTt6P6OXP654zLi3pwdk_G2BmP-_YUTbAlmvFDt1E0ENxi_Km5_cQza8).-   [Assine o webhook account\_update](/documentation/business-messaging/whatsapp/webhooks/reference/account_update) para receber notificações em tempo real sempre que uma conta comercial violar uma política e para saber o tipo e a duração da restrição de mensagens quando aplicável.-   Ajuste o comportamento na plataforma o quanto antes para evitar o recebimento de outros avisos e/ou ações de monitoramento.-   Leia as boas práticas para enviar mensagens de alta qualidade no WhatsApp definidas na [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=AT2e9RzN0cBw8mHTmL4QIIzikpOxbtsgmS-MBvVZuoQ6NgNz1P44GTwJszztO9LXZ8UEmLar_wWHgy6FjnsPUo-48-ykKc-AwREmTt6P6OXP654zLi3pwdk_G2BmP-_YUTbAlmvFDt1E0ENxi_Km5_cQza8).
+
+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)