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.
- package/docs/ativos_da_conta/outros_ativos/display_names.md +9 -9
- package/docs/ativos_da_conta/outros_ativos/official_business_accounts.md +27 -27
- package/docs/ativos_da_conta/telefones_comerciais/phone_numbers.md +151 -27
- package/docs/business_profiles.md +72 -0
- package/docs/business_scoped_user_ids.md +1533 -0
- package/docs/dados_privacidade_e_politica/encryption.md +1 -1
- package/docs/flows/changelog.md +6 -6
- package/docs/flows/gettingstarted/health_insurance.md +12 -6
- package/docs/flows/gettingstarted/personalised_offer.md +6 -6
- package/docs/flows/gettingstarted/pre_approved_loan.md +6 -6
- package/docs/flows/gettingstarted/purchase_intent.md +2 -2
- package/docs/flows/gettingstarted.md +5 -5
- package/docs/flows/guias.md +1 -1
- package/docs/flows/playground.md +1 -1
- package/docs/flows/referencia.md +1 -1
- package/docs/flows/support.md +3 -3
- package/docs/flows.md +2 -2
- package/docs/insights/analytics.md +200 -66
- package/docs/ligacoes/call_settings.md +129 -57
- package/docs/ligacoes/calling.md +33 -16
- package/docs/ligacoes/integration_examples.md +526 -0
- package/docs/ligacoes/pricing.md +11 -300
- package/docs/ligacoes/sandbox.md +160 -0
- package/docs/ligacoes/video_calling.md +8 -0
- package/docs/mensagens/interactive_media_carousel_messages.md +256 -0
- package/docs/mensagens/interactive_product_carousel_messages.md +181 -0
- package/docs/mensagens/limites_de_mensagens/messaging_limits.md +16 -12
- package/docs/mensagens/recursos_adicionais/media.md +15 -16
- package/docs/mensagens/recursos_adicionais/payload_encryption.md +1 -1
- package/docs/mensagens/tipos_de_mensagens/audio_messages.md +11 -11
- package/docs/mensagens/tipos_de_mensagens/interactive_flow_messages.md +1 -1
- package/docs/mensagens/tipos_de_mensagens/message_with_link.md +1 -1
- package/docs/mensagens_de_marketing/changelog.md +299 -0
- package/docs/mensagens_de_marketing/features.md +184 -0
- package/docs/mensagens_de_marketing/implementacao/get_started.md +17 -21
- package/docs/mensagens_de_marketing/implementacao/send_marketing_messages.md +50 -45
- package/docs/mensagens_de_marketing/measure_conversion.md +132 -0
- package/docs/mensagens_de_marketing/onboarding.md +282 -0
- package/docs/mensagens_de_marketing/recursos/automatic_creative_optimization.md +1 -1
- package/docs/mensagens_de_marketing/recursos/conversion_measurement.md +1 -1
- package/docs/mensagens_de_marketing/visao_geral/overview.md +11 -9
- package/docs/messaging_limits/upcoming_changes.md +1 -1
- package/docs/modelos/authentication_templates/bulk_management.md +145 -0
- package/docs/modelos/authentication_templates/template_preview.md +109 -0
- package/docs/modelos/gerenciamento_de_modelos/components.md +23 -23
- package/docs/modelos/gerenciamento_de_modelos/template_media.md +1 -1
- package/docs/modelos/modelos_de_marketing/marketing_templates.md +20 -20
- package/docs/modelos/modelos_de_marketing/per_user_limits.md +7 -5
- package/docs/modelos/portfolio_pacing.md +30 -0
- package/docs/modelos/visao_geral/overview.md +17 -17
- package/docs/pagamentos/payments_br/cards.md +8 -0
- package/docs/parceiros/gerenciamento/suporte_ao_parceiro/transferring_wabas_to_customers.md +1 -1
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/onboarding_business_app_users.md +364 -75
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/overview.md +34 -30
- package/docs/parceiros/migrate_existing_whatsapp_number_to_a_business_account.md +40 -0
- package/docs/parceiros/obo_model_deprecation.md +32 -0
- package/docs/parceiros/seja_um_parceiro/get_started_for_solution_partners.md +42 -42
- package/docs/parceiros/seja_um_parceiro/get_started_for_tech_providers.md +38 -142
- package/docs/recado/precos/pricing.md +82 -50
- package/docs/recado/precos/pricing_authentication_international_rates.md +16 -18
- package/docs/recado/precos/pricing_updates_to_pricing.md +1 -1
- package/docs/recado/sobre_a_plataforma/about_the_platform.md +80 -24
- package/docs/recado/sobre_a_plataforma/access_tokens.md +19 -19
- package/docs/referencia/bot_do_whatsapp_business/bot_details_api.md +4 -758
- package/docs/referencia/business/add_phone_numbers_api.md +4 -722
- package/docs/referencia/business/business_account_api.md +8 -0
- package/docs/referencia/business/client_whatsapp_business_accounts_api.md +4 -1002
- package/docs/referencia/business/owned_whatsapp_business_accounts.md +4 -798
- package/docs/referencia/business/whatsapp_business_accounts_api.md +4 -1546
- package/docs/referencia/business/whatsapp_business_partner_onboarding_to_mm_lite_api.md +4 -779
- package/docs/referencia/business/whatsapp_business_pre_verified_phone_number_sharing_api.md +4 -786
- package/docs/referencia/business/whatsapp_business_pre_verified_phone_numbers_api.md +4 -882
- package/docs/referencia/changelog.md +1837 -3
- package/docs/referencia/conta_do_whatsapp_business/assigned_users_management_api.md +4 -2198
- package/docs/referencia/conta_do_whatsapp_business/business_account_api.md +4 -263
- package/docs/referencia/conta_do_whatsapp_business/business_account_extended_credits_api.md +4 -271
- package/docs/referencia/conta_do_whatsapp_business/conversational_automation_api.md +4 -778
- package/docs/referencia/conta_do_whatsapp_business/flows_api.md +4 -1528
- package/docs/referencia/conta_do_whatsapp_business/in_progress_on_behalf_requests_api.md +1 -1
- package/docs/referencia/conta_do_whatsapp_business/migration_intent_api.md +4 -1577
- package/docs/referencia/conta_do_whatsapp_business/obo_mobility_intent_api.md +1 -1
- package/docs/referencia/conta_do_whatsapp_business/phone_number_management_api.md +4 -1682
- package/docs/referencia/conta_do_whatsapp_business/schedules_api.md +4 -1768
- package/docs/referencia/conta_do_whatsapp_business/set_obo_mobility_intent_api.md +1 -1
- package/docs/referencia/conta_do_whatsapp_business/set_solution_migration_intent_api.md +1 -1
- package/docs/referencia/conta_do_whatsapp_business/subscribed_apps_api.md +4 -2174
- package/docs/referencia/conta_do_whatsapp_business/template_api.md +4 -972
- package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_activities_api.md +4 -838
- package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_api.md +4 -1380
- package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_solutions_list_api.md +4 -850
- package/docs/referencia/groups/groups_invite_link_api.md +8 -0
- package/docs/referencia/groups/groups_join_requests_api.md +8 -0
- package/docs/referencia/groups/groups_participants_api.md +8 -0
- package/docs/referencia/groups/groups_query_api.md +8 -0
- package/docs/referencia/grupo/groups_invite_link_api.md +4 -300
- package/docs/referencia/grupo/groups_join_requests_api.md +4 -682
- package/docs/referencia/grupo/groups_participants_api.md +4 -270
- package/docs/referencia/grupo/groups_query_api.md +4 -432
- package/docs/referencia/historico_de_mensagens/whatsapp_business_message_history_events_api.md +4 -862
- package/docs/referencia/inscricao/application_connected_client_businesses.md +4 -808
- package/docs/referencia/inscricao/application_solutions_api.md +4 -870
- package/docs/referencia/inscricao/solution_creation_api.md +4 -820
- package/docs/referencia/intencao_de_migracao_da_conta_do_whatsapp_business/migration_intent_details_api.md +4 -720
- package/docs/referencia/midias/media_api.md +4 -338
- package/docs/referencia/midias/media_download_api.md +4 -156
- package/docs/referencia/numero_da_conta_do_whatsapp/whatsapp_account_number_api.md +4 -774
- package/docs/referencia/perfil_do_whatsapp_business/whatsapp_business_profile_node_api.md +4 -1490
- package/docs/referencia/solucao_do_whatsapp_business/accept_deactivation_request_api.md +4 -758
- package/docs/referencia/solucao_do_whatsapp_business/access_token_api.md +4 -700
- package/docs/referencia/solucao_do_whatsapp_business/reject_deactivation_request_api.md +4 -808
- package/docs/referencia/solucao_do_whatsapp_business/send_deactivation_request_api.md +4 -774
- package/docs/referencia/solucao_do_whatsapp_business/solution_accept_api.md +4 -808
- package/docs/referencia/solucao_do_whatsapp_business/solution_details_api.md +4 -764
- package/docs/referencia/solucao_do_whatsapp_business/solution_reject_api.md +4 -794
- package/docs/referencia/telefone_do_whatsapp_business/block_api.md +4 -538
- package/docs/referencia/telefone_do_whatsapp_business/business_compliance_information_api.md +4 -1604
- package/docs/referencia/telefone_do_whatsapp_business/business_encryption_api.md +4 -1398
- package/docs/referencia/telefone_do_whatsapp_business/calling_api.md +4 -594
- package/docs/referencia/telefone_do_whatsapp_business/encrypted_messages_api.md +4 -478
- package/docs/referencia/telefone_do_whatsapp_business/groups_management_api.md +4 -481
- package/docs/referencia/telefone_do_whatsapp_business/marketing_messages_lite_api.md +4 -311
- package/docs/referencia/telefone_do_whatsapp_business/media_upload_api.md +4 -184
- package/docs/referencia/telefone_do_whatsapp_business/message_api.md +4 -1794
- package/docs/referencia/telefone_do_whatsapp_business/phone_number_api.md +4 -373
- package/docs/referencia/telefone_do_whatsapp_business/phone_number_deregister_api.md +4 -710
- package/docs/referencia/telefone_do_whatsapp_business/phone_number_registration.md +4 -776
- package/docs/referencia/telefone_do_whatsapp_business/phone_number_verification_request_code_api.md +4 -730
- package/docs/referencia/telefone_do_whatsapp_business/register_api.md +4 -407
- package/docs/referencia/telefone_do_whatsapp_business/settings_api.md +4 -670
- package/docs/referencia/telefone_do_whatsapp_business/verify_code_api.md +4 -742
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_message_history_api.md +4 -928
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_official_business_account_status_api.md +4 -1536
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_phone_number_api.md +4 -1596
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_profile_api.md +4 -1474
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_qr_code_api.md +4 -1175
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_qr_code_management_api.md +4 -1311
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/request_verification_code_api.md +4 -774
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/verify_code_api.md +4 -764
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/whatsapp_business_pre_verified_phone_number_api.md +4 -1378
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/whatsapp_business_pre_verified_phone_number_partners_api.md +4 -816
- package/docs/referencia/usuario/assigned_whatsapp_business_accounts_api.md +4 -860
- package/docs/referencia/webhooks/whatsapp_incoming_webhook_payload.md +4 -1651
- package/docs/referencia/whatsapp_business_account/extended_credits_api.md +8 -0
- package/docs/referencia/whatsapp_business_phone_number/commerce_settings_api.md +8 -0
- package/docs/suporte/error_codes.md +88 -89
- package/docs/suporte/migrating_from_onprem_to_cloud.md +222 -0
- package/docs/suporte/support.md +77 -186
- package/docs/suporte.md +77 -186
- package/docs/throughput.md +60 -0
- package/docs/upcoming_messaging_limits_changes.md +132 -0
- package/docs/visao_geral/overview.md +354 -306
- package/docs/webhooks/create_webhook_endpoint.md +158 -0
- package/docs/webhooks/reference/messages/group.md +182 -0
- package/docs/webhooks/referencia/account_update.md +27 -27
- package/docs/webhooks/referencia/messages/status.md +35 -35
- package/docs/webhooks/visao_geral/message_echoes.md +1 -1
- package/docs/webhooks/visao_geral/overview.md +23 -15
- package/package.json +1 -1
|
@@ -1,19 +1,19 @@
|
|
|
1
1
|
<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/messages/status -->
|
|
2
|
-
<!-- Scraped:
|
|
2
|
+
<!-- Scraped: 2026-01-24T01:10:47.041Z -->
|
|
3
3
|
|
|
4
4
|
# Referência do webhook de mensagens de status
|
|
5
5
|
|
|
6
|
-
Updated:
|
|
6
|
+
Updated: 20 de nov de 2025
|
|
7
7
|
|
|
8
8
|
Esta referência descreve os eventos de gatilho e o conteúdo da carga do webhook de **mensagens** de status da conta do WhatsApp Business.
|
|
9
9
|
|
|
10
10
|
## Gatilhos
|
|
11
11
|
|
|
12
|
-
- Sua mensagem é enviada a um usuário do WhatsApp.- Sua mensagem é entregue ao dispositivo de um usuário do WhatsApp.- Sua mensagem é exibida (ou seja, "lida") no cliente do WhatsApp no dispositivo de um usuário do WhatsApp.- Não é possível enviar sua mensagem a um usuário do WhatsApp.- Não é possível entregar
|
|
12
|
+
- Sua mensagem é enviada a um usuário do WhatsApp.- Sua mensagem é entregue ao dispositivo de um usuário do WhatsApp.- Sua mensagem é exibida (ou seja, "lida") no cliente do WhatsApp no dispositivo de um usuário do WhatsApp.- Não é possível enviar sua mensagem a um usuário do WhatsApp.- Não é possível entregar a mensagem ao dispositivo de um usuário do WhatsApp.- Sua mensagem é enviada a um usuário do WhatsApp em uma conversa em grupo.- A mensagem de voz é reproduzida pelo dispositivo do usuário do WhatsApp.
|
|
13
13
|
|
|
14
14
|
Os gatilhos acima também se aplicam a usuários do WhatsApp que fazem parte de uma conversa em grupo.
|
|
15
15
|
|
|
16
|
-
Um status é considerado lido somente se tiver sido entregue. Em alguns casos,
|
|
16
|
+
Um status é considerado lido somente se tiver sido entregue. Em alguns casos (por exemplo, quando o usuário recebe uma mensagem enquanto está na tela da conversa), a mensagem é entregue e lida ao mesmo tempo. Nesses casos, o webhook "entregue" não é enviado, porque fica implícito que a mensagem foi entregue depois de ter sido lida. Esse comportamento é resultado de uma otimização interna.
|
|
17
17
|
|
|
18
18
|
## Sintaxe
|
|
19
19
|
|
|
@@ -119,21 +119,21 @@ Identificação do número de telefone comercial.
|
|
|
119
119
|
|
|
120
120
|
_String_
|
|
121
121
|
|
|
122
|
-
[Categoria
|
|
122
|
+
[Categoria da conversa](/documentation/business-messaging/whatsapp/pricing#conversation-categories). Os valores podem ser os seguintes:
|
|
123
123
|
|
|
124
|
-
`authentication
|
|
124
|
+
`authentication`: indica uma conversa de autenticação.
|
|
125
125
|
|
|
126
|
-
`authentication_international
|
|
126
|
+
`authentication_international`: indica uma conversa de [autenticação internacional](/documentation/business-messaging/whatsapp/pricing/authentication-international-rates).
|
|
127
127
|
|
|
128
|
-
`marketing
|
|
128
|
+
`marketing`: indica uma conversa de marketing.
|
|
129
129
|
|
|
130
|
-
`marketing_lite
|
|
130
|
+
`marketing_lite`: indica uma conversa da [API de Mensagens de Marketing para WhatsApp](/documentation/business-messaging/whatsapp/marketing-messages/overview).
|
|
131
131
|
|
|
132
|
-
`referral_conversion
|
|
132
|
+
`referral_conversion`: indica uma conversa com ponto de entrada gratuito.
|
|
133
133
|
|
|
134
|
-
`service
|
|
134
|
+
`service`: indica uma conversa de serviço.
|
|
135
135
|
|
|
136
|
-
`utility
|
|
136
|
+
`utility`: indica uma conversa de utilidade.
|
|
137
137
|
|
|
138
138
|
`service`
|
|
139
139
|
|
|
@@ -181,7 +181,7 @@ Link para a [documentação de códigos de erro](/documentation/business-messagi
|
|
|
181
181
|
|
|
182
182
|
_String_
|
|
183
183
|
|
|
184
|
-
[
|
|
184
|
+
Detalhes do [código de erro](/documentation/business-messaging/whatsapp/support/error-codes).
|
|
185
185
|
|
|
186
186
|
`In order to maintain a healthy ecosystem engagement, the message failed to be delivered.`
|
|
187
187
|
|
|
@@ -197,7 +197,7 @@ _String_
|
|
|
197
197
|
|
|
198
198
|
_String_
|
|
199
199
|
|
|
200
|
-
[
|
|
200
|
+
Título do [código de erro](/documentation/business-messaging/whatsapp/support/error-codes). Esse valor é igual ao valor da propriedade `message`.
|
|
201
201
|
|
|
202
202
|
`This message was not delivered to maintain healthy ecosystem engagement.`
|
|
203
203
|
|
|
@@ -233,19 +233,19 @@ _String_
|
|
|
233
233
|
|
|
234
234
|
Categoria de preço ([taxa](/documentation/business-messaging/whatsapp/pricing#rates)) aplicada em caso de cobrança. Os valores podem ser os seguintes:
|
|
235
235
|
|
|
236
|
-
`authentication
|
|
236
|
+
`authentication`: indica a taxa de autenticação aplicada.
|
|
237
237
|
|
|
238
|
-
`authentication-international
|
|
238
|
+
`authentication-international`: indica a aplicação da taxa internacional de autenticação.
|
|
239
239
|
|
|
240
|
-
`marketing
|
|
240
|
+
`marketing`: indica a aplicação da taxa de marketing.
|
|
241
241
|
|
|
242
|
-
`marketing_lite
|
|
242
|
+
`marketing_lite`: indica a aplicação de preços da [API de Mensagens de Marketing Lite](/docs/whatsapp/marketing-messages-lite-api).
|
|
243
243
|
|
|
244
|
-
`referral_conversion
|
|
244
|
+
`referral_conversion`: indica uma [conversa com ponto de entrada gratuito](/documentation/business-messaging/whatsapp/pricing#free-entry-point-conversations).
|
|
245
245
|
|
|
246
|
-
`service
|
|
246
|
+
`service`: indica a taxa de serviço aplicada.
|
|
247
247
|
|
|
248
|
-
`utility
|
|
248
|
+
`utility`: indica a taxa de utilidade aplicada.
|
|
249
249
|
|
|
250
250
|
`service`
|
|
251
251
|
|
|
@@ -255,9 +255,9 @@ _String_
|
|
|
255
255
|
|
|
256
256
|
Modelo de preços. Os valores podem ser os seguintes:
|
|
257
257
|
|
|
258
|
-
`CBP
|
|
258
|
+
`CBP`: indica a aplicação de preços baseados em conversas. Esse valor só será definido se o webhook tiver sido enviado antes de 1º de julho de 2025.
|
|
259
259
|
|
|
260
|
-
`PMP
|
|
260
|
+
`PMP`: indica a aplicação de [preços por mensagem](/documentation/business-messaging/whatsapp/pricing).
|
|
261
261
|
|
|
262
262
|
`PMP`
|
|
263
263
|
|
|
@@ -267,11 +267,11 @@ _String_
|
|
|
267
267
|
|
|
268
268
|
Tipo de preços.
|
|
269
269
|
|
|
270
|
-
`regular
|
|
270
|
+
`regular`: indica que a mensagem é faturável.
|
|
271
271
|
|
|
272
|
-
`free_customer_service
|
|
272
|
+
`free_customer_service`: indica que a mensagem é gratuita, porque era uma mensagem de modelo de utilidade ou uma mensagem que não pertence a um modelo, enviada dentro de uma janela de atendimento ao cliente.
|
|
273
273
|
|
|
274
|
-
`free_entry_point
|
|
274
|
+
`free_entry_point`: indica que a mensagem é gratuita, porque ela foi enviada dentro de uma janela aberta de ponto de entrada gratuito.
|
|
275
275
|
|
|
276
276
|
`regular`
|
|
277
277
|
|
|
@@ -281,25 +281,25 @@ _String_
|
|
|
281
281
|
|
|
282
282
|
Status da mensagem. Os valores podem ser os seguintes:
|
|
283
283
|
|
|
284
|
-
`delivered
|
|
284
|
+
`delivered`: indica que a mensagem foi entregue no dispositivo do usuário do WhatsApp.
|
|
285
285
|
|
|
286
|
-
- Equivalente na interface do usuário do WhatsApp: dois
|
|
286
|
+
- Equivalente na interface do usuário do WhatsApp: dois selos de verificação.
|
|
287
287
|
|
|
288
|
-
`failed
|
|
288
|
+
`failed`: indica falha ao enviar ou entregar a mensagem no dispositivo do usuário do WhatsApp.
|
|
289
289
|
|
|
290
290
|
- Equivalente na interface do usuário do WhatsApp: triângulo de erro vermelho.
|
|
291
291
|
|
|
292
|
-
`played
|
|
292
|
+
`played`: indica a primeira reprodução da mensagem de voz pelo dispositivo do usuário do WhatsApp.
|
|
293
293
|
|
|
294
294
|
- Equivalente na interface do usuário do WhatsApp: microfone azul.
|
|
295
295
|
|
|
296
|
-
`read
|
|
296
|
+
`read`: indica que a mensagem foi exibida em uma conversa aberta no dispositivo do usuário do WhatsApp.
|
|
297
297
|
|
|
298
298
|
- Equivalente na interface do usuário do WhatsApp: dois traços azuis.
|
|
299
299
|
|
|
300
|
-
`sent
|
|
300
|
+
`sent`: indica que a mensagem foi enviada com sucesso dos nossos servidores.
|
|
301
301
|
|
|
302
|
-
- Equivalente na interface do usuário do WhatsApp: um
|
|
302
|
+
- Equivalente na interface do usuário do WhatsApp: um selo de verificação.
|
|
303
303
|
|
|
304
304
|
`read`
|
|
305
305
|
|
|
@@ -309,7 +309,7 @@ _String_
|
|
|
309
309
|
|
|
310
310
|
Número de telefone do usuário ou ID do grupo do WhatsApp.
|
|
311
311
|
|
|
312
|
-
O valor corresponde ao número de telefone do usuário do WhatsApp, quando a mensagem é enviada diretamente a ele
|
|
312
|
+
O valor corresponde ao número de telefone do usuário do WhatsApp, quando a mensagem é enviada diretamente a ele ou à [identificação do grupo](/documentation/business-messaging/whatsapp/groups) quando ela é enviada a uma identificação do grupo. Nesse último caso, o número de telefone do usuário do WhatsApp será atribuído à propriedade `recipient_participant_id`.
|
|
313
313
|
|
|
314
314
|
`16505551234`
|
|
315
315
|
|
|
@@ -345,7 +345,7 @@ Este exemplo de webhook descreve uma mensagem de marketing que foi enviada com s
|
|
|
345
345
|
{ "object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "statuses": [ { "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=", "status": "sent", "timestamp": "1750030073", "recipient_id": "16505551234", "conversation": { "id": "72b14d6bd5407799e66f64d1b338e567", "expiration_timestamp": "1750116480", "origin": { "type": "marketing" } }, "pricing": { "billable": true, "pricing_model": "PMP", "type": "regular", "category": "marketing" } } ] }, "field": "messages" } ] } ]}
|
|
346
346
|
```
|
|
347
347
|
|
|
348
|
-
Este exemplo de webhook v24.0 descreve uma mensagem de marketing exibida no WhatsApp do cliente (ou seja, "lida"). Nesse caso, o objeto `conversation` foi omitido porque se trata de um webhook v24.0
|
|
348
|
+
Este exemplo de webhook v24.0 descreve uma mensagem de marketing exibida no WhatsApp do cliente (ou seja, "lida"). Nesse caso, o objeto `conversation` foi omitido porque se trata de um webhook v24.0. Já o objeto `pricing` foi omitido porque estava sendo exibido em um webhook de mensagens de status entregues associado (o objeto pode aparecer apenas em um ou no outro).
|
|
349
349
|
|
|
350
350
|
```
|
|
351
351
|
{ "object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "statuses": [ { "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=", "status": "sent", "timestamp": "1750030073", "recipient_id": "16505551234" } ] }, "field": "messages" } ] } ]}
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/overview -->
|
|
2
|
-
<!-- Scraped:
|
|
2
|
+
<!-- Scraped: 2026-01-24T01:07:53.165Z -->
|
|
3
3
|
|
|
4
4
|
# Webhooks
|
|
5
5
|
|
|
6
|
-
Updated:
|
|
6
|
+
Updated: 2 de dez de 2025
|
|
7
7
|
|
|
8
8
|
Este documento descreve o que são webhooks e como eles são usados pela Plataforma do WhatsApp Business.
|
|
9
9
|
|
|
@@ -27,13 +27,15 @@ Você precisará das seguintes permissões para receber webhooks:
|
|
|
27
27
|
|
|
28
28
|
- **whatsapp\_business\_messaging**: para webhooks de **mensagens**- **whatsapp\_business\_management**: para todos os outros webhooks
|
|
29
29
|
|
|
30
|
-
Caso você seja um desenvolvedor direto,
|
|
30
|
+
Caso você seja um desenvolvedor direto, utilize o usuário do sistema para conceder essas permissões ao app ao gerar o [token do sistema](/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens)).
|
|
31
31
|
|
|
32
|
-
Caso seja um [provedor de soluções](/documentation/business-messaging/whatsapp/solution-providers/overview) e precise dessas permissões para fornecer serviços adequados aos clientes, você deverá receber aprovação para acesso avançado às permissões por meio da [Análise do App](/docs/app-review). Depois disso, os clientes
|
|
32
|
+
Caso seja um [provedor de soluções](/documentation/business-messaging/whatsapp/solution-providers/overview) e precise dessas permissões para fornecer serviços adequados aos clientes, você deverá receber aprovação para acesso avançado às permissões por meio da [Análise do App](/docs/app-review). Depois disso, os clientes comerciais poderão conceder essas permissões ao seu app durante a integração.
|
|
33
33
|
|
|
34
34
|
## Campos
|
|
35
35
|
|
|
36
|
-
Depois de criar e configurar
|
|
36
|
+
Depois de [criar e configurar](/documentation/business-messaging/whatsapp/webhooks/create-webhook-endpoint) seu ponto de extremidade de webhook (ou de configurar um [ponto de extremidade de webhook de teste](/documentation/business-messaging/whatsapp/webhooks/set-up-whatsapp-echo-bot)), use o painel **[Painel de Apps](/apps)** > **WhatsApp** > **Configuração** para assinar campos específicos de webhook.
|
|
37
|
+
|
|
38
|
+
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**.
|
|
37
39
|
|
|
38
40
|
Nome do campo
|
|
39
41
|
|
|
@@ -41,7 +43,7 @@ Descrição
|
|
|
41
43
|
|
|
42
44
|
[account\_alerts](/documentation/business-messaging/whatsapp/webhooks/reference/account_alerts)
|
|
43
45
|
|
|
44
|
-
O webhook **account\_alerts** notifica você sobre alterações no [limite de mensagens](/documentation/business-messaging/whatsapp/messaging-limits), [perfil empresarial](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#business-profiles) e status da [](/documentation/business-messaging/whatsapp/whatsapp-business-accounts#official-business-account)
|
|
46
|
+
O webhook **account\_alerts** notifica você sobre alterações no [limite de mensagens](/documentation/business-messaging/whatsapp/messaging-limits), [perfil empresarial](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#business-profiles) e status da [conta comercial oficial](/documentation/business-messaging/whatsapp/whatsapp-business-accounts#official-business-account) de um número de telefone comercial.
|
|
45
47
|
|
|
46
48
|
[account\_review\_update](/documentation/business-messaging/whatsapp/webhooks/reference/account_review_update)
|
|
47
49
|
|
|
@@ -61,7 +63,7 @@ O webhook **business\_capability\_update** notifica você sobre alterações de
|
|
|
61
63
|
|
|
62
64
|
[history](/documentation/business-messaging/whatsapp/webhooks/reference/history)
|
|
63
65
|
|
|
64
|
-
O webhook
|
|
66
|
+
O webhook **history** é usado para sincronizar o [histórico de conversas do app WhatsApp Business](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users) de um cliente comercial integrado por um provedor de soluções.
|
|
65
67
|
|
|
66
68
|
[message\_template\_components\_update](/documentation/business-messaging/whatsapp/webhooks/reference/message_template_components_update)
|
|
67
69
|
|
|
@@ -105,7 +107,7 @@ O webhook **smb\_app\_state\_sync** é usado para sincronizar contatos de [usuá
|
|
|
105
107
|
|
|
106
108
|
[smb\_message\_echoes](/documentation/business-messaging/whatsapp/webhooks/reference/smb_message_echoes)
|
|
107
109
|
|
|
108
|
-
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
|
|
110
|
+
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 comercial 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.
|
|
109
111
|
|
|
110
112
|
[template\_category\_update](/documentation/business-messaging/whatsapp/webhooks/reference/template_category_update)
|
|
111
113
|
|
|
@@ -117,9 +119,9 @@ O webhook **user\_preferences** notifica você sobre as alterações nas [prefer
|
|
|
117
119
|
|
|
118
120
|
## Como substituir webhooks
|
|
119
121
|
|
|
120
|
-
É possível usar um ponto de extremidade de webhook alternativo para webhooks de mensagens na sua conta do WhatsApp Business (WABA
|
|
122
|
+
É possível usar um ponto de extremidade de webhook alternativo para webhooks de mensagens na sua conta do WhatsApp Business (WABA) ou número de telefone comercial. Isso pode ser útil para fins de teste ou se você for um provedor de soluções e quiser usar pontos de extremidade de webhook únicos para cada um dos seus clientes integrados.
|
|
121
123
|
|
|
122
|
-
Consulte o documento [Substituições de webhook](/
|
|
124
|
+
Consulte o documento [Substituições de webhook](/documentation/business-messaging/whatsapp/webhooks/override) para saber como substituir webhooks.
|
|
123
125
|
|
|
124
126
|
## Tamanho da carga
|
|
125
127
|
|
|
@@ -127,29 +129,35 @@ As cargas de webhook podem ter até 3 MB.
|
|
|
127
129
|
|
|
128
130
|
## Falha na entrega do webhook
|
|
129
131
|
|
|
130
|
-
Se enviarmos um pedido de webhook para seu ponto de extremidade e o servidor responder com um código de status HTTP que não seja 200, ou se não pudermos enviar o webhook por outro motivo, continuaremos fazendo tentativas
|
|
132
|
+
Se enviarmos um pedido de webhook para seu ponto de extremidade e o servidor responder com um código de status HTTP que não seja 200, ou se não pudermos enviar o webhook por outro motivo, continuaremos fazendo tentativas com uma frequência menor durante 7 dias.
|
|
131
133
|
|
|
132
134
|
Essas tentativas serão enviadas a todos os apps que assinaram os webhooks (e os campos relacionados) na conta do WhatsApp Business. Isso pode fazer com que as notificações de webhook sejam duplicadas.
|
|
133
135
|
|
|
136
|
+
## TLS mútuo
|
|
137
|
+
|
|
138
|
+
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.
|
|
139
|
+
|
|
134
140
|
## Endereços IP
|
|
135
141
|
|
|
136
|
-
É possível receber endereços IP dos nossos servidores de webhook
|
|
142
|
+
É possível receber endereços IP dos nossos servidores de webhook executando este comando no seu terminal:
|
|
137
143
|
|
|
138
144
|
```
|
|
139
145
|
whois -h whois.radb.net — '-i origin AS32934' | grep '^route' | awk '{print $2}' | sort
|
|
140
146
|
```
|
|
141
147
|
|
|
142
|
-
|
|
148
|
+
Também é possível usar nosso feed geográfico para [baixar um arquivo CSV](https://facebook.com/peering/geofeed) com a lista de endereços IP.
|
|
149
|
+
|
|
150
|
+
No entanto, mudamos nossos endereços IP com frequência. Por isso, para não precisar gerar novamente sua lista de endereços IP permitidos, recomendamos [usar o mTLS](/docs/graph-api/webhooks/getting-started#mtls-for-webhooks).
|
|
143
151
|
|
|
144
152
|
## Solução de problemas
|
|
145
153
|
|
|
146
154
|
Se você não estiver recebendo webhooks:
|
|
147
155
|
|
|
148
|
-
- Verifique se o seu ponto de extremidade está aceitando pedidos.- Envie uma carga de teste ao ponto de extremidade
|
|
156
|
+
- Verifique se o seu ponto de extremidade está aceitando pedidos.- Envie uma carga de teste ao ponto de extremidade pelo painel **[Painel de Apps](/apps)** > **WhatsApp** > **Configurações**.- Verifique se o app está no modo **Live**. Alguns webhooks não serão enviados se o app estiver no modo **Desenvolvimento**.- Use nosso [ponto de extremidade do webhook de teste](/documentation/business-messaging/whatsapp/webhooks/set-up-whatsapp-echo-bot). Se o ponto de extremidade de teste estiver processando cargas de webhook e exibindo-as no console, o problema provavelmente está no código do seu ponto de extremidade.
|
|
149
157
|
|
|
150
158
|
## Saiba mais
|
|
151
159
|
|
|
152
|
-
- Consulte o post de blog do WhatsApp Business [Como usar o Node.js para implementar webhooks](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fblog%2Fhow-to-use-webhooks-from-whatsapp-business-api&h=
|
|
160
|
+
- Consulte o post de blog do WhatsApp Business [Como usar o Node.js para implementar webhooks](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fblog%2Fhow-to-use-webhooks-from-whatsapp-business-api&h=AT1LZL1sZjFlRsRCM_nXGnByYvewVOEPUlZOPXia96WqqdPpXYdONzop6XlFwjm1dl59exOgXb26VtsAT6hEizmmGP5dztrwc2PV26t4HsC4NwngyshNXuy_j3WRuSw4_AxA90aH4M_VS6kT-LEsg3RnqG8).
|
|
153
161
|
|
|
154
162
|
Você achou esta página útil?
|
|
155
163
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "whatsapp-docs-mcp",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.7",
|
|
4
4
|
"description": "MCP server for WhatsApp Business API documentation - Access comprehensive WhatsApp Business API docs through Model Context Protocol",
|
|
5
5
|
"main": "./dist/index.js",
|
|
6
6
|
"types": "./dist/index.d.ts",
|