whatsapp-docs-mcp 1.0.5 → 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/README.md +47 -139
- 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
package/docs/suporte.md
CHANGED
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
<!-- Source: https://developers.facebook.com/docs/whatsapp/support -->
|
|
2
|
-
<!-- Scraped:
|
|
2
|
+
<!-- Scraped: 2026-01-24T00:25:03.634Z -->
|
|
3
3
|
|
|
4
4
|
# Suporte
|
|
5
5
|
|
|
6
|
-
Updated:
|
|
6
|
+
Updated: 19 de nov de 2025
|
|
7
7
|
|
|
8
8
|
## Termos e políticas
|
|
9
9
|
|
|
10
|
-
- [Termos de hospedagem da Meta para a API de Nuvem](https://www.facebook.com/legal/Meta-Hosting-Terms-Cloud-API)- [Política de Mensagens do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fpolicy&h=
|
|
10
|
+
- [Termos de hospedagem da Meta para a API de Nuvem](https://www.facebook.com/legal/Meta-Hosting-Terms-Cloud-API)- [Política de Mensagens do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fpolicy&h=AT031QHaO74TYZVzxwuX16iMlMDFoLcMT_aU3cOMssdrExWad32GwSL_ej3Vw5-sOdUBTnlmQzIOtmC1IQa6CBMTbUssEORJyWOnR3BQD4aW1gEJ5hL8jA1IT_QqWvoFiuFbMXQCRRTkf1q1knjPc9KsY6w)- [Termos de Serviço do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.whatsapp.com%2Flegal%2Fbusiness-terms&h=AT031QHaO74TYZVzxwuX16iMlMDFoLcMT_aU3cOMssdrExWad32GwSL_ej3Vw5-sOdUBTnlmQzIOtmC1IQa6CBMTbUssEORJyWOnR3BQD4aW1gEJ5hL8jA1IT_QqWvoFiuFbMXQCRRTkf1q1knjPc9KsY6w)- [Política Comercial da Meta](https://www.facebook.com/policies_center/commerce)- [Termos da Meta para o WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.whatsapp.com%2Flegal%2Fmeta-terms-whatsapp-business&h=AT031QHaO74TYZVzxwuX16iMlMDFoLcMT_aU3cOMssdrExWad32GwSL_ej3Vw5-sOdUBTnlmQzIOtmC1IQa6CBMTbUssEORJyWOnR3BQD4aW1gEJ5hL8jA1IT_QqWvoFiuFbMXQCRRTkf1q1knjPc9KsY6w)
|
|
11
11
|
|
|
12
12
|
## Status da API
|
|
13
13
|
|
|
14
|
-
Consulte [Status da API do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fmetastatus.com%2Fwhatsapp-business-api&h=
|
|
14
|
+
Consulte [Status da API do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fmetastatus.com%2Fwhatsapp-business-api&h=AT031QHaO74TYZVzxwuX16iMlMDFoLcMT_aU3cOMssdrExWad32GwSL_ej3Vw5-sOdUBTnlmQzIOtmC1IQa6CBMTbUssEORJyWOnR3BQD4aW1gEJ5hL8jA1IT_QqWvoFiuFbMXQCRRTkf1q1knjPc9KsY6w) para saber mais sobre a página de status da API do WhatsApp Business e as informações disponíveis.
|
|
15
15
|
|
|
16
16
|
## Suporte para desenvolvedores
|
|
17
17
|
|
|
@@ -35,7 +35,7 @@ Desenvolvedores empresariais, como [provedores de soluções](/documentation/bus
|
|
|
35
35
|
|
|
36
36
|
[https://business.facebook.com/direct-support/](https://business.facebook.com/direct-support/)
|
|
37
37
|
|
|
38
|
-
Os clientes finais de
|
|
38
|
+
Os clientes finais de parceiros de soluções ou parceiros gerenciados devem entrar em contato com eles para obter suporte diretamente.
|
|
39
39
|
|
|
40
40
|
Fazemos o possível para enviar uma resposta inicial dentro de 24 horas em dias úteis. Os dias úteis são de segunda a sexta-feira no país do cliente definido na conta comercial, excluindo feriados.
|
|
41
41
|
|
|
@@ -54,14 +54,14 @@ Tipo de problema
|
|
|
54
54
|
O problema afeta gravemente o ambiente de produção, o que impede por completo o funcionamento da API. Com isso, não é possível enviar nenhuma mensagem nem adicionar/registrar números de telefone.
|
|
55
55
|
|
|
56
56
|
|
|
57
|
-
Isso suspende as operações comerciais
|
|
57
|
+
Isso suspende as operações comerciais. Não há soluções processuais.
|
|
58
58
|
|
|
59
59
|
**2 – Urgente**
|
|
60
60
|
|
|
61
|
-
O problema afeta o ambiente de produção
|
|
61
|
+
O problema afeta o ambiente de produção por bloquear funções da API, o que resulta na falha do envio da maioria das mensagens.
|
|
62
62
|
|
|
63
63
|
|
|
64
|
-
Isso causa interrupções em partes significativas das operações de negócios
|
|
64
|
+
Isso causa interrupções em partes significativas das operações de negócios. Não há soluções processuais.
|
|
65
65
|
|
|
66
66
|
**3 – Padrão**
|
|
67
67
|
|
|
@@ -71,7 +71,7 @@ O problema afeta o ambiente de produção, e a API enfrenta problemas menores ou
|
|
|
71
71
|
Isso causa pequenas interrupções em partes das operações de negócios, mas existem soluções processuais.
|
|
72
72
|
|
|
73
73
|
|
|
74
|
-
|
|
74
|
+
Também inclui os problemas que não foram classificados como **Críticos** nem **Urgentes**.
|
|
75
75
|
|
|
76
76
|
Quando um tíquete **Crítico** ou **Urgente** for resolvido, mas tiver pedidos pendentes, atualizaremos a gravidade para **Solucionado**.
|
|
77
77
|
|
|
@@ -85,7 +85,7 @@ Os cenários a seguir podem fazer com que uma mensagem apareça como "enviada",
|
|
|
85
85
|
|
|
86
86
|
Em algumas situações, a API retorna um [código de erro](/documentation/business-messaging/whatsapp/support/error-codes) com uma mensagem que descreve a natureza do erro. Exemplos de cenários:
|
|
87
87
|
|
|
88
|
-
- Parâmetros de pedido inválidos- Erros de integridade- O cliente não aceitou os novos Termos de Serviço e a nova Política de Privacidade. Envie este link [https://wa.me/tos/20210210](https://l.facebook.com/l.php?u=https%3A%2F%2Fwa.me%2Ftos%2F20210210&h=
|
|
88
|
+
- Parâmetros de pedido inválidos- Erros de integridade- O cliente não aceitou os novos Termos de Serviço e a nova Política de Privacidade. Envie este link [https://wa.me/tos/20210210](https://l.facebook.com/l.php?u=https%3A%2F%2Fwa.me%2Ftos%2F20210210&h=AT031QHaO74TYZVzxwuX16iMlMDFoLcMT_aU3cOMssdrExWad32GwSL_ej3Vw5-sOdUBTnlmQzIOtmC1IQa6CBMTbUssEORJyWOnR3BQD4aW1gEJ5hL8jA1IT_QqWvoFiuFbMXQCRRTkf1q1knjPc9KsY6w) para que o usuário final aceite os Termos de Serviço mais recentes.- O cliente está usando uma versão antiga do WhatsApp. Os clientes devem usar a seguinte versão ou uma versão superior:
|
|
89
89
|
- Android: 2.21.15.15- SMBA: 2.21.15.15- iOS: 2.21.170.4- SMBI: 2.21.170.4- KaiOS: 2.2130.10- Web: 2.2132.6- O cliente faz parte de um grupo [experimental](/documentation/business-messaging/whatsapp/support/experiments).
|
|
90
90
|
|
|
91
91
|
#### Soluções possíveis
|
|
@@ -96,9 +96,9 @@ Usando um método de comunicação diferente do WhatsApp, peça ao usuário do W
|
|
|
96
96
|
|
|
97
97
|
### Restrições de país
|
|
98
98
|
|
|
99
|
-
Empresas em Cuba, Irã, Coreia do Norte, Síria e três regiões sancionadas da Ucrânia (Crimeia, Donetsk, Luhansk) não são
|
|
99
|
+
Empresas em Cuba, Irã, Coreia do Norte, Síria e três regiões sancionadas da Ucrânia (Crimeia, Donetsk, Luhansk) não são qualificadas para usar a plataforma WhatsApp Business.
|
|
100
100
|
|
|
101
|
-
Os usuários do app WhatsApp Messenger (WhatsApp) e do WhatsApp Business em Cuba, Irã, Coreia do Norte, Síria e três regiões sancionadas na Ucrânia (Crimeia, Donetsk, Luhansk) não são
|
|
101
|
+
Os usuários do app WhatsApp Messenger (WhatsApp) e do WhatsApp Business em Cuba, Irã, Coreia do Norte, Síria e três regiões sancionadas na Ucrânia (Crimeia, Donetsk, Luhansk) não são qualificados para receber mensagens enviadas pela Plataforma do WhatsApp Business.
|
|
102
102
|
|
|
103
103
|
A partir de 15 de maio de 2024, a Turquia não estará mais restrita a mensagens comerciais da API de Nuvem. Agora, as empresas que usam a API de Nuvem podem enviar e receber mensagens de usuários do WhatsApp com números turcos.
|
|
104
104
|
|
|
@@ -106,9 +106,9 @@ A partir de 15 de maio de 2024, a Turquia não estará mais restrita a mensagens
|
|
|
106
106
|
|
|
107
107
|
#### Status de entrega de mensagem conflituoso
|
|
108
108
|
|
|
109
|
-
Em casos raros, a mesma mensagem pode disparar webhooks de [mensagens de status](/documentation/business-messaging/whatsapp/webhooks/reference/messages/status) de sucesso e de falha. Por exemplo, uma mensagem pode disparar webhooks de status com `status` definido como `delivered` e outro webhook com `status` definido como `failed`. Isso pode acontecer quando um cliente está conectado ao WhatsApp em vários dispositivos
|
|
109
|
+
Em casos raros, a mesma mensagem pode disparar webhooks de [mensagens de status](/documentation/business-messaging/whatsapp/webhooks/reference/messages/status) de sucesso e de falha. Por exemplo, uma mensagem pode disparar webhooks de status com `status` definido como `delivered` e outro webhook com `status` definido como `failed`. Isso pode acontecer quando um cliente está conectado ao WhatsApp em vários dispositivos e a mensagem é entregue com sucesso para um dispositivo, mas não para outro. Qualquer mensagem que aciona um webhook de mensagens de status `delivered` foi entregue a pelo menos um dos dispositivos do usuário.
|
|
110
110
|
|
|
111
|
-
### Código de erro `2`
|
|
111
|
+
### Código de erro `2` – Serviço de API
|
|
112
112
|
|
|
113
113
|
Quando atualizarmos a API, poderá haver até 5 minutos de inatividade. Durante esse período, o serviço ficará indisponível. Nós tentamos fazer essas atualizações com o mínimo de interrupção para as empresas, mas é possível que haja impacto
|
|
114
114
|
|
|
@@ -124,212 +124,103 @@ Esses erros são retornados quando há um problema com o token de acesso que voc
|
|
|
124
124
|
|
|
125
125
|
É possível colar o token de acesso que está sendo usado diretamente no [Depurador de Token de Acesso](/tools/debug/accesstoken). Depois, verifique se você selecionou as permissões `whatsapp_business_management` e `whatsapp_business_messaging`.
|
|
126
126
|
|
|
127
|
-
Se o token não tiver acesso às permissões, será preciso gerar um novo. Enquanto gera o token,
|
|
127
|
+
Se o token não tiver acesso às permissões, será preciso gerar um novo. Enquanto gera o token, selecione:
|
|
128
128
|
|
|
129
|
-
- O app Meta que você está usando para as chamadas
|
|
129
|
+
- O app da Meta que você está usando para as chamadas de API- As seguintes permissões: `whatsapp_business_management` e `whatsapp_business_messaging`
|
|
130
130
|
|
|
131
|
-
## API de
|
|
131
|
+
## API de Mensagens de Marketing para o WhatsApp
|
|
132
132
|
|
|
133
|
-
### Não consigo encontrar um usuário administrador na minha empresa para integrar à MM
|
|
133
|
+
### Não consigo encontrar um usuário administrador na minha empresa para integrar à API de MM para o WhatsApp
|
|
134
134
|
|
|
135
|
-
Para usar a API de
|
|
135
|
+
Para usar a API de Mensagens de Marketing para o WhatsApp, a [integração](/documentation/business-messaging/whatsapp/marketing-messages/onboarding#onboarding-business-customers) deve ser concluída por um usuário do seu portfólio empresarial com permissões de "controle total" (anteriormente, a função de administrador). Leia mais sobre as diversas [permissões de acesso disponíveis em um portfólio empresarial](https://business.facebook.com/business/help/442345745885606).
|
|
136
136
|
|
|
137
137
|
Caso a empresa (ou o parceiro que trabalha com a empresa) não consiga localizar um usuário com “controle total”, siga as etapas abaixo para encontrar usuários com permissão suficiente ou pedir acesso a um portfólio empresarial.
|
|
138
138
|
|
|
139
139
|
### Como encontrar ou adicionar um usuário com permissões de “controle total”
|
|
140
140
|
|
|
141
|
-
A maneira mais simples de aceitar os Termos de Serviço da API de MM
|
|
141
|
+
- A maneira mais simples de aceitar os Termos de Serviço da API de MM para o WhatsApp é quando uma empresa já conhece um usuário com permissão de “controle total”. Nesse caso, o usuário pode passar pelo fluxo de integração da API de MM para o WhatsApp.
|
|
142
|
+
- **Encontre administradores no Gerenciador de Negócios**. Se a empresa (ou o parceiro) não conseguir encontrar um usuário com “controle total”, é possível acessar o Gerenciador de Negócios usando outro usuário com “acesso básico” para encontrar a lista de administradores com “controle total”.
|
|
143
|
+
|
|
142
144
|
|
|
143
|
-
|
|
145
|
+
- Entre no Meta Business Suite, acesse “Configurações do negócio” e, em seguida, acesse a aba “Pessoas”
|
|
146
|
+
- Qualquer usuário do portfólio empresarial com “acesso básico” ou mais pode acessar a lista completa de usuários e encontrar uma pessoa com “controle total”.
|
|
147
|
+
|
|
144
148
|
|
|
145
|
-
Se a empresa
|
|
149
|
+
- **Encontre administradores usando uma chamada de API**. Se a empresa não conseguir encontrar o administrador do portfólio empresarial, mas o parceiro tiver um token BISU com permissões business\_management (API), será possível buscar uma lista de usuários com permissões de “controle total” com os pontos de extremidade da API a seguir
|
|
146
150
|
|
|
147
|
-
-
|
|
151
|
+
- [Documentos sobre o ponto de extremidade da conta do WhatsApp Business](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api)
|
|
152
|
+
- [Documentos do ponto de extremidade de usuários da empresa](/docs/marketing-api/reference/business/business_users)
|
|
153
|
+
|
|
148
154
|
|
|
149
|
-
**
|
|
155
|
+
- **Envie um pedido para que um novo usuário seja adicionado ao portfólio empresarial**. Uma empresa pode enviar um pedido para adicionar um usuário com acesso de "controle total" a um portfólio empresarial. **Esse processo leva em média 24 horas para que seja possível realizar uma análise de segurança minuciosa, conferindo se todos os documentos foram fornecidos e estão em ordem. Esse deve ser um último recurso, depois que todas as outras opções tiverem sido esgotadas.**
|
|
150
156
|
|
|
151
|
-
|
|
157
|
+
- Um usuário da empresa pode pedir para ser adicionado ao portfólio empresarial com “acesso total”, desde que cumpra os requisitos de documentação descritos abaixo.
|
|
158
|
+
- Siga as instruções para [enviar um pedido para ter controle total de um portfólio empresarial](https://www.facebook.com/business/help/474856681929983)
|
|
159
|
+
- Colete os documentos necessários mencionados no link acima.
|
|
160
|
+
|
|
152
161
|
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
**Envie um pedido para que um novo usuário seja adicionado ao portfólio empresarial**.
|
|
156
|
-
|
|
157
|
-
Uma empresa pode enviar um pedido para adicionar um usuário com acesso de "controle total" a um portfólio empresarial. **Esse processo leva em média 24 horas para que seja possível realizar uma análise de segurança minuciosa, conferindo se todos os documentos foram fornecidos e estão em ordem. Esse deve ser um último recurso, depois que todas as outras opções tiverem sido esgotadas.**
|
|
158
|
-
|
|
159
|
-
- Um usuário da empresa pode pedir para ser adicionado ao portfólio empresarial com “acesso total”, desde que atenda aos requisitos de documentação descritos abaixo.- Siga as instruções para [enviar um pedido para ter controle total de um portfólio empresarial](https://www.facebook.com/business/help/474856681929983)- Colete os documentos necessários mencionados no link acima. Com os ativos coletados, preencha o [formulário de suporte para contato](https://www.facebook.com/business-support-home/contact-support).
|
|
162
|
+
Com os ativos coletados, preencha o [formulário de suporte para contato](https://www.facebook.com/business-support-home/contact-support.)
|
|
160
163
|
|
|
161
164
|
Observação: se o administrador desejado não conseguir selecionar uma empresa na lista exibida, ele poderá selecionar qualquer ativo aleatório da lista e mencionar a identificação do Gerenciador de Negócios como parte do “texto da descrição” do pedido. Caso não consiga selecionar nenhum ativo ou não tenha ativos para selecionar, entre em contato com seu gerente de parceiros.
|
|
162
165
|
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
**A Meta recomenda que todas as mensagens de marketing sejam enviadas por meio da API de MM Lite da próxima geração para aproveitar melhorias em recursos e entrega.** A API de MM Lite entrega um número igual ou maior de mensagens de marketing do que a API de Nuvem. A API de MM Lite oferece limites de mensagens mais dinâmicos para que as mensagens de marketing com alto engajamento (por exemplo, mensagens mais lidas) alcancem um número maior de clientes.
|
|
166
|
-
|
|
167
|
-
Na Índia, as mensagens de marketing da API de MM Lite que apresentam maior engajamento (por exemplo, taxas de leitura) registram até 9% mais entregas em comparação com a API de Nuvem\*.
|
|
168
|
-
|
|
169
|
-
### Etapas a serem seguidas para solucionar problemas com taxas de entrega mais baixas ao mudar para a API de MM Lite:
|
|
170
|
-
|
|
171
|
-
**Etapa 1: garanta que sua equipe entenda como funciona a priorização na API de MM Lite em relação à API de Nuvem.**
|
|
172
|
-
|
|
173
|
-
Na API de MM Lite, as mensagens com maior engajamento podem alcançar mais clientes. Enquanto os limites de mensagem por usuário da API de Nuvem podem impedir que uma mensagem seja entregue a um usuário, a API de MM Lite é capaz de reconhecer modelos de mensagem com alto engajamento (como mensagens com maiores taxas de leitura) e, quando uma mensagem é enviada, permite aplicar limites de mensagem dinâmicos.
|
|
166
|
+
## Acho que minhas taxas de entrega são mais baixas na API de MM para o WhatsApp do que eram na API de Nuvem
|
|
174
167
|
|
|
175
|
-
**
|
|
168
|
+
**A Meta recomenda que todas as mensagens de marketing sejam enviadas por meio da API de MM para o WhatsApp da próxima geração para aproveitar melhorias em recursos e entrega.** A API de MM para o WhatsApp entrega um número igual ou maior de mensagens de marketing do que a API de Nuvem. A API de MM para o WhatsApp permite limites de envio mais dinâmicos, possibilitando que mensagens de marketing com alto engajamento (por exemplo, mensagens mais lidas) alcancem um número maior de clientes.
|
|
176
169
|
|
|
177
|
-
|
|
170
|
+
Na Índia, as mensagens de marketing enviadas pela API de MM para o WhatsApp que apresentaram maior engajamento (como taxas de leitura) registraram até 9% mais entregas em comparação com a API de Nuvem\*.
|
|
178
171
|
|
|
179
|
-
|
|
172
|
+
### Etapas a serem seguidas para solucionar problemas com taxas de entrega mais baixas ao mudar para a API de MM para o WhatsApp:
|
|
180
173
|
|
|
181
|
-
|
|
174
|
+
- Garanta que sua equipe entenda como funciona a priorização na API de MM para o WhatsApp em relação à API de Nuvem. Na API de MM para o WhatsApp, as mensagens com maior engajamento podem alcançar mais clientes. Enquanto os limites de mensagem por usuário da API de Nuvem podem impedir que uma mensagem seja entregue a um usuário, a API de MM para o WhatsApp é capaz de reconhecer modelos de mensagem com alto engajamento (como mensagens com maiores taxas de leitura) e, quando uma mensagem é enviada, permite aplicar limites de mensagem dinâmicos.
|
|
175
|
+
- **Garanta que você esteja fazendo uma comparação adequada entre a API de MM para o WhatsApp e a API de Nuvem.** Muitas diferenças nas taxas de entrega podem ser atribuídas a variações como o uso de modelos, horários ou públicos diferentes. Antes de enviar um pedido de suporte, confira se você está fazendo uma comparação adequada considerando as diretrizes abaixo:
|
|
176
|
+
|
|
182
177
|
|
|
183
|
-
|
|
178
|
+
- **Compare o mesmo período.** Para comparar a entrega de mensagens com precisão, avalie campanhas veiculadas no mesmo período de quatro a sete dias. Os limites de mensagem por usuário são dinâmicos e mudam em tempo real dependendo de fatores como volume de mensagens, feriados, atividade comercial e comportamento do usuário. Por esse motivo, comparações de resultados de diferentes períodos não são confiáveis.
|
|
179
|
+
- **Compare os mesmos modelos (ou modelos extremamente parecidos).** Muitas vezes, as comparações de entrega contrastam modelos de mensagem com textos, taxas de leitura e engajamento diferentes, o que é um erro. Use o mesmo modelo para os dois pontos de extremidade das APIs. Confira se o modelo está ativo e segue as diretrizes para mensagens de marketing de qualidade.
|
|
180
|
+
- **Compare campanhas grandes com dados demográficos de público equivalentes.** Compare campanhas com pelo menos 100 mil mensagens de marketing enviadas a coortes de públicos funcionalmente idênticos. Por exemplo, divida aleatoriamente os segmentos de usuários para evitar resultados tendenciosos (como regiões geográficas, filtros de usuários ou características de ROI e engajamento diferentes). Nenhum destinatário deve receber mensagens mais de uma vez, incluindo de outras campanhas.
|
|
181
|
+
- **Compare o mesmo horário de envio.** Envie campanhas para os dois pontos de extremidade simultaneamente, para minimizar impactos externos como bloqueios ou sinalizações.
|
|
182
|
+
|
|
184
183
|
|
|
185
|
-
**
|
|
184
|
+
- **Não considere mensagens reenviadas na sua estatística de “entregas”.** Se uma mensagem não for entregue devido aos limites de mensagens de marketing por usuário, aguarde 24 horas antes de tentar novamente (consulte o [código de erro 131049](/documentation/business-messaging/whatsapp/support/error-codes)). Novas tentativas de envio da mesma mensagem diminuem artificialmente a taxa de entrega percebida, já que o mesmo limite por usuário ainda pode ser válido, gerando o mesmo resultado. Por exemplo, se 20 de 100 mensagens falharem devido aos limites e você tentar enviá-las novamente, a verdadeira taxa de entrega de 80% poderá cair para aproximadamente 67% após apenas uma nova tentativa.
|
|
185
|
+
- **Siga as boas práticas para criar mensagens de marketing com alto engajamento**
|
|
186
|
+
|
|
186
187
|
|
|
187
|
-
- **Qualidade e relevância:** priorize o envio de mensagens que ofereçam um valor claro aos clientes e evite contatos não relevantes ou impessoais. As probabilidades de leitura de mensagens relevantes são maiores, o que gera mais engajamento de clientes em potencial e existentes
|
|
188
|
-
- **
|
|
189
|
-
-
|
|
188
|
+
- **Qualidade e relevância:** priorize o envio de mensagens que ofereçam um valor claro aos clientes e evite contatos não relevantes ou impessoais. As probabilidades de leitura de mensagens relevantes são maiores, o que gera mais engajamento de clientes em potencial e existentes.
|
|
189
|
+
- **Qualidade das mensagens**:
|
|
190
|
+
- **Esperadas:** os clientes escolheram receber esse tipo de mensagens e geralmente interagem com suas mensagens de marketing. Ofereça a opção de recusar.
|
|
191
|
+
- **Oportunas**: as mensagens são enviadas em um momento lógico (por exemplo, após o engajamento inicial ou com um ritmo definido) e com frequência adequada.
|
|
192
|
+
- **Relevantes:** as mensagens são personalizadas, contêm informações importantes e incluem chamadas para ação claras.
|
|
193
|
+
- **Use os recursos da API de MM para o WhatsApp**, por exemplo:
|
|
194
|
+
- Períodos personalizáveis de validade da mensagem ([tempo de vida](/documentation/business-messaging/whatsapp/marketing-messages/send-marketing-messages#create-marketing-templates)) para garantir que as mensagens cheguem em tempo hábil
|
|
195
|
+
- Confira suas [recomendações de avaliações comparativas](/documentation/business-messaging/whatsapp/marketing-messages/view-metrics#benchmark-metrics) para melhorar o desempenho
|
|
196
|
+
|
|
190
197
|
|
|
191
|
-
|
|
198
|
+
## Acho que minhas veiculações são mais baixas na API de MM para o WhatsApp do que eram na API de Nuvem
|
|
192
199
|
|
|
193
|
-
Como a API de MM
|
|
200
|
+
Como a API de MM para o WhatsApp prioriza a entrega de mensagens de alto engajamento para os usuários, mais entregas desse tipo de mensagem podem gerar taxas de cliques (CTR) mais altas ou outros resultados na API.
|
|
194
201
|
|
|
195
|
-
Se você observar que a taxa de cliques de uma campanha é mais baixa na API de MM
|
|
202
|
+
Se você observar que a taxa de cliques de uma campanha é mais baixa na API de MM para o WhatsApp em relação à API de Nuvem, confira o seguinte:
|
|
196
203
|
|
|
197
|
-
- **Faça uma comparação A/B precisa das mesmas campanhas.** Consulte a orientação acima sobre as taxas de veiculação para configurar uma comparação A/B confiável do mesmo modelo, ao mesmo tempo, para um público grande o suficiente e que possa ser comparado, a fim de garantir que outros fatores não estejam invalidando a comparação de CTR na API de MM
|
|
204
|
+
- **Faça uma comparação A/B precisa das mesmas campanhas.** Consulte a orientação acima sobre as taxas de veiculação para configurar uma comparação A/B confiável do mesmo modelo, ao mesmo tempo, para um público grande o suficiente e que possa ser comparado, a fim de garantir que outros fatores não estejam invalidando a comparação de CTR na API de MM para o WhatsApp em relação à API de Nuvem.
|
|
205
|
+
- **Seu URL deve ser compatível com a mensuração de conversões da Meta.** As taxas de cliques serão mais baixas se os URLs não estiverem funcionando. Veja as instruções abaixo.
|
|
206
|
+
- **Avalie se as [otimizações de criativos automatizadas](/documentation/business-messaging/whatsapp/marketing-messages/send-marketing-messages#automatic-creative-optimizations) devem ser habilitadas na sua campanha.** Algumas empresas estão participando de um piloto de otimizações automáticas de criativos, que testa pequenas variações de modelos de mensagens de marketing e seleciona automaticamente a variante que recebe a maior taxa de cliques ao longo do tempo. Trabalhe com seu parceiro para determinar se a sua empresa usa esses recursos e se a sua campanha é adequada
|
|
207
|
+
|
|
198
208
|
|
|
199
|
-
|
|
209
|
+
## Não estou encontrando as métricas de conversão no site ou no app para minhas mensagens de marketing
|
|
200
210
|
|
|
201
|
-
Envie um evento de teste para garantir que seu URL seja compatível com a mensuração de conversões. Alguns parceiros reformatam os URLs antes de enviá-los à API de MM
|
|
211
|
+
Envie um evento de teste para garantir que seu URL seja compatível com a mensuração de conversões. Alguns parceiros reformatam os URLs antes de enviá-los à API de MM para o WhatsApp, o que impede a Meta de anexar uma identificação do clique ao URL, que seria usada para mensurar as conversões.
|
|
202
212
|
|
|
203
213
|
Entre em contato com seu parceiro da Meta se estiver trabalhando com uma plataforma ou um parceiro que reformata o URL de modo a impedir a mensuração de conversões pela Meta. Caso seu app esteja usando o SDK da Meta, será necessário atualizar a versão do SDK para a versão 17.0.2 ou posterior do Android SDK da Meta.
|
|
204
214
|
|
|
205
|
-
|
|
215
|
+
## Ainda preciso de ajuda
|
|
206
216
|
|
|
207
217
|
Se você tiver seguido todas as etapas de solução de problemas e ainda estiver enfrentando problemas, envie uma [pergunta de suporte direto](https://business.facebook.com/direct-support/) usando o tipo de pergunta "WABiz: mensagens de marketing".
|
|
208
218
|
|
|
209
|
-
- Em caso de entregas mais baixas na MM
|
|
210
|
-
|
|
211
|
-
### Códigos de erro da API de MM Lite
|
|
212
|
-
|
|
213
|
-
A API de MM Lite usa os [mesmos códigos de erro que a API de Nuvem](/documentation/business-messaging/whatsapp/support/error-codes), com algumas adições listadas abaixo.
|
|
214
|
-
|
|
215
|
-
### Sintaxe
|
|
216
|
-
|
|
217
|
-
```
|
|
218
|
-
{
|
|
219
|
-
"error": {
|
|
220
|
-
"message": "<MESSAGE>",
|
|
221
|
-
"type": "<TYPE>",
|
|
222
|
-
"code": <CODE>,
|
|
223
|
-
"error_data": {
|
|
224
|
-
"messaging_product": "whatsapp",
|
|
225
|
-
"details": "<DETAILS>"
|
|
226
|
-
},
|
|
227
|
-
"fbtrace_id": "<TRACE_ID>"
|
|
228
|
-
}
|
|
229
|
-
}
|
|
230
|
-
```
|
|
231
|
-
|
|
232
|
-
### Exemplo
|
|
233
|
-
|
|
234
|
-
```
|
|
235
|
-
{ "error": { "message": "(#100) Invalid parameter", "type": "OAuthException", "code": 100, "error_data": { "messaging_product": "whatsapp", "details": "Message must be a template message." }, "fbtrace_id": "Ak6nxJSySLEJz32Ps-QiZ1t" }}
|
|
236
|
-
```
|
|
237
|
-
|
|
238
|
-
### Códigos
|
|
239
|
-
|
|
240
|
-
Código
|
|
241
|
-
|
|
242
|
-
Mensagem
|
|
243
|
-
|
|
244
|
-
Detalhes
|
|
245
|
-
|
|
246
|
-
Possíveis motivos e soluções
|
|
247
|
-
|
|
248
|
-
HTTP
|
|
249
|
-
status
|
|
250
|
-
code
|
|
251
|
-
|
|
252
|
-
`100`
|
|
253
|
-
|
|
254
|
-
`(#100) Invalid parameter`
|
|
255
|
-
|
|
256
|
-
`Message must be a template message.`
|
|
257
|
-
|
|
258
|
-
Você está tentando enviar uma mensagem sem modelo. O tipo de mensagem deve ser `template`. Tente novamente usando um modelo de marketing.
|
|
259
|
-
|
|
260
|
-
400 Bad Request
|
|
261
|
-
|
|
262
|
-
`131009`
|
|
263
|
-
|
|
264
|
-
`(#131009) Parameter value is not valid`
|
|
265
|
-
|
|
266
|
-
`One or more parameter values are invalid.`
|
|
267
|
-
|
|
268
|
-
Talvez você esteja usando um parâmetro inválido. Verifique se você está usando um [parâmetro válido](/documentation/business-messaging/whatsapp/marketing-messages/send-marketing-messages) e tente novamente.
|
|
269
|
-
|
|
270
|
-
A sincronização de anúncios pode estar incompleta. Aguarde dez minutos e tente novamente. Se o problema persistir, entre em contato com o suporte.
|
|
271
|
-
|
|
272
|
-
400 Bad Request
|
|
273
|
-
|
|
274
|
-
`131055`
|
|
275
|
-
|
|
276
|
-
`(#131055) Method not allowed`
|
|
277
|
-
|
|
278
|
-
`Only marketing template messages are supported`
|
|
279
|
-
|
|
280
|
-
É possível que você tenha tentado enviar uma mensagem sem modelo ou usando um modelo de autenticação ou utilidade. Experimente enviar novamente usando um modelo de mensagem de marketing.
|
|
281
|
-
|
|
282
|
-
400 Bad Request
|
|
283
|
-
|
|
284
|
-
`134100`
|
|
285
|
-
|
|
286
|
-
`(#134100) Only marketing messages supported`
|
|
287
|
-
|
|
288
|
-
`You're only able to send marketing messages on this API.`
|
|
289
|
-
|
|
290
|
-
_Disponível na versão 23.0 da API Graph._
|
|
291
|
-
|
|
292
|
-
Você está tentando enviar um modelo de utilidade ou autenticação. Somente modelos categorizados como `MARKETING` são compatíveis.
|
|
293
|
-
|
|
294
|
-
400 Bad Request
|
|
295
|
-
|
|
296
|
-
`134101`
|
|
297
|
-
|
|
298
|
-
`(#134101) Your template is still syncing`
|
|
299
|
-
|
|
300
|
-
`When you send a message from a template, the template syncing process can take up to 10 minutes to complete. Wait a few minutes, and then try sending your message again.`
|
|
301
|
-
|
|
302
|
-
_Disponível na versão 23.0 da API Graph._
|
|
303
|
-
|
|
304
|
-
Você está tentando enviar um modelo criado recentemente antes de concluir a sincronização de anúncios. A sincronização de anúncios pode levar até dez minutos. Aguarde dez minutos e tente novamente.
|
|
305
|
-
|
|
306
|
-
400 Bad Request
|
|
307
|
-
|
|
308
|
-
`134102`
|
|
309
|
-
|
|
310
|
-
`(#134102) Template unavailable for use`
|
|
311
|
-
|
|
312
|
-
`Please check your eligibility status to ensure you are onboarded (/documentation/business-messaging/whatsapp/marketing-messages/onboarding#ensure-you-are-eligible-to-onboard ) or contact Meta's customer support.`
|
|
313
|
-
|
|
314
|
-
_Disponível na versão 23.0 da API Graph._
|
|
315
|
-
|
|
316
|
-
Não foi possível concluir a sincronização de anúncios para o modelo que você está tentando enviar ou sua conta pode não estar qualificada para a API de MM Lite.
|
|
317
|
-
|
|
318
|
-
[Verifique seu status de qualificação.](/documentation/business-messaging/whatsapp/marketing-messages/onboarding#checking-eligibility-status) Se o valor `marketing_messages_lite_api_status` da conta do WhatsApp Business for `ONBOARDED` e o problema persistir, [entre em contato com o suporte](https://business.facebook.com/direct-support/).
|
|
319
|
-
|
|
320
|
-
500 Erro de servidor interno
|
|
321
|
-
|
|
322
|
-
`134103`
|
|
323
|
-
|
|
324
|
-
`(#134103) Ineligible account type`
|
|
325
|
-
|
|
326
|
-
`The WhatsApp Business account you're using isn't eligible to send messages through MM Lite API.`
|
|
327
|
-
|
|
328
|
-
_Disponível na versão 23.0 da API Graph._
|
|
219
|
+
- Em caso de entregas mais baixas na API de MM para o WhatsApp em relação à API de Nuvem para campanhas semelhantes, selecione WABiz: Mensagens de marketing > **Entrega de mensagens** e inclua detalhes sobre como as campanhas que você está comparando estão considerando fatores semelhantes, como tempo, público, modelo e normalização de novas tentativas.
|
|
329
220
|
|
|
330
|
-
|
|
221
|
+
## Códigos de erro
|
|
331
222
|
|
|
332
|
-
|
|
223
|
+
A API de MM para o WhatsApp usa os [mesmos códigos de erro que a API de Nuvem](/documentation/business-messaging/whatsapp/support/error-codes) com [códigos de erro adicionais](/documentation/business-messaging/whatsapp/support/error-codes#mm-lite-api-error-codes).
|
|
333
224
|
|
|
334
225
|
## Perguntas frequentes
|
|
335
226
|
|
|
@@ -341,13 +232,13 @@ O WhatsApp desenvolve e opera a API do WhatsApp Business, que permite que as emp
|
|
|
341
232
|
|
|
342
233
|
**Há custos adicionais para a API de Nuvem?**
|
|
343
234
|
|
|
344
|
-
O acesso à API de Nuvem é gratuito. Esperamos que ela gere economias de custo adicionais para os desenvolvedores, pois
|
|
235
|
+
O acesso à API de Nuvem é gratuito. Esperamos que ela gere economias de custo adicionais para os desenvolvedores, pois é hospedada e mantida pela Meta.
|
|
345
236
|
|
|
346
237
|
### Perguntas frequentes sobre implementação técnica
|
|
347
238
|
|
|
348
239
|
**Qual é a arquitetura da API de Nuvem?**
|
|
349
240
|
|
|
350
|
-
A arquitetura da API de Nuvem simplifica significativamente os requisitos operacionais e de infraestrutura do
|
|
241
|
+
A arquitetura da API de Nuvem simplifica significativamente os requisitos operacionais e de infraestrutura do parceiro de soluções para a integração com a Plataforma do WhatsApp Business. Primeiro, ela elimina os requisitos de infraestrutura para executar contêineres do Docker da API do WhatsApp Business (economias de CAPEX). Em segundo lugar, ela elimina a necessidade de responsabilidades operacionais para gerenciar a implantação (economias de OPEX). 
|
|
351
242
|
|
|
352
243
|
**Como fazer a migração da API Local para a API de Nuvem?**
|
|
353
244
|
|
|
@@ -361,7 +252,7 @@ A API de Nuvem valida cada pedido de mensagem por meio de diversas verificaçõe
|
|
|
361
252
|
|
|
362
253
|
**Como posso monitorar as métricas de latência e disponibilidade da API de Nuvem em mais detalhes?**
|
|
363
254
|
|
|
364
|
-
Para ver as métricas de observabilidade específicas da API de Nuvem, consulte a [página de status da API do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fmetastatus.com%2Fwhatsapp-business-api&h=
|
|
255
|
+
Para ver as métricas de observabilidade específicas da API de Nuvem, consulte a [página de status da API do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fmetastatus.com%2Fwhatsapp-business-api&h=AT031QHaO74TYZVzxwuX16iMlMDFoLcMT_aU3cOMssdrExWad32GwSL_ej3Vw5-sOdUBTnlmQzIOtmC1IQa6CBMTbUssEORJyWOnR3BQD4aW1gEJ5hL8jA1IT_QqWvoFiuFbMXQCRRTkf1q1knjPc9KsY6w).
|
|
365
256
|
|
|
366
257
|
**Como o tempo de inatividade da disponibilidade é calculado?**
|
|
367
258
|
|
|
@@ -377,7 +268,7 @@ Em algumas situações, certos erros do usuário podem ser contabilizados automa
|
|
|
377
268
|
|
|
378
269
|
**A página de status da Meta não indica problemas com a API de Nuvem, mas ainda estou enfrentando problemas.**
|
|
379
270
|
|
|
380
|
-
Pode haver problemas que não afetam nossa disponibilidade global. Nesses casos, a [página de status da API do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fmetastatus.com%2Fwhatsapp-business-api&h=
|
|
271
|
+
Pode haver problemas que não afetam nossa disponibilidade global. Nesses casos, a [página de status da API do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fmetastatus.com%2Fwhatsapp-business-api&h=AT031QHaO74TYZVzxwuX16iMlMDFoLcMT_aU3cOMssdrExWad32GwSL_ej3Vw5-sOdUBTnlmQzIOtmC1IQa6CBMTbUssEORJyWOnR3BQD4aW1gEJ5hL8jA1IT_QqWvoFiuFbMXQCRRTkf1q1knjPc9KsY6w) terá um status indicando que pode haver interrupções que não estão afetando a disponibilidade global. Para investigar o problema, abra um tíquete no [Suporte Direto](https://business.facebook.com/direct-support).
|
|
381
272
|
|
|
382
273
|
**Há instâncias em que o período de indisponibilidade não é monitorado?**
|
|
383
274
|
|
|
@@ -385,7 +276,7 @@ Há casos em que os períodos de indisponibilidade não são monitorados automat
|
|
|
385
276
|
|
|
386
277
|
- Problemas de rede que fazem com que os pedidos falhem antes de atingirem a camada da Graph API (primeira camada).- Problemas de rede que fazem com que os webhooks de saída não alcancem o ponto de extremidade do webhook da empresa.
|
|
387
278
|
|
|
388
|
-
Os problemas que surgirem antes da admissão no nosso sistema após esse ponto aparecerão como erro ou falha. Além disso, as tentativas de emitir o
|
|
279
|
+
Os problemas que surgirem antes da admissão no nosso sistema após esse ponto aparecerão como erro ou falha. Além disso, as tentativas de emitir o webhook continuarão mesmo após os problemas encontrados depois da primeira tentativa, até que a entrega ao ponto de extremidade de Webhook seja bem-sucedida.
|
|
389
280
|
|
|
390
281
|
Veja outros casos que aparecem no painel de disponibilidade após a detecção manual (que não são erro do sistema):
|
|
391
282
|
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/throughput -->
|
|
2
|
+
<!-- Scraped: 2026-01-24T01:07:03.564Z -->
|
|
3
|
+
|
|
4
|
+
# Taxa de transferência de dados
|
|
5
|
+
|
|
6
|
+
Updated: 30 de out de 2025
|
|
7
|
+
|
|
8
|
+
Para cada número de telefone comercial registrado, a API de Nuvem é compatível com até 80 mensagens por segundo (mps). Esse limite pode aumentar para até [1.000 mps](#higher-throughput) por atualização automática.
|
|
9
|
+
|
|
10
|
+
A taxa de transferência de dados inclui mensagens enviadas e recebidas, assim como todos os tipos de mensagem. Independentemente da taxa de transferência de dados, os números de telefone comerciais ainda estarão sujeitos ao [limite de volume do caso de uso da empresa](#rate-limits) e aos [limites de modelos de mensagem](/documentation/business-messaging/whatsapp/messaging-limits) da conta do WhatsApp Business.
|
|
11
|
+
|
|
12
|
+
Se você tentar enviar mais mensagens do que o permitido pelo nível de taxa de transferência de dados atual, a API retornará o código de erro `130429` até que você volte ao nível permitido. Além disso, os níveis de taxa de transferência de dados são destinados a campanhas de mensagens envolvendo diferentes números de telefone de usuário do WhatsApp. Se tentar enviar muitas mensagens ao mesmo número de usuário do WhatsApp, você poderá receber um erro de [limite de volume de emparelhamento](#pair-rate-limits).
|
|
13
|
+
|
|
14
|
+
## Números de telefone do app WhatsApp Business
|
|
15
|
+
|
|
16
|
+
Para manter a compatibilidade com o app WhatsApp Business, os números de telefone comercias que estão em uso no app WhatsApp Business e na API de Nuvem ("[números coexistentes](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users)") têm a taxa de transferência fixa de 20 mps.
|
|
17
|
+
|
|
18
|
+
## Taxa de transferência de dados mais alta
|
|
19
|
+
|
|
20
|
+
Se você atender aos [requisitos de qualificação](#eligibility-requirements), atualizaremos a taxa de transferência de dados do seu número de telefone comercial para 1.000 mps sem custos. Isso não gerará cobranças adicionais nem afetará os preços.
|
|
21
|
+
|
|
22
|
+
O processo de atualização pode levar até 1 minuto. Durante esse período, o número de telefone não poderá ser usado na nossa plataforma. Se ele for usado em chamadas de API, o código de erro `131057` será retornado. Assim que o número de telefone comercial for atualizado, futuras alterações na taxa de transferência de dados serão feitas automaticamente sem tempo de inatividade.
|
|
23
|
+
|
|
24
|
+
Quando seu número receber uma taxa mais alta, o webhook [phone\_number\_quality\_update](/documentation/business-messaging/whatsapp/webhooks/reference/phone_number_quality_update) será acionado com `event` definido como `THROUGHPUT_UPGRADE` e `max_daily_conversations_per_business` definido como `TIER_UNLIMITED`.
|
|
25
|
+
|
|
26
|
+
## Qualificação
|
|
27
|
+
|
|
28
|
+
- O portfólio empresarial associado ao número de telefone deve ter um [limite de mensagens](/documentation/business-messaging/whatsapp/messaging-limits) ilimitado.- O número de telefone comercial deve ser usado para enviar mensagens para 100 mil ou mais números de telefone únicos de usuários do WhatsApp, fora de uma [janela de atendimento ao cliente](/documentation/business-messaging/whatsapp/messages/send-messages#customer-service-windows), em um período móvel de 24 horas.- O número de telefone comercial precisa ter uma `quality_score` de `YELLOW` (exibida como uma [classificação de qualidade](https://www.facebook.com/business/help/896873687365001)**média** no Gerenciador do WhatsApp) ou superior.
|
|
29
|
+
|
|
30
|
+
## Webhooks
|
|
31
|
+
|
|
32
|
+
Seus servidores de webhook devem suportar 3 vezes a capacidade do tráfego de mensagens de saída e 1 vez a capacidade do tráfego de mensagens de entrada esperado. Por exemplo, se considerarmos um envio de 1.000 mps a uma taxa de resposta esperada de 30%, seus servidores deverão ser capazes de processar até 3.000 webhooks de status de mensagem, mais 300 webhooks adicionais de mensagens recebidas.
|
|
33
|
+
|
|
34
|
+
Tentamos entregar os webhooks simultaneamente; por isso, recomendamos que você configure e faça um teste de carga do servidor de webhook para processar solicitações concomitantes com o padrão de latência descrito a seguir:
|
|
35
|
+
|
|
36
|
+
- Latência mediana não superior a 250 ms.- Menos de 1% de latência excede 1 s.
|
|
37
|
+
|
|
38
|
+
Tentaremos entregar os webhooks com falha novamente por até 7 dias, com retirada exponencial.
|
|
39
|
+
|
|
40
|
+
## Mensagens de mídia
|
|
41
|
+
|
|
42
|
+
Para aproveitar ao máximo a taxa de transferência de dados superior, recomendamos [carregar os ativos de mídia](/documentation/business-messaging/whatsapp/business-phone-numbers/media#upload-media) nos nossos servidores e usar os IDs de mídia retornados (em vez de hospedar os ativos nos seus servidores e usar os respectivos URLs) nas [mensagens de mídia](/documentation/business-messaging/whatsapp/messages/send-messages). Caso você prefira ou precise hospedar os ativos em servidores próprios, recomendamos usar o [armazenamento em cache de mídia](/documentation/business-messaging/whatsapp/messages/send-messages#media-http-caching).
|
|
43
|
+
|
|
44
|
+
## Como consultar o nível da taxa de transferência
|
|
45
|
+
|
|
46
|
+
Use o ponto de extremidade [Número de telefone do WhatsApp Business](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-phone-number-api) para saber o nível atual de taxa de transferência de dados do número de telefone:
|
|
47
|
+
|
|
48
|
+
```
|
|
49
|
+
GET /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>?fields=throughput
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## Migração
|
|
53
|
+
|
|
54
|
+
Se você [migrar um número de telefone comercial](/documentation/business-messaging/whatsapp/support/migrating-from-onprem-to-cloud) que tenha multiconexão executando 2 ou mais fragmentos da API Local para a API de Nuvem, ele será atualizado automaticamente para uma taxa de transferência de dados mais alta.
|
|
55
|
+
|
|
56
|
+
Você achou esta página útil?
|
|
57
|
+
|
|
58
|
+

|
|
59
|
+
|
|
60
|
+

|