whatsapp-docs-mcp 1.0.6 → 1.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (158) hide show
  1. package/docs/ativos_da_conta/outros_ativos/display_names.md +9 -9
  2. package/docs/ativos_da_conta/outros_ativos/official_business_accounts.md +27 -27
  3. package/docs/ativos_da_conta/telefones_comerciais/phone_numbers.md +151 -27
  4. package/docs/business_profiles.md +72 -0
  5. package/docs/business_scoped_user_ids.md +1533 -0
  6. package/docs/dados_privacidade_e_politica/encryption.md +1 -1
  7. package/docs/flows/changelog.md +6 -6
  8. package/docs/flows/gettingstarted/health_insurance.md +12 -6
  9. package/docs/flows/gettingstarted/personalised_offer.md +6 -6
  10. package/docs/flows/gettingstarted/pre_approved_loan.md +6 -6
  11. package/docs/flows/gettingstarted/purchase_intent.md +2 -2
  12. package/docs/flows/gettingstarted.md +5 -5
  13. package/docs/flows/guias.md +1 -1
  14. package/docs/flows/playground.md +1 -1
  15. package/docs/flows/referencia.md +1 -1
  16. package/docs/flows/support.md +3 -3
  17. package/docs/flows.md +2 -2
  18. package/docs/insights/analytics.md +200 -66
  19. package/docs/ligacoes/call_settings.md +129 -57
  20. package/docs/ligacoes/calling.md +33 -16
  21. package/docs/ligacoes/integration_examples.md +526 -0
  22. package/docs/ligacoes/pricing.md +11 -300
  23. package/docs/ligacoes/sandbox.md +160 -0
  24. package/docs/ligacoes/video_calling.md +8 -0
  25. package/docs/mensagens/interactive_media_carousel_messages.md +256 -0
  26. package/docs/mensagens/interactive_product_carousel_messages.md +181 -0
  27. package/docs/mensagens/limites_de_mensagens/messaging_limits.md +16 -12
  28. package/docs/mensagens/recursos_adicionais/media.md +15 -16
  29. package/docs/mensagens/recursos_adicionais/payload_encryption.md +1 -1
  30. package/docs/mensagens/tipos_de_mensagens/audio_messages.md +11 -11
  31. package/docs/mensagens/tipos_de_mensagens/interactive_flow_messages.md +1 -1
  32. package/docs/mensagens/tipos_de_mensagens/message_with_link.md +1 -1
  33. package/docs/mensagens_de_marketing/changelog.md +299 -0
  34. package/docs/mensagens_de_marketing/features.md +184 -0
  35. package/docs/mensagens_de_marketing/implementacao/get_started.md +17 -21
  36. package/docs/mensagens_de_marketing/implementacao/send_marketing_messages.md +50 -45
  37. package/docs/mensagens_de_marketing/measure_conversion.md +132 -0
  38. package/docs/mensagens_de_marketing/onboarding.md +282 -0
  39. package/docs/mensagens_de_marketing/recursos/automatic_creative_optimization.md +1 -1
  40. package/docs/mensagens_de_marketing/recursos/conversion_measurement.md +1 -1
  41. package/docs/mensagens_de_marketing/visao_geral/overview.md +11 -9
  42. package/docs/messaging_limits/upcoming_changes.md +1 -1
  43. package/docs/modelos/authentication_templates/bulk_management.md +145 -0
  44. package/docs/modelos/authentication_templates/template_preview.md +109 -0
  45. package/docs/modelos/gerenciamento_de_modelos/components.md +23 -23
  46. package/docs/modelos/gerenciamento_de_modelos/template_media.md +1 -1
  47. package/docs/modelos/modelos_de_marketing/marketing_templates.md +20 -20
  48. package/docs/modelos/modelos_de_marketing/per_user_limits.md +7 -5
  49. package/docs/modelos/portfolio_pacing.md +30 -0
  50. package/docs/modelos/visao_geral/overview.md +17 -17
  51. package/docs/pagamentos/payments_br/cards.md +8 -0
  52. package/docs/parceiros/gerenciamento/suporte_ao_parceiro/transferring_wabas_to_customers.md +1 -1
  53. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/onboarding_business_app_users.md +364 -75
  54. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/overview.md +34 -30
  55. package/docs/parceiros/migrate_existing_whatsapp_number_to_a_business_account.md +40 -0
  56. package/docs/parceiros/obo_model_deprecation.md +32 -0
  57. package/docs/parceiros/seja_um_parceiro/get_started_for_solution_partners.md +42 -42
  58. package/docs/parceiros/seja_um_parceiro/get_started_for_tech_providers.md +38 -142
  59. package/docs/recado/precos/pricing.md +82 -50
  60. package/docs/recado/precos/pricing_authentication_international_rates.md +16 -18
  61. package/docs/recado/precos/pricing_updates_to_pricing.md +1 -1
  62. package/docs/recado/sobre_a_plataforma/about_the_platform.md +80 -24
  63. package/docs/recado/sobre_a_plataforma/access_tokens.md +19 -19
  64. package/docs/referencia/bot_do_whatsapp_business/bot_details_api.md +4 -758
  65. package/docs/referencia/business/add_phone_numbers_api.md +4 -722
  66. package/docs/referencia/business/business_account_api.md +8 -0
  67. package/docs/referencia/business/client_whatsapp_business_accounts_api.md +4 -1002
  68. package/docs/referencia/business/owned_whatsapp_business_accounts.md +4 -798
  69. package/docs/referencia/business/whatsapp_business_accounts_api.md +4 -1546
  70. package/docs/referencia/business/whatsapp_business_partner_onboarding_to_mm_lite_api.md +4 -779
  71. package/docs/referencia/business/whatsapp_business_pre_verified_phone_number_sharing_api.md +4 -786
  72. package/docs/referencia/business/whatsapp_business_pre_verified_phone_numbers_api.md +4 -882
  73. package/docs/referencia/changelog.md +1837 -3
  74. package/docs/referencia/conta_do_whatsapp_business/assigned_users_management_api.md +4 -2198
  75. package/docs/referencia/conta_do_whatsapp_business/business_account_api.md +4 -263
  76. package/docs/referencia/conta_do_whatsapp_business/business_account_extended_credits_api.md +4 -271
  77. package/docs/referencia/conta_do_whatsapp_business/conversational_automation_api.md +4 -778
  78. package/docs/referencia/conta_do_whatsapp_business/flows_api.md +4 -1528
  79. package/docs/referencia/conta_do_whatsapp_business/in_progress_on_behalf_requests_api.md +1 -1
  80. package/docs/referencia/conta_do_whatsapp_business/migration_intent_api.md +4 -1577
  81. package/docs/referencia/conta_do_whatsapp_business/obo_mobility_intent_api.md +1 -1
  82. package/docs/referencia/conta_do_whatsapp_business/phone_number_management_api.md +4 -1682
  83. package/docs/referencia/conta_do_whatsapp_business/schedules_api.md +4 -1768
  84. package/docs/referencia/conta_do_whatsapp_business/set_obo_mobility_intent_api.md +1 -1
  85. package/docs/referencia/conta_do_whatsapp_business/set_solution_migration_intent_api.md +1 -1
  86. package/docs/referencia/conta_do_whatsapp_business/subscribed_apps_api.md +4 -2174
  87. package/docs/referencia/conta_do_whatsapp_business/template_api.md +4 -972
  88. package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_activities_api.md +4 -838
  89. package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_api.md +4 -1380
  90. package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_solutions_list_api.md +4 -850
  91. package/docs/referencia/groups/groups_invite_link_api.md +8 -0
  92. package/docs/referencia/groups/groups_join_requests_api.md +8 -0
  93. package/docs/referencia/groups/groups_participants_api.md +8 -0
  94. package/docs/referencia/groups/groups_query_api.md +8 -0
  95. package/docs/referencia/grupo/groups_invite_link_api.md +4 -300
  96. package/docs/referencia/grupo/groups_join_requests_api.md +4 -682
  97. package/docs/referencia/grupo/groups_participants_api.md +4 -270
  98. package/docs/referencia/grupo/groups_query_api.md +4 -432
  99. package/docs/referencia/historico_de_mensagens/whatsapp_business_message_history_events_api.md +4 -862
  100. package/docs/referencia/inscricao/application_connected_client_businesses.md +4 -808
  101. package/docs/referencia/inscricao/application_solutions_api.md +4 -870
  102. package/docs/referencia/inscricao/solution_creation_api.md +4 -820
  103. package/docs/referencia/intencao_de_migracao_da_conta_do_whatsapp_business/migration_intent_details_api.md +4 -720
  104. package/docs/referencia/midias/media_api.md +4 -338
  105. package/docs/referencia/midias/media_download_api.md +4 -156
  106. package/docs/referencia/numero_da_conta_do_whatsapp/whatsapp_account_number_api.md +4 -774
  107. package/docs/referencia/perfil_do_whatsapp_business/whatsapp_business_profile_node_api.md +4 -1490
  108. package/docs/referencia/solucao_do_whatsapp_business/accept_deactivation_request_api.md +4 -758
  109. package/docs/referencia/solucao_do_whatsapp_business/access_token_api.md +4 -700
  110. package/docs/referencia/solucao_do_whatsapp_business/reject_deactivation_request_api.md +4 -808
  111. package/docs/referencia/solucao_do_whatsapp_business/send_deactivation_request_api.md +4 -774
  112. package/docs/referencia/solucao_do_whatsapp_business/solution_accept_api.md +4 -808
  113. package/docs/referencia/solucao_do_whatsapp_business/solution_details_api.md +4 -764
  114. package/docs/referencia/solucao_do_whatsapp_business/solution_reject_api.md +4 -794
  115. package/docs/referencia/telefone_do_whatsapp_business/block_api.md +4 -538
  116. package/docs/referencia/telefone_do_whatsapp_business/business_compliance_information_api.md +4 -1604
  117. package/docs/referencia/telefone_do_whatsapp_business/business_encryption_api.md +4 -1398
  118. package/docs/referencia/telefone_do_whatsapp_business/calling_api.md +4 -594
  119. package/docs/referencia/telefone_do_whatsapp_business/encrypted_messages_api.md +4 -478
  120. package/docs/referencia/telefone_do_whatsapp_business/groups_management_api.md +4 -481
  121. package/docs/referencia/telefone_do_whatsapp_business/marketing_messages_lite_api.md +4 -311
  122. package/docs/referencia/telefone_do_whatsapp_business/media_upload_api.md +4 -184
  123. package/docs/referencia/telefone_do_whatsapp_business/message_api.md +4 -1794
  124. package/docs/referencia/telefone_do_whatsapp_business/phone_number_api.md +4 -373
  125. package/docs/referencia/telefone_do_whatsapp_business/phone_number_deregister_api.md +4 -710
  126. package/docs/referencia/telefone_do_whatsapp_business/phone_number_registration.md +4 -776
  127. package/docs/referencia/telefone_do_whatsapp_business/phone_number_verification_request_code_api.md +4 -730
  128. package/docs/referencia/telefone_do_whatsapp_business/register_api.md +4 -407
  129. package/docs/referencia/telefone_do_whatsapp_business/settings_api.md +4 -670
  130. package/docs/referencia/telefone_do_whatsapp_business/verify_code_api.md +4 -742
  131. package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_message_history_api.md +4 -928
  132. package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_official_business_account_status_api.md +4 -1536
  133. package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_phone_number_api.md +4 -1596
  134. package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_profile_api.md +4 -1474
  135. package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_qr_code_api.md +4 -1175
  136. package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_qr_code_management_api.md +4 -1311
  137. package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/request_verification_code_api.md +4 -774
  138. package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/verify_code_api.md +4 -764
  139. package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/whatsapp_business_pre_verified_phone_number_api.md +4 -1378
  140. package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/whatsapp_business_pre_verified_phone_number_partners_api.md +4 -816
  141. package/docs/referencia/usuario/assigned_whatsapp_business_accounts_api.md +4 -860
  142. package/docs/referencia/webhooks/whatsapp_incoming_webhook_payload.md +4 -1651
  143. package/docs/referencia/whatsapp_business_account/extended_credits_api.md +8 -0
  144. package/docs/referencia/whatsapp_business_phone_number/commerce_settings_api.md +8 -0
  145. package/docs/suporte/error_codes.md +88 -89
  146. package/docs/suporte/migrating_from_onprem_to_cloud.md +222 -0
  147. package/docs/suporte/support.md +77 -186
  148. package/docs/suporte.md +77 -186
  149. package/docs/throughput.md +60 -0
  150. package/docs/upcoming_messaging_limits_changes.md +132 -0
  151. package/docs/visao_geral/overview.md +354 -306
  152. package/docs/webhooks/create_webhook_endpoint.md +158 -0
  153. package/docs/webhooks/reference/messages/group.md +182 -0
  154. package/docs/webhooks/referencia/account_update.md +27 -27
  155. package/docs/webhooks/referencia/messages/status.md +35 -35
  156. package/docs/webhooks/visao_geral/message_echoes.md +1 -1
  157. package/docs/webhooks/visao_geral/overview.md +23 -15
  158. package/package.json +1 -1
@@ -0,0 +1,158 @@
1
+ <!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/create-webhook-endpoint -->
2
+ <!-- Scraped: 2026-01-24T01:07:25.530Z -->
3
+
4
+ # Como criar um ponto de extremidade de webhook
5
+
6
+ Updated: 7 de nov de 2025
7
+
8
+ Conheça as solicitações e respostas de webhook para configurar seu próprio ponto de extremidade de webhook em um servidor público.
9
+
10
+ Antes de poder usar o app em capacidade de produção, você deve criar e configurar seu próprio ponto de extremidade de webhook em um servidor público capaz de aceitar e responder a solicitações GET e POST, bem como validar e capturar cargas de webhook.
11
+
12
+ ## TLS/SSL
13
+
14
+ O servidor do ponto de extremidade de webhook deve ter um certificado de segurança digital TLS ou SSL válido, configurado e instalado corretamente. Não são aceitos certificados autoatribuídos.
15
+
16
+ ## mTLS
17
+
18
+ Os webhooks são compatíveis com o protocolo TLS mútuo (mTLS) para aumentar a segurança. Para saber como habilitar e usar o mTLS, consulte o documento [mTLS para webhooks](/docs/graph-api/webhooks/getting-started#mtls-for-webhooks) da Graph API.
19
+
20
+ Não é possível habilitar e desabilitar o mTLS no nível da WABA ou do número de telefone comercial. Se houver mais de um app acessando a plataforma, será necessário habilitar o mTLS para cada um deles.
21
+
22
+ ## Solicitações GET
23
+
24
+ As solicitações GET são usadas para verificar o ponto de extremidade do webhook. Sempre que você [definir ou editar o campo **URL de retorno de ligação** ou o campo **Verificar token**](#configure-webhooks) no Painel de Apps, enviaremos uma solicitação GET para seu ponto de extremidade de webhook. É necessário validar e responder a essa solicitação.
25
+
26
+ ### Sintaxe da solicitação
27
+
28
+ ```
29
+ GET <CALLBACK_URL>
30
+ ?hub.mode=subscribe
31
+ &hub.challenge=<HUB.CHALLENGE>
32
+ &hub.verify_token=<HUB.VERIFY_TOKEN>
33
+ ```
34
+
35
+ ### Parâmetros de solicitação
36
+
37
+ Espaço reservado
38
+
39
+ Descrição
40
+
41
+ Valor de exemplo
42
+
43
+ `<CALLBACK_URL>`
44
+
45
+ O URL do ponto de extremidade do webhook.
46
+
47
+ Adicione esse URL ao campo **URL de retorno de chamada** no Painel de Apps quando você [configurar webhooks](#configure-webhooks) mais tarde.
48
+
49
+ `https://www.luckyshrub.com/webhooks`
50
+
51
+ `<HUB.CHALLENGE>`
52
+
53
+ Uma string aleatória que será gerada por nós.
54
+
55
+ `1158201444`
56
+
57
+ `<HUB.VERIFY_TOKEN>`
58
+
59
+ Uma string de verificação da sua escolha. Armazene essa string no seu servidor.
60
+
61
+ Adicione essa string ao campo **Verificar token** no Painel de Apps quando você [configurar webhooks](#configure-webhooks) mais tarde.
62
+
63
+ `vibecoding`
64
+
65
+ ### Validação
66
+
67
+ Para validar as solicitações GET, compare o valor `hub.verify_token` na solicitação com a string de verificação armazenada no seu servidor. Se os valores corresponderem, a solicitação será válida. Caso contrário, ela será inválida.
68
+
69
+ ### Resposta
70
+
71
+ Se a solicitação for válida, responda com o status HTTP `200` e o valor `hub.challenge`. Se a solicitação for inválida, responda com um código de status HTTP do nível 400 ou com qualquer outra opção que não seja o status `200`.
72
+
73
+ Quando você [configurar webhooks](docs/whatsapp/cloud-api/guides/set-up-webhooks#configure-webhooks), enviaremos uma solicitação GET para o ponto de extremidade do webhook. Se retornar o status `200` e o valor `hub.challenge` incluído na solicitação, consideraremos o ponto de extremidade do seu webhook verificado e começaremos a enviar webhooks para você. Se o ponto de extremidade do webhook responder de outra forma, consideraremos o ponto de extremidade não verificado. Nesse caso, os webhooks não serão enviados.
74
+
75
+ ## Solicitações POST
76
+
77
+ Sempre que um evento de webhook for disparado em qualquer campo do webhook que você tiver assinado, uma solicitação POST será enviada para seu ponto de extremidade do webhook, contendo uma carga JSON que descreve o evento.
78
+
79
+ ### Sintaxe da solicitação
80
+
81
+ ```
82
+ POST <CALLBACK_URL>
83
+ Content-Type: application/json
84
+ X-Hub-Signature-256: sha256=<SHA256_PAYLOAD_HASH>
85
+ Content-Length: <CONTENT_LENGTH><JSON_PAYLOAD>
86
+ ```
87
+
88
+ ### Parâmetros de solicitação
89
+
90
+ Espaço reservado
91
+
92
+ Descrição
93
+
94
+ Valor de exemplo
95
+
96
+ `<CALLBACK_URL>`
97
+
98
+ O URL do ponto de extremidade do webhook.
99
+
100
+ `https://www.luckyshrub.com/webhooks`
101
+
102
+ `<CONTENT_LENGTH>`
103
+
104
+ Comprimento do conteúdo em bytes.
105
+
106
+ `492`
107
+
108
+ `<JSON_PAYLOAD>`
109
+
110
+ A carga do corpo do post, formatada em JSON.
111
+
112
+ Consulte as referências sobre [campos](/documentation/business-messaging/whatsapp/webhooks/overview#fields) para ver exemplos de cargas.
113
+
114
+ `<SHA256_PAYLOAD_HASH>`
115
+
116
+ Hash HMAC-SHA256 calculado usando a carga do corpo do post e a [chave secreta do app](/docs/development/create-an-app/app-dashboard/basic-settings#app-secret) como a chave secreta.
117
+
118
+ `b63bb356dff0f1c24379efea2d6ef0b2e2040853339d1bcf13f9018790b1f7d2`
119
+
120
+ ### Validação
121
+
122
+ Para validar a solicitação:
123
+
124
+ Gere um hash HMAC-SHA256 usando a carga JSON como entrada de mensagem e a [chave secreta do app](/docs/development/create-an-app/app-dashboard/basic-settings#app-secret) como a chave secreta. Compare o hash gerado com o atribuído ao cabeçalho `X-Hub-Signature-256` (tudo que aparece depois de `sha256=`).
125
+
126
+ Se os hashes coincidirem, a carga será válida. Capture a carga e processe o conteúdo conforme as necessidades da empresa. Caso não haja correspondência, considere a carga como inválida.
127
+
128
+ Não oferecemos APIs para buscar dados históricos de webhooks. Por isso, capture e armazene a carga de webhooks adequadamente.
129
+
130
+ ### Resposta
131
+
132
+ Se a solicitação for válida, responda com o status HTTP 200. Caso contrário, responda com um status HTTP 400 ou outro diferente de 200.
133
+
134
+ ### Envio em lote
135
+
136
+ As solicitações POST são agregadas e enviadas em lote com um máximo de mil atualizações. No entanto, a criação de lotes não pode ser garantida. Por isso, ajuste seus servidores para lidar com cada solicitação POST individualmente.
137
+
138
+ Se o envio de um solicitação POST para o servidor falhar, tentaremos outra vez imediatamente e depois mais algumas vezes, diminuindo a frequência nas 36 horas seguintes. Seu servidor deverá lidar com a desduplicação nesses casos.
139
+
140
+ As respostas não reconhecidas serão descartadas após 36 horas.
141
+
142
+ ## Configurar webhooks
143
+
144
+ Depois de criar o ponto de extremidade de webhook, navegue até o painel **[Painel de Apps](/apps)** > **WhatsApp** > **Configuração** e adicione o URL do ponto de extremidade de webhook no campo **URL de retorno de chamada** e a string de verificação no campo **Verificar token**.
145
+
146
+ Se você criou o app usando o caso de uso **Conectar-se com clientes pelo WhatsApp**, navegue até **[Painel de Apps](/apps)** > **Casos de uso** > **Personalizar** > **Configuração**.
147
+
148
+ ![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/518348561_1679202599393717_3427225193188619311_n.png?_nc_cat=111&ccb=1-7&_nc_sid=e280be&_nc_ohc=UQpgMszmHO4Q7kNvwF44f6D&_nc_oc=AdmawGYkMCd5C1CtTCLbaC086-bEkjbC6wqwA5feN-B4Mo9BQDDAPhGnODCcJvZlNJs&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=hA8DuR5V7XzvB9L1oTlotw&oh=00_AfqtPSSgm78Cw_R7XXg3SLjlg8-bHcOYTHWVq6zCxLpekw&oe=698E5D30)
149
+
150
+ Se o ponto de extremidade do webhook estiver respondendo corretamente às solicitações GET de verificação, o painel salvará as alterações e será exibida uma lista de campos que podem ser assinados. Dessa forma, você pode [assinar os campos](/documentation/business-messaging/whatsapp/webhooks/overview#fields) que atendem às suas necessidades comerciais.
151
+
152
+ Você pode usar o ponto de extremidade [POST Application Subscriptions](https/docs/graph-api/reference/app/subscriptions#creating) para configurar webhooks como um método alternativo, mas isso exige o uso de um [token do app](/docs/facebook-login/guides/access-tokens#apptokens). Para saber como fazer isso, consulte o documento da borda [Assinaturas](/docs/graph-api/webhooks/subscriptions-edge) da Graph API e use whatsapp\_business\_account como o valor do objeto.
153
+
154
+ Você achou esta página útil?
155
+
156
+ ![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
157
+
158
+ ![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)
@@ -0,0 +1,182 @@
1
+ <!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/messages/group -->
2
+ <!-- Scraped: 2026-01-24T01:09:53.277Z -->
3
+
4
+ # Referência de webhook de mensagens de grupo
5
+
6
+ Updated: 10 de nov de 2025
7
+
8
+ Esta referência descreve os eventos de disparo e o conteúdo da carga do webhook de **mensagens** da conta do WhatsApp Business para mensagens enviadas para um grupo ou recebidas de um grupo.
9
+
10
+ ## Gatilhos
11
+
12
+ - Um usuário do WhatsApp ou uma empresa envia uma mensagem a um grupo.- Um usuário do WhatsApp ou uma empresa recebe uma mensagem em um grupo.
13
+
14
+ ## Sintaxe
15
+
16
+ ```
17
+ {
18
+ "object": "whatsapp_business_account",
19
+ "entry": [
20
+ {
21
+ "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
22
+ "changes": [
23
+ {
24
+ "value": {
25
+ "messaging_product": "whatsapp",
26
+ "metadata": {
27
+ "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
28
+ "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
29
+ },
30
+ "contacts": [
31
+ {
32
+ "profile": {
33
+ "name": "<WHATSAPP_USER_PROFILE_NAME>"
34
+ },
35
+ "wa_id": "<WHATSAPP_USER_ID>",
36
+ "identity_key_hash": "<IDENTITY_KEY_HASH>" <!-- only included if identity change check enabled -->
37
+ }
38
+ ],
39
+ "messages": [
40
+ {
41
+ "from": "<WHATSAPP_USER_PHONE_NUMBER>",
42
+ "group_id": "<GROUP_ID>",
43
+ "id": "<WHATSAPP_MESSAGE_ID>",
44
+ "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
45
+ "text": {
46
+ "body": "<MESSAGE_TEXT_BODY>"
47
+ },
48
+ "type": "<MESSAGE_TYPE>"
49
+ }
50
+ ],
51
+ },
52
+ "field": "messages"
53
+ }
54
+ ]
55
+ }
56
+ ]
57
+ }
58
+ ```
59
+
60
+ ## Parâmetros
61
+
62
+ Espaço reservado
63
+
64
+ Descrição
65
+
66
+ Valor de exemplo
67
+
68
+ `<BUSINESS_DISPLAY_PHONE_NUMBER>`
69
+
70
+ _String_
71
+
72
+ Número de telefone comercial exibido.
73
+
74
+ `15550783881`
75
+
76
+ `<BUSINESS_PHONE_NUMBER_ID>`
77
+
78
+ _String_
79
+
80
+ Identificação do número de telefone comercial.
81
+
82
+ `106540352242922`
83
+
84
+ `<GROUP_ID>`
85
+
86
+ _String_
87
+
88
+ O identificador de string de um grupo feito usando a API de Grupos.
89
+
90
+ Esse campo mostra quando as mensagens são enviadas, recebidas ou lidas em um grupo.
91
+
92
+ [Saiba mais sobre a API de Grupos](/documentation/business-messaging/whatsapp/groups)
93
+
94
+ `"Y2FwaV9ncm91cDoxNzA1NTU1MDEzOToxMjAzNjM0MDQ2OTQyMzM4MjAZD"`
95
+
96
+ `<IDENTITY_KEY_HASH>`
97
+
98
+ _String_
99
+
100
+ Hash de chave de identidade. Esse campo só será incluído se você tiver habilitado o recurso de [verificação de alteração de identidade](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers).
101
+
102
+ `DF2lS5v2W6x=`
103
+
104
+ `<MESSAGE_TEXT_BODY>`
105
+
106
+ _String_
107
+
108
+ Corpo de texto da mensagem.
109
+
110
+ `What do you all think about this?`
111
+
112
+ `<MESSAGE_TYPE>`
113
+
114
+ _String_
115
+
116
+ O tipo de mensagem a ser enviada. Ele muda dependendo da mensagem enviada para o grupo.
117
+
118
+ No momento, a API de Grupos é compatível com:
119
+
120
+ - Texto- Mídia- Modelos baseados em texto- Modelos baseados em mídia
121
+
122
+ `text`
123
+
124
+ `<WHATSAPP_BUSINESS_ACCOUNT_ID>`
125
+
126
+ _String_
127
+
128
+ Identificação da conta do WhatsApp Business.
129
+
130
+ `102290129340398`
131
+
132
+ `<WHATSAPP_MESSAGE_ID>`
133
+
134
+ _String_
135
+
136
+ Identificação da mensagem do WhatsApp.
137
+
138
+ `wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=`
139
+
140
+ `<WEBHOOK_TRIGGER_TIMESTAMP>`
141
+
142
+ _String_
143
+
144
+ Registro de data e hora Unix que indica quando o webhook foi disparado.
145
+
146
+ `1739321024`
147
+
148
+ `<WHATSAPP_USER_PHONE_NUMBER>`
149
+
150
+ _String_
151
+
152
+ 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.
153
+
154
+ `+16505551234`
155
+
156
+ `<WHATSAPP_USER_PROFILE_NAME>`
157
+
158
+ _String_
159
+
160
+ O nome de usuário do WhatsApp exibido no perfil do cliente na plataforma.
161
+
162
+ `Sheena Nelson`
163
+
164
+ `<WHATSAPP_USER_ID>`
165
+
166
+ _String_
167
+
168
+ 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.
169
+
170
+ `16505551234`
171
+
172
+ ## Exemplo
173
+
174
+ ```
175
+ {  "object": "whatsapp_business_account",  "entry": [    {      "id": "102290129340398",      "changes": [        {          "value": {            "messaging_product": "whatsapp",            "metadata": {              "display_phone_number": "15550783881",              "phone_number_id": "106540352242922"            },            "contacts": [              {                "profile": {                  "name": "Tiago Mingo"                },                "wa_id": "16505551234"              }            ],            "messages": [              {                "from": "16505551234",                "group_id": "HBgLMTY1MDM4Nzk0MzkVAgASGBQzQTRBNjU5OUFFRTAzODEwMTQ0RgA",                "id": "wamid.HASDI128HJOPUERIH82ahdasd09ASDHi5>",                "timestamp": "1744344496",                "text": {                  "body": "What does everyone think about this?"                },                "type": "text"              }            ],          },          "field": "messages"        }      ]    }  ]}
176
+ ```
177
+
178
+ Você achou esta página útil?
179
+
180
+ ![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
181
+
182
+ ![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)
@@ -1,13 +1,13 @@
1
1
  <!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/account_update -->
2
- <!-- Scraped: 2025-12-20T17:35:45.924Z -->
2
+ <!-- Scraped: 2026-01-24T01:08:22.310Z -->
3
3
 
4
4
  # Referência do webhook account\_update
5
5
 
6
- Updated: 14 de nov de 2025
6
+ Updated: 5 de dez de 2025
7
7
 
8
8
  Esta referência descreve os eventos de gatilho e o conteúdo da carga do webhook **account\_update** da conta do WhatsApp Business.
9
9
 
10
- O webhook **account\_update** notifica sobre alterações no envio da [verificação da empresa conduzida pelo parceiro](/documentation/business-messaging/whatsapp/solution-providers/partner-led-business-verification), na [taxa internacional de autenticação](/documentation/business-messaging/whatsapp/pricing/authentication-international-rates), na qualificação ou na localização comercial principal de uma conta do WhatsApp Business, quando compartilhada com um [provedor de soluções](/documentation/business-messaging/whatsapp/solution-providers/overview), em caso de [violações de políticas ou termos](/documentation/business-messaging/whatsapp/policy-enforcement) ou quando é excluída.
10
+ O webhook **account\_update** notifica sobre alterações no envio da [verificação da empresa conduzida pelo parceiro](/documentation/business-messaging/whatsapp/solution-providers/partner-led-business-verification) de uma conta do WhatsApp Business, na qualificação para a [taxa internacional de autenticação](/documentation/business-messaging/whatsapp/pricing/authentication-international-rates) ou no ponto comercial principal, quando é compartilhado com um [provedor de soluções](/documentation/business-messaging/whatsapp/solution-providers/overview), em caso de [violações de políticas ou termos](/documentation/business-messaging/whatsapp/policy-enforcement) ou quando é excluída.
11
11
 
12
12
  ## Gatilhos
13
13
 
@@ -136,11 +136,11 @@ Evento da conta do WhatsApp Business ("WABA").
136
136
 
137
137
  Os valores podem ser os seguintes:
138
138
 
139
- `ACCOUNT_DELETED` Indica que a WABA foi excluída.
139
+ `ACCOUNT_DELETED`: indica que a WABA foi excluída.
140
140
 
141
141
  `ACCOUNT_VIOLATION`: indica que a WABA violou uma das nossas [políticas ou termos](/documentation/business-messaging/whatsapp/policy-enforcement).
142
142
 
143
- `AD_ACCOUNT_LINKED` Indica que a WABA foi integrada à API de Mensagens de Marketing Lite por meio do Cadastro Incorporado ou API de Intenção e dá ao parceiro acesso às contas de anúncios.
143
+ `AD_ACCOUNT_LINKED`: indica que a WABA foi integrada à API de Mensagens de Marketing para o WhatsApp por meio do Cadastro Incorporado ou Intent API e dá ao parceiro acesso às contas de anúncios.
144
144
 
145
145
  `AUTH_INTL_PRICE_ELIGIBILITY_UPDATE`: indica que a WABA está qualificada para as [tarifas de autenticação internacional](/documentation/business-messaging/whatsapp/pricing/authentication-international-rates).
146
146
 
@@ -148,13 +148,13 @@ Os valores podem ser os seguintes:
148
148
 
149
149
  `DISABLED_UPDATE`: indica que a WABA violou uma das nossas [políticas ou termos](/documentation/business-messaging/whatsapp/policy-enforcement).
150
150
 
151
- `MM_LITE_TERMS_SIGNED` Indica que a WABA aceitou com sucesso os Termos de Serviço da MM Lite.
151
+ `MM_LITE_TERMS_SIGNED`: indica que a WABA aceitou com sucesso os Termos de Serviço da API de MM para WhatsApp.
152
152
 
153
153
  `PARTNER_ADDED`: indica que a WABA foi compartilhada com um [provedor de soluções](/documentation/business-messaging/whatsapp/solution-providers/overview).
154
154
 
155
- `PARTNER_APP_INSTALLED` Indica que um cliente empresarial concedeu mais uma permissão ao app.
155
+ `PARTNER_APP_INSTALLED`: indica que um cliente empresarial concedeu mais uma permissão ao app.
156
156
 
157
- `PARTNER_APP_UNINSTALLED` Indica que um cliente empresarial desautenticou ou desinstalou o app.
157
+ `PARTNER_APP_UNINSTALLED`: indica que um cliente empresarial desautenticou ou desinstalou o app.
158
158
 
159
159
  `PARTNER_CLIENT_CERTIFICATION_STATUS_UPDATE`: indica que o envio da [verificação da empresa conduzida por parceiro](/documentation/business-messaging/whatsapp/solution-providers/partner-led-business-verification) da WABA foi aprovado, rejeitado ou descartado.
160
160
 
@@ -182,7 +182,7 @@ Registro de data e hora UNIX que indica a hora de início da taxa internacional
182
182
 
183
183
  _Matriz_
184
184
 
185
- As strings com identificações de portfólios empresariais pertencentes ao provedor de tecnologia (ou parceiro de tecnologia) e ao parceiro de solução associado à [solução multiparceiro](/documentation/business-messaging/whatsapp/solution-providers/multi-partner-solutions).
185
+ As strings com identificações de portfólios empresariais pertencentes ao Provedor de Tecnologia (ou Parceiro de Tecnologia) e ao Parceiro de Soluções associado à [solução multiparceiro](/documentation/business-messaging/whatsapp/solution-providers/multi-partner-solutions).
186
186
 
187
187
  `"506914307656634","116133292427920"`
188
188
 
@@ -194,21 +194,21 @@ O motivo da rejeição do envio da verificação da empresa conduzida por parcei
194
194
 
195
195
  Os valores podem ser os seguintes:
196
196
 
197
- `ADDRESS NOT MATCHING` O endereço no envio não corresponde ao endereço no perfil empresarial do cliente. Edite o envio ou peça à empresa para atualizar o perfil e tente novamente.
197
+ `ADDRESS NOT MATCHING`: o endereço no envio não corresponde ao endereço no perfil empresarial do cliente. Edite o envio ou peça à empresa para atualizar o perfil e tente novamente.
198
198
 
199
- `BUSINESS NOT ELIGIBLE` Esta empresa não está qualificada para verificação por meio de informações fornecidas por parceiros. Ainda será possível se inscrever para a verificação da empresa da Meta.
199
+ `BUSINESS NOT ELIGIBLE`: esta empresa não está qualificada para verificação por meio de informações fornecidas por parceiros. Ainda será possível se inscrever para a verificação da empresa da Meta.
200
200
 
201
- `LEGAL NAME NOT MATCHING` A razão social no envio não corresponde à razão social no perfil empresarial do cliente. Edite o envio ou peça à empresa para atualizar o perfil e tente novamente.
201
+ `LEGAL NAME NOT MATCHING`: a razão social no envio não corresponde à razão social no perfil empresarial do cliente. Edite o envio ou peça à empresa para atualizar o perfil e tente novamente.
202
202
 
203
- `LEGAL NAME NOT FOUND IN DOCUMENTS` Não foi possível verificar esta empresa devido a um problema com os documentos enviados. Isso pode acontecer por diversos motivos, incluindo os seguintes:
203
+ `LEGAL NAME NOT FOUND IN DOCUMENTS`: não foi possível verificar esta empresa devido a um problema com os documentos enviados. Isso pode acontecer por diversos motivos, incluindo os seguintes:
204
204
 
205
205
  - A razão social da empresa não é mencionada nos documentos- O texto do documento não está claro ou é difícil de ler.
206
206
 
207
- `MALFORMED DOCUMENTS` Não foi possível abrir os documentos fornecidos. Isso pode acontecer se os arquivos estiverem corrompidos, protegidos por senha ou se houver outros problemas ao abrir o documento.
207
+ `MALFORMED DOCUMENTS`: não foi possível abrir os documentos fornecidos. Isso pode acontecer se os arquivos estiverem corrompidos, protegidos por senha ou se houver outros problemas ao abrir o documento.
208
208
 
209
- `NONE` Indica que o envio não foi rejeitado.
209
+ `NONE`: indica que o envio não foi rejeitado.
210
210
 
211
- `WEBSITE NOT MATCHING` O site no envio não corresponde ao site no perfil empresarial do cliente. Edite o envio ou peça à empresa para atualizar o perfil e tente novamente.
211
+ `WEBSITE NOT MATCHING`: o site no envio não corresponde ao site no perfil empresarial do cliente. Edite o envio ou peça à empresa para atualizar o perfil e tente novamente.
212
212
 
213
213
  `LEGAL NAME NOT FOUND IN DOCUMENTS`
214
214
 
@@ -236,15 +236,15 @@ O status do envio da [verificação da empresa conduzida pelo parceiro](/documen
236
236
 
237
237
  Os valores podem ser os seguintes:
238
238
 
239
- `APPROVED` O envio foi analisado e aprovado.
239
+ `APPROVED`: o envio foi analisado e aprovado.
240
240
 
241
- `DISCARDED` O envio foi descartado devido a problemas técnicos ou não há progresso há algum tempo.
241
+ `DISCARDED`: o envio foi descartado devido a problemas técnicos ou não há progresso há algum tempo.
242
242
 
243
- `FAILED` O envio foi analisado e rejeitado. Consulte o campo rejection\_reasons para ver mais informações sobre o motivo.
243
+ `FAILED`: o envio foi analisado e rejeitado. Consulte o campo rejection\_reasons para ver mais informações sobre o motivo.
244
244
 
245
- `PENDING` O envio está aguardando análise.
245
+ `PENDING`: o envio está aguardando análise.
246
246
 
247
- `REVOKED` O envio foi revogado.
247
+ `REVOKED`: o envio foi revogado.
248
248
 
249
249
  `APPROVED`
250
250
 
@@ -254,7 +254,7 @@ _String_
254
254
 
255
255
  O tipo de violação.
256
256
 
257
- Veja [Violações](/documentation/business-messaging/whatsapp/policy-enforcement-violations) para consultar uma lista de valores possíveis.
257
+ Consulte [Violações](/documentation/business-messaging/whatsapp/policy-enforcement-violations) para ver uma lista de valores possíveis.
258
258
 
259
259
  `ADULT`
260
260
 
@@ -266,11 +266,11 @@ Estado de banimento da WABA.
266
266
 
267
267
  Os valores podem ser os seguintes:
268
268
 
269
- `DISABLE` Indica que a WABA está desabilitada.
269
+ `DISABLE`: indica que a WABA está desabilitada.
270
270
 
271
- `REINSTATE` Indica que a WABA foi restabelecida.
271
+ `REINSTATE`: indica que a WABA foi restabelecida.
272
272
 
273
- `SCHEDULE_FOR_DISABLE` Indica que a WABA foi programada para ser desabilitada.
273
+ `SCHEDULE_FOR_DISABLE`: indica que a WABA foi programada para ser desabilitada.
274
274
 
275
275
  `REINSTATE`
276
276
 
@@ -330,7 +330,7 @@ Identificação da conta do WhatsApp Business.
330
330
  {  "object": "whatsapp_business_account",  "entry": [    {      "id": "102290129340398",      "time": 1743451903,      "changes": [        {          "value": {            "event": "DISABLED_UPDATE",            "ban_info": {              "waba_ban_state": "REINSTATE",              "waba_ban_date": "April 17, 2025"            }          },          "field": "account_update"        }      ]    }  ]}
331
331
  ```
332
332
 
333
- ### Termos de Serviço da MM Lite
333
+ ### Termos de Serviço da API de MM para WhatsApp
334
334
 
335
335
  ```
336
336
  {  "object": "whatsapp_business_account",  "entry": [    {      "id": "2949482758682047",      "time": 1744823932,      "changes": [        {          "field": "account_update",          "value": {            "event": "MM_LITE_TERMS_SIGNED",            "waba_info": {              "owner_business_id": "2329417887457253",              "waba_id": "980198427658004"            }          }        }      ]    }  ]}
@@ -369,7 +369,7 @@ Identificação da conta do WhatsApp Business.
369
369
  ### Atualização de níveis de preços
370
370
 
371
371
  ```
372
- {  "object": "whatsapp_business_account",  "entry": [    {      "id": "102290129340398",      "time": 1743451903,      "changes": [        {          "value": {            "volume_tier_info": {                "tier_update_time": 1743451903,                "pricing_category": "UTILITY",                "tier": "25000001:50000000",                "effective_month": "2025-11",                "region": "INDIA"            },            "event": "VOLUME_BASED_PRICING_TIER_UPDATE"          },          "field": "account_update"        }      ]    }  ]}
372
+ {  "object": "whatsapp_business_account",  "entry": [    {      "id": "102290129340398",      "time": 1743451903,      "changes": [        {          "value": {            "volume_tier_info": {                "tier_update_time": 1743451903,                "pricing_category": "UTILITY",                "tier": "25000001:50000000",                "effective_month": "2025-11",                "region": "India"            },            "event": "VOLUME_BASED_PRICING_TIER_UPDATE"          },          "field": "account_update"        }      ]    }  ]}
373
373
  ```
374
374
 
375
375
  Você achou esta página útil?