whatsapp-docs-mcp 1.0.0

package/docs/webhooks/referencia/outros_webhooks/phone_number_quality_update.md

@@ -0,0 +1,172 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/phone_number_quality_update -->
+<!-- Scraped: 2025-12-20T17:39:29.703Z -->
+
+# Referência do webhook phone\_number\_quality\_update
+
+Updated: 14 de nov de 2025
+
+Esta referência descreve os eventos de disparo e o conteúdo da carga do webhook **phone\_number\_quality\_update** da conta do WhatsApp Business.
+
+O webhook **phone\_number\_quality\_update** fornece notificações sobre as alterações de [nível de taxa de transferência de dados](/documentation/business-messaging/whatsapp/throughput) de um número de telefone comercial.
+
+## Gatilhos
+
+-   O nível da taxa de transferência do número de telefone comercial foi alterado.
+
+## Sintaxe
+
+```
+{
+    "entry": [
+      {
+        "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
+        "time": <WEBHOOK_TRIGGER_TIMESTAMP>,
+        "changes": [
+          {
+            "value": {
+              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
+              "event": "<EVENT>",
+              "old_limit": "<OLD_LIMIT>", <!-- only included for messaging limit changes -->
+              "current_limit": "<CURRENT_LIMIT>",
+              "max_daily_conversations_per_business": "<MAX_DAILY_MESSAGES_LIMIT>"
+            },
+            "field": "phone_number_quality_update"
+          }
+        ]
+      }
+    ],
+    "object": "whatsapp_business_account"
+  }
+```
+
+## Parâmetros
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<BUSINESS_DISPLAY_PHONE_NUMBER>`
+
+_String_
+
+Número de telefone comercial exibido.
+
+`15550783881`
+
+`<CURRENT_LIMIT>`
+
+_String_
+
+**Este campo será removido em fevereiro de 2026. Use `max_daily_conversations_per_business`.**
+
+Indica o [limite de mensagens](/documentation/business-messaging/whatsapp/messaging-limits) ou o nível de [taxa de transferência](/documentation/business-messaging/whatsapp/throughput) atual.
+
+Os valores podem ser os seguintes:
+
+`TIER_50` – Indica um limite de 50 mensagens.
+
+`TIER_250` – Indica um limite de 250 mensagens.
+
+`TIER_2K` – Indica um limite de 2 mil mensagens.
+
+`TIER_10K` – Indica um limite de 10 mil mensagens.
+
+`TIER_100K` – Indica um limite de 100 mil mensagens.
+
+`TIER_NOT_SET` – Indica que o número de telefone comercial ainda não foi usado para enviar uma mensagem.
+
+`TIER_UNLIMITED` – Indica que a taxa de transferência do número de telefone comercial aumentou.
+
+`TIER_UNLIMITED`
+
+`<EVENT>`
+
+_String_
+
+Evento de alteração de [limite de mensagens](/documentation/business-messaging/whatsapp/messaging-limits) ou de [taxa de transferência](/documentation/business-messaging/whatsapp/throughput).
+
+Os valores podem ser os seguintes:
+
+`ONBOARDING` – Indica que o número de telefone comercial ainda está sendo registrado.
+
+`THROUGHPUT_UPGRADE` – Indica que o nível da taxa de transferência do número de telefone comercial aumentou.
+
+`THROUGHPUT_UPGRADE`
+
+`<MAX_DAILY_MESSAGES_LIMIT>`
+
+_String_
+
+Indica uma alteração no [limite de mensagens](/documentation/business-messaging/whatsapp/messaging-limits) ou na [taxa de transferência](/documentation/business-messaging/whatsapp/throughput) do portfólio empresarial.
+
+Os valores podem ser os seguintes:
+
+`TIER_50` – Indica um limite de 50 mensagens.
+
+`TIER_250` – Indica um limite de 250 mensagens.
+
+`TIER_2K` – Indica um limite de 2 mil mensagens.
+
+`TIER_10K` – Indica um limite de 10 mil mensagens.
+
+`TIER_100K` – Indica um limite de 100 mil mensagens.
+
+`TIER_NOT_SET` – Indica que o número de telefone comercial ainda não foi usado para enviar uma mensagem.
+
+`TIER_UNLIMITED` – Indica que a taxa de transferência do número de telefone comercial aumentou.
+
+`TIER_2K`
+
+`<OLD_LIMIT>`
+
+_String_
+
+**Este parâmetro será removido em fevereiro de 2026. Use `max_daily_conversations_per_business`.**
+
+Indica o [limite de mensagens](/documentation/business-messaging/whatsapp/messaging-limits) antigo.
+
+Os valores podem ser os seguintes:
+
+`TIER_50` – Indica um limite de 50 mensagens.
+
+`TIER_250` – Indica um limite de 250 mensagens.
+
+`TIER_2K` – Indica um limite de 2 mil mensagens.
+
+`TIER_10K` – Indica um limite de 10 mil mensagens.
+
+`TIER_100K` – Indica um limite de 100 mil mensagens.
+
+`TIER_NOT_SET` – Indica que o número de telefone comercial ainda não foi usado para enviar uma mensagem.
+
+`TIER_UNLIMITED`
+
+`<WEBHOOK_TRIGGER_TIMESTAMP>`
+
+_Número inteiro_
+
+Registro de data e hora Unix que indica quando o webhook foi disparado.
+
+`1739321024`
+
+`<WHATSAPP_BUSINESS_ACCOUNT_ID>`
+
+_String_
+
+Identificação da conta do WhatsApp Business.
+
+`102290129340398`
+
+## Exemplo
+
+```
+{  "entry": [    {      "id": "102290129340398",      "time": 1748454394,      "changes": [        {          "value": {            "display_phone_number": "15550783881",            "event": "THROUGHPUT_UPGRADE",            "current_limit": "TIER_UNLIMITED"          },          "field": "phone_number_quality_update"        }      ]    }  ],  "object": "whatsapp_business_account"}
+```
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

package/docs/webhooks/referencia/outros_webhooks/security.md

@@ -0,0 +1,108 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/security -->
+<!-- Scraped: 2025-12-20T17:39:36.279Z -->
+
+# Referência do webhook de segurança
+
+Updated: 22 de out de 2025
+
+Esta referência descreve os eventos de gatilho e o conteúdo da carga do webhook de **segurança** da conta do WhatsApp Business.
+
+O webhook de **segurança** notifica você sobre alterações nas configurações de segurança de um número de telefone comercial.
+
+## Gatilhos
+
+-   Um usuário do Meta Business Suite clica no botão **Desativar a confirmação em duas etapas** no [Gerenciador do WhatsApp](http://business.facebook.com/latest/whatsapp_manager/).-   Um usuário do Meta Business Suite conclui as instruções no email **Reiniciar verificação em duas etapas do WhatsApp** para desativar esse processo.-   Um usuário do Meta Business Suite altera ou habilita o PIN do número de telefone comercial usando o [Gerenciador do WhatsApp](http://business.facebook.com/latest/whatsapp_manager/).
+
+## Sintaxe
+
+```
+{
+  "entry": [
+    {
+      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
+      "time": <WEBHOOK_TRIGGER_TIMESTAMP>,
+      "changes": [
+        {
+          "value": {
+            "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
+            "event": "<EVENT>",
+            "requester": "<META_BUSINESS_SUITE_USER_ID>"
+          },
+          "field": "security"
+        }
+      ]
+    }
+  ],
+  "object": "whatsapp_business_account"
+}
+```
+
+## Parâmetros
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<BUSINESS_DISPLAY_PHONE_NUMBER>`
+
+_String_
+
+Número de telefone comercial exibido.
+
+`15550783881`
+
+`<EVENT>`
+
+String
+
+O evento de segurança que disparou o webhook.
+
+Os valores podem ser os seguintes:
+
+`PIN_CHANGED` – Indica que um usuário do Meta Business Suite alterou ou habilitou o PIN do número de telefone comercial usando o [Gerenciador do WhatsApp](http://business.facebook.com/latest/whatsapp_manager/).
+
+`PIN_RESET_REQUEST` – Indica que um usuário do Meta Business Suite clicou no botão "Desativar a confirmação em duas etapas" no [Gerenciador do WhatsApp](http://business.facebook.com/latest/whatsapp_manager/).
+
+`PIN_REQUEST_SUCCESS` – Um usuário do Meta Business Suite concluiu as instruções no email de redefinição da verificação em duas etapas do WhatsApp para desativar esse processo.
+
+`PIN_RESET_REQUEST`
+
+`<META_BUSINESS_SUITE_USER_ID>`
+
+String
+
+O número de identificação do usuário do Meta Business Suite que solicitou a desativação da verificação em duas etapas usando o [Gerenciador do WhatsApp](http://business.facebook.com/latest/whatsapp_manager/).
+
+Esse parâmetro é incluído apenas em solicitações de redefinição do PIN.
+
+`61555822107539`
+
+`<WEBHOOK_TRIGGER_TIMESTAMP>`
+
+_Número inteiro_
+
+Registro de data e hora Unix que indica quando o webhook foi disparado.
+
+`1739321024`
+
+`<WHATSAPP_BUSINESS_ACCOUNT_ID>`
+
+_String_
+
+Identificação da conta do WhatsApp Business.
+
+`102290129340398`
+
+## Exemplo
+
+```
+{  "entry": [    {      "id": "102290129340398",      "time": 1748811473,      "changes": [        {          "value": {            "display_phone_number": "15550783881",            "event": "PIN_RESET_REQUEST",            "requester": "61555822107539"          },          "field": "security"        }      ]    }  ],  "object": "whatsapp_business_account"}
+```
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

package/docs/webhooks/referencia/outros_webhooks/smb_app_state_sync.md

@@ -0,0 +1,146 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/smb_app_state_sync -->
+<!-- Scraped: 2025-12-20T17:39:45.763Z -->
+
+# Referência do webhook smb\_app\_state\_sync
+
+Updated: 22 de out de 2025
+
+Esta referência descreve os eventos de gatilho e o conteúdo da carga do webhook **smb\_app\_state\_sync** da conta do WhatsApp Business.
+
+O webhook **smb\_app\_state\_sync** é usado para sincronizar contatos de [usuários do app WhatsApp Business que foram integrados](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users) por meio de um provedor de soluções.
+
+## Gatilhos
+
+-   Um provedor de soluções [sincroniza os contatos do app WhatsApp Business](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users#step-1--initiate-contacts-synchronization) de um cliente comercial com um número de telefone do app WhatsApp Business que o provedor [integrou](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users).-   Um cliente empresarial com um número de telefone do app WhatsApp Business que foi [integrado](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users) por um provedor de soluções adiciona um contato aos [contatos](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F1270784217226727%2F&h=AT2dBZlDXgEah9jHgi0az93YaNTQiv2l1uLLUm_pCv-BRmoGVW39SXstlXwTb27k70Fx86UtyAehtiCzfcNCVh8uMgDRdw1gkI082OaWkVaCVBqpqG36lJRG3ZGxofJxxAT62jXpF0gbgbH5waL_ssIOFsg) do próprio app WhatsApp Business.-   Um cliente empresarial com um número de telefone do app WhatsApp Business que foi [integrado](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users) por um provedor de soluções remove um contato dos [contatos](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F1270784217226727%2F&h=AT2dBZlDXgEah9jHgi0az93YaNTQiv2l1uLLUm_pCv-BRmoGVW39SXstlXwTb27k70Fx86UtyAehtiCzfcNCVh8uMgDRdw1gkI082OaWkVaCVBqpqG36lJRG3ZGxofJxxAT62jXpF0gbgbH5waL_ssIOFsg) do app WhatsApp Business.-   Um cliente empresarial com um número de telefone do app WhatsApp Business que foi [integrado](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users) por um provedor de soluções edita um contato nos [contatos](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F1270784217226727%2F&h=AT2dBZlDXgEah9jHgi0az93YaNTQiv2l1uLLUm_pCv-BRmoGVW39SXstlXwTb27k70Fx86UtyAehtiCzfcNCVh8uMgDRdw1gkI082OaWkVaCVBqpqG36lJRG3ZGxofJxxAT62jXpF0gbgbH5waL_ssIOFsg) do app WhatsApp Business.
+
+## Sintaxe
+
+```
+{
+  "object": "whatsapp_business_account",
+  "entry": [
+    {
+      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
+      "changes": [
+        {
+          "value": {
+            "messaging_product": "whatsapp",
+            "metadata": {
+              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
+              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
+            },
+            "state_sync": [
+              {
+                "type": "contact",
+                "contact": {
+                  "full_name": "<CONTACT_FULL_NAME>",
+                  "first_name": "<CONTACT_FIRST_NAME>",
+                  "phone_number": "<CONTACT_PHONE_NUMBER>"
+                },
+                "action": "<ACTION>",
+                "metadata": {
+                  "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>"
+                }
+              },
+              <!-- Additional contacts would follow, if any -->
+            ]
+          },
+          "field": "smb_app_state_sync"
+        }
+      ]
+    }
+  ]
+}
+```
+
+## Parâmetros
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<ACTION>`
+
+_String_
+
+Indica se o cliente corporativo adicionou, editou ou excluiu um contato da lista de contatos telefônicos do app WhatsApp Business.
+
+Os valores podem ser os seguintes:
+
+`add` – Indica que o usuário do app WhatsApp Business adicionou ou editou um contato.
+
+`remove` – Indica que o usuário do app WhatsApp Business removeu um contato.
+
+`add`
+
+`<BUSINESS_DISPLAY_PHONE_NUMBER>`
+
+_String_
+
+Número de telefone comercial exibido.
+
+`15550783881`
+
+`<BUSINESS_PHONE_NUMBER_ID>`
+
+_String_
+
+Identificação do número de telefone comercial.
+
+`106540352242922`
+
+`<CONTACT_FIRST_NAME>`
+
+_String_
+
+O nome do contato, conforme aparece na lista de contatos telefônicos do app WhatsApp Business do cliente corporativo.
+
+Não é incluído quando o cliente corporativo remove um contato da lista de contatos telefônicos do app WhatsApp Business.
+
+`Pablo`
+
+`<CONTACT_FULL_NAME>`
+
+_String_
+
+O nome completo do contato, conforme aparece na lista de contatos telefônicos do app WhatsApp Business do cliente corporativo.
+
+Não é incluído quando o cliente corporativo remove um contato da lista de contatos telefônicos do app WhatsApp Business.
+
+`Pablo Morales`
+
+`<CONTACT_PHONE_NUMBER>`_String_
+
+O número de telefone do WhatsApp do contato.
+
+`16505551234`
+
+`<WEBHOOK_TRIGGER_TIMESTAMP>`
+
+_Número inteiro_
+
+Registro de data e hora Unix que indica quando o webhook foi disparado.
+
+`1739321024`
+
+`<WHATSAPP_BUSINESS_ACCOUNT_ID>`
+
+_String_
+
+Identificação da conta do WhatsApp Business.
+
+`102290129340398`
+
+## Exemplo
+
+```
+{  "object": "whatsapp_business_account",  "entry": [    {      "id": "102290129340398",      "changes": [        {          "value": {            "messaging_product": "whatsapp",            "metadata": {              "display_phone_number": "15550783881",              "phone_number_id": "106540352242922"            },            "state_sync": [              {                "type": "contact",                "contact": {                  "full_name": "Pablo Morales",                  "first_name": "Pablo",                  "phone_number": "16505551234"                },                "action": "add",                "metadata": {                  "timestamp": "1739321024"                }              }            ]          },          "field": "smb_app_state_sync"        }      ]    }  ]}
+```
+
+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/webhooks/referencia/outros_webhooks/smb_message_echoes.md

@@ -0,0 +1,143 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/smb_message_echoes -->
+<!-- Scraped: 2025-12-20T17:39:53.896Z -->
+
+# Referência de webhook smb\_message\_echoes
+
+Updated: 22 de out de 2025
+
+Esta referência descreve os eventos de gatilho e o conteúdo da carga do webhook **smb\_message\_echoes** da conta do WhatsApp Business.
+
+O webhook **smb\_message\_echoes** avisa você sobre as mensagens enviadas por meio do app WhatsApp Business ou um [dispositivo adicional ("conectado")](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users#linked-devices) por um cliente empresarial que fez a [integração com a API de Nuvem](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users) por meio de um provedor de soluções.
+
+## Gatilhos
+
+-   Um cliente empresarial com um número de telefone do app WhatsApp Business, que fez a [integração por meio de um provedor de soluções](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users), envia uma mensagem usando o app WhatsApp Business ou um [dispositivo adicional](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users#linked-devices) para um usuário do WhatsApp ou outra empresa.
+
+## Sintaxe
+
+```
+{
+  "object": "whatsapp_business_account",
+  "entry": [
+    {
+      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
+      "changes": [
+        {
+          "value": {
+            "messaging_product": "whatsapp",
+            "metadata": {
+              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
+              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
+            },
+            "message_echoes": [
+              {
+                "from": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
+                "to": "<WHATSAPP_USER_PHONE_NUMBER>",
+                "id": "<WHATSAPP_MESSAGE_ID>",
+                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
+                "type": "<MESSAGE_TYPE>",
+                "<MESSAGE_TYPE>": {
+                  <MESSAGE_CONTENTS>
+                }
+              }
+            ]
+          },
+          "field": "smb_message_echoes"
+        }
+      ]
+    }
+  ]
+}
+```
+
+## Parâmetros
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<BUSINESS_DISPLAY_PHONE_NUMBER>`
+
+_String_
+
+Número de telefone comercial exibido.
+
+`15550783881`
+
+`<BUSINESS_PHONE_NUMBER_ID>`
+
+_String_
+
+Identificação do número de telefone comercial.
+
+`106540352242922`
+
+`<MESSAGE_CONTENTS>`
+
+_Objeto_
+
+Um objeto que descreve o conteúdo da mensagem.
+
+Esse valor variará com base na mensagem `type`, bem como no conteúdo da mensagem.
+
+Por exemplo, se uma empresa enviar uma mensagem `image` sem legenda, o objeto não incluirá a propriedade `caption`.
+
+Consulte [Como enviar mensagens](/documentation/business-messaging/whatsapp/messages/send-messages) para ver exemplos de carga de cada tipo de mensagem.
+
+`{"body":"Here's the info you requested! https://www.meta.com/quest/quest-3/"}`
+
+`<MESSAGE_TYPE>`
+
+_String_
+
+[Tipo de mensagem](/documentation/business-messaging/whatsapp/webhooks/reference/messages). Esse espaço reservado aparece duas vezes na sintaxe acima, pois serve para o valor da propriedade `type` e o nome correspondente da propriedade.
+
+`text`
+
+`<WEBHOOK_TRIGGER_TIMESTAMP>`
+
+_Número inteiro_
+
+Registro de data e hora Unix que indica quando o webhook foi disparado.
+
+`1739321024`
+
+`<WHATSAPP_BUSINESS_ACCOUNT_ID>`
+
+_String_
+
+Identificação da conta do WhatsApp Business do cliente corporativo.
+
+`102290129340398`
+
+`<WHATSAPP_MESSAGE_ID>`
+
+_String_
+
+Identificação da mensagem do WhatsApp.
+
+`wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=`
+
+`<WHATSAPP_USER_PHONE_NUMBER>`
+
+_String_
+
+Número de telefone do usuário do WhatsApp. É o mesmo valor retornado pela API como o valor de `input` ao enviar uma mensagem para um usuário do WhatsApp. Vale observar que o número de identificação de um usuário do WhatsApp nem sempre coincide com seu número de telefone.
+
+`+16505551234`
+
+## Exemplo
+
+Esta carga de exemplo descreve uma mensagem de texto (`type` é `text`) enviada a um usuário do WhatsApp por um cliente corporativo usando o app WhatsApp Business.
+
+```
+{  "object": "whatsapp_business_account",  "entry": [    {      "id": "102290129340398",      "changes": [        {          "value": {            "messaging_product": "whatsapp",            "metadata": {              "display_phone_number": "15550783881",              "phone_number_id": "106540352242922"            },            "message_echoes": [              {                "from": "15550783881",                "to": "16505551234",                "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBIyNDlBOEI5QUQ4NDc0N0FCNjMA",                "timestamp": "1739321024",                "type": "text"                "text": {                  "body": "Here's the info you requested! https://www.meta.com/quest/quest-3/"                }              }            ]          },          "field": "smb_message_echoes"        }      ]    }  ]}
+```
+
+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)