whatsapp-docs-mcp 1.0.0

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

@@ -0,0 +1,154 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/template_category_update -->
+<!-- Scraped: 2025-12-20T17:40:02.885Z -->
+
+# Referência do webhook template\_category\_update
+
+Updated: 11 de nov de 2025
+
+Esta referência descreve eventos de gatilho e conteúdos de carga para o webhook **template\_category\_update** da conta do WhatsApp Business.
+
+O webhook **template\_category\_update** envia uma notificação sobre as alterações à [categoria](/documentation/business-messaging/whatsapp/templates/template-categorization) do modelo.
+
+## Gatilhos
+
+-   A categoria existente de um modelo do WhatsApp será alterada por um [processo automatizado](/documentation/business-messaging/whatsapp/templates/template-categorization#how-we-update-a-template-s-category-after-initial-approval).-   A categoria existente de um modelo do WhatsApp é alterada manualmente ou por um [processo automatizado](/documentation/business-messaging/whatsapp/templates/template-categorization#how-we-update-a-template-s-category-after-initial-approval).
+
+## Sintaxe
+
+```
+{
+  "object": "whatsapp_business_account",
+  "entry": [
+    {
+      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
+      "time": <WEBHOOK_TRIGGER_TIMESTAMP>,
+      "changes": [
+        {
+          "field": "template_category_update",
+          "value": {
+            "message_template_id": <TEMPLATE_ID>,
+            "message_template_name": "<TEMPLATE_NAME>",
+            "message_template_language": "<TEMPLATE_LANGUAGE>",
+
+            <!-- impending category change notifications only -->
+            "correct_category": "<CORRECT_CATEGORY>",
+            "new_category": "<CURRENT_CATEGORY>",
+            "category_update_timestamp": <CATEGORY_UPDATE_TIMESTAMP><!-- completed category change notifications only -->
+            "previous_category": "<PREVIOUS_CATEGORY>",
+            "new_category": "<NEW_CATEGORY>"
+
+          }
+        }
+      ]
+    }
+  ]
+}
+```
+
+## Parâmetros
+
+Espaço reservado
+
+Descrição
+
+Example value
+
+`<CORRECT_CATEGORY>`
+
+_String_
+
+A categoria que o modelo [receberá](/documentation/business-messaging/whatsapp/templates/template-categorization#how-we-update-a-template-s-category-after-initial-approval) em 24 horas.
+
+`MARKETING`
+
+`<CURRENT_CATEGORY>`
+
+_String_
+
+A [categoria](/documentation/business-messaging/whatsapp/templates/overview#template-categories) atual do modelo.
+
+`MARKETING`
+
+`<NEW_CATEGORY>`
+
+_String_
+
+A nova [categoria](/documentation/business-messaging/whatsapp/templates/overview#template-categories) do modelo.
+
+`MARKETING`
+
+`<CATEGORY_UPDATE_TIMESTAMP>`
+
+_Número inteiro_
+
+O registro de data e hora UNIX (em segundos) que indica quando a categoria do modelo será atualizada para a opção `<CORRECT_CATEGORY>` especificada no webhook. Esse valor representa o momento em que a atualização está programada para ocorrer.
+
+`1760711433`
+
+`<PREVIOUS_CATEGORY>`
+
+_String_
+
+A [categoria](/documentation/business-messaging/whatsapp/templates/overview#template-categories) anterior do modelo.
+
+`UTILITY`
+
+`<TEMPLATE_ID>`
+
+_Número inteiro_
+
+ID do modelo.
+
+`278077987957091`
+
+`<TEMPLATE_LANGUAGE>`
+
+_String_
+
+O [código de localidade e idioma](/documentation/business-messaging/whatsapp/templates/supported-languages) do modelo.
+
+`en-US`
+
+`<TEMPLATE_NAME>`
+
+_String_
+
+O nome do modelo.
+
+`welcome_template`
+
+`<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`
+
+## Exemplos
+
+O webhook de exemplo descreve um modelo que será recategorizado como `MARKETING` em 24 horas. Observe que `new_category` indica a categoria _atual_:
+
+```
+{ "entry": [   {     "id": "102290129340398",     "time": 1746082800,     "changes": [       {         "field": "template_category_update",         "value": {           "message_template_id": 278077987957091,           "message_template_name": "welcome_template",           "message_template_language": "en-US",           "new_category": "UTILITY",           "correct_category": "MARKETING",           "category_update_timestamp": 1746169200         }       }     ]   } ], "object": "whatsapp_business_account"}
+```
+
+O exemplo de webhook descreve um modelo que foi recategorizado como `MARKETING`:
+
+```
+{ "entry": [   {     "id": "102290129340398",     "time": 1746169200,     "changes": [       {         "field": "template_category_update",         "value": {           "message_template_id": 278077987957091,           "message_template_name": "welcome_template",           "message_template_language": "en-US",           "previous_category": "UTILITY",           "new_category": "MARKETING"         }       }     ]   } ], "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/user_preferences.md

@@ -0,0 +1,150 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/user_preferences -->
+<!-- Scraped: 2025-12-20T17:40:13.053Z -->
+
+# Referência do webhook user\_preferences
+
+Updated: 5 de nov de 2025
+
+Esta referência descreve os eventos de gatilho e o conteúdo da carga do webhook **user\_preferences** da conta do WhatsApp Business.
+
+O webhook **user\_preferences** notifica você sobre as alterações nas [preferências de mensagens de marketing](/documentation/business-messaging/whatsapp/templates/marketing-templates#user-preferences-for-marketing-messages) de um usuário do WhatsApp.
+
+## Gatilhos
+
+-   Um usuário do WhatsApp interrompe as mensagens de marketing.-   Um usuário do WhatsApp retoma as mensagens de marketing.
+
+## 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>"
+            },
+            "contacts": [
+              {
+                "profile": {
+                  "name": "<WHATSAPP_USER_NAME>"
+                },
+                "wa_id": "<WHATSAPP_USER_ID>"
+              }
+            ],
+            "user_preferences": [
+              {
+                "wa_id": "<WHATSAPP_USER_ID>",
+                "detail": "<PREFERENCE_DESCRIPTION>",
+                "category": "marketing_messages",
+                "value": "<PREFERENCE>",
+                "timestamp": <WEBHOOK_SENT_TIMESTAMP>
+              }
+            ]
+          },
+          "field": "user_preferences"
+        }
+      ]
+    }
+  ]
+}
+```
+
+## Parâmetros
+
+Espaço reservado
+
+Descrição
+
+Exemplo de valor
+
+`<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`
+
+`<PREFERENCE>`
+
+_String_
+
+[Preferência de mensagens de marketing](/documentation/business-messaging/whatsapp/templates/marketing-templates#user-preferences-for-marketing-messages).
+
+Os valores podem ser os seguintes:
+
+`stop` – indica que os usuários do WhatsApp optaram por parar de receber suas mensagens de marketing.
+
+`resume` – indica que os usuários do WhatsApp aceitaram receber suas mensagens de marketing novamente.
+
+`stop`
+
+`<PREFERENCE_DESCRIPTION>`
+
+_String_
+
+Descrição da [preferência de mensagens de marketing](/documentation/business-messaging/whatsapp/templates/marketing-templates#user-preferences-for-marketing-messages).
+
+Os valores podem ser os seguintes:
+
+-   `User requested to stop marketing messages`-   `User requested to resume marketing messages`
+
+`User requested to stop marketing messages`
+
+`<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`
+
+`<WHATSAPP_USER_ID>`
+
+_String_
+
+Número de identificação do 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`
+
+`<WHATSAPP_USER_PROFILE_NAME>`
+
+_String_
+
+O nome de usuário do WhatsApp exibido no perfil do cliente na plataforma.
+
+`Sheena Nelson`
+
+## Exemplo
+
+```
+{  "object": "whatsapp_business_account",  "entry": [    {      "id": "102290129340398",      "changes": [        {          "value": {            "messaging_product": "whatsapp",            "metadata": {              "display_phone_number": "15550783881",              "phone_number_id": "106540352242922"            },            "contacts": [              {                "wa_id": "16505551234"              }            ],            "user_preferences": [              {                "wa_id": "16505551234",                "detail": "User requested to resume marketing messages",                "category": "marketing_messages",                "value": "resume",                "timestamp": 1731705721              }            ]          },          "field": "user_preferences"        }      ]    }  ]}
+```
+
+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/visao_geral/AGENTS.md

@@ -0,0 +1,11 @@
+# Visão Geral
+
+Visão geral sobre webhooks
+
+## Documentos Disponíveis
+
+- [Message Echoes](./message_echoes.md)
+- [Override](./override.md)
+- [Overview](./overview.md)
+- [Set Up Whatsapp Echo Bot](./set_up_whatsapp_echo_bot.md)
+

package/docs/webhooks/visao_geral/message_echoes.md

@@ -0,0 +1,8 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/message_echoes -->
+<!-- Scraped: 2025-12-20T17:35:22.485Z -->
+
+## 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/webhooks/visao_geral/override.md

@@ -0,0 +1,235 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/override -->
+<!-- Scraped: 2025-12-20T17:35:14.140Z -->
+
+# Substituições de webhook
+
+Updated: 7 de nov de 2025
+
+Webhooks de [mensagens](/documentation/business-messaging/whatsapp/webhooks/reference/messages) são enviados ao URL de retorno de chamada definido no app, mas é possível designar um URL de retorno de chamada alternativo para a conta do WhatsApp Business (WABA) ou o número de telefone comercial.
+
+Quando um webhook de mensagens é disparado, primeiro verificamos se o seu app definiu um URL de retorno de chamada alternativo para o número de telefone comercial associado à mensagem. Se tiver definido, enviaremos o webhook ao URL de retorno de chamada alternativo. Se não houver um número de telefone alternativo, verificaremos se a WABA associada ao número tem um URL de retorno de chamada alternativo; se tiver, enviaremos para lá. Se também não houver uma WABA alternativa, faremos o fallback para o URL de retorno de chamada do app.
+
+## Requisitos
+
+Antes de configurar um URL de retorno de chamada alternativa, verifique se o seu app está [inscrito nos webhooks da WABA](/documentation/business-messaging/whatsapp/solution-providers/manage-webhooks#subscribe-to-a-whatsapp-business-account) e verifique se o seu ponto de extremidade de retorno de chamada alternativa pode receber e processar webhooks de mensagens corretamente.
+
+## Definir retorno de chamada alternativa da WABA
+
+Use o ponto de extremidade [**POST /<WABA\_ID>/subscribed\_apps**](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/subscribed-apps-api#post-version-waba-id-subscribed-apps) para definir um URL de retorno de chamada alternativa em uma WABA.
+
+### Sintaxe da solicitação
+
+```
+POST /<WABA_ID>/subscribed_apps
+```
+
+### Corpo do post
+
+```
+{
+  "override_callback_uri":"<WABA_ALT_CALLBACK_URL>",
+  "verify_token":"<WABA_ALT_CALLBACK_URL_TOKEN>"
+}
+```
+
+### Parâmetros do corpo
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<WABA_ALT_CALLBACK_URL>`
+
+**Obrigatório.**
+
+URL de retorno de chamada alternativa para a qual os webhooks de mensagens devem ser enviados.
+
+Máximo de 200 caracteres.
+
+`https://my-waba-alternate-callback.com/webhook`
+
+`<WABA_ALT_CALLBACK_URL_TOKEN>`
+
+**Obrigatório.**
+
+[Token de verificação](/docs/graph-api/webhooks/getting-started#verification-requests) do URL de retorno de chamada alternativa.
+
+Sem máximo.
+
+`myvoiceismypassport?`
+
+### Resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{  "success": true}
+```
+
+### Exemplo de solicitação
+
+```
+curl -X POST \
+'https://graph.facebook.com/v24.0/102290129340398/subscribed_apps' \
+-H 'Authorization: Bearer EAAJi...' \
+-H 'Content-Type: application/json' \
+-d '
+{
+  "override_callback_uri":"https://my-waba-alternate-callback.com/webhook",
+  "verify_token":"myvoiceismypassport?"
+}'
+```
+
+### Exemplo de resposta
+
+```
+{  "success": true}
+```
+
+## Obter retorno de chamada alternativa da WABA
+
+Use o ponto de extremidade [**GET /<WABA\_ID>/subscribed\_apps**](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/subscribed-apps-api#Reading) para obter uma lista de todos os apps inscritos em webhooks na WABA. A resposta deve incluir a propriedade e o valor `override_callback_uri`.
+
+### Exemplo de resposta
+
+```
+{  "data" : [    {      "whatsapp_business_api_data" : {        "id" : "670843887433847",        "link" : "https://www.facebook.com/games/?app_id=67084...",        "name" : "Lucky Shrub"      },      "override_callback_uri" : "https://my-waba-alternate-callback.com/webhook"    }  ]}
+```
+
+## Excluir retorno de chamada alternativa da WABA
+
+Use o ponto de extremidade [**POST /<WABA\_ID>/subscribed\_apps**](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/subscribed-apps-api#post-version-waba-id-subscribed-apps) para inscrever seu app para webhooks na WABA, [como você faria normalmente](/documentation/business-messaging/whatsapp/solution-providers/manage-webhooks#subscribe) (ou seja, sem quaisquer parâmetros de publicação no corpo). Essa ação removerá o URL do ponto de extremidade alternativo da WABA, e os webhooks de mensagens da WABA voltarão a ser enviados para o URL de retorno de chamada definida no Painel de Apps.
+
+## Definir retorno de chamada alternativa de número de telefone
+
+Use o ponto de extremidade [**POST /<BUSINESS\_PHONE\_NUMBER\_ID>**](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-phone-number-api#Creating) para definir um URL de retorno de chamada alternativa no número de telefone comercial.
+
+### Sintaxe da solicitação
+
+```
+POST /<BUSINESS_PHONE_NUMBER_ID>
+```
+
+### Corpo do post
+
+```
+{
+  "webhook_configuration": {
+    "override_callback_uri": "<PHONE_ALT_CALLBACK_URL>",
+    "verify_token": "<PHONE_ALT_CALLBACK_URL_TOKEN>"
+  }
+}
+```
+
+### Parâmetros do corpo
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<PHONE_ALT_CALLBACK_URL>`
+
+**Obrigatório.**
+
+URL de retorno de chamada alternativa para a qual os webhooks de mensagens devem ser enviados.
+
+Máximo de 200 caracteres.
+
+`https://my-phone-alternate-callback.com/webhook`
+
+`<PHONE_ALT_CALLBACK_URL_TOKEN>`
+
+**Obrigatório.**
+
+[Token de verificação](/docs/graph-api/webhooks/getting-started#verification-requests) do URL de retorno de chamada alternativa.
+
+Sem máximo.
+
+`myvoiceismypassport?`
+
+### Resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{  "success": true}
+```
+
+### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v24.0/106540352242922' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer EAAJB...' \
+-d '
+{
+  "webhook_configuration": {
+    "override_callback_uri": "https://my-phone-alternate-callback.com/webhook",
+    "verify_token": "myvoiceismypassport?"
+  }
+}'
+```
+
+### Exemplo de resposta
+
+```
+{  "success": true}
+```
+
+## Obter retorno de chamada alternativa de número de telefone
+
+Use o ponto de extremidade [**GET /<BUSINESS\_PHONE\_NUMBER\_ID>**](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-phone-number-api#Reading) e solicite o campo `webhook_configuration` para verificar se o número de telefone comercial tem um URL de retorno de chamada alternativa.
+
+### Sintaxe da solicitação
+
+```
+GET /<BUSINESS_PHONE_NUMBER_ID>
+  ?fields=webhook_configuration
+```
+
+### Resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{
+  "webhook_configuration": {
+    "phone_number": "<PHONE_ALT_CALLBACK_URL>",
+    "whatsapp_business_account": "<WABA_ALT_CALLBACK_URL>",
+    "application": "<APP_CALLBACK_URL>"
+  },
+  "id": "106540352242922"
+}
+```
+
+Observe que `whatsapp_business_account` só será incluído se a WABA associada ao número de telefone comercial também tiver um URL de retorno de chamada alternativa definida.
+
+### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v17.0/106540352242922?fields=webhook_configuration' \-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta
+
+```
+{  "webhook_configuration": {    "phone_number": "https://my-phone-alternate-callback.com/webhook",    "whatsapp_business_account": "https://my-waba-alternate-callback.com/webhook",    "application": "https://my-production-callback.com/webhook"  },  "id": "106540352242922"}
+```
+
+## Excluir retorno de chamada alternativa de número de telefone
+
+Para excluir o URL de retorno de chamada alternativa de um número de telefone comercial, use o ponto de extremidade [**POST /<BUSINESS\_PHONE\_NUMBER\_ID>**](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-phone-number-api#Creating) com o conjunto de propriedades `override_callback_uri` para uma string vazia:
+
+```
+{  "webhook_configuration": {    "override_callback_uri": "",  }}
+```
+
+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)