whatsapp-docs-mcp 1.0.0
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/LICENSE +22 -0
- package/README.md +181 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +65 -0
- package/dist/index.js.map +1 -0
- package/dist/prompts.d.ts +22 -0
- package/dist/prompts.d.ts.map +1 -0
- package/dist/prompts.js +305 -0
- package/dist/prompts.js.map +1 -0
- package/dist/resources.d.ts +24 -0
- package/dist/resources.d.ts.map +1 -0
- package/dist/resources.js +132 -0
- package/dist/resources.js.map +1 -0
- package/dist/tools.d.ts +6 -0
- package/dist/tools.d.ts.map +1 -0
- package/dist/tools.js +379 -0
- package/dist/tools.js.map +1 -0
- package/dist/utils/fileLoader.d.ts +19 -0
- package/dist/utils/fileLoader.d.ts.map +1 -0
- package/dist/utils/fileLoader.js +126 -0
- package/dist/utils/fileLoader.js.map +1 -0
- package/dist/utils/search.d.ts +27 -0
- package/dist/utils/search.d.ts.map +1 -0
- package/dist/utils/search.js +91 -0
- package/dist/utils/search.js.map +1 -0
- package/docs/QUICK_REFERENCE.md +223 -0
- package/docs/anuncios_com_clique_para_whatsapp/AGENTS.md +8 -0
- package/docs/anuncios_com_clique_para_whatsapp/welcome_message_sequences.md +449 -0
- package/docs/ativos_da_conta/AGENTS.md +9 -0
- package/docs/ativos_da_conta/outros_ativos/AGENTS.md +12 -0
- package/docs/ativos_da_conta/outros_ativos/business_profiles.md +137 -0
- package/docs/ativos_da_conta/outros_ativos/display_names.md +108 -0
- package/docs/ativos_da_conta/outros_ativos/official_business_accounts.md +123 -0
- package/docs/ativos_da_conta/outros_ativos/qr_codes.md +198 -0
- package/docs/ativos_da_conta/outros_ativos/whatsapp_business_accounts.md +99 -0
- package/docs/ativos_da_conta/telefones_comerciais/AGENTS.md +11 -0
- package/docs/ativos_da_conta/telefones_comerciais/conversational_components.md +347 -0
- package/docs/ativos_da_conta/telefones_comerciais/phone_numbers.md +486 -0
- package/docs/ativos_da_conta/telefones_comerciais/registration.md +171 -0
- package/docs/ativos_da_conta/telefones_comerciais/two_step_verification.md +66 -0
- package/docs/catalogos/AGENTS.md +12 -0
- package/docs/catalogos/receive_responses.md +28 -0
- package/docs/catalogos/sell_products_and_services.md +24 -0
- package/docs/catalogos/set_commerce_settings.md +163 -0
- package/docs/catalogos/share_products.md +401 -0
- package/docs/catalogos/upload_inventory.md +28 -0
- package/docs/comecar/AGENTS.md +8 -0
- package/docs/comecar/get_started.md +127 -0
- package/docs/dados_privacidade_e_politica/AGENTS.md +16 -0
- package/docs/dados_privacidade_e_politica/block_users.md +549 -0
- package/docs/dados_privacidade_e_politica/data_privacy_and_security.md +78 -0
- package/docs/dados_privacidade_e_politica/encryption.md +8 -0
- package/docs/dados_privacidade_e_politica/getting_opt_in.md +41 -0
- package/docs/dados_privacidade_e_politica/identity_change.md +34 -0
- package/docs/dados_privacidade_e_politica/local_storage.md +277 -0
- package/docs/dados_privacidade_e_politica/no_storage.md +132 -0
- package/docs/dados_privacidade_e_politica/policy_enforcement.md +85 -0
- package/docs/dados_privacidade_e_politica/policy_enforcement_violations.md +127 -0
- package/docs/grupos/AGENTS.md +15 -0
- package/docs/grupos/error_codes.md +170 -0
- package/docs/grupos/faq.md +30 -0
- package/docs/grupos/get_started.md +73 -0
- package/docs/grupos/groups.md +75 -0
- package/docs/grupos/groups_messaging.md +340 -0
- package/docs/grupos/pricing.md +322 -0
- package/docs/grupos/reference.md +1059 -0
- package/docs/grupos/webhooks.md +298 -0
- package/docs/index.md +318 -0
- package/docs/insights/AGENTS.md +8 -0
- package/docs/insights/analytics.md +944 -0
- package/docs/ligacoes/AGENTS.md +20 -0
- package/docs/ligacoes/app_review_guidelines.md +48 -0
- package/docs/ligacoes/business_initiated_calls.md +858 -0
- package/docs/ligacoes/call_button_messages_deep_links.md +454 -0
- package/docs/ligacoes/call_settings.md +643 -0
- package/docs/ligacoes/calling.md +130 -0
- package/docs/ligacoes/faq.md +468 -0
- package/docs/ligacoes/integration_patterns.md +121 -0
- package/docs/ligacoes/pricing.md +339 -0
- package/docs/ligacoes/reference.md +1923 -0
- package/docs/ligacoes/sip.md +1090 -0
- package/docs/ligacoes/troubleshooting.md +483 -0
- package/docs/ligacoes/user_call_permissions.md +672 -0
- package/docs/ligacoes/user_initiated_calls.md +1030 -0
- package/docs/mensagens/AGENTS.md +46 -0
- package/docs/mensagens/limites_de_mensagens/AGENTS.md +9 -0
- package/docs/mensagens/limites_de_mensagens/messaging_limits.md +91 -0
- package/docs/mensagens/limites_de_mensagens/upcoming_changes.md +8 -0
- package/docs/mensagens/recursos_adicionais/AGENTS.md +13 -0
- package/docs/mensagens/recursos_adicionais/contextual_replies.md +82 -0
- package/docs/mensagens/recursos_adicionais/link_previews.md +58 -0
- package/docs/mensagens/recursos_adicionais/mark_message_as_read.md +111 -0
- package/docs/mensagens/recursos_adicionais/media.md +419 -0
- package/docs/mensagens/recursos_adicionais/payload_encryption.md +8 -0
- package/docs/mensagens/recursos_adicionais/typing_indicators.md +117 -0
- package/docs/mensagens/tipos_de_mensagens/AGENTS.md +24 -0
- package/docs/mensagens/tipos_de_mensagens/address_messages.md +465 -0
- package/docs/mensagens/tipos_de_mensagens/audio_messages.md +211 -0
- package/docs/mensagens/tipos_de_mensagens/contacts_messages.md +482 -0
- package/docs/mensagens/tipos_de_mensagens/document_messages.md +232 -0
- package/docs/mensagens/tipos_de_mensagens/image_messages.md +176 -0
- package/docs/mensagens/tipos_de_mensagens/interactive_cta_url_messages.md +240 -0
- package/docs/mensagens/tipos_de_mensagens/interactive_flow_messages.md +8 -0
- package/docs/mensagens/tipos_de_mensagens/interactive_list_messages.md +300 -0
- package/docs/mensagens/tipos_de_mensagens/interactive_reply_buttons_messages.md +271 -0
- package/docs/mensagens/tipos_de_mensagens/location_messages.md +156 -0
- package/docs/mensagens/tipos_de_mensagens/location_request_messages.md +310 -0
- package/docs/mensagens/tipos_de_mensagens/message_with_link.md +8 -0
- package/docs/mensagens/tipos_de_mensagens/reaction_messages.md +144 -0
- package/docs/mensagens/tipos_de_mensagens/sticker_messages.md +157 -0
- package/docs/mensagens/tipos_de_mensagens/template_messages.md +20 -0
- package/docs/mensagens/tipos_de_mensagens/text_messages.md +142 -0
- package/docs/mensagens/tipos_de_mensagens/video_messages.md +149 -0
- package/docs/mensagens/visao_geral/AGENTS.md +8 -0
- package/docs/mensagens/visao_geral/send_messages.md +370 -0
- package/docs/mensagens_de_marketing/AGENTS.md +10 -0
- package/docs/mensagens_de_marketing/implementacao/AGENTS.md +10 -0
- package/docs/mensagens_de_marketing/implementacao/get_started.md +107 -0
- package/docs/mensagens_de_marketing/implementacao/onboard_business_customers.md +180 -0
- package/docs/mensagens_de_marketing/implementacao/send_marketing_messages.md +260 -0
- package/docs/mensagens_de_marketing/recursos/AGENTS.md +12 -0
- package/docs/mensagens_de_marketing/recursos/automatic_creative_optimization.md +8 -0
- package/docs/mensagens_de_marketing/recursos/conversion_measurement.md +8 -0
- package/docs/mensagens_de_marketing/recursos/deep_links.md +302 -0
- package/docs/mensagens_de_marketing/recursos/track_click_events.md +119 -0
- package/docs/mensagens_de_marketing/recursos/view_metrics.md +338 -0
- package/docs/mensagens_de_marketing/visao_geral/AGENTS.md +8 -0
- package/docs/mensagens_de_marketing/visao_geral/overview.md +26 -0
- package/docs/modelos/AGENTS.md +12 -0
- package/docs/modelos/gerenciamento_de_modelos/AGENTS.md +21 -0
- package/docs/modelos/gerenciamento_de_modelos/components.md +717 -0
- package/docs/modelos/gerenciamento_de_modelos/supported_languages.md +462 -0
- package/docs/modelos/gerenciamento_de_modelos/tap_target_url_title_override.md +211 -0
- package/docs/modelos/gerenciamento_de_modelos/template_categorization.md +499 -0
- package/docs/modelos/gerenciamento_de_modelos/template_comparison.md +136 -0
- package/docs/modelos/gerenciamento_de_modelos/template_library.md +526 -0
- package/docs/modelos/gerenciamento_de_modelos/template_management.md +148 -0
- package/docs/modelos/gerenciamento_de_modelos/template_media.md +8 -0
- package/docs/modelos/gerenciamento_de_modelos/template_migration.md +164 -0
- package/docs/modelos/gerenciamento_de_modelos/template_pacing.md +38 -0
- package/docs/modelos/gerenciamento_de_modelos/template_pausing.md +58 -0
- package/docs/modelos/gerenciamento_de_modelos/template_quality.md +47 -0
- package/docs/modelos/gerenciamento_de_modelos/template_review.md +74 -0
- package/docs/modelos/gerenciamento_de_modelos/time_to_live.md +88 -0
- package/docs/modelos/modelos_de_autenticacao/AGENTS.md +13 -0
- package/docs/modelos/modelos_de_autenticacao/authentication_best_practices.md +73 -0
- package/docs/modelos/modelos_de_autenticacao/authentication_templates.md +252 -0
- package/docs/modelos/modelos_de_autenticacao/autofill_button_authentication_templates.md +732 -0
- package/docs/modelos/modelos_de_autenticacao/copy_code_button_authentication_templates.md +402 -0
- package/docs/modelos/modelos_de_autenticacao/error_signals.md +143 -0
- package/docs/modelos/modelos_de_autenticacao/zero_tap_authentication_templates.md +742 -0
- package/docs/modelos/modelos_de_marketing/AGENTS.md +18 -0
- package/docs/modelos/modelos_de_marketing/call_permission_request_message_template.md +221 -0
- package/docs/modelos/modelos_de_marketing/catalog_templates.md +308 -0
- package/docs/modelos/modelos_de_marketing/coupon_templates.md +425 -0
- package/docs/modelos/modelos_de_marketing/custom_marketing_templates.md +537 -0
- package/docs/modelos/modelos_de_marketing/limited_time_offer_templates.md +496 -0
- package/docs/modelos/modelos_de_marketing/marketing_templates.md +112 -0
- package/docs/modelos/modelos_de_marketing/media_card_carousel_templates.md +770 -0
- package/docs/modelos/modelos_de_marketing/mpm_templates.md +717 -0
- package/docs/modelos/modelos_de_marketing/per_user_limits.md +42 -0
- package/docs/modelos/modelos_de_marketing/product_card_carousel_templates.md +515 -0
- package/docs/modelos/modelos_de_marketing/spm_templates.md +466 -0
- package/docs/modelos/modelos_de_utilidade/AGENTS.md +8 -0
- package/docs/modelos/modelos_de_utilidade/utility_templates.md +583 -0
- package/docs/modelos/visao_geral/AGENTS.md +8 -0
- package/docs/modelos/visao_geral/overview.md +163 -0
- package/docs/pagamentos/AGENTS.md +9 -0
- package/docs/pagamentos/pagamentos_na_india/AGENTS.md +19 -0
- package/docs/pagamentos/pagamentos_na_india/checkout_button_templates.md +1332 -0
- package/docs/pagamentos/pagamentos_na_india/enhanced_payment_links.md +93 -0
- package/docs/pagamentos/pagamentos_na_india/onboarding_apis.md +580 -0
- package/docs/pagamentos/pagamentos_na_india/orderdetailstemplate.md +205 -0
- package/docs/pagamentos/pagamentos_na_india/orderstatustemplate.md +143 -0
- package/docs/pagamentos/pagamentos_na_india/overview.md +102 -0
- package/docs/pagamentos/pagamentos_na_india/payment_links.md +581 -0
- package/docs/pagamentos/pagamentos_na_india/pg.md +1228 -0
- package/docs/pagamentos/pagamentos_na_india/upi_intent/AGENTS.md +12 -0
- package/docs/pagamentos/pagamentos_na_india/upi_intent/dynamic_vpa.md +572 -0
- package/docs/pagamentos/pagamentos_na_india/upi_intent/pg_guide_billdesk.md +343 -0
- package/docs/pagamentos/pagamentos_na_india/upi_intent/pg_guide_cashfree.md +145 -0
- package/docs/pagamentos/pagamentos_na_india/upi_intent/pg_guide_ccavenue.md +146 -0
- package/docs/pagamentos/pagamentos_na_india/upi_intent/upi_intent.md +660 -0
- package/docs/pagamentos/pagamentos_no_brasil/AGENTS.md +14 -0
- package/docs/pagamentos/pagamentos_no_brasil/boleto.md +104 -0
- package/docs/pagamentos/pagamentos_no_brasil/offsite_pix.md +128 -0
- package/docs/pagamentos/pagamentos_no_brasil/one_click_payments.md +226 -0
- package/docs/pagamentos/pagamentos_no_brasil/orderdetailstemplate.md +180 -0
- package/docs/pagamentos/pagamentos_no_brasil/orders.md +768 -0
- package/docs/pagamentos/pagamentos_no_brasil/overview.md +32 -0
- package/docs/pagamentos/pagamentos_no_brasil/payment_links.md +104 -0
- package/docs/parceiros/AGENTS.md +12 -0
- package/docs/parceiros/analise_do_app/AGENTS.md +8 -0
- package/docs/parceiros/analise_do_app/app_review.md +91 -0
- package/docs/parceiros/gerenciamento/AGENTS.md +14 -0
- package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/AGENTS.md +15 -0
- package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/manage_accounts.md +274 -0
- package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/manage_system_users.md +106 -0
- package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/manage_webhooks.md +277 -0
- package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/numeros_de_telefone/AGENTS.md +9 -0
- package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/numeros_de_telefone/manage_phone_numbers.md +248 -0
- package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/numeros_de_telefone/registering_phone_numbers.md +373 -0
- package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/share_and_revoke_credit_lines.md +551 -0
- package/docs/parceiros/gerenciamento/partner_led_business_verification.md +367 -0
- package/docs/parceiros/gerenciamento/pixel_tracking.md +35 -0
- package/docs/parceiros/gerenciamento/suporte_ao_parceiro/AGENTS.md +18 -0
- package/docs/parceiros/gerenciamento/suporte_ao_parceiro/adding_waba_to_mps.md +64 -0
- package/docs/parceiros/gerenciamento/suporte_ao_parceiro/business_customer_support.md +102 -0
- package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_customers_off_solutions_via_embedded_signup.md +151 -0
- package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_customers_off_solutions_via_meta_business_suite.md +234 -0
- package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_phone_numbers_among_solution_partners_programmatically.md +292 -0
- package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_phone_numbers_among_solution_partners_via_embedded_signup.md +118 -0
- package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_wabas_among_solution_partners_via_embedded_signup.md +76 -0
- package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_wabas_among_solutions_via_embedded_signup.md +90 -0
- package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_wabas_among_solutions_via_meta_business_suite.md +265 -0
- package/docs/parceiros/gerenciamento/suporte_ao_parceiro/support.md +48 -0
- package/docs/parceiros/gerenciamento/suporte_ao_parceiro/transferring_wabas_to_customers.md +8 -0
- package/docs/parceiros/integracao_de_clientes/AGENTS.md +9 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/AGENTS.md +26 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/app_only_install.md +135 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/automatic_events_api.md +204 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/bypass_phone_addition.md +52 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/custom_flows.md +40 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/default_flow.md +90 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/errors.md +185 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/hosted_es.md +153 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/implementation.md +417 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/onboarding_business_app_users.md +926 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/onboarding_customers_as_a_solution_partner.md +402 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/onboarding_customers_as_a_tech_provider.md +332 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/overview.md +168 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/pre_filled_data.md +524 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/pre_verified_numbers.md +291 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/versions/AGENTS.md +12 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/versions/version_2_public_preview.md +88 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/versions/version_3.md +98 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/versions/version_3_public_preview.md +88 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/versions/version_4.md +92 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/versions/versions.md +463 -0
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/website_optional.md +57 -0
- package/docs/parceiros/integracao_de_clientes/outras_opcoes_de_integracao/AGENTS.md +11 -0
- package/docs/parceiros/integracao_de_clientes/outras_opcoes_de_integracao/multi_partner_solution_embedded_creation.md +178 -0
- package/docs/parceiros/integracao_de_clientes/outras_opcoes_de_integracao/multi_partner_solutions.md +775 -0
- package/docs/parceiros/integracao_de_clientes/outras_opcoes_de_integracao/multi_solution_conversations.md +319 -0
- package/docs/parceiros/integracao_de_clientes/outras_opcoes_de_integracao/partner_initiated_waba_creation.md +74 -0
- package/docs/parceiros/seja_um_parceiro/AGENTS.md +11 -0
- package/docs/parceiros/seja_um_parceiro/get_started_for_solution_partners.md +280 -0
- package/docs/parceiros/seja_um_parceiro/get_started_for_tech_providers.md +194 -0
- package/docs/parceiros/seja_um_parceiro/measurement_partners.md +146 -0
- package/docs/parceiros/seja_um_parceiro/upgrade_to_tech_partner.md +94 -0
- package/docs/parceiros/visao_geral/AGENTS.md +8 -0
- package/docs/parceiros/visao_geral/overview.md +190 -0
- package/docs/recado/AGENTS.md +9 -0
- package/docs/recado/precos/AGENTS.md +11 -0
- package/docs/recado/precos/pricing.md +915 -0
- package/docs/recado/precos/pricing_authentication_international_rates.md +464 -0
- package/docs/recado/precos/pricing_conversation_based_pricing.md +773 -0
- package/docs/recado/precos/pricing_updates_to_pricing.md +8 -0
- package/docs/recado/sobre_a_plataforma/AGENTS.md +10 -0
- package/docs/recado/sobre_a_plataforma/about_the_platform.md +217 -0
- package/docs/recado/sobre_a_plataforma/access_tokens.md +110 -0
- package/docs/recado/sobre_a_plataforma/permissions.md +55 -0
- package/docs/referencia/AGENTS.md +92 -0
- package/docs/referencia/bot_do_whatsapp_business/AGENTS.md +8 -0
- package/docs/referencia/bot_do_whatsapp_business/bot_details_api.md +762 -0
- package/docs/referencia/business/AGENTS.md +14 -0
- package/docs/referencia/business/add_phone_numbers_api.md +726 -0
- package/docs/referencia/business/client_whatsapp_business_accounts_api.md +1006 -0
- package/docs/referencia/business/owned_whatsapp_business_accounts.md +802 -0
- package/docs/referencia/business/whatsapp_business_accounts_api.md +1550 -0
- package/docs/referencia/business/whatsapp_business_partner_onboarding_to_mm_lite_api.md +783 -0
- package/docs/referencia/business/whatsapp_business_pre_verified_phone_number_sharing_api.md +790 -0
- package/docs/referencia/business/whatsapp_business_pre_verified_phone_numbers_api.md +886 -0
- package/docs/referencia/changelog.md +10 -0
- package/docs/referencia/conta_do_whatsapp_business/AGENTS.md +24 -0
- package/docs/referencia/conta_do_whatsapp_business/assigned_users_management_api.md +2202 -0
- package/docs/referencia/conta_do_whatsapp_business/business_account_api.md +267 -0
- package/docs/referencia/conta_do_whatsapp_business/business_account_extended_credits_api.md +275 -0
- package/docs/referencia/conta_do_whatsapp_business/conversational_automation_api.md +782 -0
- package/docs/referencia/conta_do_whatsapp_business/flows_api.md +1532 -0
- package/docs/referencia/conta_do_whatsapp_business/in_progress_on_behalf_requests_api.md +8 -0
- package/docs/referencia/conta_do_whatsapp_business/migration_intent_api.md +1581 -0
- package/docs/referencia/conta_do_whatsapp_business/obo_mobility_intent_api.md +8 -0
- package/docs/referencia/conta_do_whatsapp_business/phone_number_management_api.md +1686 -0
- package/docs/referencia/conta_do_whatsapp_business/schedules_api.md +1772 -0
- package/docs/referencia/conta_do_whatsapp_business/set_obo_mobility_intent_api.md +8 -0
- package/docs/referencia/conta_do_whatsapp_business/set_solution_migration_intent_api.md +8 -0
- package/docs/referencia/conta_do_whatsapp_business/subscribed_apps_api.md +2178 -0
- package/docs/referencia/conta_do_whatsapp_business/template_api.md +976 -0
- package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_activities_api.md +842 -0
- package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_api.md +1384 -0
- package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_solutions_list_api.md +854 -0
- package/docs/referencia/grupo/AGENTS.md +11 -0
- package/docs/referencia/grupo/groups_invite_link_api.md +304 -0
- package/docs/referencia/grupo/groups_join_requests_api.md +686 -0
- package/docs/referencia/grupo/groups_participants_api.md +274 -0
- package/docs/referencia/grupo/groups_query_api.md +436 -0
- package/docs/referencia/historico_de_mensagens/AGENTS.md +8 -0
- package/docs/referencia/historico_de_mensagens/whatsapp_business_message_history_events_api.md +866 -0
- package/docs/referencia/inscricao/AGENTS.md +10 -0
- package/docs/referencia/inscricao/application_connected_client_businesses.md +812 -0
- package/docs/referencia/inscricao/application_solutions_api.md +874 -0
- package/docs/referencia/inscricao/solution_creation_api.md +824 -0
- package/docs/referencia/intencao_de_migracao_da_conta_do_whatsapp_business/AGENTS.md +8 -0
- package/docs/referencia/intencao_de_migracao_da_conta_do_whatsapp_business/migration_intent_details_api.md +724 -0
- package/docs/referencia/midias/AGENTS.md +9 -0
- package/docs/referencia/midias/media_api.md +342 -0
- package/docs/referencia/midias/media_download_api.md +160 -0
- package/docs/referencia/numero_da_conta_do_whatsapp/AGENTS.md +8 -0
- package/docs/referencia/numero_da_conta_do_whatsapp/whatsapp_account_number_api.md +778 -0
- package/docs/referencia/perfil_do_whatsapp_business/AGENTS.md +8 -0
- package/docs/referencia/perfil_do_whatsapp_business/whatsapp_business_profile_node_api.md +1494 -0
- package/docs/referencia/solucao_do_whatsapp_business/AGENTS.md +14 -0
- package/docs/referencia/solucao_do_whatsapp_business/accept_deactivation_request_api.md +762 -0
- package/docs/referencia/solucao_do_whatsapp_business/access_token_api.md +704 -0
- package/docs/referencia/solucao_do_whatsapp_business/reject_deactivation_request_api.md +812 -0
- package/docs/referencia/solucao_do_whatsapp_business/send_deactivation_request_api.md +778 -0
- package/docs/referencia/solucao_do_whatsapp_business/solution_accept_api.md +812 -0
- package/docs/referencia/solucao_do_whatsapp_business/solution_details_api.md +768 -0
- package/docs/referencia/solucao_do_whatsapp_business/solution_reject_api.md +798 -0
- package/docs/referencia/telefone_do_whatsapp_business/AGENTS.md +29 -0
- package/docs/referencia/telefone_do_whatsapp_business/block_api.md +542 -0
- package/docs/referencia/telefone_do_whatsapp_business/business_compliance_information_api.md +1608 -0
- package/docs/referencia/telefone_do_whatsapp_business/business_encryption_api.md +1402 -0
- package/docs/referencia/telefone_do_whatsapp_business/calling_api.md +598 -0
- package/docs/referencia/telefone_do_whatsapp_business/encrypted_messages_api.md +482 -0
- package/docs/referencia/telefone_do_whatsapp_business/groups_management_api.md +485 -0
- package/docs/referencia/telefone_do_whatsapp_business/marketing_messages_lite_api.md +315 -0
- package/docs/referencia/telefone_do_whatsapp_business/media_upload_api.md +188 -0
- package/docs/referencia/telefone_do_whatsapp_business/message_api.md +1798 -0
- package/docs/referencia/telefone_do_whatsapp_business/phone_number_api.md +377 -0
- package/docs/referencia/telefone_do_whatsapp_business/phone_number_deregister_api.md +714 -0
- package/docs/referencia/telefone_do_whatsapp_business/phone_number_registration.md +780 -0
- package/docs/referencia/telefone_do_whatsapp_business/phone_number_verification_request_code_api.md +734 -0
- package/docs/referencia/telefone_do_whatsapp_business/register_api.md +411 -0
- package/docs/referencia/telefone_do_whatsapp_business/settings_api.md +674 -0
- package/docs/referencia/telefone_do_whatsapp_business/verify_code_api.md +746 -0
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_message_history_api.md +932 -0
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_official_business_account_status_api.md +1540 -0
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_phone_number_api.md +1600 -0
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_profile_api.md +1478 -0
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_qr_code_api.md +1179 -0
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_qr_code_management_api.md +1315 -0
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/AGENTS.md +11 -0
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/request_verification_code_api.md +778 -0
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/verify_code_api.md +768 -0
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/whatsapp_business_pre_verified_phone_number_api.md +1382 -0
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/whatsapp_business_pre_verified_phone_number_partners_api.md +820 -0
- package/docs/referencia/usuario/AGENTS.md +8 -0
- package/docs/referencia/usuario/assigned_whatsapp_business_accounts_api.md +864 -0
- package/docs/referencia/webhooks/AGENTS.md +8 -0
- package/docs/referencia/webhooks/whatsapp_incoming_webhook_payload.md +1655 -0
- package/docs/suporte/AGENTS.md +13 -0
- package/docs/suporte/api_status_page.md +134 -0
- package/docs/suporte/error_codes.md +1194 -0
- package/docs/suporte/experiments.md +26 -0
- package/docs/suporte/health_status.md +225 -0
- package/docs/suporte/load_testing.md +340 -0
- package/docs/suporte/support.md +408 -0
- package/docs/visao_geral/AGENTS.md +8 -0
- package/docs/visao_geral/overview.md +2590 -0
- package/docs/webhooks/AGENTS.md +41 -0
- package/docs/webhooks/referencia/AGENTS.md +20 -0
- package/docs/webhooks/referencia/account_alerts.md +190 -0
- package/docs/webhooks/referencia/account_review_update.md +90 -0
- package/docs/webhooks/referencia/account_update.md +379 -0
- package/docs/webhooks/referencia/business_capability_update.md +121 -0
- package/docs/webhooks/referencia/history.md +302 -0
- package/docs/webhooks/referencia/message_template_components_update.md +179 -0
- package/docs/webhooks/referencia/message_template_quality_update.md +136 -0
- package/docs/webhooks/referencia/message_template_status_update.md +253 -0
- package/docs/webhooks/referencia/messages/AGENTS.md +24 -0
- package/docs/webhooks/referencia/messages/audio.md +298 -0
- package/docs/webhooks/referencia/messages/button.md +170 -0
- package/docs/webhooks/referencia/messages/contacts.md +491 -0
- package/docs/webhooks/referencia/messages/document.md +307 -0
- package/docs/webhooks/referencia/messages/errors.md +132 -0
- package/docs/webhooks/referencia/messages/image.md +304 -0
- package/docs/webhooks/referencia/messages/interactive.md +225 -0
- package/docs/webhooks/referencia/messages/location.md +296 -0
- package/docs/webhooks/referencia/messages/messages.md +44 -0
- package/docs/webhooks/referencia/messages/order.md +208 -0
- package/docs/webhooks/referencia/messages/reaction.md +178 -0
- package/docs/webhooks/referencia/messages/status.md +364 -0
- package/docs/webhooks/referencia/messages/sticker.md +298 -0
- package/docs/webhooks/referencia/messages/system.md +140 -0
- package/docs/webhooks/referencia/messages/text.md +322 -0
- package/docs/webhooks/referencia/messages/unsupported.md +165 -0
- package/docs/webhooks/referencia/messages/video.md +304 -0
- package/docs/webhooks/referencia/outros_webhooks/AGENTS.md +16 -0
- package/docs/webhooks/referencia/outros_webhooks/partner_solutions.md +114 -0
- package/docs/webhooks/referencia/outros_webhooks/payment_configuration_update.md +135 -0
- package/docs/webhooks/referencia/outros_webhooks/phone_number_name_update.md +129 -0
- package/docs/webhooks/referencia/outros_webhooks/phone_number_quality_update.md +172 -0
- package/docs/webhooks/referencia/outros_webhooks/security.md +108 -0
- package/docs/webhooks/referencia/outros_webhooks/smb_app_state_sync.md +146 -0
- package/docs/webhooks/referencia/outros_webhooks/smb_message_echoes.md +143 -0
- package/docs/webhooks/referencia/outros_webhooks/template_category_update.md +154 -0
- package/docs/webhooks/referencia/outros_webhooks/user_preferences.md +150 -0
- package/docs/webhooks/visao_geral/AGENTS.md +11 -0
- package/docs/webhooks/visao_geral/message_echoes.md +8 -0
- package/docs/webhooks/visao_geral/override.md +235 -0
- package/docs/webhooks/visao_geral/overview.md +158 -0
- package/docs/webhooks/visao_geral/set_up_whatsapp_echo_bot.md +109 -0
- package/package.json +50 -0
|
@@ -0,0 +1,340 @@
|
|
|
1
|
+
<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/groups/groups-messaging -->
|
|
2
|
+
<!-- Scraped: 2025-12-20T17:42:42.798Z -->
|
|
3
|
+
|
|
4
|
+
# Mensagens em grupo
|
|
5
|
+
|
|
6
|
+
Updated: 14 de nov de 2025
|
|
7
|
+
|
|
8
|
+
## Visão geral
|
|
9
|
+
|
|
10
|
+
Este documento fornece informações abrangentes sobre as APIs e webhooks disponíveis para enviar e receber mensagens em grupos. Ela detalha o suporte para vários tipos de mensagens, incluindo:
|
|
11
|
+
|
|
12
|
+
- SMS- Mensagens de mídia- Modelos baseados em texto- Modelos baseados em mídia
|
|
13
|
+
|
|
14
|
+
## Assinar webhooks de metadados de grupos
|
|
15
|
+
|
|
16
|
+
Para receber notificações de webhook com metadados sobre seus grupos, assine os seguintes campos de webhook:
|
|
17
|
+
|
|
18
|
+
- `group_lifecycle_update`- `group_participants_update`- `group_settings_update`- `group_status_update`
|
|
19
|
+
|
|
20
|
+
Para ver uma referência completa de webhooks para a API de Grupos, acesse [Webhooks para a referência da API de Grupos](/documentation/business-messaging/whatsapp/groups/webhooks).
|
|
21
|
+
|
|
22
|
+
## Enviar mensagens de grupo
|
|
23
|
+
|
|
24
|
+
Para enviar uma mensagem de grupo, use o ponto de extremidade de envio de mensagens existente:
|
|
25
|
+
|
|
26
|
+
`POST /<BUSINESS_PHONE_NUMBER_ID>/messages`
|
|
27
|
+
|
|
28
|
+
A compatibilidade desse ponto de extremidade foi estendida para incluir mensagens de grupo da seguinte maneira:
|
|
29
|
+
|
|
30
|
+
- O campo `recipient_type` agora é compatível com `group` e `individual`.- O campo `to` agora é compatível com `group ID`, que é obtida ao usar a API de Grupos.
|
|
31
|
+
|
|
32
|
+
### Exemplo de envio de mensagem em grupo
|
|
33
|
+
|
|
34
|
+
```
|
|
35
|
+
curl 'https://graph.facebook.com/v24.0/756079150920219/messages' \
|
|
36
|
+
-H 'Content-Type: application/json' \
|
|
37
|
+
-H 'Authorization: Bearer EAAAu...' \
|
|
38
|
+
-d '
|
|
39
|
+
{
|
|
40
|
+
"messaging_product": "whatsapp",
|
|
41
|
+
"recipient_type": "group",
|
|
42
|
+
"to": "Y2FwaV9ncm91cDoxNzA1NTU1MDEzOToxMjAzNjM0MDQ2OTQyMzM4MjAZD",
|
|
43
|
+
"type": "text",
|
|
44
|
+
"text": {
|
|
45
|
+
"preview_url": true,
|
|
46
|
+
"body": "This is another destination option: https://www.luckytravel.com/DDLmU5F1Pw"
|
|
47
|
+
}
|
|
48
|
+
}'
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### Webhooks
|
|
52
|
+
|
|
53
|
+
#### Exemplo de mensagem de grupo enviada
|
|
54
|
+
|
|
55
|
+
```
|
|
56
|
+
{
|
|
57
|
+
"object": "whatsapp_business_account",
|
|
58
|
+
"entry": [
|
|
59
|
+
{
|
|
60
|
+
"id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
|
|
61
|
+
"changes": [
|
|
62
|
+
{
|
|
63
|
+
"value": {
|
|
64
|
+
"messaging_product": "whatsapp",
|
|
65
|
+
"metadata": {
|
|
66
|
+
"display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
|
|
67
|
+
"phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
|
|
68
|
+
},
|
|
69
|
+
"statuses": [
|
|
70
|
+
{
|
|
71
|
+
"id": "<WHATSAPP_MESSAGE_ID>",
|
|
72
|
+
"recipient_id": "<GROUP_ID>",
|
|
73
|
+
"recipient_type": "group",
|
|
74
|
+
"status": "sent",
|
|
75
|
+
"timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
|
|
76
|
+
}
|
|
77
|
+
]
|
|
78
|
+
},
|
|
79
|
+
"field": "messages"
|
|
80
|
+
}
|
|
81
|
+
]
|
|
82
|
+
}
|
|
83
|
+
]
|
|
84
|
+
}
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
#### Exemplo de falha na mensagem de grupo
|
|
88
|
+
|
|
89
|
+
```
|
|
90
|
+
{
|
|
91
|
+
"object": "whatsapp_business_account",
|
|
92
|
+
"entry": [
|
|
93
|
+
{
|
|
94
|
+
"id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
|
|
95
|
+
"changes": [
|
|
96
|
+
{
|
|
97
|
+
"value": {
|
|
98
|
+
"messaging_product": "whatsapp",
|
|
99
|
+
"metadata": {
|
|
100
|
+
"display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
|
|
101
|
+
"phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
|
|
102
|
+
},
|
|
103
|
+
"statuses": [
|
|
104
|
+
{
|
|
105
|
+
"id": "<WHATSAPP_MESSAGE_ID>",
|
|
106
|
+
"recipient_id": "<GROUP_ID>",
|
|
107
|
+
"recipient_type": "group",
|
|
108
|
+
"status": "failed",
|
|
109
|
+
"timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
|
|
110
|
+
"errors": [
|
|
111
|
+
{
|
|
112
|
+
"code": "<ERROR_CODE>",
|
|
113
|
+
"title": "<ERROR_TITLE>",
|
|
114
|
+
"message": "<ERROR_MESSAGE>",
|
|
115
|
+
"error_data": {
|
|
116
|
+
"details": "<ERROR_DETAILS>",
|
|
117
|
+
},
|
|
118
|
+
"href": "/documentation/business-messaging/whatsapp/support/error-codes"
|
|
119
|
+
}
|
|
120
|
+
]
|
|
121
|
+
}
|
|
122
|
+
]
|
|
123
|
+
},
|
|
124
|
+
"field": "messages"
|
|
125
|
+
}
|
|
126
|
+
]
|
|
127
|
+
}
|
|
128
|
+
]
|
|
129
|
+
}
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
## Receber mensagens de grupo
|
|
133
|
+
|
|
134
|
+
Você pode usar os webhooks a seguir para receber o status das mensagens recebidas no grupo.
|
|
135
|
+
|
|
136
|
+
O objeto `message` inclui um campo `group_id` para indicar que se trata de uma mensagem de grupo. O campo `from` no objeto `message` e o objeto de contato apontam para o mesmo participante que envia a mensagem.
|
|
137
|
+
|
|
138
|
+
### Webhooks
|
|
139
|
+
|
|
140
|
+
#### Exemplo de webhook para receber mensagens de grupo
|
|
141
|
+
|
|
142
|
+
```
|
|
143
|
+
{
|
|
144
|
+
"object": "whatsapp_business_account",
|
|
145
|
+
"entry": [{
|
|
146
|
+
"id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
|
|
147
|
+
"changes": [{
|
|
148
|
+
"value": {
|
|
149
|
+
"messaging_product": "whatsapp",
|
|
150
|
+
"metadata": {
|
|
151
|
+
"display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
|
|
152
|
+
"phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
|
|
153
|
+
},
|
|
154
|
+
"contacts": [{
|
|
155
|
+
"profile": {
|
|
156
|
+
"name": "<WHATSAPP_USER_NAME>"
|
|
157
|
+
},
|
|
158
|
+
"wa_id": "<WHATSAPP_USER_PHONE_NUMBER>"
|
|
159
|
+
}],
|
|
160
|
+
"messages": [{
|
|
161
|
+
"from": "<GROUP_PARTICIPANT_PHONE_NUMBER>",
|
|
162
|
+
"group_id": "<GROUP_ID>",
|
|
163
|
+
"id": "<WHATSAPP_MESSAGE_ID>",
|
|
164
|
+
"timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
|
|
165
|
+
"text": {
|
|
166
|
+
"body": "<MESSAGE_BODY>"
|
|
167
|
+
},
|
|
168
|
+
"type": "text"
|
|
169
|
+
}]
|
|
170
|
+
},
|
|
171
|
+
"field": "messages"
|
|
172
|
+
}]
|
|
173
|
+
}]
|
|
174
|
+
}
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
#### Exemplo de webhook para receber mensagens de grupo incompatíveis
|
|
178
|
+
|
|
179
|
+
```
|
|
180
|
+
{
|
|
181
|
+
"object": "whatsapp_business_account",
|
|
182
|
+
"entry": [
|
|
183
|
+
{
|
|
184
|
+
"id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
|
|
185
|
+
"changes": [
|
|
186
|
+
{
|
|
187
|
+
"value": {
|
|
188
|
+
"messaging_product": "whatsapp",
|
|
189
|
+
"metadata": {
|
|
190
|
+
"display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
|
|
191
|
+
"phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>",
|
|
192
|
+
},
|
|
193
|
+
"contacts": [
|
|
194
|
+
{
|
|
195
|
+
"profile": {
|
|
196
|
+
"name": "<WHATSAPP_USER_NAME>"
|
|
197
|
+
},
|
|
198
|
+
"wa_id": "<WHATSAPP_USER_PHONE_NUMBER>"
|
|
199
|
+
}
|
|
200
|
+
],
|
|
201
|
+
"messages": [
|
|
202
|
+
{
|
|
203
|
+
"from": "<GROUP_PARTICIPANT_PHONE_NUMBER>",
|
|
204
|
+
"group_id": "<GROUP_ID>",
|
|
205
|
+
"id": "<WHATSAPP_MESSAGE_ID>",
|
|
206
|
+
"timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
|
|
207
|
+
"errors": [
|
|
208
|
+
{
|
|
209
|
+
"code": 130501,
|
|
210
|
+
"message": "Message type is not currently supported",
|
|
211
|
+
"title": "Unsupported message type",
|
|
212
|
+
"error_data": {
|
|
213
|
+
"details": "<ERROR_DETAILS>"
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
],
|
|
217
|
+
"type": "unsupported"
|
|
218
|
+
}
|
|
219
|
+
]
|
|
220
|
+
},
|
|
221
|
+
"field": "messages"
|
|
222
|
+
}
|
|
223
|
+
]
|
|
224
|
+
}
|
|
225
|
+
]
|
|
226
|
+
}
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
## Fixar e desafixar mensagens de grupo
|
|
230
|
+
|
|
231
|
+
Fixar uma mensagem destaca a relevância dela.
|
|
232
|
+
|
|
233
|
+
A ordem de exibição das mensagens fixadas é baseada na ordem cronológica das principais mensagens, com as mais recentes aparecendo primeiro. Caso já haja três mensagens fixadas quando uma nova solicitação para fixar for feita, a mensagem fixada mais antiga será automaticamente desafixada.
|
|
234
|
+
|
|
235
|
+
### Limites
|
|
236
|
+
|
|
237
|
+
- Ao chamar a API, só é possível fixar uma mensagem por vez.- Somente o administrador do grupo pode fixar ou desafixar mensagens.- É possível fixar até três mensagens por vez.
|
|
238
|
+
|
|
239
|
+
### Sintaxe da solicitação
|
|
240
|
+
|
|
241
|
+
`POST /<BUSINESS_PHONE_NUMBER_ID>/messages`
|
|
242
|
+
|
|
243
|
+
**Observação: você receberá um erro na resposta de sincronização se os tipos `recipient_type` e `to` não corresponderem.**
|
|
244
|
+
|
|
245
|
+
### Corpo da solicitação
|
|
246
|
+
|
|
247
|
+
```
|
|
248
|
+
{
|
|
249
|
+
"messaging_product": "whatsapp",
|
|
250
|
+
"recipient_type": "group",
|
|
251
|
+
"to": "<GROUP_ID>",
|
|
252
|
+
"type": "pin",
|
|
253
|
+
"pin": {
|
|
254
|
+
"type": "<PIN_OPERATION>",
|
|
255
|
+
"message_id": "<MESSAGE_ID>",
|
|
256
|
+
"expiration_days": "<EXPIRATION>"
|
|
257
|
+
}
|
|
258
|
+
}
|
|
259
|
+
```
|
|
260
|
+
|
|
261
|
+
### Parâmetros do corpo
|
|
262
|
+
|
|
263
|
+
Espaço reservado
|
|
264
|
+
|
|
265
|
+
Descrição
|
|
266
|
+
|
|
267
|
+
Exemplo de valor
|
|
268
|
+
|
|
269
|
+
`<GROUP_ID>`
|
|
270
|
+
|
|
271
|
+
_String_
|
|
272
|
+
|
|
273
|
+
**Obrigatório**
|
|
274
|
+
|
|
275
|
+
O grupo em que você está fixando a mensagem.
|
|
276
|
+
|
|
277
|
+
`Y2FwaV9ncm91cDoxOTUwNTU1MDA3OToxMjAzNjMzOTQzMjAdOTY0MTUZD`
|
|
278
|
+
|
|
279
|
+
`<PIN_OPERATION>`
|
|
280
|
+
|
|
281
|
+
_String_
|
|
282
|
+
|
|
283
|
+
**Obrigatório**
|
|
284
|
+
|
|
285
|
+
A operação de fixação que você está realizando no grupo.
|
|
286
|
+
|
|
287
|
+
Pode ser `"pin"` ou `"unpin"`
|
|
288
|
+
|
|
289
|
+
`pin`
|
|
290
|
+
|
|
291
|
+
`<MESSAGE_ID>`
|
|
292
|
+
|
|
293
|
+
_String_
|
|
294
|
+
|
|
295
|
+
**Obrigatório**
|
|
296
|
+
|
|
297
|
+
Um identificador único da mensagem que você está fixando ou desafixando no grupo.
|
|
298
|
+
|
|
299
|
+
`wamid.HBgLM...`
|
|
300
|
+
|
|
301
|
+
`<EXPIRATION>`
|
|
302
|
+
|
|
303
|
+
_Número inteiro_
|
|
304
|
+
|
|
305
|
+
**Obrigatório quando `PIN_OPERATION` é `pin`**
|
|
306
|
+
|
|
307
|
+
|
|
308
|
+
Duração da fixação em dias. Pode ser de 1 a 30 dias.
|
|
309
|
+
|
|
310
|
+
`4`
|
|
311
|
+
|
|
312
|
+
### Corpo da resposta
|
|
313
|
+
|
|
314
|
+
```
|
|
315
|
+
{ "messaging_product": "whatsapp", "contacts": [ { "input": "Y2FwaV9ncm91cDo....", "wa_id": "Y2FwaV9ncm91cDo...." } ], "messages": [ { "id": "wamid.HBgLM..." } ]}
|
|
316
|
+
```
|
|
317
|
+
|
|
318
|
+
### Webhooks
|
|
319
|
+
|
|
320
|
+
Assine o tópico de webhook `messages` para receber notificações de status da mensagem. Os webhooks de status padrão "enviado" e "entregue" serão recebidos para o `message_id` na resposta.
|
|
321
|
+
|
|
322
|
+
[Saiba mais sobre o objeto de webhook de mensagens `status` webhook neste link](/documentation/business-messaging/whatsapp/webhooks/reference/messages/status)
|
|
323
|
+
|
|
324
|
+
## Webhooks de status de mensagens de grupo
|
|
325
|
+
|
|
326
|
+
Ao enviar mensagens para um grupo, você receberá um webhook quando a mensagem for entregue ou lida.
|
|
327
|
+
|
|
328
|
+
Em vez de enviar vários webhooks para cada atualização de status, enviaremos um webhook agregado.
|
|
329
|
+
|
|
330
|
+
Isso significa que, se você enviar uma mensagem e tiver definido o recebimento de vários status `read` ou `delivered`, enviaremos um único webhook agregado com vários objetos `status`.
|
|
331
|
+
|
|
332
|
+
Cada webhook que você recebe faz referência apenas a uma mensagem única enviada a um grupo único e a um tipo de status único.
|
|
333
|
+
|
|
334
|
+
[Saiba mais sobre o webhook de status de mensagens de grupo](/documentation/business-messaging/whatsapp/groups/webhooks#group-message-status-webhooks)
|
|
335
|
+
|
|
336
|
+
Você achou esta página útil?
|
|
337
|
+
|
|
338
|
+

|
|
339
|
+
|
|
340
|
+

|
|
@@ -0,0 +1,322 @@
|
|
|
1
|
+
<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/groups/pricing -->
|
|
2
|
+
<!-- Scraped: 2025-12-20T17:43:07.824Z -->
|
|
3
|
+
|
|
4
|
+
# Preços da API de Grupos
|
|
5
|
+
|
|
6
|
+
Updated: 22 de out de 2025
|
|
7
|
+
|
|
8
|
+
## Preços por mensagem na API de Grupos
|
|
9
|
+
|
|
10
|
+
A API de Grupos usa o [modelo de preços por mensagem](/documentation/business-messaging/whatsapp/pricing#per-message-pricing) da API de Nuvem para determinar se uma mensagem específica é faturável. No entanto, **você receberá uma cobrança sempre que uma mensagem faturável for entregue a alguém do grupo.**
|
|
11
|
+
|
|
12
|
+
Por exemplo, se você enviar uma mensagem de modelo de marketing (faturável) para um grupo com cinco usuários do WhatsApp e ela for entregue a todos os cinco, você receberá uma cobrança pelas cinco mensagens entregues conforme a tarifa de mensagens de marketing vigente para o código de chamada do país de cada destinatário.
|
|
13
|
+
|
|
14
|
+
Se a mensagem fosse entregue apenas para quatro dos cinco usuários, você receberia uma cobrança somente pelas quatro mensagens entregues.
|
|
15
|
+
|
|
16
|
+
## Como funcionam as janelas de atendimento ao cliente com a API de Grupos
|
|
17
|
+
|
|
18
|
+
As janelas de atendimento ao cliente funcionam de forma diferente ao usar a API de Grupos.
|
|
19
|
+
|
|
20
|
+
Quando um usuário do WhatsApp no grupo envia uma mensagem para você, é aberta uma [janela de atendimento ao cliente](/documentation/business-messaging/whatsapp/messages/send-messages#customer-service-windows) entre você e todo o grupo (ou é atualizada, se já existir uma). Isso permite enviar mensagens de modelo de utilidade e de marketing ou mensagens em formato livre gratuitamente.
|
|
21
|
+
|
|
22
|
+
Esse processo é diferente do que acontece nas conversas individuais, em que uma janela de [atendimento ao cliente](/documentation/business-messaging/whatsapp/messages/send-messages#customer-service-windows) é aberta (ou é atualizada, se já existir uma) quando um usuário do WhatsApp envia uma mensagem para você.
|
|
23
|
+
|
|
24
|
+
Todo o restante sobre as [janelas de atendimento ao cliente](/documentation/business-messaging/whatsapp/messages/send-messages#customer-service-windows) permanece igual.
|
|
25
|
+
|
|
26
|
+
## Informações de preços no webhook de status da mensagem
|
|
27
|
+
|
|
28
|
+
As informações de preços para mensagens enviadas usando a API de Grupos estão incluídas em [webhooks de status de mensagens](/documentation/business-messaging/whatsapp/groups/webhooks#pricing-information).
|
|
29
|
+
|
|
30
|
+
### Como são processados os webhooks de status de mensagens `read` e `delivered`
|
|
31
|
+
|
|
32
|
+
Para que o status de uma mensagem seja considerado `read`, ele deve ter sido pelo menos `delivered`.
|
|
33
|
+
|
|
34
|
+
Em algumas situações, como quando um usuário está presente na conversa e uma mensagem é recebida, ela será marcada como `delivered` e `read` quase simultaneamente. Nesse e em outros casos semelhantes, o webhook `delivered` não será enviado de volta. Isso acontece porque, quando uma mensagem é lida, fica implícito que ela também foi entregue.
|
|
35
|
+
|
|
36
|
+
### Como os dados de preços são exibidos no webhook de status da mensagem
|
|
37
|
+
|
|
38
|
+
Nem todos os webhooks de status da mensagem incluem informações de preço.
|
|
39
|
+
|
|
40
|
+
Com a implementação dos [Preços por mensagem](/documentation/business-messaging/whatsapp/pricing#per-message-pricing), os dados de preço podem estar presentes em webhooks de status `sent`, `delivered` ou `read`. Caso uma mensagem seja **cobrada**, pelo menos um webhook (`delivered` ou `read`) conterá as informações de preços.
|
|
41
|
+
|
|
42
|
+
### Webhook de status de mensagem enviada
|
|
43
|
+
|
|
44
|
+
```
|
|
45
|
+
// All versions
|
|
46
|
+
|
|
47
|
+
"pricing": {
|
|
48
|
+
"billable": "<IS_BILLABLE>",
|
|
49
|
+
"pricing_model": "<PRICING_MODEL>", // new value, see table below
|
|
50
|
+
"type": "<PRICING_TYPE>", // new property, see table below
|
|
51
|
+
"category": "<CONVERSATION_CATEGORY>"
|
|
52
|
+
}
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
### Webhook de status de mensagem entregue/lida
|
|
56
|
+
|
|
57
|
+
```
|
|
58
|
+
// Version 24.0 and higher
|
|
59
|
+
|
|
60
|
+
"pricing": {
|
|
61
|
+
"billable": "<IS_BILLABLE?>",
|
|
62
|
+
"pricing_model": "<PRICING_MODEL>", // new value, see table below
|
|
63
|
+
"type": "<PRICING_TYPE>", // new property, see table below
|
|
64
|
+
"category": "<CONVERSATION_CATEGORY>"
|
|
65
|
+
}
|
|
66
|
+
// Version 23.0 and lower
|
|
67
|
+
"conversation": {
|
|
68
|
+
"id": "<CONVERSATION_ID>", // new behavior, see table below
|
|
69
|
+
"expiration_timestamp": "<CONVERSATION_EXPIRATION_TIMESTAMP>",
|
|
70
|
+
"origin": {
|
|
71
|
+
"type": "<CONVERSATION_CATEGORY>"
|
|
72
|
+
}
|
|
73
|
+
},
|
|
74
|
+
|
|
75
|
+
"pricing": {
|
|
76
|
+
"billable": "<IS_BILLABLE?>",
|
|
77
|
+
"pricing_model": "PMP", // Value is now "PMP" instead of "CBP"
|
|
78
|
+
"type": "<PRICING_TYPE>", // new property, see table below
|
|
79
|
+
"category": "<PRICING_CATEGORY>"
|
|
80
|
+
}
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### Parâmetros
|
|
84
|
+
|
|
85
|
+
Espaço reservado
|
|
86
|
+
|
|
87
|
+
Descrição
|
|
88
|
+
|
|
89
|
+
`<CONVERSATION_ID>`
|
|
90
|
+
|
|
91
|
+
Versão 24.0 e posteriores:
|
|
92
|
+
|
|
93
|
+
- O objeto `conversation` será totalmente omitido
|
|
94
|
+
|
|
95
|
+
Versão 23.0 e anteriores:
|
|
96
|
+
|
|
97
|
+
- O valor será definido como um ID única por mensagem, em vez de por conversa.
|
|
98
|
+
|
|
99
|
+
`<CONVERSATION_CATEGORY>`
|
|
100
|
+
|
|
101
|
+
Sem alterações.
|
|
102
|
+
|
|
103
|
+
`<CONVERSATION_EXPIRATION_TIMESTAMP>`
|
|
104
|
+
|
|
105
|
+
Sem alterações.
|
|
106
|
+
|
|
107
|
+
`<IS_BILLABLE?>`
|
|
108
|
+
|
|
109
|
+
Sem alterações.
|
|
110
|
+
|
|
111
|
+
No entanto, a propriedade `billable` será descontinuada em um futuro [lançamento com controle de versão](/docs/graph-api/guides/versioning#calling_older_versions). Por isso, recomendamos que você comece a usar `pricing.type` e `pricing.category` juntos para determinar se uma mensagem é faturável e, em caso afirmativo, definir a [tarifa de cobrança](#identifying-billable-messages).
|
|
112
|
+
|
|
113
|
+
`<PRICING_TYPE>`
|
|
114
|
+
|
|
115
|
+
Nova propriedade. Os valores podem ser os seguintes:
|
|
116
|
+
|
|
117
|
+
- `regular`: indica que a mensagem é faturável.- `free_group_customer_service`: indica que não houve cobrança porque se tratava de uma mensagem de modelo de utilidade ou de uma mensagem sem modelo enviada durante a [janela de atendimento ao cliente](/documentation/business-messaging/whatsapp/messages/send-messages#customer-service-windows).
|
|
118
|
+
|
|
119
|
+
`<PRICING_CATEGORY>`
|
|
120
|
+
|
|
121
|
+
Os valores não serão alterados, mas agora podem ser interpretados da seguinte forma:
|
|
122
|
+
|
|
123
|
+
- `group_marketing`: indica uma mensagem de modelo de marketing.- `group_utility`: indica uma mensagem de modelo de utilidade.- `group_service`: indica uma mensagem que não pertence a um modelo.
|
|
124
|
+
|
|
125
|
+
### Como identificar mensagens faturáveis
|
|
126
|
+
|
|
127
|
+
Para as mensagens faturáveis, o campo `pricing.type` é definido como regular. O valor `pricing.category` indica a taxa (`group_marketing` ou `group_utility`).
|
|
128
|
+
|
|
129
|
+
### Como identificar mensagens gratuitas
|
|
130
|
+
|
|
131
|
+
As mensagens gratuitas têm `pricing.type` definido como `free_group_customer_service`. O valor `pricing.category` indica o motivo pelo qual o campo estava livre:
|
|
132
|
+
|
|
133
|
+
- `group_utility` – A mensagem foi enviada dentro da janela aberta de atendimento ao cliente em grupo.- `group_service` – Todas as mensagens que não são de modelos são gratuitas.
|
|
134
|
+
|
|
135
|
+
## Análise de mensagens para a API de Grupos
|
|
136
|
+
|
|
137
|
+
O campo `analytics` fornece o número e o tipo de mensagens enviadas e entregues por números de telefone associados a uma WABA específica. Para saber mais sobre métricas de conversa, consulte Análise de conversas.
|
|
138
|
+
|
|
139
|
+
É possível usar o seguinte ponto de extremidade para recuperar análises de mensagens enviadas por meio da API de Grupos:
|
|
140
|
+
|
|
141
|
+
```
|
|
142
|
+
/<WHATSAPP_BUSINESS_ACCOUNT_ID>?fields=analytics.<FILTER_PARAMETER>.<FILTER_PARAMETER>...
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
### Parâmetros de filtro para análise de mensagens
|
|
146
|
+
|
|
147
|
+
Para ver uma lista completa dos parâmetros de filtro de análise de mensagens, consulte a [Referência de análise de mensagens](/documentation/business-messaging/whatsapp/analytics#conversation-analytics).
|
|
148
|
+
|
|
149
|
+
### Alterações nos parâmetros de filtro da API de Grupos
|
|
150
|
+
|
|
151
|
+
|
|
152
|
+
|
|
153
|
+
Nome
|
|
154
|
+
|
|
155
|
+
Descrição
|
|
156
|
+
|
|
157
|
+
`product_types`
|
|
158
|
+
|
|
159
|
+
tipo: matriz
|
|
160
|
+
|
|
161
|
+
_Opcional._
|
|
162
|
+
|
|
163
|
+
São os tipos de mensagens referentes à análise que você quer recuperar (mensagens de notificação e/ou de suporte ao cliente).
|
|
164
|
+
|
|
165
|
+
Forneça uma matriz e inclua:
|
|
166
|
+
|
|
167
|
+
- `101` para mensagens de notificação de grupo- `102` para mensagens de suporte ao cliente em grupo.- `103` para mensagens de grupo recebidas
|
|
168
|
+
|
|
169
|
+
Se os valores mencionados não forem fornecidos, a chamada de API retornará análises para todas as mensagens.
|
|
170
|
+
|
|
171
|
+
O tipo de produto de entrada não pode ser consultado com outros tipos de produtos. Caso contrário, você verá um erro parecido com este:
|
|
172
|
+
|
|
173
|
+
```
|
|
174
|
+
{
|
|
175
|
+
"error": {
|
|
176
|
+
"message": "Invalid parameter",
|
|
177
|
+
"type": "OAuthException",
|
|
178
|
+
"code": 100,
|
|
179
|
+
"error_subcode": 2388077,
|
|
180
|
+
"is_transient": false,
|
|
181
|
+
"error_user_title": "Insight Invalid Product Type Combination",
|
|
182
|
+
"error_user_msg": "Unable to query this combination of product types. Please query individually and try again.",
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
### Valor da resposta
|
|
188
|
+
|
|
189
|
+
As respostas bem-sucedidas à API de análise ao consultar os dados de mensagem da API de Grupos retornarão um objeto semelhante ao seguinte:
|
|
190
|
+
|
|
191
|
+
**Observação: o filtro de código do país não é compatível com mensagens enviadas em grupo.**
|
|
192
|
+
|
|
193
|
+
```
|
|
194
|
+
With Country code filter
|
|
195
|
+
{
|
|
196
|
+
"analytics": {
|
|
197
|
+
"phone_numbers": [
|
|
198
|
+
"16505550111",
|
|
199
|
+
"16505550112",
|
|
200
|
+
"16505550113"
|
|
201
|
+
],
|
|
202
|
+
"country_codes": [
|
|
203
|
+
"US",
|
|
204
|
+
"BR"
|
|
205
|
+
],
|
|
206
|
+
"granularity": "DAY",
|
|
207
|
+
"data_points": [
|
|
208
|
+
{
|
|
209
|
+
"start": 1543543200,
|
|
210
|
+
"end": 1543629600,
|
|
211
|
+
"sent": 196093,
|
|
212
|
+
"delivered": 179715,
|
|
213
|
+
"groups_delivered": 4
|
|
214
|
+
},
|
|
215
|
+
{
|
|
216
|
+
"start": 1543629600,
|
|
217
|
+
"end": 1543716000,
|
|
218
|
+
"sent": 147649,
|
|
219
|
+
"delivered": 139032
|
|
220
|
+
}
|
|
221
|
+
# more data points
|
|
222
|
+
]
|
|
223
|
+
},
|
|
224
|
+
"id": "102290129340398"
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
Without Country code filter
|
|
228
|
+
{
|
|
229
|
+
"analytics": {
|
|
230
|
+
"phone_numbers": [
|
|
231
|
+
"16505550111",
|
|
232
|
+
"16505550112",
|
|
233
|
+
"16505550113"
|
|
234
|
+
],
|
|
235
|
+
"granularity": "DAY",
|
|
236
|
+
"data_points": [
|
|
237
|
+
{
|
|
238
|
+
"start": 1543543200,
|
|
239
|
+
"end": 1543629600,
|
|
240
|
+
"sent": 196093,
|
|
241
|
+
"delivered": 179715,
|
|
242
|
+
"groups_sent": 2,
|
|
243
|
+
"groups_delivered": 4
|
|
244
|
+
},
|
|
245
|
+
{
|
|
246
|
+
"start": 1543629600,
|
|
247
|
+
"end": 1543716000,
|
|
248
|
+
"sent": 147649,
|
|
249
|
+
"delivered": 139032
|
|
250
|
+
}
|
|
251
|
+
# more data points
|
|
252
|
+
]
|
|
253
|
+
},
|
|
254
|
+
"id": "102290129340398"
|
|
255
|
+
}
|
|
256
|
+
```
|
|
257
|
+
|
|
258
|
+
## Análise de preços para a API de Grupos
|
|
259
|
+
|
|
260
|
+
Com o campo `pricing_analytics`, é possível consultar detalhamentos de preços para mensagens entregues em um intervalo de datas específico.
|
|
261
|
+
|
|
262
|
+
```
|
|
263
|
+
GET /<WABA_ID>
|
|
264
|
+
?fields=pricing_analytics
|
|
265
|
+
.start(<START>)
|
|
266
|
+
.end(<END>)
|
|
267
|
+
.granularity(<GRANULARITY>)
|
|
268
|
+
.phone_numbers(<PHONE_NUMBERS>)
|
|
269
|
+
.country_codes(<COUNTRY_CODES>)
|
|
270
|
+
.metric_types(<METRIC_TYPES>)
|
|
271
|
+
.pricing_types(<PRICING_TYPES>)
|
|
272
|
+
.pricing_categories(<PRICING_CATEGORIES>)
|
|
273
|
+
.dimensions(<DIMENSIONS>)
|
|
274
|
+
```
|
|
275
|
+
|
|
276
|
+
### Parâmetros de filtro para análise de preços
|
|
277
|
+
|
|
278
|
+
Para ver uma lista completa dos parâmetros de filtro de análise de mensagens, consulte a [Referência de análise de mensagens](/documentation/business-messaging/whatsapp/analytics#pricing-analytics).
|
|
279
|
+
|
|
280
|
+
### Alterações nos parâmetros de filtro da API de Grupos
|
|
281
|
+
|
|
282
|
+
Nome
|
|
283
|
+
|
|
284
|
+
Descrição
|
|
285
|
+
|
|
286
|
+
`<PRICING_CATEGORIES>`
|
|
287
|
+
|
|
288
|
+
_Matriz de strings_
|
|
289
|
+
|
|
290
|
+
_Opcional._
|
|
291
|
+
|
|
292
|
+
É a matriz de categorias de preços. Se você enviar uma matriz vazia, retornaremos resultados para todas as categorias de preços.
|
|
293
|
+
|
|
294
|
+
Os valores podem ser os seguintes:
|
|
295
|
+
|
|
296
|
+
- `GROUP_MARKETING`: mensagens de grupo cobradas por taxa de marketing.- `GROUP_SERVICE`: mensagens de grupo que não foram cobradas. Inclui todas as mensagens sem modelo e mensagens de utilidade enviadas na janela de atendimento ao cliente.- `GROUP_UTILITY`: mensagens de grupo cobradas por taxa de utilidade.
|
|
297
|
+
|
|
298
|
+
`<PRICING_TYPES>`
|
|
299
|
+
|
|
300
|
+
_Matriz de strings_
|
|
301
|
+
|
|
302
|
+
_Opcional._
|
|
303
|
+
|
|
304
|
+
É a matriz de tipos de preços. Se você enviar uma matriz vazia, retornaremos resultados para todos os tipos de preços.
|
|
305
|
+
|
|
306
|
+
Os valores podem ser os seguintes:
|
|
307
|
+
|
|
308
|
+
- `FREE_GROUP_CUSTOMER_SERVICE`: mensagens gratuitas de grupo. Inclui mensagens sem modelo e mensagens de utilidade enviadas na janela de atendimento ao cliente do grupo.- `REGULAR`: mensagens faturáveis. Inclui todas as mensagens de modelo de autenticação e marketing e mensagens de modelo de utilidade enviadas fora da janela de atendimento ao cliente.
|
|
309
|
+
|
|
310
|
+
## Tabelas de tarifas
|
|
311
|
+
|
|
312
|
+
As mensagens de utilidade de grupo não são qualificadas para níveis de volume.
|
|
313
|
+
|
|
314
|
+
As tarifas de mensagens para a API de Grupos são as mesmas que as tarifas de preços por mensagem para mensagens individuais.
|
|
315
|
+
|
|
316
|
+
[Ver tabelas de tarifas de preços por mensagem](/documentation/business-messaging/whatsapp/pricing#rate-cards-and-volume-tiers)
|
|
317
|
+
|
|
318
|
+
Você achou esta página útil?
|
|
319
|
+
|
|
320
|
+

|
|
321
|
+
|
|
322
|
+

|