whatsapp-docs-mcp 1.0.5 → 1.0.7

package/docs/mensagens_de_marketing/onboarding.md

@@ -0,0 +1,282 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/onboarding -->
+<!-- Scraped: 2026-01-24T00:37:44.220Z -->
+
+# Integração
+
+Updated: 10 de dez de 2025
+
+A API de Mensagens de Marketing para o WhatsApp (anteriormente conhecida como API de Mensagens de Marketing Lite) agora está disponível para todos.
+
+A integração com a API de Mensagens de Marketing para o WhatsApp (API de MM para o WhatsApp) é uma atualização de baixo esforço para o envio de mensagens de marketing com otimizações na API de Nuvem. Confira as instruções abaixo para integrar sua empresa, seja diretamente com a API ou usando um parceiro.
+
+Quando uma empresa se cadastra na API de MM para o WhatsApp, contas de anúncios somente para leitura são criadas e vinculadas a cada um dos modelos de marketing associados ao portfólio empresarial.
+
+Veja o que as empresas podem fazer com essas contas vinculadas:
+
+-   Buscar insights da API de MM para o WhatsApp por meio da "API de Insights" da API de Marketing para análise
+
+Essas contas de anúncios somente leitura ficam sincronizadas para que qualquer alteração nos modelos de marketing seja refletida na entidade de anúncio vinculada.
+
+Siga as etapas abaixo para integrar a API de MM para o WhatsApp.
+
+## Requisitos de qualificação
+
+Para usar a API de Mensagens de Marketing para o WhatsApp (API de MM para o WhatsApp), a empresa precisa cumprir as restrições legais, setoriais e de conteúdo aplicáveis (que variam de acordo com o país), conforme descrito nas [Políticas de Mensagens do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fpolicy&h=AT3R2yIDRQ5FhkYT0IZq_hcT6L15PVOkgTpNAstd-b0_AJZmto9pPl3CX7FD3UYL6pq5DIVNy-dQ_FCIF2yUFmoG5UC_hx7IDoYgXhJYSPaay1OFI4SQF3Uyw895Ervr3eE7dvFPigt-dGINTnAaDRH_umI).
+
+Além disso, os seguintes requisitos devem ser atendidos:
+
+-   A Conta do WhatsApp Business (WABA, nas iniciais em inglês) precisa estar ativa, sem restrições de mensagens devido a violações-   O país fiscal da WABA não está em regiões sancionadas-   O país da empresa proprietária não pode estar em regiões sancionadas
+
+A API de MM para o WhatsApp atualizará continuamente a qualificação por vertical e as políticas para cumprir diversas normas e regulamentações internacionais. Isso significa que esses requisitos podem sofrer alterações.
+
+### Verificar o status de integração e a qualificação da WABA
+
+Use o ponto de extremidade [GET /<WHATSAPP\_BUSINESS\_ACCOUNT\_ID>](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api#fields) e peça o campo `marketing_messages_onboarding_status` para verificar o status de qualificação de uma WABA para a API de MM para o WhatsApp.
+
+Nas WABAs qualificadas, o campo é definido como `ELIGIBLE`. Um valor definido como `ONBOARDED` indica que a WABA do cliente empresarial já foi integrada. Para conferir os valores possíveis e os respectivos significados, consulte a referência [GET /<WHATSAPP\_BUSINESS\_ACCOUNT\_ID>](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api#fields).
+
+**Exemplo de solicitação**
+
+```
+curl 'https://graph.facebook.com/v24.0/25002526842541/?fields=marketing_messages_onboarding_status' \
+    -H 'Authorization: Bearer EAAAl...'
+```
+
+**Exemplo de resposta**
+
+```
+{  "marketing_messages_onboarding_status": "ELIGIBLE",  "id": "25002526842541"}
+```
+
+Também é possível usar o ponto de extremidade [GET /<BUSINESS\_PORTFOLIO\_ID>/client\_whatsapp\_business\_accounts](/docs/marketing-api/reference/business) com o filtro a seguir para gerar uma lista de todas as WABAs qualificadas que foram compartilhadas com você.
+
+**Sintaxe da solicitação**
+
+```
+GET /<BUSINESS_PORTFOLIO_ID>/client_whatsapp_business_accounts
+  ?filtering=[
+    {
+      'field':'marketing_messages_onboarding_status',
+      'operator':'IN',
+      'value':['ELIGIBLE']
+    }
+  ]
+```
+
+**Exemplo de solicitação**
+
+```
+curl -g 'https://graph.facebook.com/v24.0/19502398688333/client_whatsapp_business_accounts?filtering=[{'field':'marketing_messages_onboarding_status','operator':'IN','value':['ELIGIBLE']}]' \
+    -H 'Authorization: Bearer EAAAj...'
+```
+
+**Exemplo de resposta**
+
+```
+{  "data": [    {      "id": "46302397361990",      "name": "San Andreas Roofing",      "timezone_id": "1",      "message_template_namespace": "93d3e793_8a4f_49c4_b903_fd72aac80f71"    }  ]}
+```
+
+### Verificar o status de qualificação (opção alternativa)
+
+Este campo ficará obsoleto na versão 24.0. Recomendamos usar o campo [`marketing_messages_onboarding_status`](#check-waba-onboarding-status-and-eligibility).
+
+Você pode usar o ponto de extremidade [GET /<WHATSAPP\_BUSINESS\_ACCOUNT\_ID>](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api) e solicitar o campo [`marketing_messages_lite_api_status`](#check-waba-onboarding-status-and-eligibility) para ver o status de qualificação. No entanto, como esse campo ficará obsoleto em uma data futura, recomendamos usar o [método acima](/documentation/business-messaging/whatsapp/marketing-messages/onboarding#eligibility-requirements).
+
+```
+GET /<WHATSAPP_BUSINESS_ACCOUNT_ID>?fields=marketing_messages_lite_api_status
+```
+
+Para WABAs gerenciadas por parceiros, as empresas podem encontrar as contas qualificadas usando este ponto de extremidade:
+
+```
+GET /<BUSINESS_ID>/client_whatsapp_business_accounts?fields=marketing_messages_lite_api_status
+```
+
+Para conferir uma lista dos valores que podem ser retornados e os respectivos significados, consulte a referência [GET /<WHATSAPP\_BUSINESS\_ACCOUNT\_ID>](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api#fields).
+
+### Caso queira conferir se a empresa aceitou os Termos de Serviço e qual o status da Intenção para o Gerenciador de Negócios
+
+Use o ponto de extremidade [GET /<BUSINESS\_PORTFOLIO\_ID>/](/docs/marketing-api/reference/business) e solicite o campo `marketing_messages_onboarding_status` para verificar o status de qualificação para a API de MM para o WhatsApp.
+
+**Permissão**
+
+-   `business_management`
+
+#### Exemplo de solicitação
+
+```
+curl "https://graph.facebook.com/v24.0/52002526842524351/?fields=marketing_messages_onboarding_status" \-H 'Authorization: Bearer EAAAl...'
+```
+
+#### Exemplo de resposta
+
+```
+{  "marketing_messages_onboarding_status":   {      "status": "TERM_OF_SERVICE_SIGNED"      "time": "2025-10-07"   }}
+```
+
+Use o ponto de extremidade [GET /<WHATSAPP\_BUSINESS\_ACCOUNT\_ID>](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api#fields) e solicite o campo `owner_business_info` para verificar o status de integração da WABA.
+
+**Permissões**
+
+-   `whatsapp_business_management`-   `whatsapp_business_messaging`
+
+#### Exemplo de solicitação
+
+```
+curl GET "https://graph.facebook.com/v24.0/69843579834234?fields=owner_business_info" \-H 'Authorization: Bearer EAAAl...'
+```
+
+#### Exemplo de resposta
+
+```
+{
+  "owner_business_info": {
+    "name": "WhatsApp PaidSend Testing",
+    "id": "<BM_ID>",
+    "marketing_messages_onboarding_status": {
+     "status": "TERM_OF_SERVICE_SIGNED" | "REQUEST_SENT" | "NOT_STARTED"
+     "time": "2025-08-13"
+    }
+  },
+}
+```
+
+## Registrar um número de telefone na API de Nuvem
+
+Para enviar uma mensagem por meio da API de MM para o WhatsApp, também é preciso registrar um número de telefone comercial na API de Nuvem. A API de MM para o WhatsApp e a API de Nuvem são usadas juntas no mesmo número de telefone:
+
+-   A API de Nuvem permite que uma empresa envie modelos de autenticação, serviço, utilidade e marketing não otimizado, além de mensagens em formato livre, e receba mensagens de consumidores em um número de telefone comercial.
+    -   Com a API de MM para o WhatsApp, a empresa pode enviar mensagens de marketing com otimizações usando o mesmo número de telefone registrado na API de Nuvem.
+    
+
+Os números de telefone do WhatsApp Business que não estiverem registrados na API de Nuvem não poderão ser usados com a API de MM para o WhatsApp.
+
+Se um número de telefone comercial já estiver registrado na API de Nuvem, não será necessário verificar o telefone para usar a API de MM para o WhatsApp, já que nenhum novo número será incluído durante o processo de registro. Os números de telefone existentes continuarão registrados na API de Nuvem e agora também poderão usar a API de MM Lite, além da API de Nuvem, simultaneamente, para o envio de mensagens de marketing.
+
+## Para provedores de soluções
+
+Caso você seja um provedor de soluções integrando empresas finais, consulte [Como integrar clientes comerciais](/documentation/business-messaging/whatsapp/marketing-messages/onboard-business-customers).
+
+## Como integrar clientes comerciais
+
+Instrua seus clientes comerciais a designarem alguém com controle total do portfólio empresarial para aceitar os Termos de Serviço e integrar a API de MM para o WhatsApp via Gerenciador do WhatsApp.
+
+-   Navegue até Gerenciador do WhatsApp > Visão geral.-   Na seção Alertas, clique em Aceitar termos para começar a usar a API de Mensagens de Marketing para o WhatsApp.-   Siga as etapas para aceitar os Termos de Serviço da API de MM para o WhatsApp.
+
+Seus clientes comerciais poderão começar a enviar mensagens por meio da API de MM para o WhatsApp.
+
+Caso não consiga acessar o Gerenciador do WhatsApp, [encontre o administrador do seu portfólio empresarial neste link](/documentation/business-messaging/whatsapp/support#i-can-t-find-an-admin-user-at-my-company-to-onboard-to-mm-api-for-whatsapp).
+
+## Para clientes comerciais sem parceiro
+
+Caso sua empresa faça a integração direta com a API de Nuvem sem um parceiro, siga as instruções abaixo para aceitar os Termos de Serviço e usar a API de MM para o WhatsApp.
+
+-   Acesse **[Painel de Apps](/apps)** > **WhatsApp** > **Início rápido**.-   Na página **Início rápido** , localize o cartão “Aumente o ROI com a API de Mensagens de Marketing para o WhatsApp” e clique no botão “Começar”.-   Clique em "Continuar para o guia de integração" e aceite os Termos de Serviço
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/476020445_3647418092312679_4465719704295641193_n.png?_nc_cat=110&ccb=1-7&_nc_sid=e280be&_nc_ohc=hWuUJeCMyt4Q7kNvwG8JLgF&_nc_oc=AdmW2vMoUb_Z1KGAFv3wAC-LIzpFKRzSq3gwE3D5eBKG1bKNgz-cEp5-oJ3fhYCt1Ss&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=Op4XEqVddXCxdm6-eUGXiw&oh=00_AfpQZh1dwKKcgYGbFjO4OHhkA6IkaSAi_yJFDljBiKstzQ&oe=698E460B)
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/476114538_1636490170408141_5744881403199109308_n.png?_nc_cat=106&ccb=1-7&_nc_sid=e280be&_nc_ohc=W0rATKznZesQ7kNvwEIPeN9&_nc_oc=Adl1_5O6LOzlh6IElOkSr067ErFDOARgelYTNa0DXpjPRdJEiW8j2ePRPsBWHfz-NrY&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=Op4XEqVddXCxdm6-eUGXiw&oh=00_Afr_tzGOzR2Ah_o1qYi_cX6dV87GRe4nTMdcu0S0Vbbf8Q&oe=698E6D91)
+
+## Como compartilhar a atividade do evento
+
+Assim que a empresa for integrada, os eventos de status de mensagem (entregue, lida, clicada) serão compartilhados com a Meta automaticamente como parte da atividade do evento. A Meta não vende seus dados nem os dos assinantes. Esses dados são usados somente para otimizar o desempenho de campanhas de marketing.
+
+### Gerenciar via configurações da conta do WhatsApp
+
+É possível desabilitar o compartilhamento da atividade do evento na [configuração da conta do WhatsApp Business](https://business.facebook.com/latest/settings/whatsapp_account).
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/532666735_24223328414028742_8881901315029283677_n.png?_nc_cat=103&ccb=1-7&_nc_sid=e280be&_nc_ohc=tyEQ5sWl38UQ7kNvwHWFLVB&_nc_oc=AdkOo2S8Vfq9qvx-FOv7LFnjt97OdhmIUrxUFZagvlCr9JxfZjMpKh8DKxPheCq0SsQ&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=Op4XEqVddXCxdm6-eUGXiw&oh=00_AfpQoNqivFRyeXaHJvFyHZ7GTqbnBqrkUJGIT9tdU_uFWQ&oe=698E489C)
+
+### Configurar via API
+
+Além disso, para personalizar o compartilhamento da atividade do evento por mensagem, é possível incluir o parâmetro `<message_activity_sharing>` e defini-lo como um booliano (True/False) na carga `marketing_messages` da chamada de API. A chamada de API substitui a configuração predefinida da conta do WhatsApp Business.
+
+Use o ponto de extremidade `POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/marketing_messages` para enviar uma mensagem a um usuário do WhatsApp.
+
+### Sintaxe da solicitação
+
+```
+curl 'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/marketing_messages' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer <ACCESS_TOKEN>' \
+-d '
+{
+  "messaging_product": "whatsapp",
+  "recipient_type": "individual",
+  "to": "<WHATSAPP_USER_PHONE_NUMBER>",
+  "message_activity_sharing": "<BOOLEAN>",
+  "type": "<MESSAGE_TYPE",
+  "<MESSAGE_TYPE":"<MESSAGE_CONTENTS>"
+}
+```
+
+## Receber webhook de assinatura dos Termos de Serviço da API de MM para o WhatsApp (preferencial)
+
+Observação: o valor do evento de Termos de Serviço ficará disponível em 8 de setembro de 2025. Consulte o webhook legado abaixo.
+
+Quando os Termos de Serviço da API de MM para o WhatsApp forem assinados por uma empresa, um webhook [`account_update`](/documentation/business-messaging/whatsapp/webhooks/reference/account_update) será enviado a cada conta do WhatsApp Business associada ao seu portfólio empresarial. Esse webhook indica que a empresa da WABA aceitou os Termos de Serviço da API de MM para o WhatsApp. Quando o webhook é acionado, a WABA poderá enviar mensagens por meio da API de MM para o WhatsApp.
+
+Você pode usar a identificação do portfólio empresarial e a identificação da WABA para verificar a conformidade e enviar mensagens. Também pode acionar ações subsequentes de integração conforme necessário. Este é o webhook de preferência para acompanhar a integração e o status de qualificação da API de MM para o WhatsApp.
+
+```
+{
+  "object": "whatsapp_business_account",
+  "entry": [
+    {
+      "id": "<SOLUTION_PROVIDER_BUSINESS_ID>",
+      "time": "<WEBHOOK_TIMESTAMP>",
+      "changes": [
+        {
+          "field": "account_update",
+          "value": {
+            "event": "MM_LITE_TERMS_SIGNED",
+            "waba_info": {
+              "owner_business_id": "<BUSINESS_PORTFOLIO_ID>",
+              "waba_id": "<WABA_ID>"
+            }
+          }
+        }
+      ]
+    }
+  ]
+}
+```
+
+## Receber webhook de conclusão da integração (legado)
+
+Assim que o processo de integração for concluído e as contas de anúncios vinculadas estiverem configuradas, um webhook do tipo [`account_update`](/documentation/business-messaging/whatsapp/webhooks/reference/account_update) será enviado para cada WABA associada ao seu portfólio empresarial, indicando que a integração foi concluída com sucesso. Esse webhook contém a identificação da conta de anúncios com permissão de leitura à qual cada WABA está vinculada, para uso nas chamadas das APIs de Insights.
+
+Observação: este webhook é considerado legado na integração com a API de MM para o WhatsApp. Use o webhook de assinatura dos Termos de Serviço da API de MM para o WhatsApp.
+
+Importante: o evento de webhook `ad_account_linked` não será mais disparado, já que os parceiros não terão acesso às contas de anúncios.
+
+```
+{
+  "object": "whatsapp_business_account",
+  "entry": [
+    {
+      "id": "<WABA_ID>",
+      "time": "<WEBHOOK_TIMESTAMP>",
+      "changes": [
+        {
+          "field": "account_update",
+          "value": {
+            "event": "AD_ACCOUNT_LINKED",
+            "waba_info": {
+              "waba_id": "<WABA_ID>",
+              "ad_account_id": "<AD_ACCOUNT_ID>",
+              "owner_business_id": "<BUSINESS_PORTFOLIO_ID>"
+            }
+          }
+        }
+      ]
+    }
+  ]
+}
+```
+
+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/mensagens_de_marketing/recursos/automatic_creative_optimization.md

@@ -1,5 +1,5 @@
 <!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/automatic-creative-optimization -->
-<!-- Scraped: 2025-12-20T17:29:07.121Z -->
+<!-- Scraped: 2026-01-24T00:36:32.123Z -->
 
 ## Esta página não está disponível no momento
 

package/docs/mensagens_de_marketing/recursos/conversion_measurement.md

@@ -1,5 +1,5 @@
 <!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/conversion-measurement -->
-<!-- Scraped: 2025-12-20T17:29:13.801Z -->
+<!-- Scraped: 2026-01-24T00:36:48.491Z -->
 
 ## Esta página não está disponível no momento
 

package/docs/mensagens_de_marketing/visao_geral/overview.md

@@ -1,23 +1,25 @@
 <!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/overview -->
-<!-- Scraped: 2025-12-20T17:29:00.104Z -->
+<!-- Scraped: 2026-01-24T00:37:57.483Z -->
 
-# API de Mensagens de Marketing Lite
+# API de Mensagens de Marketing para o WhatsApp
 
-Updated: 30 de out de 2025
+Updated: 18 de nov de 2025
 
-Válido a partir de 1º de julho de 2025: os preços por mensagem já estão em vigor. Além disso, as taxas para mensagens de marketing na API de Nuvem e na API de MM Lite são consistentes, de acordo com as tabelas de tarifas publicadas [neste link](/documentation/business-messaging/whatsapp/pricing).
+A API de Mensagens de Marketing para o WhatsApp (anteriormente conhecida como API de Mensagens de Marketing Lite) agora está disponível para todos.
 
-Planejamos lançar a MM Lite para o público geral no quarto trimestre de 2025.
-
-A API de Mensagens de Marketing Lite ("API de MM Lite") é uma solução fácil de usar, desenvolvida para profissionais de marketing direto ou CRM, com o objetivo de aprimorar a experiência do cliente e gerar resultados iguais ou superiores para empresas quando comparada com o marketing feito usando a API de Nuvem.
+A API de MM para o WhatsApp é a nossa solução de marketing de última geração criada para melhorar a experiência do cliente e entregar a mensagem certa para mais pessoas.
 
 ### Principais benefícios
 
--   **A API de MM Lite entrega um número igual ou maior de mensagens de marketing do que a API de Nuvem.** A API de MM Lite oferece limites de mensagens mais dinâmicos para que as mensagens de marketing com alto engajamento (por exemplo, mensagens mais lidas) alcancem um número maior de clientes. Na Índia, as mensagens de marketing enviadas pela API de MM Lite que apresentaram maior engajamento (por exemplo, leituras) registraram até 9% mais entregas em comparação com a API de Nuvem ([1](#footnotes)).-   **A API de MM Lite tem novos [recursos](/documentation/business-messaging/whatsapp/marketing-messages/features) exclusivos que não estão disponíveis na API de Nuvem.** A API de MM Lite oferece referências de comparação exclusivas que mostram o desempenho dos seus modelos em relação a modelos semelhantes na sua região, além de recomendações sobre como melhorar as métricas de desempenho, mensagens de marketing com validade programada para promoções de curta duração, novos relatórios de conversão para mostrar conversões na web e no app e muito mais. Confira a [lista completa de recursos da API de MM Lite](/documentation/business-messaging/whatsapp/marketing-messages/features).-   **É fácil fazer a transição da API de Nuvem.** As empresas podem usar contas do WhatsApp Business, números de telefone e modelos de marketing que já existem. Os parceiros continuam com o mesmo modelo de cobrança da API de Nuvem e têm uma integração simples e sem complicações.
+-   **Impulsione e mensure os resultados comerciais**: com nossas otimizações automáticas de entrega, alcance mais pessoas que considerarão suas mensagens importantes, além de gerar mais leituras e cliques. Também é possível acessar insights de mensuração exclusivos:
+    -   _Referências de desempenho_, para entender como foi o desempenho da sua mensagem em comparação com empresas semelhantes-   _Recomendações personalizadas_, para melhorar o desempenho da campanha-   **Aprimore a experiência e o engajamento dos clientes**: a API de MM para o WhatsApp ajuda a entregar mensagens de marketing mais relevantes e em tempo hábil aos clientes com recursos exclusivos, como:
+    -   Otimizações automáticas de criativos (em testes) para aplicar tratamentos criativos, como animação de imagens e filtragem para mensagens mais envolventes.-   Formatos de mídia avançados, como GIFs.-   Tempo de vida, para evitar a entrega de mensagens irrelevantes ou atrasadas em campanhas urgentes.-   **Atualização fácil, com confiabilidade e segurança consistentes**: a API de MM para o WhatsApp é confiável, segura e fácil de usar. Essa opção oferece um esquema técnico semelhante e o mesmo modelo de cobrança da API de Nuvem. Além disso, as empresas podem usar números de telefone e modelos de mensagem de marketing existentes.
+
+Envie todo o seu tráfego de marketing ao ponto de extremidade `/marketing_messages` para fazer o roteamento automático de mensagens de empresas qualificadas.
 
 ## Notas de rodapé
 
--   \*Teste A/B realizado com aproximadamente 12 milhões de mensagens de marketing entregues, enviadas por anunciantes na Índia, entre 1º e 31 de janeiro de 2025. O teste comparou a entrega otimizada da API de MM Lite com a entrega padrão da API de Nuvem apenas entre mensagens de alto engajamento (por exemplo, mensagens com mais leituras, cliques e assim por diante). A análise consistiu em um teste t com 95% de confiança.
+-   \*Teste A/B realizado com aproximadamente 12 milhões de mensagens de marketing entregues, enviadas por anunciantes na Índia, entre 1º e 31 de janeiro de 2025. O teste comparou a entrega otimizada da API de MM para o WhatsApp com a entrega padrão da API de Nuvem apenas entre mensagens de alto engajamento (por exemplo, mensagens com mais leituras, cliques e assim por diante). A análise consistiu em um teste t com 95% de confiança.
 
 Você achou esta página útil?
 

package/docs/messaging_limits/upcoming_changes.md

@@ -1,5 +1,5 @@
 <!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits/upcoming-changes -->
-<!-- Scraped: 2025-12-21T14:44:16.116Z -->
+<!-- Scraped: 2026-01-24T00:42:07.667Z -->
 
 ## Esta página não está disponível no momento
 

package/docs/modelos/authentication_templates/bulk_management.md

@@ -0,0 +1,145 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/bulk-management -->
+<!-- Scraped: 2026-01-24T01:02:11.148Z -->
+
+# Gerenciamento em massa
+
+Updated: 10 de nov de 2025
+
+Use o ponto de extremidade [POST /<WABA\_ID>/upsert\_message\_templates](/docs/graph-api/reference/whats-app-business-account/upsert_message_templates#Creating) para atualizar ou criar modelos de autenticação em massa em vários idiomas que incluam ou excluam os avisos opcionais de segurança e de expiração.
+
+Se já houver um modelo com o nome e o idioma correspondentes, ele será atualizado com o conteúdo da solicitação. Caso contrário, um novo modelo será criado.
+
+### Sintaxe da solicitação
+
+```
+POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/upsert_message_templates
+```
+
+### Corpo da publicação
+
+```
+{
+  "name": "<NAME>",
+  "languages": [<LANGUAGES>],
+  "category": "AUTHENTICATION",
+  "components": [
+    {
+      "type": "BODY",
+      "add_security_recommendation": <ADD_SECURITY_RECOMMENDATION> // Optional
+    },
+    {
+      "type": "FOOTER",
+      "code_expiration_minutes": <CODE_EXPIRATION_MINUTES> // Optional
+    },
+    {
+      "type": "BUTTONS",
+      "buttons": [
+        {
+          "type": "OTP",
+          "otp_type": "<OTP_TYPE>",
+          "supported_apps": [
+            {
+              "package_name": "<PACKAGE_NAME>", // One-tap and zero-tap buttons only
+              "signature_hash": "<SIGNATURE_HASH>" // One-tap and zero-tap buttons only
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}
+```
+
+### Propriedades
+
+Todas as [propriedades de criação de modelos](/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates#properties) são compatíveis, exceto estas:
+
+-   A propriedade `language` é incompatível. Como alternativa, use `languages` e defina o valor como uma matriz de strings de [código de localidade e idioma](/documentation/business-messaging/whatsapp/templates/supported-languages). Por exemplo: `["en_US","es_ES","fr"]`.-   A propriedade `text` é incompatível.-   A propriedade `autofill_text` é incompatível.
+
+### Exemplo de solicitação de cópia de código
+
+Este exemplo cria três modelos de autenticação (em inglês, espanhol e francês) com botões de copiar código. Cada modelo recebe o nome de "authentication\_code\_copy\_code\_button" e inclui a recomendação de segurança e o tempo de expiração.
+
+```
+curl 'https://graph.facebook.com/v24.0/102290129340398/upsert_message_templates' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer EAAJB...' \
+-d '
+{
+  "name": "authentication_code_copy_code_button",
+  "languages": ["en_US","es_ES","fr"],
+  "category": "AUTHENTICATION",
+  "components": [
+    {
+      "type": "BODY",
+      "add_security_recommendation": true
+    },
+    {
+      "type": "FOOTER",
+      "code_expiration_minutes": 10
+    },
+    {
+      "type": "BUTTONS",
+      "buttons": [
+        {
+          "type": "OTP",
+          "otp_type": "COPY_CODE"
+        }
+      ]
+    }
+  ]
+}'
+```
+
+### Exemplo de solicitação para preenchimento automático com um toque
+
+Este exemplo (1) atualiza um modelo existente com o nome "authentication\_code\_autofill\_button" e o idioma "en\_US" e (2) cria dois novos modelos de autenticação (em espanhol e francês) com botões de preenchimento automático com um toque. Os dois modelos recém-criados recebem o nome de "authentication\_code\_autofill\_button" e incluem a recomendação de segurança e o tempo de expiração.
+
+```
+curl 'https://graph.facebook.com/v24.0/102290129340398/upsert_message_templates' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer EAAJB...' \
+-d '
+{
+  "name": "authentication_code_autofill_button",
+  "languages": ["en_US","es_ES","fr"],
+  "category": "AUTHENTICATION",
+  "components": [
+    {
+      "type": "BODY",
+      "add_security_recommendation": true
+    },
+    {
+      "type": "FOOTER",
+      "code_expiration_minutes": 15
+    },
+    {
+      "type": "BUTTONS",
+      "buttons": [
+        {
+          "type": "OTP",
+          "otp_type": "ONE_TAP",
+          "supported_apps": [
+            {
+              "package_name": "com.example.luckyshrub",
+              "signature_hash": "K8a/AINcGX7"
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}'
+```
+
+### Exemplo de resposta
+
+```
+{  "data": [    {      "id": "954638012257287",      "status": "APPROVED",      "language": "en_US"    },    {      "id": "969725527415202",      "status": "APPROVED",      "language": "es_ES"    },    {      "id": "969725530748535",      "status": "APPROVED",      "language": "fr"    }  ]}
+```
+
+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/modelos/authentication_templates/template_preview.md

@@ -0,0 +1,109 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/template-preview -->
+<!-- Scraped: 2026-01-24T01:02:33.370Z -->
+
+# Prévias do modelo
+
+Updated: 4 de nov de 2025
+
+Você pode gerar prévias do texto do modelo de autenticação em vários idiomas que incluem ou excluem as strings de recomendação de segurança e de expiração de código usando o ponto de extremidade [**GET /<WABA\_ID>/message\_template\_previews**](/docs/graph-api/reference/whats-app-business-account/message_template_previews#Reading).
+
+### Sintaxe da solicitação
+
+```
+GET /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_template_previews
+  ?category=AUTHENTICATION,
+  &language=<LANGUAGE>, // Optional
+  &add_security_recommendation=<ADD_SECURITY_RECOMMENDATION>, // Optional
+  &code_expiration_minutes=<CODE_EXPIRATION_MINUTES>, // Optional
+  &button_types=<BUTTON_TYPES> // Optional
+```
+
+### Parâmetros de solicitação
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<LANGUAGE>`
+
+_Lista separada por vírgulas_
+
+**Opcional.**
+
+  
+Lista separada por vírgulas dos [códigos de localidade e idioma](/documentation/business-messaging/whatsapp/templates/supported-languages) das versões que você quer retornar.
+
+  
+Em caso de omissão, as versões em todos os idiomas aceitos serão retornadas.
+
+`en_US,es_ES`
+
+`<ADD_SECURITY_RECOMMENDATION>`
+
+_Booliano_
+
+**Opcional.**
+
+  
+Defina como `true` se quiser que a string do corpo da recomendação de segurança seja incluída na resposta.
+
+  
+Em caso de omissão, a string não será incluída.
+
+`true`
+
+`<CODE_EXPIRATION_MINUTES>`
+
+_Int64_
+
+**Opcional.**
+
+  
+Defina como um número inteiro se quiser que a string de rodapé da expiração do código seja incluída na resposta.
+
+  
+Em caso de omissão, a string não será incluída.
+
+  
+O valor indica o número de minutos até a expiração do código.
+
+Mínimo `1`, máximo `90`.
+
+`10`
+
+`<BUTTON_TYPES>`
+
+_Lista de strings separadas por vírgulas_
+
+**Obrigatório.**
+
+  
+Lista separada por vírgulas de strings que indicam o tipo de botão.
+
+  
+Em caso de inclusão, a resposta exibirá o texto de cada botão.
+
+  
+Nos modelos de autenticação, esse valor deve ser `OTP`.
+
+`OTP`
+
+### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v17.0/102290129340398/message_template_previews?category=AUTHENTICATION&languages=en_US,es_ES&add_security_recommendation=true&code_expiration_minutes=10&button_types=OTP' \-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta
+
+```
+{  "data": [    {      "body": "*{{1}}* is your verification code. For your security, do not share this code.",      "buttons": [        {          "autofill_text": "Autofill",          "text": "Copy code"        }      ],      "footer": "This code expires in 10 minutes.",      "language": "en_US"    },    {      "body": "Tu código de verificación es *{{1}}*. Por tu seguridad, no lo compartas.",      "buttons": [        {          "autofill_text": "Autocompletar",          "text": "Copiar código"        }      ],      "footer": "Este código caduca en 10 minutos.",      "language": "es_ES"    }  ]}
+```
+
+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)