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
|
@@ -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
|
+

|
|
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
|
+

|
|
157
|
+
|
|
158
|
+

|
|
@@ -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
|
+

|
|
181
|
+
|
|
182
|
+

|
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/account_update -->
|
|
2
|
-
<!-- Scraped:
|
|
2
|
+
<!-- Scraped: 2026-01-24T01:08:22.310Z -->
|
|
3
3
|
|
|
4
4
|
# Referência do webhook account\_update
|
|
5
5
|
|
|
6
|
-
Updated:
|
|
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)
|
|
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
|
|
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
|
|
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
|
|
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
|
|
155
|
+
`PARTNER_APP_INSTALLED`: indica que um cliente empresarial concedeu mais uma permissão ao app.
|
|
156
156
|
|
|
157
|
-
`PARTNER_APP_UNINSTALLED
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
209
|
+
`NONE`: indica que o envio não foi rejeitado.
|
|
210
210
|
|
|
211
|
-
`WEBSITE NOT MATCHING
|
|
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
|
|
239
|
+
`APPROVED`: o envio foi analisado e aprovado.
|
|
240
240
|
|
|
241
|
-
`DISCARDED
|
|
241
|
+
`DISCARDED`: o envio foi descartado devido a problemas técnicos ou não há progresso há algum tempo.
|
|
242
242
|
|
|
243
|
-
`FAILED
|
|
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
|
|
245
|
+
`PENDING`: o envio está aguardando análise.
|
|
246
246
|
|
|
247
|
-
`REVOKED
|
|
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
|
-
|
|
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
|
|
269
|
+
`DISABLE`: indica que a WABA está desabilitada.
|
|
270
270
|
|
|
271
|
-
`REINSTATE
|
|
271
|
+
`REINSTATE`: indica que a WABA foi restabelecida.
|
|
272
272
|
|
|
273
|
-
`SCHEDULE_FOR_DISABLE
|
|
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
|
|
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": "
|
|
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?
|