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,256 @@
|
|
|
1
|
+
<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/interactive-media-carousel-messages -->
|
|
2
|
+
<!-- Scraped: 2026-01-24T00:40:00.698Z -->
|
|
3
|
+
|
|
4
|
+
# Mensagens de carrossel de mídia interativa
|
|
5
|
+
|
|
6
|
+
Updated: 22 de dez de 2025
|
|
7
|
+
|
|
8
|
+
As mensagens de carrossel de mídia interativa exibem um conjunto de cartões de mídia com rolagem horizontal. Cada cartão pode exibir um cabeçalho de imagem ou vídeo, texto do corpo e botões de resposta rápida ou um botão de URL.
|
|
9
|
+
|
|
10
|
+
Por exemplo, esta é uma mensagem de carrossel de cartão de mídia interativa que mostra três cartões em uma área de rolagem (delimitada por um retângulo pontilhado), cada um com um cabeçalho de imagem, corpo de texto e botão de URL:
|
|
11
|
+
|
|
12
|
+

|
|
13
|
+
|
|
14
|
+
Esta é a mesma mensagem, mas usando botões de resposta rápida em vez de botões de URL:
|
|
15
|
+
|
|
16
|
+

|
|
17
|
+
|
|
18
|
+
## Componentes
|
|
19
|
+
|
|
20
|
+
- As mensagens devem incluir entre 2 e 10 cartões.- É necessário adicionar o corpo de texto da mensagem principal.- Não há compatibilidade com cabeçalhos/rodapés de mensagens principais nem com componentes interativos.- Os cartões devem incluir um cabeçalho com imagem ou vídeo. Outros tipos de cabeçalho não são compatíveis.- O texto do corpo do cartão é opcional.- Os cartões devem incluir um botão de URL ou um ou mais botões de resposta rápida. Os tipos e números de botões devem corresponder em todos os cartões (por exemplo, se você definir um cartão com dois botões de resposta rápida, todos os cartões deverão definir exatamente dois botões de resposta rápida).
|
|
21
|
+
|
|
22
|
+
## Sintaxe da solicitação
|
|
23
|
+
|
|
24
|
+
```
|
|
25
|
+
curl 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/messages' \
|
|
26
|
+
-H 'Content-Type: application/json' \
|
|
27
|
+
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
|
|
28
|
+
-d '
|
|
29
|
+
{
|
|
30
|
+
"messaging_product": "whatsapp",
|
|
31
|
+
"recipient_type": "individual",
|
|
32
|
+
"to": "<USER_PHONE_NUMBER>",
|
|
33
|
+
"type": "interactive",
|
|
34
|
+
"interactive": {
|
|
35
|
+
"type": "carousel",
|
|
36
|
+
"body": {
|
|
37
|
+
"text": "<MESSAGE_BODY_TEXT>"
|
|
38
|
+
},
|
|
39
|
+
"action": {
|
|
40
|
+
|
|
41
|
+
<!-- First card object -->
|
|
42
|
+
"cards": [
|
|
43
|
+
{
|
|
44
|
+
"card_index": <CARD_INDEX>,
|
|
45
|
+
"type": "cta_url",
|
|
46
|
+
"header": {
|
|
47
|
+
"type": "<HEADER_TYPE>",
|
|
48
|
+
"<HEADER_TYPE>": {
|
|
49
|
+
"link": "<MEDIA_ASSET_URL>"
|
|
50
|
+
}
|
|
51
|
+
},
|
|
52
|
+
|
|
53
|
+
<!-- Card body text is optional -->
|
|
54
|
+
"body": {
|
|
55
|
+
"text": "<CARD_BODY_TEXT>"
|
|
56
|
+
},
|
|
57
|
+
|
|
58
|
+
"action": {
|
|
59
|
+
<!-- Only if using a URL button -->
|
|
60
|
+
"name": "cta_url",
|
|
61
|
+
"parameters": {
|
|
62
|
+
"display_text": "<URL_BUTTON_LABEL>",
|
|
63
|
+
"url": "<URL_BUTTON_URL>"
|
|
64
|
+
}
|
|
65
|
+
<!-- Only if using one or more quick-reply buttons -->
|
|
66
|
+
"buttons": [
|
|
67
|
+
{
|
|
68
|
+
"type": "quick_reply",
|
|
69
|
+
"quick_reply": {
|
|
70
|
+
"id": "<QUICK_REPLY_BUTTON_ID>",
|
|
71
|
+
"title": "<QUICK_REPLY_BUTTON_LABEL>"
|
|
72
|
+
}
|
|
73
|
+
},
|
|
74
|
+
<!-- Additional quick-reply buttons would follow -->
|
|
75
|
+
}
|
|
76
|
+
},
|
|
77
|
+
<!-- Additional card objects would follow -->
|
|
78
|
+
]
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
}'
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
## Parâmetros de solicitação
|
|
85
|
+
|
|
86
|
+
Espaço reservado
|
|
87
|
+
|
|
88
|
+
Descrição
|
|
89
|
+
|
|
90
|
+
Valor de exemplo
|
|
91
|
+
|
|
92
|
+
`<ACCESS_TOKEN>`
|
|
93
|
+
|
|
94
|
+
_String_
|
|
95
|
+
|
|
96
|
+
**Obrigatório.**
|
|
97
|
+
|
|
98
|
+
Token de acesso.
|
|
99
|
+
|
|
100
|
+
`EAAJB...`
|
|
101
|
+
|
|
102
|
+
`<API_VERSION>`
|
|
103
|
+
|
|
104
|
+
_String_
|
|
105
|
+
|
|
106
|
+
**Opcional.**
|
|
107
|
+
|
|
108
|
+
Versão da API.
|
|
109
|
+
|
|
110
|
+
`v23.0`
|
|
111
|
+
|
|
112
|
+
`<BUSINESS_PHONE_NUMBER_ID>`
|
|
113
|
+
|
|
114
|
+
_Número inteiro_
|
|
115
|
+
|
|
116
|
+
**Obrigatório.**
|
|
117
|
+
|
|
118
|
+
Identificação do número de telefone comercial.
|
|
119
|
+
|
|
120
|
+
`106540352242922`
|
|
121
|
+
|
|
122
|
+
`<CARD_BODY_TEXT>`
|
|
123
|
+
|
|
124
|
+
_String_
|
|
125
|
+
|
|
126
|
+
**Opcional.**
|
|
127
|
+
|
|
128
|
+
Corpo do texto do cartão. Máximo de 160 caracteres e até 2 quebras de linha.
|
|
129
|
+
|
|
130
|
+
`*Blue Echeveria*\n\nA rosette-shaped succulent with powdery blue leaves, perfect for brightening up any space.`
|
|
131
|
+
|
|
132
|
+
`<CARD_INDEX>`
|
|
133
|
+
|
|
134
|
+
_Número inteiro_
|
|
135
|
+
|
|
136
|
+
**Obrigatório.**
|
|
137
|
+
|
|
138
|
+
Índice de cartões com base zero. Os cartões aparecerão da esquerda para a direita em uma visualização de rolagem, começando com 0.
|
|
139
|
+
|
|
140
|
+
`0`
|
|
141
|
+
|
|
142
|
+
`<HEADER_TYPE>`
|
|
143
|
+
|
|
144
|
+
_String_
|
|
145
|
+
|
|
146
|
+
**Obrigatório.**
|
|
147
|
+
|
|
148
|
+
Tipo de cabeçalho. Os valores podem ser os seguintes:
|
|
149
|
+
|
|
150
|
+
`image`: Indica um cabeçalho de imagem do cartão.
|
|
151
|
+
|
|
152
|
+
`video`: indica um cabeçalho de vídeo do cartão.
|
|
153
|
+
|
|
154
|
+
Consulte [Tipos de mídia compatíveis](/documentation/business-messaging/whatsapp/business-phone-numbers/media).
|
|
155
|
+
|
|
156
|
+
`image`
|
|
157
|
+
|
|
158
|
+
`<MEDIA_ASSET_URL>`
|
|
159
|
+
|
|
160
|
+
_String_
|
|
161
|
+
|
|
162
|
+
**Obrigatório.**
|
|
163
|
+
|
|
164
|
+
O URL do ativo de mídia disponível publicamente.
|
|
165
|
+
|
|
166
|
+
`https://www.luckyshrub.com/assets/blue-echeveria.jpeg`
|
|
167
|
+
|
|
168
|
+
`<MESSAGE_BODY_TEXT>`
|
|
169
|
+
|
|
170
|
+
_String_
|
|
171
|
+
|
|
172
|
+
**Obrigatório.**
|
|
173
|
+
|
|
174
|
+
Texto do corpo da mensagem principal. Máximo de 1.024 caracteres.
|
|
175
|
+
|
|
176
|
+
`Of course! Here are three of our latest arrivals, each under $25:`
|
|
177
|
+
|
|
178
|
+
`<QUICK_REPLY_BUTTON_ID>`
|
|
179
|
+
|
|
180
|
+
_String_
|
|
181
|
+
|
|
182
|
+
**Obrigatório ao usar um botão de resposta rápida.**
|
|
183
|
+
|
|
184
|
+
ID do botão de resposta rápida. Máximo de 20 caracteres.
|
|
185
|
+
|
|
186
|
+
`learn-blue-echeveria`
|
|
187
|
+
|
|
188
|
+
`<QUICK_REPLY_BUTTON_LABEL>`
|
|
189
|
+
|
|
190
|
+
_String_
|
|
191
|
+
|
|
192
|
+
**Obrigatório ao usar um botão de resposta rápida.**
|
|
193
|
+
|
|
194
|
+
Texto do rótulo do botão de resposta rápida. Máximo de 20 caracteres.
|
|
195
|
+
|
|
196
|
+
`Learn more`
|
|
197
|
+
|
|
198
|
+
`<URL_BUTTON_LABEL>`
|
|
199
|
+
|
|
200
|
+
_String_
|
|
201
|
+
|
|
202
|
+
**Obrigatório ao usar um botão de URL.**
|
|
203
|
+
|
|
204
|
+
Texto do rótulo do botão de URL. Máximo de 20 caracteres.
|
|
205
|
+
|
|
206
|
+
`Buy now`
|
|
207
|
+
|
|
208
|
+
`<URL_BUTTON_URL>`
|
|
209
|
+
|
|
210
|
+
_String_
|
|
211
|
+
|
|
212
|
+
**Obrigatório ao usar um botão de URL.**
|
|
213
|
+
|
|
214
|
+
O URL que será carregado no navegador da web padrão do dispositivo após o toque do usuário. Máximo de 20 caracteres.
|
|
215
|
+
|
|
216
|
+
`https://shop.luckyshrub.com/latest/blue-echeveria`
|
|
217
|
+
|
|
218
|
+
`<USER_PHONE_NUMBER>`
|
|
219
|
+
|
|
220
|
+
_String_
|
|
221
|
+
|
|
222
|
+
**Obrigatório.**
|
|
223
|
+
|
|
224
|
+
Número de telefone do usuário do WhatsApp.
|
|
225
|
+
|
|
226
|
+
`16505551234`
|
|
227
|
+
|
|
228
|
+
## Exemplos de solicitação
|
|
229
|
+
|
|
230
|
+
### Exemplo de botões de URL
|
|
231
|
+
|
|
232
|
+
Esse exemplo de solicitação envia uma mensagem de carrossel de mídia composta por três cartões, cada um com um cabeçalho de imagem, texto do corpo do cartão e um botão de URL.
|
|
233
|
+
|
|
234
|
+
```
|
|
235
|
+
curl 'https://graph.facebook.com/v23.0/106540352242922/messages' \-H 'Content-Type: application/json' \-H 'Authorization: Bearer EAAJB...' \-d '{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "16505551234", "type": "interactive", "interactive": { "type": "carousel", "body": { "text": "Of course! Here are three of our latest arrivals, each under $25:" }, "action": { "cards": [ { "card_index": 0, "type": "cta_url", "header": { "type": "image", "image": { "link": "https://www.luckyshrub.com/assets/blue-echeveria.jpeg" } }, "body": { "text": "*Blue Echeveria*\n\nA rosette-shaped succulent with powdery blue leaves, perfect for brightening up any space." }, "action": { "name": "cta_url", "parameters": { "display_text": "Buy now", "url": "https://shop.luckyshrub.com/latest/blue-echeveria" } } }, { "card_index": 1, "type": "cta_url", "header": { "type": "image", "image": { "link": "https://www.luckyshrub.com/assets/zebra-haworthia.jpeg" } }, "body": { "text": "*Zebra Haworthia*\n\nStriking white stripes on deep green leaves give this compact succulent a bold, modern look." }, "action": { "name": "cta_url", "parameters": { "display_text": "Buy now", "url": "https://shop.luckyshrub.com/latest/zebra-haworthia" } } }, { "card_index": 2, "type": "cta_url", "header": { "type": "image", "image": { "link": "https://www.luckyshrub.com/assets/panda-plant.jpeg" } }, "body": { "text": "*Panda Plant*\n\nSoft, fuzzy leaves with chocolate-brown edges—adorable and easy to care for." }, "action": { "name": "cta_url", "parameters": { "display_text": "Buy now", "url": "https://shop.luckyshrub.com/latest/panda-plant" } } } ] } }}'
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
### Exemplo de botões de resposta rápida
|
|
239
|
+
|
|
240
|
+
Esse exemplo de solicitação envia uma mensagem de mídia de carrossel composta por três cartões, cada um com um cabeçalho de imagem, texto do corpo do cartão e dois botões de resposta rápida.
|
|
241
|
+
|
|
242
|
+
```
|
|
243
|
+
curl 'https://graph.facebook.com/v23.0/106540352242922/messages' \-H 'Content-Type: application/json' \-H 'Authorization: Bearer EAAJB...' \-d '{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "16505551234", "type": "interactive", "interactive": { "type": "carousel", "body": { "text": "Of course! Here are three of our latest arrivals, each under $25:" }, "action": { "cards": [ { "card_index": 0, "type": "cta_url", "header": { "type": "image", "image": { "link": "https://www.luckyshrub.com/assets/blue-echeveria.jpeg" } }, "body": { "text": "*Blue Echeveria*\n\nA rosette-shaped succulent with powdery blue leaves, perfect for brightening up any space." }, "action": { "buttons": [ { "type": "quick_reply", "quick_reply": { "id": "learn-blue-echeveria", "title": "Learn more" } }, { "type": "quick_reply", "quick_reply": { "id": "fav-blue-echeveria", "title": "Add to favorites" } } ] } }, { "card_index": 1, "type": "cta_url", "header": { "type": "image", "image": { "link": "https://www.luckyshrub.com/assets/zebra-haworthia.jpeg" } }, "body": { "text": "*Zebra Haworthia*\n\nStriking white stripes on deep green leaves give this compact succulent a bold, modern look." }, "action": { "buttons": [ { "type": "quick_reply", "quick_reply": { "id": "learn-zebra-haworthia", "title": "Learn more" } }, { "type": "quick_reply", "quick_reply": { "id": "fav-zebra-haworthia", "title": "Add to favorites" } } ] } }, { "card_index": 2, "type": "cta_url", "header": { "type": "image", "image": { "link": "https://www.luckyshrub.com/assets/panda-plant.jpeg" } }, "body": { "text": "*Panda Plant*\n\nSoft, fuzzy leaves with chocolate-brown edges—adorable and easy to care for." }, "action": { "buttons": [ { "type": "quick_reply", "quick_reply": { "id": "learn-panda-plant", "title": "Learn more" } }, { "type": "quick_reply", "quick_reply": { "id": "fav-panda-plant", "title": "Add to favorites" } } ] } } ] } }}'
|
|
244
|
+
```
|
|
245
|
+
|
|
246
|
+
## Exemplo de resposta
|
|
247
|
+
|
|
248
|
+
```
|
|
249
|
+
{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA" } ]}
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
Você achou esta página útil?
|
|
253
|
+
|
|
254
|
+

|
|
255
|
+
|
|
256
|
+

|
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/interactive-product-carousel-messages -->
|
|
2
|
+
<!-- Scraped: 2026-01-24T00:40:09.684Z -->
|
|
3
|
+
|
|
4
|
+
# Mensagens interativas de carrossel de produtos
|
|
5
|
+
|
|
6
|
+
Updated: 14 de nov de 2025
|
|
7
|
+
|
|
8
|
+
Esse tipo de mensagem ficará disponível para entrega a usuários do WhatsApp em 11 de novembro.
|
|
9
|
+
|
|
10
|
+
As mensagens de carrossel de produtos interativas permitem que as empresas enviem cartões de produtos com rolagem horizontal em conversas do WhatsApp, possibilitando que os usuários procurem e interajam com os itens diretamente na conversa.
|
|
11
|
+
|
|
12
|
+
Esse formato é integrado ao catálogo de produtos e é compatível com ações de mensagem de produto único (SPM, pelas iniciais em inglês) em cada cartão, proporcionando uma experiência de compra interativa e contínua por meio das APIs do WhatsApp Business e dos clientes móveis.
|
|
13
|
+
|
|
14
|
+
## Como criar uma mensagem de carrossel de produtos
|
|
15
|
+
|
|
16
|
+
A mensagem do carrossel de produtos contém um objeto `card`. É preciso adicionar dois objetos de cartão à mensagem e é possível adicionar até dez. Cada cartão existe na matriz `cards[]` e deve receber um valor `"card_index"` de `0` a `9`.
|
|
17
|
+
|
|
18
|
+
O tipo de cada cartão deve ser definido como `"product"`, e cada cartão deve fazer referência ao mesmo `"catalog_id"`.
|
|
19
|
+
|
|
20
|
+
É preciso adicionar um corpo à mensagem e não são permitidos cabeçalhos, rodapés ou botões.
|
|
21
|
+
|
|
22
|
+
Por fim, cada cartão deve especificar os identificadores de produto e catálogo `"product_retailer_id"` (string, obrigatório) e `"catalog_id"`.
|
|
23
|
+
|
|
24
|
+
### O objeto `card`
|
|
25
|
+
|
|
26
|
+
```
|
|
27
|
+
...{ "card_index": 0, "type": "product", "action": { "product_retailer_id": "abc123xyz", "catalog_id": "123456789"}...
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Sintaxe da solicitação
|
|
31
|
+
|
|
32
|
+
```
|
|
33
|
+
curl 'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages' \
|
|
34
|
+
-H 'Content-Type: application/json' \
|
|
35
|
+
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
|
|
36
|
+
-d '{
|
|
37
|
+
"messaging_product": "whatsapp",
|
|
38
|
+
"recipient_type": "individual",
|
|
39
|
+
"to": "<WHATSAPP_USER_PHONE_NUMBER>",
|
|
40
|
+
"type": "interactive", // must be interactive
|
|
41
|
+
"interactive": {
|
|
42
|
+
"type": "carousel", // must be carousel
|
|
43
|
+
"body": {
|
|
44
|
+
"text": "<MESSAGE_BODY_TEXT>"
|
|
45
|
+
},
|
|
46
|
+
"action": {
|
|
47
|
+
"cards": [
|
|
48
|
+
{
|
|
49
|
+
"card_index": 0,
|
|
50
|
+
"type": "product",
|
|
51
|
+
"action": {
|
|
52
|
+
"product_retailer_id": "abc123xyz",
|
|
53
|
+
"catalog_id": "123456789"
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
// additional product cards
|
|
57
|
+
]
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
}'
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
## Parâmetros da solicitação
|
|
64
|
+
|
|
65
|
+
Espaço reservado
|
|
66
|
+
|
|
67
|
+
Descrição
|
|
68
|
+
|
|
69
|
+
Exemplo de valor
|
|
70
|
+
|
|
71
|
+
`<ACCESS_TOKEN>`
|
|
72
|
+
|
|
73
|
+
_String_
|
|
74
|
+
|
|
75
|
+
**Obrigatório.**
|
|
76
|
+
|
|
77
|
+
[Token do sistema](/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens) ou [token da empresa](/documentation/business-messaging/whatsapp/access-tokens#business-integration-system-user-access-tokens).
|
|
78
|
+
|
|
79
|
+
`EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD`
|
|
80
|
+
|
|
81
|
+
`<API_VERSION>`
|
|
82
|
+
|
|
83
|
+
_String_
|
|
84
|
+
|
|
85
|
+
**Opcional.**
|
|
86
|
+
|
|
87
|
+
Versão da Graph API.
|
|
88
|
+
|
|
89
|
+
v24.0
|
|
90
|
+
|
|
91
|
+
`<MESSAGE_BODY_TEXT>`
|
|
92
|
+
|
|
93
|
+
_String_
|
|
94
|
+
|
|
95
|
+
**Obrigatório.**
|
|
96
|
+
|
|
97
|
+
Máximo de 1.024 caracteres.
|
|
98
|
+
|
|
99
|
+
`Which option do you prefer?`
|
|
100
|
+
|
|
101
|
+
`<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>`
|
|
102
|
+
|
|
103
|
+
_String_
|
|
104
|
+
|
|
105
|
+
**Obrigatório.**
|
|
106
|
+
|
|
107
|
+
Identificação do número de telefone do WhatsApp Business.
|
|
108
|
+
|
|
109
|
+
`106540352242922`
|
|
110
|
+
|
|
111
|
+
`<WHATSAPP_USER_PHONE_NUMBER>`
|
|
112
|
+
|
|
113
|
+
_String_
|
|
114
|
+
|
|
115
|
+
**Obrigatório.**
|
|
116
|
+
|
|
117
|
+
Número de telefone do usuário do WhatsApp.
|
|
118
|
+
|
|
119
|
+
`+16505551234`
|
|
120
|
+
|
|
121
|
+
## Parâmetros do objeto cartão
|
|
122
|
+
|
|
123
|
+
```
|
|
124
|
+
...
|
|
125
|
+
{
|
|
126
|
+
"card_index": <INDEX>,
|
|
127
|
+
"type": "product",
|
|
128
|
+
"action": {
|
|
129
|
+
"product_retailer_id": "<PRODUCT_RETAILER_ID>",
|
|
130
|
+
"catalog_id": "<CATALOG_ID>"
|
|
131
|
+
}
|
|
132
|
+
...
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
Espaço reservado
|
|
136
|
+
|
|
137
|
+
Descrição
|
|
138
|
+
|
|
139
|
+
Exemplo de valor
|
|
140
|
+
|
|
141
|
+
`<INDEX>`
|
|
142
|
+
_Número inteiro_
|
|
143
|
+
|
|
144
|
+
**Obrigatório**
|
|
145
|
+
Índice único para cada cartão (0-9). Não pode se repetir na mensagem.
|
|
146
|
+
|
|
147
|
+
`2`
|
|
148
|
+
|
|
149
|
+
`<PRODUCT_RETAILER_ID>`
|
|
150
|
+
_String_
|
|
151
|
+
|
|
152
|
+
**Obrigatório**
|
|
153
|
+
A identificação única do varejista do produto no catálogo.
|
|
154
|
+
|
|
155
|
+
`"0JkSUu4qizuXv"`
|
|
156
|
+
|
|
157
|
+
`<CATALOG_ID>`
|
|
158
|
+
_String_
|
|
159
|
+
|
|
160
|
+
**Obrigatório**
|
|
161
|
+
A identificação única do catálogo que contém o produto.
|
|
162
|
+
|
|
163
|
+
`"Lq1ZtoWL5OkljTerAW"`
|
|
164
|
+
|
|
165
|
+
## Exemplo de solicitação
|
|
166
|
+
|
|
167
|
+
```
|
|
168
|
+
{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "1234567890", "type": "interactive", "interactive": { "type": "carousel", "body": { "text": "Check out our featured products!" }, "action": { "cards": [ { "card_index": 0, "type": "product", "action": { "product_retailer_id": "abc123xyz", "catalog_id": "123456789" } }, { "card_index": 1, "type": "product", "action": { "product_retailer_id": "def456uvw", "catalog_id": "123456789" } } ] } }}
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
## Exemplo de resposta
|
|
172
|
+
|
|
173
|
+
```
|
|
174
|
+
{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA" } ]}
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
Você achou esta página útil?
|
|
178
|
+
|
|
179
|
+

|
|
180
|
+
|
|
181
|
+

|
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits -->
|
|
2
|
-
<!-- Scraped:
|
|
2
|
+
<!-- Scraped: 2026-01-24T00:42:00.923Z -->
|
|
3
3
|
|
|
4
4
|
# Limites de mensagens
|
|
5
5
|
|
|
6
|
-
Updated:
|
|
6
|
+
Updated: 26 de nov de 2025
|
|
7
|
+
|
|
8
|
+
O campo `messaging_limit_tier`, que era usado para retornar o limite de mensagens de um número de telefone comercial, ficou obsoleto. [Peça](#via-api) o campo `whatsapp_business_manager_messaging_limit`.
|
|
7
9
|
|
|
8
10
|
Este documento descreve os limites de mensagens para a plataforma do WhatsApp Business.
|
|
9
11
|
|
|
@@ -11,13 +13,13 @@ Os limites de mensagens representam o número máximo de telefones de usuários
|
|
|
11
13
|
|
|
12
14
|
Esses limites são calculados e definidos no nível do portfólio empresarial, sendo compartilhados por todos os números de telefone comerciais do portfólio. Isso significa que, se um portfólio empresarial tiver vários números de telefone comerciais, pode ser que um deles consuma toda a capacidade de envio de mensagens do portfólio em determinado período.
|
|
13
15
|
|
|
14
|
-
Os novos portfólios empresariais têm um limite de 250
|
|
16
|
+
Os novos portfólios empresariais têm um limite de 250 mensagens, mas esse limite pode ser aumentado para:
|
|
15
17
|
|
|
16
18
|
- 2.000 (com a conclusão de um [caminho de ajuste](#scaling-paths))- 10.000 (via [ajuste automático](#automatic-scaling))- 100.000 (via ajuste automático)- Ilimitado (via ajuste automático)
|
|
17
19
|
|
|
18
|
-
##
|
|
20
|
+
## Como aumentar o limite
|
|
19
21
|
|
|
20
|
-
Você pode aumentar seu limite de mensagens para 2.000 concluindo um dos [caminhos de ajuste](#scaling-paths) descritos abaixo. Depois disso, aumentaremos automaticamente seu limite para o próximo nível superior se você
|
|
22
|
+
Você pode aumentar seu limite de mensagens para 2.000 concluindo um dos [caminhos de ajuste](#scaling-paths) descritos abaixo. Depois disso, aumentaremos automaticamente seu limite para o próximo nível superior se você cumprir nossos [critérios de ajuste automático](#automatic-scaling).
|
|
21
23
|
|
|
22
24
|
### Caminhos de ajuste
|
|
23
25
|
|
|
@@ -41,7 +43,7 @@ O que você pode fazer
|
|
|
41
43
|
|
|
42
44
|
`INCREASED_CAPABILITIES_ELIGIBILITY_DEFERRED`
|
|
43
45
|
|
|
44
|
-
|
|
46
|
+
Envie 2.000 mensagens entregues fora das janelas de atendimento ao cliente para números de telefone únicos de usuários do WhatsApp, em um período móvel de 30 dias, usando modelos com uma alta [classificação de qualidade](/documentation/business-messaging/whatsapp/templates/template-quality).
|
|
45
47
|
|
|
46
48
|
`INCREASED_CAPABILITIES_ELIGIBILITY_FAILED`
|
|
47
49
|
|
|
@@ -49,13 +51,13 @@ Envie 2.000 mensagens entregues fora das janelas de atendimento ao cliente para
|
|
|
49
51
|
|
|
50
52
|
`INCREASED_CAPABILITIES_ELIGIBILITY_NEED_MORE_INFO`
|
|
51
53
|
|
|
52
|
-
[
|
|
54
|
+
[Verifique sua identidade](https://www.facebook.com/business/help/587323819101032) ou envie 2.000 mensagens entregues fora das janelas de atendimento ao cliente para números de telefone únicos de usuários do WhatsApp, em um período móvel de 30 dias, usando modelos com uma alta [classificação de qualidade](/documentation/business-messaging/whatsapp/templates/template-quality).
|
|
53
55
|
|
|
54
56
|
## Ajuste automático
|
|
55
57
|
|
|
56
58
|
Depois que o limite de mensagens do portfólio empresarial chegar a 2.000, determinaremos se ele deverá ser aumentado ainda mais de acordo com os seguintes critérios:
|
|
57
59
|
|
|
58
|
-
- Você envia [mensagens de alta qualidade](/documentation/business-messaging/whatsapp/messages/send-messages#message-quality) com todos os seus modelos e números de telefone comerciais
|
|
60
|
+
- Você envia [mensagens de alta qualidade](/documentation/business-messaging/whatsapp/messages/send-messages#message-quality) com todos os seus modelos e números de telefone comerciais- Nos últimos sete dias, sua empresa usou pelo menos metade do limite de mensagens atual
|
|
59
61
|
|
|
60
62
|
Se esses critérios forem atendidos, aumentaremos o limite do seu portfólio em um nível dentro de seis horas.
|
|
61
63
|
|
|
@@ -63,15 +65,17 @@ Se esses critérios forem atendidos, aumentaremos o limite do seu portfólio em
|
|
|
63
65
|
|
|
64
66
|
### Via Meta Business Suite
|
|
65
67
|
|
|
66
|
-
O
|
|
68
|
+
O limite de mensagens atual do seu número de telefone comercial aparece no painel [Gerenciador do WhatsApp](https://business.facebook.com/wa/manage/home/) > **Ferramentas da conta** > **Limites de mensagens**:
|
|
67
69
|
|
|
68
|
-

|
|
69
71
|
|
|
70
72
|
### Via API
|
|
71
73
|
|
|
72
|
-
Use o ponto de extremidade [GET /<BUSINESS\_PHONE\_NUMBER\_ID>](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-phone-number-api#Reading) e peça o campo `whatsapp_business_manager_messaging_limit
|
|
74
|
+
Use o ponto de extremidade [GET /<BUSINESS\_PHONE\_NUMBER\_ID>](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-phone-number-api#Reading) e peça o campo `whatsapp_business_manager_messaging_limit`.
|
|
75
|
+
|
|
76
|
+
Observe que o `messaging_limit_tier`, que era usado para retornar o limite de mensagens do número de telefone, está obsoleto.
|
|
73
77
|
|
|
74
|
-
|
|
78
|
+
### Exemplo de pedido
|
|
75
79
|
|
|
76
80
|
```
|
|
77
81
|
curl 'https://graph.facebook.com/v24.0/106540352242922?fields=whatsapp_business_manager_messaging_limit' \
|
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media -->
|
|
2
|
-
<!-- Scraped:
|
|
2
|
+
<!-- Scraped: 2026-01-24T00:26:30.521Z -->
|
|
3
3
|
|
|
4
4
|
# Mídia
|
|
5
5
|
|
|
6
|
-
Updated:
|
|
6
|
+
Updated: 11 de dez de 2025
|
|
7
|
+
|
|
8
|
+
Os webhooks de mensagens de mídia recebidas ([mensagens de imagem](/documentation/business-messaging/whatsapp/webhooks/reference/messages/image), [mensagens de vídeo](/documentation/business-messaging/whatsapp/webhooks/reference/messages/video) etc.) agora incluem o URL de download da mídia (atribuída à propriedade `url`), que pode ser consultado diretamente com seu token de acesso para baixar o ativo de mídia da mensagem recebida.
|
|
7
9
|
|
|
8
10
|
Você usa quatro pontos de extremidade diferentes para gerenciar mídias:
|
|
9
11
|
|
|
@@ -45,7 +47,7 @@ Autenticação
|
|
|
45
47
|
|
|
46
48
|
`/PHONE_NUMBER_ID/media`
|
|
47
49
|
|
|
48
|
-
(Consulte [
|
|
50
|
+
(Consulte [Obter o ID do número de telefone](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#get-all-phone-numbers))
|
|
49
51
|
|
|
50
52
|
Os desenvolvedores podem autenticar as chamadas de API com o token de acesso gerado em **Painel de Apps** > **WhatsApp** > **Configuração da API**.
|
|
51
53
|
|
|
@@ -63,7 +65,7 @@ Descrição
|
|
|
63
65
|
|
|
64
66
|
**Obrigatório.**
|
|
65
67
|
|
|
66
|
-
O caminho
|
|
68
|
+
O caminho para o arquivo armazenado no diretório local. Por exemplo: "@/local/path/file.jpg".
|
|
67
69
|
|
|
68
70
|
`type`
|
|
69
71
|
|
|
@@ -75,7 +77,7 @@ O tipo de arquivo de mídia que está sendo carregado. Consulte a seção [Tipos
|
|
|
75
77
|
|
|
76
78
|
**Obrigatório.**
|
|
77
79
|
|
|
78
|
-
|
|
80
|
+
Serviço de mensagens usado para a solicitação. Nesse caso, use `whatsapp`.
|
|
79
81
|
|
|
80
82
|
### Solicitação
|
|
81
83
|
|
|
@@ -113,11 +115,9 @@ curl 'https://graph.facebook.com/v24.0/106540352242922/media' \
|
|
|
113
115
|
|
|
114
116
|
## Obter o URL de mídia
|
|
115
117
|
|
|
116
|
-
É possível consultar diretamente um [ID de mídia](#get-media-id) para obter um URL de mídia, que pode ser usado com seu token de acesso para [baixar o ativo de mídia](#download-media).
|
|
117
|
-
|
|
118
|
-
A partir de 12 de novembro de 2025, os webhooks de mídia recebida ([mensagens de imagem](/documentation/business-messaging/whatsapp/webhooks/reference/messages/image), [mensagens de vídeo](/documentation/business-messaging/whatsapp/webhooks/reference/messages/video) etc.) incluirão automaticamente o URL da mídia e vão atribuí-lo a uma nova propriedade `url`. **Essa propriedade será lançada de forma gradual para os desenvolvedores ao longo de várias semanas e talvez não esteja disponível para você imediatamente.**
|
|
118
|
+
É possível consultar diretamente um [ID de mídia](#get-media-id) para obter um URL de mídia, que pode ser usado com seu token de acesso para [baixar o ativo de mídia](#download-media). Os webhooks de mensagens de mídia recebidas ([mensagens de imagem](/documentation/business-messaging/whatsapp/webhooks/reference/messages/image), [mensagens de vídeo](/documentation/business-messaging/whatsapp/webhooks/reference/messages/video) etc.) entre outros) incluem o URL da mídia, que é atribuída à propriedade `url`.
|
|
119
119
|
|
|
120
|
-
Os URLs de mídia **expiram após cinco minutos**. Você deve consultar o ID novamente para
|
|
120
|
+
Os URLs de mídia **expiram após cinco minutos**. Você deve consultar o ID novamente para ter um novo URL.
|
|
121
121
|
|
|
122
122
|
### Sintaxe da solicitação
|
|
123
123
|
|
|
@@ -166,7 +166,7 @@ Observe que `phone_number_id` é opcional. Se incluída, a solicitação será p
|
|
|
166
166
|
|
|
167
167
|
Para baixar mídias, faça uma solicitação `GET` no URL da mídia e inclua seu token de acesso. **Se o token for omitido, a solicitação falhará.**
|
|
168
168
|
|
|
169
|
-
|
|
169
|
+
Ao recuperar uma mídia a partir de uma identificação de mídia recebida via webhook, a identificação de mídia só estará disponível para baixar por sete dias.
|
|
170
170
|
|
|
171
171
|
### Sintaxe da solicitação
|
|
172
172
|
|
|
@@ -367,10 +367,9 @@ image/webp
|
|
|
367
367
|
|
|
368
368
|
### Vídeo
|
|
369
369
|
|
|
370
|
-
|
|
370
|
+
Apenas o codec de vídeo H.264 e o codec de áudio AAC são aceitos. Somente stream de áudio único ou sem stream de áudio.
|
|
371
371
|
|
|
372
|
-
|
|
373
|
-
|
|
372
|
+
Vídeos codificados com o perfil H.264 "High" e B-frames não são compatíveis com os clientes do WhatsApp para Android. Recomendamos que você use o perfil H.264 "Main" sem B-frames ou o perfil H.264 "Baseline" ao codificar (ou recodificar com uma ferramenta como ffmpeg) e posicione caixas moov antes de caixas mdat para garantir uma compatibilidade mais ampla. Caso você esteja usando o ffmpeg, utilize a sinalização -movflags faststart para inserir caixas moov antes das caixas mdata.
|
|
374
373
|
|
|
375
374
|
Tipo de vídeo
|
|
376
375
|
|
|
@@ -396,13 +395,13 @@ video/mp4
|
|
|
396
395
|
|
|
397
396
|
16 MB
|
|
398
397
|
|
|
399
|
-
|
|
398
|
+
Observe que um tipo MIME incompatível (`131053`) é um erro comum. Recomendamos que você inspecione os arquivos de mídia para verificar o tipo MIME e confirme que as extensões do nome do arquivo reflitam os tipos deles. Por exemplo, se estiver usando UNIX, você pode inspecionar um arquivo por meio da linha de comando para determinar seu tipo MIME:
|
|
400
399
|
|
|
401
400
|
`file -I your-image-asset.png`
|
|
402
401
|
|
|
403
402
|
## Restrições de download de mensagens de mídia
|
|
404
403
|
|
|
405
|
-
O tamanho máximo de arquivo aceito para mensagens de mídia na API de Nuvem é 100
|
|
404
|
+
O tamanho máximo de arquivo aceito para mensagens de mídia na API de Nuvem é de 100 MB. Caso o cliente envie um arquivo com mais de 100 MB, você receberá um webhook com o código de erro [131052](/documentation/business-messaging/whatsapp/support/error-codes#other-errors) e `title`:
|
|
406
405
|
|
|
407
406
|
_“O arquivo de mídia é muito grande. Tamanho máximo do arquivo aceito atualmente: 100 MB. Peça ao cliente para enviar um arquivo de mídia com tamanho inferior a 100 MB"_.
|
|
408
407
|
|
|
@@ -410,7 +409,7 @@ Recomendamos que você envie aos clientes uma mensagem de aviso informando que o
|
|
|
410
409
|
|
|
411
410
|
## Saiba mais
|
|
412
411
|
|
|
413
|
-
Blog do WhatsApp Business – [Como enviar mensagens de mídia pelo WhatsApp em um app](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fblog%2Fmedia-messages-via-app&h=
|
|
412
|
+
Blog do WhatsApp Business – [Como enviar mensagens de mídia pelo WhatsApp em um app](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fblog%2Fmedia-messages-via-app&h=AT0mZT57Tz_t_gCcZY6rmBHEjosuDQaCWAFIgVtzlkhH7ULfbhsKSnwQg73pmqW2yNB65rdZcybuVcvGaSgZ3y9blUo4coqKo5-lhKt8JOjypz59VyPSqwFodyMbjIWuiIo6U_8v1qoNekWOHHJK8ablq0c)
|
|
414
413
|
|
|
415
414
|
Você achou esta página útil?
|
|
416
415
|
|