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.
Files changed (406) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +181 -0
  3. package/dist/index.d.ts +3 -0
  4. package/dist/index.d.ts.map +1 -0
  5. package/dist/index.js +65 -0
  6. package/dist/index.js.map +1 -0
  7. package/dist/prompts.d.ts +22 -0
  8. package/dist/prompts.d.ts.map +1 -0
  9. package/dist/prompts.js +305 -0
  10. package/dist/prompts.js.map +1 -0
  11. package/dist/resources.d.ts +24 -0
  12. package/dist/resources.d.ts.map +1 -0
  13. package/dist/resources.js +132 -0
  14. package/dist/resources.js.map +1 -0
  15. package/dist/tools.d.ts +6 -0
  16. package/dist/tools.d.ts.map +1 -0
  17. package/dist/tools.js +379 -0
  18. package/dist/tools.js.map +1 -0
  19. package/dist/utils/fileLoader.d.ts +19 -0
  20. package/dist/utils/fileLoader.d.ts.map +1 -0
  21. package/dist/utils/fileLoader.js +126 -0
  22. package/dist/utils/fileLoader.js.map +1 -0
  23. package/dist/utils/search.d.ts +27 -0
  24. package/dist/utils/search.d.ts.map +1 -0
  25. package/dist/utils/search.js +91 -0
  26. package/dist/utils/search.js.map +1 -0
  27. package/docs/QUICK_REFERENCE.md +223 -0
  28. package/docs/anuncios_com_clique_para_whatsapp/AGENTS.md +8 -0
  29. package/docs/anuncios_com_clique_para_whatsapp/welcome_message_sequences.md +449 -0
  30. package/docs/ativos_da_conta/AGENTS.md +9 -0
  31. package/docs/ativos_da_conta/outros_ativos/AGENTS.md +12 -0
  32. package/docs/ativos_da_conta/outros_ativos/business_profiles.md +137 -0
  33. package/docs/ativos_da_conta/outros_ativos/display_names.md +108 -0
  34. package/docs/ativos_da_conta/outros_ativos/official_business_accounts.md +123 -0
  35. package/docs/ativos_da_conta/outros_ativos/qr_codes.md +198 -0
  36. package/docs/ativos_da_conta/outros_ativos/whatsapp_business_accounts.md +99 -0
  37. package/docs/ativos_da_conta/telefones_comerciais/AGENTS.md +11 -0
  38. package/docs/ativos_da_conta/telefones_comerciais/conversational_components.md +347 -0
  39. package/docs/ativos_da_conta/telefones_comerciais/phone_numbers.md +486 -0
  40. package/docs/ativos_da_conta/telefones_comerciais/registration.md +171 -0
  41. package/docs/ativos_da_conta/telefones_comerciais/two_step_verification.md +66 -0
  42. package/docs/catalogos/AGENTS.md +12 -0
  43. package/docs/catalogos/receive_responses.md +28 -0
  44. package/docs/catalogos/sell_products_and_services.md +24 -0
  45. package/docs/catalogos/set_commerce_settings.md +163 -0
  46. package/docs/catalogos/share_products.md +401 -0
  47. package/docs/catalogos/upload_inventory.md +28 -0
  48. package/docs/comecar/AGENTS.md +8 -0
  49. package/docs/comecar/get_started.md +127 -0
  50. package/docs/dados_privacidade_e_politica/AGENTS.md +16 -0
  51. package/docs/dados_privacidade_e_politica/block_users.md +549 -0
  52. package/docs/dados_privacidade_e_politica/data_privacy_and_security.md +78 -0
  53. package/docs/dados_privacidade_e_politica/encryption.md +8 -0
  54. package/docs/dados_privacidade_e_politica/getting_opt_in.md +41 -0
  55. package/docs/dados_privacidade_e_politica/identity_change.md +34 -0
  56. package/docs/dados_privacidade_e_politica/local_storage.md +277 -0
  57. package/docs/dados_privacidade_e_politica/no_storage.md +132 -0
  58. package/docs/dados_privacidade_e_politica/policy_enforcement.md +85 -0
  59. package/docs/dados_privacidade_e_politica/policy_enforcement_violations.md +127 -0
  60. package/docs/grupos/AGENTS.md +15 -0
  61. package/docs/grupos/error_codes.md +170 -0
  62. package/docs/grupos/faq.md +30 -0
  63. package/docs/grupos/get_started.md +73 -0
  64. package/docs/grupos/groups.md +75 -0
  65. package/docs/grupos/groups_messaging.md +340 -0
  66. package/docs/grupos/pricing.md +322 -0
  67. package/docs/grupos/reference.md +1059 -0
  68. package/docs/grupos/webhooks.md +298 -0
  69. package/docs/index.md +318 -0
  70. package/docs/insights/AGENTS.md +8 -0
  71. package/docs/insights/analytics.md +944 -0
  72. package/docs/ligacoes/AGENTS.md +20 -0
  73. package/docs/ligacoes/app_review_guidelines.md +48 -0
  74. package/docs/ligacoes/business_initiated_calls.md +858 -0
  75. package/docs/ligacoes/call_button_messages_deep_links.md +454 -0
  76. package/docs/ligacoes/call_settings.md +643 -0
  77. package/docs/ligacoes/calling.md +130 -0
  78. package/docs/ligacoes/faq.md +468 -0
  79. package/docs/ligacoes/integration_patterns.md +121 -0
  80. package/docs/ligacoes/pricing.md +339 -0
  81. package/docs/ligacoes/reference.md +1923 -0
  82. package/docs/ligacoes/sip.md +1090 -0
  83. package/docs/ligacoes/troubleshooting.md +483 -0
  84. package/docs/ligacoes/user_call_permissions.md +672 -0
  85. package/docs/ligacoes/user_initiated_calls.md +1030 -0
  86. package/docs/mensagens/AGENTS.md +46 -0
  87. package/docs/mensagens/limites_de_mensagens/AGENTS.md +9 -0
  88. package/docs/mensagens/limites_de_mensagens/messaging_limits.md +91 -0
  89. package/docs/mensagens/limites_de_mensagens/upcoming_changes.md +8 -0
  90. package/docs/mensagens/recursos_adicionais/AGENTS.md +13 -0
  91. package/docs/mensagens/recursos_adicionais/contextual_replies.md +82 -0
  92. package/docs/mensagens/recursos_adicionais/link_previews.md +58 -0
  93. package/docs/mensagens/recursos_adicionais/mark_message_as_read.md +111 -0
  94. package/docs/mensagens/recursos_adicionais/media.md +419 -0
  95. package/docs/mensagens/recursos_adicionais/payload_encryption.md +8 -0
  96. package/docs/mensagens/recursos_adicionais/typing_indicators.md +117 -0
  97. package/docs/mensagens/tipos_de_mensagens/AGENTS.md +24 -0
  98. package/docs/mensagens/tipos_de_mensagens/address_messages.md +465 -0
  99. package/docs/mensagens/tipos_de_mensagens/audio_messages.md +211 -0
  100. package/docs/mensagens/tipos_de_mensagens/contacts_messages.md +482 -0
  101. package/docs/mensagens/tipos_de_mensagens/document_messages.md +232 -0
  102. package/docs/mensagens/tipos_de_mensagens/image_messages.md +176 -0
  103. package/docs/mensagens/tipos_de_mensagens/interactive_cta_url_messages.md +240 -0
  104. package/docs/mensagens/tipos_de_mensagens/interactive_flow_messages.md +8 -0
  105. package/docs/mensagens/tipos_de_mensagens/interactive_list_messages.md +300 -0
  106. package/docs/mensagens/tipos_de_mensagens/interactive_reply_buttons_messages.md +271 -0
  107. package/docs/mensagens/tipos_de_mensagens/location_messages.md +156 -0
  108. package/docs/mensagens/tipos_de_mensagens/location_request_messages.md +310 -0
  109. package/docs/mensagens/tipos_de_mensagens/message_with_link.md +8 -0
  110. package/docs/mensagens/tipos_de_mensagens/reaction_messages.md +144 -0
  111. package/docs/mensagens/tipos_de_mensagens/sticker_messages.md +157 -0
  112. package/docs/mensagens/tipos_de_mensagens/template_messages.md +20 -0
  113. package/docs/mensagens/tipos_de_mensagens/text_messages.md +142 -0
  114. package/docs/mensagens/tipos_de_mensagens/video_messages.md +149 -0
  115. package/docs/mensagens/visao_geral/AGENTS.md +8 -0
  116. package/docs/mensagens/visao_geral/send_messages.md +370 -0
  117. package/docs/mensagens_de_marketing/AGENTS.md +10 -0
  118. package/docs/mensagens_de_marketing/implementacao/AGENTS.md +10 -0
  119. package/docs/mensagens_de_marketing/implementacao/get_started.md +107 -0
  120. package/docs/mensagens_de_marketing/implementacao/onboard_business_customers.md +180 -0
  121. package/docs/mensagens_de_marketing/implementacao/send_marketing_messages.md +260 -0
  122. package/docs/mensagens_de_marketing/recursos/AGENTS.md +12 -0
  123. package/docs/mensagens_de_marketing/recursos/automatic_creative_optimization.md +8 -0
  124. package/docs/mensagens_de_marketing/recursos/conversion_measurement.md +8 -0
  125. package/docs/mensagens_de_marketing/recursos/deep_links.md +302 -0
  126. package/docs/mensagens_de_marketing/recursos/track_click_events.md +119 -0
  127. package/docs/mensagens_de_marketing/recursos/view_metrics.md +338 -0
  128. package/docs/mensagens_de_marketing/visao_geral/AGENTS.md +8 -0
  129. package/docs/mensagens_de_marketing/visao_geral/overview.md +26 -0
  130. package/docs/modelos/AGENTS.md +12 -0
  131. package/docs/modelos/gerenciamento_de_modelos/AGENTS.md +21 -0
  132. package/docs/modelos/gerenciamento_de_modelos/components.md +717 -0
  133. package/docs/modelos/gerenciamento_de_modelos/supported_languages.md +462 -0
  134. package/docs/modelos/gerenciamento_de_modelos/tap_target_url_title_override.md +211 -0
  135. package/docs/modelos/gerenciamento_de_modelos/template_categorization.md +499 -0
  136. package/docs/modelos/gerenciamento_de_modelos/template_comparison.md +136 -0
  137. package/docs/modelos/gerenciamento_de_modelos/template_library.md +526 -0
  138. package/docs/modelos/gerenciamento_de_modelos/template_management.md +148 -0
  139. package/docs/modelos/gerenciamento_de_modelos/template_media.md +8 -0
  140. package/docs/modelos/gerenciamento_de_modelos/template_migration.md +164 -0
  141. package/docs/modelos/gerenciamento_de_modelos/template_pacing.md +38 -0
  142. package/docs/modelos/gerenciamento_de_modelos/template_pausing.md +58 -0
  143. package/docs/modelos/gerenciamento_de_modelos/template_quality.md +47 -0
  144. package/docs/modelos/gerenciamento_de_modelos/template_review.md +74 -0
  145. package/docs/modelos/gerenciamento_de_modelos/time_to_live.md +88 -0
  146. package/docs/modelos/modelos_de_autenticacao/AGENTS.md +13 -0
  147. package/docs/modelos/modelos_de_autenticacao/authentication_best_practices.md +73 -0
  148. package/docs/modelos/modelos_de_autenticacao/authentication_templates.md +252 -0
  149. package/docs/modelos/modelos_de_autenticacao/autofill_button_authentication_templates.md +732 -0
  150. package/docs/modelos/modelos_de_autenticacao/copy_code_button_authentication_templates.md +402 -0
  151. package/docs/modelos/modelos_de_autenticacao/error_signals.md +143 -0
  152. package/docs/modelos/modelos_de_autenticacao/zero_tap_authentication_templates.md +742 -0
  153. package/docs/modelos/modelos_de_marketing/AGENTS.md +18 -0
  154. package/docs/modelos/modelos_de_marketing/call_permission_request_message_template.md +221 -0
  155. package/docs/modelos/modelos_de_marketing/catalog_templates.md +308 -0
  156. package/docs/modelos/modelos_de_marketing/coupon_templates.md +425 -0
  157. package/docs/modelos/modelos_de_marketing/custom_marketing_templates.md +537 -0
  158. package/docs/modelos/modelos_de_marketing/limited_time_offer_templates.md +496 -0
  159. package/docs/modelos/modelos_de_marketing/marketing_templates.md +112 -0
  160. package/docs/modelos/modelos_de_marketing/media_card_carousel_templates.md +770 -0
  161. package/docs/modelos/modelos_de_marketing/mpm_templates.md +717 -0
  162. package/docs/modelos/modelos_de_marketing/per_user_limits.md +42 -0
  163. package/docs/modelos/modelos_de_marketing/product_card_carousel_templates.md +515 -0
  164. package/docs/modelos/modelos_de_marketing/spm_templates.md +466 -0
  165. package/docs/modelos/modelos_de_utilidade/AGENTS.md +8 -0
  166. package/docs/modelos/modelos_de_utilidade/utility_templates.md +583 -0
  167. package/docs/modelos/visao_geral/AGENTS.md +8 -0
  168. package/docs/modelos/visao_geral/overview.md +163 -0
  169. package/docs/pagamentos/AGENTS.md +9 -0
  170. package/docs/pagamentos/pagamentos_na_india/AGENTS.md +19 -0
  171. package/docs/pagamentos/pagamentos_na_india/checkout_button_templates.md +1332 -0
  172. package/docs/pagamentos/pagamentos_na_india/enhanced_payment_links.md +93 -0
  173. package/docs/pagamentos/pagamentos_na_india/onboarding_apis.md +580 -0
  174. package/docs/pagamentos/pagamentos_na_india/orderdetailstemplate.md +205 -0
  175. package/docs/pagamentos/pagamentos_na_india/orderstatustemplate.md +143 -0
  176. package/docs/pagamentos/pagamentos_na_india/overview.md +102 -0
  177. package/docs/pagamentos/pagamentos_na_india/payment_links.md +581 -0
  178. package/docs/pagamentos/pagamentos_na_india/pg.md +1228 -0
  179. package/docs/pagamentos/pagamentos_na_india/upi_intent/AGENTS.md +12 -0
  180. package/docs/pagamentos/pagamentos_na_india/upi_intent/dynamic_vpa.md +572 -0
  181. package/docs/pagamentos/pagamentos_na_india/upi_intent/pg_guide_billdesk.md +343 -0
  182. package/docs/pagamentos/pagamentos_na_india/upi_intent/pg_guide_cashfree.md +145 -0
  183. package/docs/pagamentos/pagamentos_na_india/upi_intent/pg_guide_ccavenue.md +146 -0
  184. package/docs/pagamentos/pagamentos_na_india/upi_intent/upi_intent.md +660 -0
  185. package/docs/pagamentos/pagamentos_no_brasil/AGENTS.md +14 -0
  186. package/docs/pagamentos/pagamentos_no_brasil/boleto.md +104 -0
  187. package/docs/pagamentos/pagamentos_no_brasil/offsite_pix.md +128 -0
  188. package/docs/pagamentos/pagamentos_no_brasil/one_click_payments.md +226 -0
  189. package/docs/pagamentos/pagamentos_no_brasil/orderdetailstemplate.md +180 -0
  190. package/docs/pagamentos/pagamentos_no_brasil/orders.md +768 -0
  191. package/docs/pagamentos/pagamentos_no_brasil/overview.md +32 -0
  192. package/docs/pagamentos/pagamentos_no_brasil/payment_links.md +104 -0
  193. package/docs/parceiros/AGENTS.md +12 -0
  194. package/docs/parceiros/analise_do_app/AGENTS.md +8 -0
  195. package/docs/parceiros/analise_do_app/app_review.md +91 -0
  196. package/docs/parceiros/gerenciamento/AGENTS.md +14 -0
  197. package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/AGENTS.md +15 -0
  198. package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/manage_accounts.md +274 -0
  199. package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/manage_system_users.md +106 -0
  200. package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/manage_webhooks.md +277 -0
  201. package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/numeros_de_telefone/AGENTS.md +9 -0
  202. package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/numeros_de_telefone/manage_phone_numbers.md +248 -0
  203. package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/numeros_de_telefone/registering_phone_numbers.md +373 -0
  204. package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/share_and_revoke_credit_lines.md +551 -0
  205. package/docs/parceiros/gerenciamento/partner_led_business_verification.md +367 -0
  206. package/docs/parceiros/gerenciamento/pixel_tracking.md +35 -0
  207. package/docs/parceiros/gerenciamento/suporte_ao_parceiro/AGENTS.md +18 -0
  208. package/docs/parceiros/gerenciamento/suporte_ao_parceiro/adding_waba_to_mps.md +64 -0
  209. package/docs/parceiros/gerenciamento/suporte_ao_parceiro/business_customer_support.md +102 -0
  210. package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_customers_off_solutions_via_embedded_signup.md +151 -0
  211. package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_customers_off_solutions_via_meta_business_suite.md +234 -0
  212. package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_phone_numbers_among_solution_partners_programmatically.md +292 -0
  213. package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_phone_numbers_among_solution_partners_via_embedded_signup.md +118 -0
  214. package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_wabas_among_solution_partners_via_embedded_signup.md +76 -0
  215. package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_wabas_among_solutions_via_embedded_signup.md +90 -0
  216. package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_wabas_among_solutions_via_meta_business_suite.md +265 -0
  217. package/docs/parceiros/gerenciamento/suporte_ao_parceiro/support.md +48 -0
  218. package/docs/parceiros/gerenciamento/suporte_ao_parceiro/transferring_wabas_to_customers.md +8 -0
  219. package/docs/parceiros/integracao_de_clientes/AGENTS.md +9 -0
  220. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/AGENTS.md +26 -0
  221. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/app_only_install.md +135 -0
  222. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/automatic_events_api.md +204 -0
  223. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/bypass_phone_addition.md +52 -0
  224. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/custom_flows.md +40 -0
  225. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/default_flow.md +90 -0
  226. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/errors.md +185 -0
  227. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/hosted_es.md +153 -0
  228. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/implementation.md +417 -0
  229. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/onboarding_business_app_users.md +926 -0
  230. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/onboarding_customers_as_a_solution_partner.md +402 -0
  231. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/onboarding_customers_as_a_tech_provider.md +332 -0
  232. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/overview.md +168 -0
  233. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/pre_filled_data.md +524 -0
  234. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/pre_verified_numbers.md +291 -0
  235. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/versions/AGENTS.md +12 -0
  236. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/versions/version_2_public_preview.md +88 -0
  237. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/versions/version_3.md +98 -0
  238. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/versions/version_3_public_preview.md +88 -0
  239. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/versions/version_4.md +92 -0
  240. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/versions/versions.md +463 -0
  241. package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/website_optional.md +57 -0
  242. package/docs/parceiros/integracao_de_clientes/outras_opcoes_de_integracao/AGENTS.md +11 -0
  243. package/docs/parceiros/integracao_de_clientes/outras_opcoes_de_integracao/multi_partner_solution_embedded_creation.md +178 -0
  244. package/docs/parceiros/integracao_de_clientes/outras_opcoes_de_integracao/multi_partner_solutions.md +775 -0
  245. package/docs/parceiros/integracao_de_clientes/outras_opcoes_de_integracao/multi_solution_conversations.md +319 -0
  246. package/docs/parceiros/integracao_de_clientes/outras_opcoes_de_integracao/partner_initiated_waba_creation.md +74 -0
  247. package/docs/parceiros/seja_um_parceiro/AGENTS.md +11 -0
  248. package/docs/parceiros/seja_um_parceiro/get_started_for_solution_partners.md +280 -0
  249. package/docs/parceiros/seja_um_parceiro/get_started_for_tech_providers.md +194 -0
  250. package/docs/parceiros/seja_um_parceiro/measurement_partners.md +146 -0
  251. package/docs/parceiros/seja_um_parceiro/upgrade_to_tech_partner.md +94 -0
  252. package/docs/parceiros/visao_geral/AGENTS.md +8 -0
  253. package/docs/parceiros/visao_geral/overview.md +190 -0
  254. package/docs/recado/AGENTS.md +9 -0
  255. package/docs/recado/precos/AGENTS.md +11 -0
  256. package/docs/recado/precos/pricing.md +915 -0
  257. package/docs/recado/precos/pricing_authentication_international_rates.md +464 -0
  258. package/docs/recado/precos/pricing_conversation_based_pricing.md +773 -0
  259. package/docs/recado/precos/pricing_updates_to_pricing.md +8 -0
  260. package/docs/recado/sobre_a_plataforma/AGENTS.md +10 -0
  261. package/docs/recado/sobre_a_plataforma/about_the_platform.md +217 -0
  262. package/docs/recado/sobre_a_plataforma/access_tokens.md +110 -0
  263. package/docs/recado/sobre_a_plataforma/permissions.md +55 -0
  264. package/docs/referencia/AGENTS.md +92 -0
  265. package/docs/referencia/bot_do_whatsapp_business/AGENTS.md +8 -0
  266. package/docs/referencia/bot_do_whatsapp_business/bot_details_api.md +762 -0
  267. package/docs/referencia/business/AGENTS.md +14 -0
  268. package/docs/referencia/business/add_phone_numbers_api.md +726 -0
  269. package/docs/referencia/business/client_whatsapp_business_accounts_api.md +1006 -0
  270. package/docs/referencia/business/owned_whatsapp_business_accounts.md +802 -0
  271. package/docs/referencia/business/whatsapp_business_accounts_api.md +1550 -0
  272. package/docs/referencia/business/whatsapp_business_partner_onboarding_to_mm_lite_api.md +783 -0
  273. package/docs/referencia/business/whatsapp_business_pre_verified_phone_number_sharing_api.md +790 -0
  274. package/docs/referencia/business/whatsapp_business_pre_verified_phone_numbers_api.md +886 -0
  275. package/docs/referencia/changelog.md +10 -0
  276. package/docs/referencia/conta_do_whatsapp_business/AGENTS.md +24 -0
  277. package/docs/referencia/conta_do_whatsapp_business/assigned_users_management_api.md +2202 -0
  278. package/docs/referencia/conta_do_whatsapp_business/business_account_api.md +267 -0
  279. package/docs/referencia/conta_do_whatsapp_business/business_account_extended_credits_api.md +275 -0
  280. package/docs/referencia/conta_do_whatsapp_business/conversational_automation_api.md +782 -0
  281. package/docs/referencia/conta_do_whatsapp_business/flows_api.md +1532 -0
  282. package/docs/referencia/conta_do_whatsapp_business/in_progress_on_behalf_requests_api.md +8 -0
  283. package/docs/referencia/conta_do_whatsapp_business/migration_intent_api.md +1581 -0
  284. package/docs/referencia/conta_do_whatsapp_business/obo_mobility_intent_api.md +8 -0
  285. package/docs/referencia/conta_do_whatsapp_business/phone_number_management_api.md +1686 -0
  286. package/docs/referencia/conta_do_whatsapp_business/schedules_api.md +1772 -0
  287. package/docs/referencia/conta_do_whatsapp_business/set_obo_mobility_intent_api.md +8 -0
  288. package/docs/referencia/conta_do_whatsapp_business/set_solution_migration_intent_api.md +8 -0
  289. package/docs/referencia/conta_do_whatsapp_business/subscribed_apps_api.md +2178 -0
  290. package/docs/referencia/conta_do_whatsapp_business/template_api.md +976 -0
  291. package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_activities_api.md +842 -0
  292. package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_api.md +1384 -0
  293. package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_solutions_list_api.md +854 -0
  294. package/docs/referencia/grupo/AGENTS.md +11 -0
  295. package/docs/referencia/grupo/groups_invite_link_api.md +304 -0
  296. package/docs/referencia/grupo/groups_join_requests_api.md +686 -0
  297. package/docs/referencia/grupo/groups_participants_api.md +274 -0
  298. package/docs/referencia/grupo/groups_query_api.md +436 -0
  299. package/docs/referencia/historico_de_mensagens/AGENTS.md +8 -0
  300. package/docs/referencia/historico_de_mensagens/whatsapp_business_message_history_events_api.md +866 -0
  301. package/docs/referencia/inscricao/AGENTS.md +10 -0
  302. package/docs/referencia/inscricao/application_connected_client_businesses.md +812 -0
  303. package/docs/referencia/inscricao/application_solutions_api.md +874 -0
  304. package/docs/referencia/inscricao/solution_creation_api.md +824 -0
  305. package/docs/referencia/intencao_de_migracao_da_conta_do_whatsapp_business/AGENTS.md +8 -0
  306. package/docs/referencia/intencao_de_migracao_da_conta_do_whatsapp_business/migration_intent_details_api.md +724 -0
  307. package/docs/referencia/midias/AGENTS.md +9 -0
  308. package/docs/referencia/midias/media_api.md +342 -0
  309. package/docs/referencia/midias/media_download_api.md +160 -0
  310. package/docs/referencia/numero_da_conta_do_whatsapp/AGENTS.md +8 -0
  311. package/docs/referencia/numero_da_conta_do_whatsapp/whatsapp_account_number_api.md +778 -0
  312. package/docs/referencia/perfil_do_whatsapp_business/AGENTS.md +8 -0
  313. package/docs/referencia/perfil_do_whatsapp_business/whatsapp_business_profile_node_api.md +1494 -0
  314. package/docs/referencia/solucao_do_whatsapp_business/AGENTS.md +14 -0
  315. package/docs/referencia/solucao_do_whatsapp_business/accept_deactivation_request_api.md +762 -0
  316. package/docs/referencia/solucao_do_whatsapp_business/access_token_api.md +704 -0
  317. package/docs/referencia/solucao_do_whatsapp_business/reject_deactivation_request_api.md +812 -0
  318. package/docs/referencia/solucao_do_whatsapp_business/send_deactivation_request_api.md +778 -0
  319. package/docs/referencia/solucao_do_whatsapp_business/solution_accept_api.md +812 -0
  320. package/docs/referencia/solucao_do_whatsapp_business/solution_details_api.md +768 -0
  321. package/docs/referencia/solucao_do_whatsapp_business/solution_reject_api.md +798 -0
  322. package/docs/referencia/telefone_do_whatsapp_business/AGENTS.md +29 -0
  323. package/docs/referencia/telefone_do_whatsapp_business/block_api.md +542 -0
  324. package/docs/referencia/telefone_do_whatsapp_business/business_compliance_information_api.md +1608 -0
  325. package/docs/referencia/telefone_do_whatsapp_business/business_encryption_api.md +1402 -0
  326. package/docs/referencia/telefone_do_whatsapp_business/calling_api.md +598 -0
  327. package/docs/referencia/telefone_do_whatsapp_business/encrypted_messages_api.md +482 -0
  328. package/docs/referencia/telefone_do_whatsapp_business/groups_management_api.md +485 -0
  329. package/docs/referencia/telefone_do_whatsapp_business/marketing_messages_lite_api.md +315 -0
  330. package/docs/referencia/telefone_do_whatsapp_business/media_upload_api.md +188 -0
  331. package/docs/referencia/telefone_do_whatsapp_business/message_api.md +1798 -0
  332. package/docs/referencia/telefone_do_whatsapp_business/phone_number_api.md +377 -0
  333. package/docs/referencia/telefone_do_whatsapp_business/phone_number_deregister_api.md +714 -0
  334. package/docs/referencia/telefone_do_whatsapp_business/phone_number_registration.md +780 -0
  335. package/docs/referencia/telefone_do_whatsapp_business/phone_number_verification_request_code_api.md +734 -0
  336. package/docs/referencia/telefone_do_whatsapp_business/register_api.md +411 -0
  337. package/docs/referencia/telefone_do_whatsapp_business/settings_api.md +674 -0
  338. package/docs/referencia/telefone_do_whatsapp_business/verify_code_api.md +746 -0
  339. package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_message_history_api.md +932 -0
  340. package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_official_business_account_status_api.md +1540 -0
  341. package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_phone_number_api.md +1600 -0
  342. package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_profile_api.md +1478 -0
  343. package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_qr_code_api.md +1179 -0
  344. package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_qr_code_management_api.md +1315 -0
  345. package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/AGENTS.md +11 -0
  346. package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/request_verification_code_api.md +778 -0
  347. package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/verify_code_api.md +768 -0
  348. package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/whatsapp_business_pre_verified_phone_number_api.md +1382 -0
  349. package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/whatsapp_business_pre_verified_phone_number_partners_api.md +820 -0
  350. package/docs/referencia/usuario/AGENTS.md +8 -0
  351. package/docs/referencia/usuario/assigned_whatsapp_business_accounts_api.md +864 -0
  352. package/docs/referencia/webhooks/AGENTS.md +8 -0
  353. package/docs/referencia/webhooks/whatsapp_incoming_webhook_payload.md +1655 -0
  354. package/docs/suporte/AGENTS.md +13 -0
  355. package/docs/suporte/api_status_page.md +134 -0
  356. package/docs/suporte/error_codes.md +1194 -0
  357. package/docs/suporte/experiments.md +26 -0
  358. package/docs/suporte/health_status.md +225 -0
  359. package/docs/suporte/load_testing.md +340 -0
  360. package/docs/suporte/support.md +408 -0
  361. package/docs/visao_geral/AGENTS.md +8 -0
  362. package/docs/visao_geral/overview.md +2590 -0
  363. package/docs/webhooks/AGENTS.md +41 -0
  364. package/docs/webhooks/referencia/AGENTS.md +20 -0
  365. package/docs/webhooks/referencia/account_alerts.md +190 -0
  366. package/docs/webhooks/referencia/account_review_update.md +90 -0
  367. package/docs/webhooks/referencia/account_update.md +379 -0
  368. package/docs/webhooks/referencia/business_capability_update.md +121 -0
  369. package/docs/webhooks/referencia/history.md +302 -0
  370. package/docs/webhooks/referencia/message_template_components_update.md +179 -0
  371. package/docs/webhooks/referencia/message_template_quality_update.md +136 -0
  372. package/docs/webhooks/referencia/message_template_status_update.md +253 -0
  373. package/docs/webhooks/referencia/messages/AGENTS.md +24 -0
  374. package/docs/webhooks/referencia/messages/audio.md +298 -0
  375. package/docs/webhooks/referencia/messages/button.md +170 -0
  376. package/docs/webhooks/referencia/messages/contacts.md +491 -0
  377. package/docs/webhooks/referencia/messages/document.md +307 -0
  378. package/docs/webhooks/referencia/messages/errors.md +132 -0
  379. package/docs/webhooks/referencia/messages/image.md +304 -0
  380. package/docs/webhooks/referencia/messages/interactive.md +225 -0
  381. package/docs/webhooks/referencia/messages/location.md +296 -0
  382. package/docs/webhooks/referencia/messages/messages.md +44 -0
  383. package/docs/webhooks/referencia/messages/order.md +208 -0
  384. package/docs/webhooks/referencia/messages/reaction.md +178 -0
  385. package/docs/webhooks/referencia/messages/status.md +364 -0
  386. package/docs/webhooks/referencia/messages/sticker.md +298 -0
  387. package/docs/webhooks/referencia/messages/system.md +140 -0
  388. package/docs/webhooks/referencia/messages/text.md +322 -0
  389. package/docs/webhooks/referencia/messages/unsupported.md +165 -0
  390. package/docs/webhooks/referencia/messages/video.md +304 -0
  391. package/docs/webhooks/referencia/outros_webhooks/AGENTS.md +16 -0
  392. package/docs/webhooks/referencia/outros_webhooks/partner_solutions.md +114 -0
  393. package/docs/webhooks/referencia/outros_webhooks/payment_configuration_update.md +135 -0
  394. package/docs/webhooks/referencia/outros_webhooks/phone_number_name_update.md +129 -0
  395. package/docs/webhooks/referencia/outros_webhooks/phone_number_quality_update.md +172 -0
  396. package/docs/webhooks/referencia/outros_webhooks/security.md +108 -0
  397. package/docs/webhooks/referencia/outros_webhooks/smb_app_state_sync.md +146 -0
  398. package/docs/webhooks/referencia/outros_webhooks/smb_message_echoes.md +143 -0
  399. package/docs/webhooks/referencia/outros_webhooks/template_category_update.md +154 -0
  400. package/docs/webhooks/referencia/outros_webhooks/user_preferences.md +150 -0
  401. package/docs/webhooks/visao_geral/AGENTS.md +11 -0
  402. package/docs/webhooks/visao_geral/message_echoes.md +8 -0
  403. package/docs/webhooks/visao_geral/override.md +235 -0
  404. package/docs/webhooks/visao_geral/overview.md +158 -0
  405. package/docs/webhooks/visao_geral/set_up_whatsapp_echo_bot.md +109 -0
  406. package/package.json +50 -0
@@ -0,0 +1,130 @@
1
+ <!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/calling -->
2
+ <!-- Scraped: 2025-12-20T17:40:24.065Z -->
3
+
4
+ # Ligação da API de Nuvem
5
+
6
+ Updated: 7 de nov de 2025
7
+
8
+ ## Visão geral
9
+
10
+ Com a API de Ligações Comerciais do WhatsApp, você pode iniciar e receber ligações de usuários do WhatsApp usando o protocolo de voz via IP (VoIP).
11
+
12
+ ### Arquitetura
13
+
14
+ ![Image](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/564723412_1339317954593522_7943224529857744756_n.jpg?_nc_cat=100&ccb=1-7&_nc_sid=e280be&_nc_ohc=5XBnYYAz4TQQ7kNvwHHduDU&_nc_oc=AdmjoTib4RzW6j8R21vYAmXhHIBQmpBXn4BEmHcIxjr1cNSfpplEmAIYP8eIBQ69p1s&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=Cx4wumyWFgDrM0PeRh5lyg&oh=00_Afn3F8LtwNkkA8Q3Qc39BaIpaNcfA9MdLGznIAcG_p-cow&oe=69611085) (_Clique com o botão direito do mouse na imagem e escolha "Abrir em uma nova aba" para ampliar a imagem_)
15
+
16
+ ## Começar
17
+
18
+ ### Etapa 1. Pré-requisitos
19
+
20
+ Antes de começar a usar a API de Ligações, verifique o seguinte:
21
+
22
+ - [O número comercial está em uso com a API de Nuvem](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers) (e não com o app WhatsApp Business)- Inscreva o app no campo de webhook `calls` (a menos que você planeje usar [SIP](/documentation/business-messaging/whatsapp/calling/sip))- O mesmo app deve estar [inscrito na conta do WhatsApp Business](/documentation/business-messaging/whatsapp/webhooks/create-webhook-endpoint#configure-webhooks) do seu número de telefone comercial.- Esse app deve ter permissões de mensagens (`whatsapp_business_messaging`) para o número comercial- A empresa precisa ter um limite de mensagens de pelo menos [dois mil conversas iniciadas pela empresa](/documentation/business-messaging/whatsapp/messaging-limits) em um período contínuo de 24 horas. Para saber mais, leia sobre [como dimensionar os recursos da sua conta](https://www.facebook.com/business/help/595597942906808).- [Habilitar recursos de ligação no número de telefone comercial](/documentation/business-messaging/whatsapp/calling/call-settings)
23
+
24
+ ### Etapa 2: configurar recursos de ligação opcionais
25
+
26
+ A API de Ligações Comerciais do WhatsApp oferece diversos recursos que afetam quando e como os recursos de ligação são exibidos para os usuários no seu perfil do WhatsApp
27
+
28
+ - O controle de ligações recebidas permite impedir que usuários façam ligações usando o seu perfil empresarial- Com o horário de ligação da empresa, você não perde ligações nem direciona os usuários a enviar mensagens quando a central de atendimento está fechada- As solicitações de retorno de ligação oferecem aos usuários a opção de pedir um retorno quando você não atende ou a central de atendimento está fechada
29
+
30
+ [Saiba mais sobre as configurações de controle de ligação](/documentation/business-messaging/whatsapp/calling/call-settings#parameter-details)
31
+
32
+ ### Etapa 3: fazer e receber ligações
33
+
34
+ Você pode testar a integração de Ligação do WhatsApp usando números de teste público e uma conta do WhatsApp Business no sandbox.
35
+
36
+ [Saiba mais sobre como testar a integração da API de Ligação do WhatsApp](/documentation/business-messaging/whatsapp/calling#testing-and-sandbox-accounts)
37
+
38
+ A ligação da API de Nuvem oferece dois caminhos de iniciação:
39
+
40
+ - **Ligações iniciadas pelo usuário:** ligações feitas de um usuário do WhatsApp para a empresa- **Ligações iniciadas pela empresa:** ligações feitas da sua empresa para um usuário do WhatsApp
41
+
42
+ ## Contas de teste e de sandbox
43
+
44
+ As contas de sandbox estão disponíveis apenas para Parceiros de Tecnologia.
45
+
46
+ Com as [contas de sandbox](/documentation/business-messaging/whatsapp/calling/sandbox) e os números de teste público, você pode testar a integração da API de Ligação do WhatsApp com limitações de ligação flexíveis.
47
+
48
+ Você pode receber um número de teste público depois de concluir o [fluxo para Começar.](/documentation/business-messaging/whatsapp/get-started)
49
+
50
+ Além disso, não é necessário ter um limite de mensagens de pelo menos [dois mil conversas iniciadas pela empresa](/documentation/business-messaging/whatsapp/messaging-limits) em um período contínuo de 24 horas para testar os recursos da API de Ligações ao usar números de teste públicos e contas de sandbox.
51
+
52
+ As ligações estão desabilitadas por padrão nos números de teste. Você deve [configurar os recursos de ligação nas definições de ligação do número de telefone](/documentation/business-messaging/whatsapp/calling/call-settings#configure-call-settings) antes de usar a API de Ligação em um número de teste.
53
+
54
+ [Saiba mais sobre contas de sandbox para fazer ligações](/documentation/business-messaging/whatsapp/embedded-signup/overview#sandbox-accounts)
55
+
56
+ ## Disponibilidade
57
+
58
+ #### Ligações iniciadas pelo usuário
59
+
60
+ As ligações iniciadas pelo usuário estão disponíveis em [todas as localizações em que a API de Nuvem está disponível](/documentation/business-messaging/whatsapp/support#country-restrictions)
61
+
62
+ #### Ligações iniciadas pela empresa
63
+
64
+ As ligações iniciadas pela empresa estão disponíveis em [todas as localizações onde a API de Nuvem está disponível](/documentation/business-messaging/whatsapp/support#country-restrictions), **exceto os seguintes países:**
65
+
66
+ - Estados Unidos- Canadá- Turquia- Egito- Vietnã- Nigéria
67
+
68
+ **Observação:** o código do país no número de telefone comercial deve estar nesta lista com suporte. O número de telefone do consumidor pode ser de qualquer [país em que a API de Nuvem esteja disponível.](/documentation/business-messaging/whatsapp/support#country-restrictions)
69
+
70
+ ## Próximas etapas
71
+
72
+ Use nossos guias abaixo para começar a integrar e usar recursos de ligação no seu app:
73
+
74
+ - [Saiba como receber ligações iniciadas pelo usuário](/documentation/business-messaging/whatsapp/calling/user-initiated-calls)- [Saiba como fazer ligações iniciadas pela empresa](/documentation/business-messaging/whatsapp/calling/business-initiated-calls)- [Saiba como aumentar o reconhecimento do cliente sobre a disponibilidade de ligações na sua empresa](/documentation/business-messaging/whatsapp/calling/call-button-messages-deep-links)
75
+
76
+ ## Registro de alterações
77
+
78
+ Use esta tabela como um local central para acompanhar as atualizações de recursos relacionadas à API de Ligações Comerciais do WhatsApp
79
+
80
+ Data
81
+
82
+ Título
83
+
84
+ Descrição
85
+
86
+ 13 de outubro de 2025
87
+
88
+ - Atualização no limite de ligações iniciadas pela empresa- Adição da seção "Teste e sandbox" à documentação
89
+
90
+ O número de ligações iniciadas pela empresa por usuário foi aumentado de 5 para 10 por dia.
91
+
92
+ [Saiba mais sobre os limites de ligações iniciadas pela empresa](/documentation/business-messaging/whatsapp/calling/user-call-permissions#limits--per-business---whatsapp-user-pair-)
93
+
94
+ As [contas de teste e de sandbox](/documentation/business-messaging/whatsapp/calling#testing-and-sandbox-accounts) foram adicionadas à documentação
95
+
96
+ 29 de setembro de 2025
97
+
98
+ Guia de integração do Asterisk
99
+
100
+ Novo guia para [integração do Asterisk](/documentation/business-messaging/whatsapp/calling/integration-examples#asterisk-using-sip)
101
+
102
+ 24 de setembro de 2025
103
+
104
+ Propagação de contexto de botões de ligação e deep links
105
+
106
+ Especifique uma string opaca em botões de ligação ou deep links de ligação para ajudar a rastrear a origem das ligações iniciadas pelo usuário. [Saiba mais](/documentation/business-messaging/whatsapp/calling/call-button-messages-deep-links)
107
+
108
+ 8 de setembro de 2025
109
+
110
+ Atualização sobre ligações da API de status de integridade
111
+
112
+ [A API de Status de Integridade](/documentation/business-messaging/whatsapp/support/health-status) agora inclui um novo `can_receive_call_sip` campo para ajudar você a fazer o autodiagnóstico de problemas relacionados à configuração de [SIP](/documentation/business-messaging/whatsapp/calling/sip)
113
+
114
+ 5 de setembro de 2025
115
+
116
+ Incluímos novas restrições para baixa taxa de atendimento de ligações
117
+
118
+ As restrições para baixa taxa de atendimento de ligações entram em vigor hoje. Para saber mais, consulte [Restrições de ligação para baixas taxas de ligações atendidas](/documentation/business-messaging/whatsapp/calling/call-settings#calling-restrictions-for-low-call-pickup-rates)
119
+
120
+ 21 de julho de 2025
121
+
122
+ Webhooks de atualização de configurações da conta
123
+
124
+ Receba webhooks quando as configurações forem atualizadas. [Saiba mais](/documentation/business-messaging/whatsapp/calling/call-settings#settings-update-webhooks).
125
+
126
+ Você achou esta página útil?
127
+
128
+ ![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
129
+
130
+ ![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)
@@ -0,0 +1,468 @@
1
+ <!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/calling/faq -->
2
+ <!-- Scraped: 2025-12-20T17:42:09.413Z -->
3
+
4
+ # Perguntas frequentes
5
+
6
+ Updated: 13 de nov de 2025
7
+
8
+ ## Perguntas frequentes sobre o produto
9
+
10
+ **As ligações aparecerão na página de insights da interface do usuário do Gerenciador do WhatsApp da Meta?**
11
+
12
+ Os insights sobre as ligações ficarão disponíveis no Gerenciador do WhatsApp e na [API de Análise](/documentation/business-messaging/whatsapp/analytics).
13
+
14
+ **As ligações internacionais têm suporte como ligações entre consumidores do WhatsApp?**
15
+
16
+ Sim
17
+
18
+ #### Em quais países é possível fazer ligações?
19
+
20
+ - A ligação iniciada pelo usuário está disponível em [todas as localizações em que a API de Nuvem está disponível](/documentation/business-messaging/whatsapp/support#country-restrictions)- As ligações iniciadas pela empresa (BIC, nas iniciais em inglês) estão disponíveis em [todas as localizações onde a API de Nuvem está disponível](/documentation/business-messaging/whatsapp/support#country-restrictions), **exceto os seguintes países:**
21
+ - Estados Unidos- Canadá- Turquia- Egito- Vietnã- Nigéria
22
+
23
+ **Observação:** o código do país no número de telefone comercial deve estar nesta lista compatível. O número de telefone do consumidor pode ser de qualquer [país em que a API de Nuvem esteja disponível](/documentation/business-messaging/whatsapp/support#country-restrictions).
24
+
25
+ **Posso usar números gratuitos para fazer ligações?**
26
+
27
+ Sim, desde que o código do país para o número gratuito esteja na lista de países compatíveis. Consulte [Números 0800 e gratuitos](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#1-800-and-toll-free-numbers) para saber mais sobre como registrar números 0800 na API de Nuvem.
28
+
29
+ **Qual é o número máximo de ligações simultâneas que um único número de telefone de conta da API de Nuvem pode receber?**
30
+
31
+ O máximo de ligações simultâneas é mil. Quando o limite de volume é excedido, o responsável pela ligação (ou seja, o usuário do WhatsApp) recebe uma mensagem genérica dizendo que não é possível fazer a ligação. Nenhuma mensagem é reproduzida e não há webhook. Esperamos aumentar esse limite e, por isso, a probabilidade de isso acontecer é baixa. Os limites de volume para a API de mensagens e a API de criação/atualização de modelo são separados e não relacionados aos limites de ligações.
32
+
33
+ **Qual é a função do BSP em relação à empresa final no fluxo de ligação geral?**
34
+
35
+ - O BSP oferece serviços de valor agregado (por exemplo, central de contato, gravação de voz, transcrição e assim por diante) além do stream de áudio bruto fornecido pela API de Nuvem para Ligações.- O webhook é enviado para apps que assinaram o novo campo de assinatura `calls`. Em casos normais, um BSP usa o próprio app e recebe o webhook de ligação, seguido da ligação em questão.- A forma como a empresa final (ou seja, seu cliente) participa da ligação depende de você como BSP.
36
+
37
+ **A infraestrutura/API de voz do WhatsApp é a mesma do Facebook Messenger?**
38
+
39
+ A API de Ligação do WhatsApp é a primeira API de voz pública da Meta. A Meta poderá reutilizar a mesma API e modelo de integração para outros produtos quando e se eles oferecerem soluções de voz.
40
+
41
+ **Qual é a duração máxima da ligação compatível?**
42
+
43
+ Não há limite de duração para a ligação
44
+
45
+ **O SIP é compatível?**
46
+
47
+ Sim, consulte ["Como configurar e usar sinais de ligação por meio do protocolo de iniciação de sessão (SIP)"](/documentation/business-messaging/whatsapp/calling/sip)
48
+
49
+ **Posso enviar/receber mensagens de texto/mídia durante uma ligação?**
50
+
51
+ Sim. A [API send-message](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api) pode ser usada durante uma ligação.
52
+
53
+ **A Meta oferece serviços como gravação de voz, transcrição e correio de voz?**
54
+
55
+ Não. No entanto, esses serviços são oferecidos por vários dos nossos parceiros
56
+
57
+ **Podemos adicionar metadados (por exemplo, contexto) como parte da aceitação da ligação?**
58
+
59
+ Sim. Confira o campo [biz\_opaque\_callback\_data na especificação principal da API](/documentation/business-messaging/whatsapp/calling/reference#initiate-call). Além disso, o estado da conversa fornece um contexto importante para o atendente humano da empresa. O ideal é que o subsistema de encaminhamento de ligações conecte diretamente a ligação do cliente do WhatsApp ao agente certo na empresa. Essa opção proporciona a melhor experiência ao cliente e evita o sistema de IVR padrão
60
+
61
+ **Como podemos aumentar o reconhecimento do recurso de ligação entre os usuários do WhatsApp?**
62
+
63
+ - É possível enviar mensagens com botões de ligação de voz. Para saber mais, consulte as seções sobre [envio de mensagem interativa](/documentation/business-messaging/whatsapp/calling/call-button-messages-deep-links#send-interactive-message-with-a-whatsapp-call-button) e [envio de mensagem de modelo](/documentation/business-messaging/whatsapp/calling/call-button-messages-deep-links#create-and-send-whatsapp-call-button-template-message)- Também é possível enviar uma mensagem com um botão de ligação de voz automaticamente quando um consumidor do WhatsApp abre uma conversa com sua conta comercial pela primeira vez. Consulte [mensagem de boas-vindas](/documentation/business-messaging/whatsapp/business-phone-numbers/conversational-components#welcome-messages) para saber mais.- É possível [adicionar um link para uma ligação do WhatsApp no seu site usando deep links](/documentation/business-messaging/whatsapp/calling/call-button-messages-deep-links#calling-deep-links).
64
+
65
+ **É possível que uma IA (por exemplo, um voicebot) tenha uma conversa com um cliente diretamente por meio de uma ligação do WhatsApp?**
66
+
67
+ Sim. A Meta só fornece o stream de mídia bruta. Você é responsável por processá-lo. Vários parceiros usam bots de voz automatizados, incluindo bots de IA, para responder a ligações de usuários do WhatsApp. Muitos produtos de IA no mercado oferecem RTC/APIs de voz. Alguns até são compatíveis com WebRTC nativo. O processo de integração é semelhante ao que você faria para integrar a API de Ligação do WhatsApp Business com centrais de atendimento humanas ou de IVR.
68
+
69
+ **Por que a [aceitação prévia](/documentation/business-messaging/whatsapp/calling/user-initiated-calls#pre-accept-call) de uma ligação iniciada pelo usuário inicia o cronometragem do lado do usuário do WhatsApp?**
70
+
71
+ Talvez seja porque você está enviando mídia antes de [aceitar](/documentation/business-messaging/whatsapp/calling/user-initiated-calls#accept-call) a ligação. Os clientes do WhatsApp consideram uma ligação como aceita por um par se receberem um pacote de mídia ou um sinal de aceitação, o que ocorrer primeiro.
72
+
73
+ Caso você não consiga controlar o momento de início da mídia, [aceite](/documentation/business-messaging/whatsapp/calling/user-initiated-calls#accept-call) a ligação diretamente, sem usar a [pré-aceitação](/documentation/business-messaging/whatsapp/calling/user-initiated-calls#pre-accept-call). A pré-aceitação serve para preparar o estabelecimento da conexão de mídia, mas exige o controle do tempo de transmissão de mídia.
74
+
75
+ ## Perguntas frequentes sobre como começar
76
+
77
+ **Qual é a versão mínima da Graph API para as APIs de Ligação?**
78
+
79
+ Versão 17.0. [Confira aqui o histórico de versões geral](/docs/graph-api/changelog)
80
+
81
+ **Podemos usar o mesmo token de acesso do usuário para enviar mensagens e fazer ligações?**
82
+
83
+ Sim. Em geral, o que funciona para mensagens também funciona para ligações.
84
+
85
+ **A WABA precisa ter uma linha de crédito anexada para usar as APIs de Ligação?**
86
+
87
+ Sim, você precisa ter uma linha de crédito associada à sua WABA para usar a API de Ligações.
88
+
89
+ **A WABA precisa ser uma empresa verificada para fazer ligações?**
90
+
91
+ Não. A [verificação da empresa](https://www.facebook.com/business/help/2058515294227817?**id=180505742745347) não é obrigatória para fazer ligações nem enviar mensagens
92
+
93
+ **Como o uso das APIs de Ligação afeta meus limites de volume?**
94
+
95
+ No momento, o uso da API de Ligações não é contabilizado no limite de volume de mensagens. No momento, o único limite aplicado para ligações é o de mil ligações simultâneas, mas isso pode mudar em breve.
96
+
97
+ **É possível que uma conta do WhatsApp Business esteja conectada ao provedor A para conversas e ao provedor B para voz (ou seja, dois apps diferentes inscritos na mesma conta/telefone do webhook do WhatsApp Business)?**
98
+
99
+ Sim, é possível que dois parceiros operem um único número de telefone da API do WhatsApp Business com duas soluções separadas, como conversa e ligações.
100
+
101
+ [Para saber mais, consulte o artigo sobre conversas com várias soluções](/documentation/business-messaging/whatsapp/solution-providers/multi-solution-conversations).
102
+
103
+ Outra opção é o provedor de voz usado por outro BSP. Nesse caso, você não precisa ter um app da Meta nem ser um Provedor de Tecnologia na Meta. Essa arquitetura é descrita em detalhes na seção [“Como fazer a integração usando um provedor de voz independente”](/documentation/business-messaging/whatsapp/calling/integration-patterns#integrating-using-a-third-party-voice-provider-detailed-design).
104
+
105
+ ## Perguntas frequentes sobre sinalização de ligações da Graph API
106
+
107
+ **A Meta fornece servidores stun/turn ou infraestrutura de WebRTC para uso pelo BSP?**
108
+
109
+ Não.
110
+
111
+ A Meta usa [ICE-lite](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc8445%23autoid-21&h=AT0oQebnLPgiwDCZK80u5D4iJNb2R12de_NRG5Zwy9-jUyqCtYb27cnJ7q9LIfPm1NpryUG_Mb8DpLD3-LPtjxaNA-64jiwG9EspAxfGgynw0fFYdP9JCwwGNOTTb4psR0E1jL6nxZ5A2P5Fu0-fLYz-410). Nossa oferta de SDP sempre possui um único endereço ipv4 e ipv6 por componente de fluxo de dados. Recomendamos que a resposta do SDP siga o mesmo
112
+
113
+ Por isso, não é obrigatório usar STUN/TURN para determinar os candidatos ICE
114
+
115
+ **A Meta recomenda servidores stun/turn ou infraestrutura de WebRTC para uso pelo BSP?**
116
+
117
+ A Meta não tem recomendações. Veja algumas ideias para reflexão, caso sejam úteis.
118
+
119
+ - Verifique se você já tem alguma tecnologia relacionada a VoIP e, se tiver, consulte essa equipe. O WebRTC usa o protocolo SRTP/SRTCP para mídias reais, que é o padrão de mídia VoIP.- O uso de STUN/TURN funciona bem em uma configuração de usuário final com um navegador em um dispositivo pessoal. Caso a integração com nossas APIs de Voz envolva o encerramento da mídia diretamente no dispositivo do usuário final, o processo de STUN/TURN acontecerá diretamente no dispositivo desse usuário. No entanto, com frequência, a mídia é encerrada na infraestrutura do parceiro para que serviços como IVR possam ser oferecidos. Nesses casos, a infraestrutura pode ter as próprias maneiras de alocar um IP e uma porta para conexões VoIP, por exemplo, usando VIP por trás de um balanceador de carga etc.
120
+
121
+ **Qual função do ICE o agente ICE do lado da empresa deve assumir?**
122
+
123
+ Você deve sempre assumir a função CONTROLLING, já que o agente ICE do lado da Meta usa o ICE-lite ([RFC 8445](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc8445%23autoid-21&h=AT0oQebnLPgiwDCZK80u5D4iJNb2R12de_NRG5Zwy9-jUyqCtYb27cnJ7q9LIfPm1NpryUG_Mb8DpLD3-LPtjxaNA-64jiwG9EspAxfGgynw0fFYdP9JCwwGNOTTb4psR0E1jL6nxZ5A2P5Fu0-fLYz-410)). Se você começar com a função de CONTROLLED, o processo ICE poderá travar e expirar. Mesmo que funcione, demorará mais tempo devido às várias idas e vindas necessárias para resolver conflitos de função.
124
+
125
+ **É possível adicionar mais candidatos ao ICE como parte do sinal em oferta + resposta (por exemplo, usando o ICE Trickle)?**
126
+
127
+ A resposta curta é "sim". A API de Nuvem usa [ICE-lite (RFC 8445)](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc8445%23autoid-21&h=AT0oQebnLPgiwDCZK80u5D4iJNb2R12de_NRG5Zwy9-jUyqCtYb27cnJ7q9LIfPm1NpryUG_Mb8DpLD3-LPtjxaNA-64jiwG9EspAxfGgynw0fFYdP9JCwwGNOTTb4psR0E1jL6nxZ5A2P5Fu0-fLYz-410) e sempre assume a [função](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc8445%23autoid-26&h=AT0oQebnLPgiwDCZK80u5D4iJNb2R12de_NRG5Zwy9-jUyqCtYb27cnJ7q9LIfPm1NpryUG_Mb8DpLD3-LPtjxaNA-64jiwG9EspAxfGgynw0fFYdP9JCwwGNOTTb4psR0E1jL6nxZ5A2P5Fu0-fLYz-410) CONTROLLED no ICE. Portanto, não é necessário enviar os candidatos atualizados para a Meta. Seu agente ICE pode iniciar verificações de conectividade a partir de endereços não incluídos no seu SDP, e nosso agente ICE considerará endereços desconhecidos como candidatos válidos, desde que a integridade da mensagem STUN seja aprovada.
128
+
129
+ **Qual é a maneira recomendada de determinar o candidato do ICE?**
130
+
131
+ A Meta tem uma infraestrutura e uma presença global e escolherá o retransmissor de mídia mais próximo ao usuário do WhatsApp envolvido na ligação.
132
+
133
+ Você pode escolher o servidor/host de mídia (também conhecido como direcionamento) com base em diversos parâmetros, incluindo o IP que escolhemos, o país do número de telefone do consumidor e o número de telefone comercial. A seleção da localização do servidor de mídia é um fator importante na otimização da latência de mídia entre o IP do BSP e o IP da Meta, o que contribui para uma maior qualidade da ligação. No mínimo, recomendamos que a localização de hospedagem da ligação/mídia do BSP esteja próxima ao país do usuário do WhatsApp, conforme determinado pelo código do país do número de telefone.
134
+
135
+ As implementações de direcionamento devem otimizar para os IPs dos candidatos nos metas-SDPs e não na fonte dos pontos de extremidade de sinalização.
136
+
137
+ **Há uma API para enviar uma resposta provisória equivalente ao toque de SIP 180?** Em caso negativo, quando o dispositivo do usuário começa a tocar?
138
+
139
+ O usuário que está ligando (ou seja, o app WhatsApp de consumidor) já estaria ligando quando você recebeu o webhook. Não há necessidade de respostas provisórias
140
+
141
+ **Como as ligações são protegidas?**
142
+
143
+ A API de Nuvem usa o protocolo SRTP para a criptografia de streams de mídia [(RTP/SAVPF)](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc5124&h=AT0oQebnLPgiwDCZK80u5D4iJNb2R12de_NRG5Zwy9-jUyqCtYb27cnJ7q9LIfPm1NpryUG_Mb8DpLD3-LPtjxaNA-64jiwG9EspAxfGgynw0fFYdP9JCwwGNOTTb4psR0E1jL6nxZ5A2P5Fu0-fLYz-410). A troca de chave SRTP real é inicialmente executada de ponta a ponta com [DTLS-SRTP](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc5764&h=AT0oQebnLPgiwDCZK80u5D4iJNb2R12de_NRG5Zwy9-jUyqCtYb27cnJ7q9LIfPm1NpryUG_Mb8DpLD3-LPtjxaNA-64jiwG9EspAxfGgynw0fFYdP9JCwwGNOTTb4psR0E1jL6nxZ5A2P5Fu0-fLYz-410).
144
+
145
+ **A Meta pode enviar webhooks de ligação para um ponto de extremidade diferente com base na localização geográfica do cliente ou outros fatores, como latência de rede?**
146
+
147
+ O URL do webhook é fornecido por você. Nós usamos HTTPs para que você possa usar técnicas de balanceamento de carga e direcionamento padrão para redirecionar de acordo. Você também pode configurar um URL de webhook diferente (também conhecido como substituto ou alternativo) por [conta do WhatsApp Business](/documentation/business-messaging/whatsapp/solution-providers/manage-webhooks#overriding-the-callback-url) e por [número de telefone comercial](/docs/whatsapp/embedded-signup/webhooks/override#set-phone-number-alternate-callback). O webhook é usado apenas para sinalização. Os servidores da Meta que fazem ligações para o servidor do webhook estão localizados nos EUA. Recomendamos que você selecione a localização do ponto de extremidade de mídia com base no código do país do consumidor do WhatsApp (disponível nos nossos webhooks) ou nos IPs do candidato ICE no SDP enviado pela Meta. Consulte as perguntas frequentes acima: **“Qual é a maneira recomendada de determinar o candidato do ICE?**” e **“Como reduzir a latência de mídia das ligações?”**.
148
+
149
+ **Quais são os endereços IP da Meta que ligarão para nosso servidor de Webhook, SIP ou mídia para que possamos incluí-los na lista de permissão do nosso firewall?**
150
+
151
+ Consulte nossa [documentação pública](/documentation/business-messaging/whatsapp/webhooks/overview#ip-addresses) sobre esse assunto. Ao recolher a lista de endereços IPv4, você obtém cerca de 23 prefixos. Confira abaixo um exemplo de comando e saída gerada em 11 de dezembro de 2024
152
+
153
+ ```
154
+ $ src % whois -h whois.radb.net — '-i origin AS32934' | grep ^route | awk '{print $2}' | grep -iv ':' | cidrmerge
155
+ 31.13.24.0/21
156
+ 31.13.64.0/18
157
+ 45.64.40.0/22
158
+ 57.141.0.0/21
159
+ 57.141.8.0/22
160
+ 57.141.12.0/23
161
+ 57.144.0.0/14
162
+ 66.220.144.0/20
163
+ 69.63.176.0/20
164
+ 69.171.224.0/19
165
+ 74.119.76.0/22
166
+ 102.132.96.0/20
167
+ 103.4.96.0/22
168
+ 129.134.0.0/16
169
+ 147.75.208.0/20
170
+ 157.240.0.0/16
171
+ 163.70.128.0/17
172
+ 163.77.128.0/17
173
+ 173.252.64.0/18
174
+ 179.60.192.0/22
175
+ 185.60.216.0/22
176
+ 185.89.216.0/22
177
+ 204.15.20.0/22
178
+ ```
179
+
180
+ **É possível reduzir os endereços IP da Meta que ligarão para nossos servidores de webhook pelo menos para fins de teste e desenvolvimento?**
181
+
182
+ Não. Porém, veja as perguntas frequentes acima, que deduziram cerca de 23 prefixos IPv4 para cobrir completamente todo o nosso espaço de endereços para v4.
183
+
184
+ **Qual é a política de novas tentativas para webhooks relacionados a ligações?**
185
+
186
+ Recomendamos que você não faça suposições nesse aspecto. O servidor de webhook deve determinar webhooks obsoletos com base no valor do registro de data e hora e evitar chamar Graph APIs para processá-los. Os webhooks de mensagens existentes [passam por novas tentativas por até 7 dias](/documentation/business-messaging/whatsapp/webhooks/overview#webhook-delivery-failure).
187
+
188
+ Webhooks relacionados a ligações provavelmente terão uma política de nova tentativa mais curta, mas é possível que você receba webhooks obsoletos, pois essa pode ser uma informação útil para a empresa saber que alguns consumidores tentaram entrar em contato.
189
+
190
+ **Vocês garantem que os webhooks serão entregues exatamente uma vez?**
191
+
192
+ Não. Você precisa estar preparado para lidar com webhooks duplicados.
193
+
194
+ Devido à natureza distribuída da nossa arquitetura, não podemos garantir que os webhooks sejam entregues exatamente uma vez, mesmo nos casos de webhooks relacionados a mensagens. Veja alguns cenários conhecidos em que podem ocorrer duplicações.
195
+
196
+ - Nossa solicitação https para o servidor do webhook expirou após aproximadamente 20 segundos. Nesse caso, o servidor acredita que processou com sucesso a solicitação do webhook, mas do nosso lado falhou devido ao tempo-limite. Tentamos enviar novamente o webhook, que aparece para você como duplicado.- Seu número de telefone tem mais de um app inscrito no campo de ligações, então enviaremos webhooks para app1, app2 nesta ordem. Se o app2 falhar, tentaremos refazer todo o envio novamente e o app1 receberá um webhook duplicado. Estamos trabalhando para corrigir esse problema.- A recuperação de falha na infraestrutura de filas da Meta pode resultar em envios duplicados de webhooks.- Também pode haver outros motivos desconhecidos.
197
+
198
+ **Vocês garantem a ordem dos webhooks em uma determinada ligação?**
199
+
200
+ Não, devido à natureza distribuída da nossa arquitetura e às novas tentativas.
201
+
202
+ Por exemplo, o webhook de encerramento poderá ser recebido antes do webhook de conexão se o usuário do WhatsApp desligar imediatamente após iniciar a ligação. Confira outros exemplos conhecidos.
203
+
204
+ Tentamos conectar o webhook, mas o tempo de espera expira após aproximadamente 20 segundos. O "webhook de encerramento" é enviado em seguida. A nova tentativa de conexão do webhook acontece depois do "webhook de encerramento". No caso de um tempo-limite, o servidor de webhook acredita que não há falha, mas nós vemos isso como uma falha que garante uma nova tentativa.
205
+
206
+ **Posso configurar vários servidores de webhook para ligações e ter uma noção de primário e secundário para alta disponibilidade?**
207
+
208
+ Assim como com acontece com as mensagens, é possível configurar várias assinaturas com apps diferentes associados a URLs de retorno de ligação distintos. A Meta enviará todos os webhooks de ligação para os URLs de retorno de ligações configurados. Entretanto, tratamos todos os URLs como iguais e não temos uma noção de primário/secundário
209
+
210
+ **Posso configurar URLs diferentes para webhooks relacionados a mensagens e ligações?**
211
+
212
+ Sim, para fazer isso, use dois apps diferentes da Meta: um para mensagens e outro para ligações.
213
+
214
+ Inscreva o app de mensagens apenas nos campos de assinatura de webhooks relacionados a mensagens e o app de ligação nos campos de assinatura relacionados a ligações. É possível substituir o URL de retorno de ligação de cada app no nível da WABA ou do número de telefone para ter uma substituição de URL diferente para mensagens e ligações.
215
+
216
+ No entanto, também é possível ter um único app e assinar os dois campos de assinatura de webhook `messages` e `calls`. Nessa configuração, o URI de retorno de ligação é o mesmo para mensagens e webhooks relacionados a ligações, mas a carga do webhook pode ser usada para distinguir as duas categorias de webhooks.
217
+
218
+ Em geral, recomendamos o uso de um único app.
219
+
220
+ **Você pode compartilhar um exemplo de solicitação CURL para interagir com as APIs?**
221
+
222
+ Consulte a seção [Exemplo de solicitação CURL](/documentation/business-messaging/whatsapp/calling/reference#sample-curl-requests) na nossa referência da API.
223
+
224
+ **Como os parâmetros SDP devem ser serializados com retornos de carro e uma nova linha?**
225
+
226
+ O parâmetro de sessão exige que o sdp seja definido como uma string de acordo com a especificação [RFC-8866](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc8866&h=AT0oQebnLPgiwDCZK80u5D4iJNb2R12de_NRG5Zwy9-jUyqCtYb27cnJ7q9LIfPm1NpryUG_Mb8DpLD3-LPtjxaNA-64jiwG9EspAxfGgynw0fFYdP9JCwwGNOTTb4psR0E1jL6nxZ5A2P5Fu0-fLYz-410), que requer o uso de CRLF para encerrar um registro. O parâmetro SDP em si é uma string; portanto, não deve ser serializado. No entanto, o parâmetro de conexão legado exigia que a string sdp em conformidade com [RFC-8866](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc8866&h=AT0oQebnLPgiwDCZK80u5D4iJNb2R12de_NRG5Zwy9-jUyqCtYb27cnJ7q9LIfPm1NpryUG_Mb8DpLD3-LPtjxaNA-64jiwG9EspAxfGgynw0fFYdP9JCwwGNOTTb4psR0E1jL6nxZ5A2P5Fu0-fLYz-410) estivesse dentro de uma estrutura json e, portanto, exigia mais serialização.
227
+
228
+ Ou seja, use “\\r\\n” para o parâmetro session->sdp. **Não use o parâmetro de conexão herdada ->webrtc->sdp.**
229
+
230
+ **Como corrigir o erro "Nenhuma impressão digital encontrada no SDP"?**
231
+
232
+ Seu SDP deve ter uma linha `a=fingerprint` quando você está usando [DTLS](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc6347&h=AT0oQebnLPgiwDCZK80u5D4iJNb2R12de_NRG5Zwy9-jUyqCtYb27cnJ7q9LIfPm1NpryUG_Mb8DpLD3-LPtjxaNA-64jiwG9EspAxfGgynw0fFYdP9JCwwGNOTTb4psR0E1jL6nxZ5A2P5Fu0-fLYz-410) como o protocolo de troca de chave [SRTP](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc3711&h=AT0oQebnLPgiwDCZK80u5D4iJNb2R12de_NRG5Zwy9-jUyqCtYb27cnJ7q9LIfPm1NpryUG_Mb8DpLD3-LPtjxaNA-64jiwG9EspAxfGgynw0fFYdP9JCwwGNOTTb4psR0E1jL6nxZ5A2P5Fu0-fLYz-410). Adicione essa linha ou [configure o número de telefone comercial para usar SDES](/documentation/business-messaging/whatsapp/calling/sip#configure-sdes-for-srtp-key-exchange-protocol). Confira todas as [configurações de sinalização e mídia](/documentation/business-messaging/whatsapp/calling/sip#signaling-and-media-possible-configurations) possíveis.
233
+
234
+ ## Perguntas frequentes sobre WebRTC/mídia
235
+
236
+ **A conexão ponto a ponto da Meta é para o BSP ou para a empresa final?**
237
+
238
+ Normalmente, é para o BSP. Porém, dependendo da oferta, da arquitetura e do produto, pode ser a empresa final.
239
+
240
+ Se for o cliente final, você (como BSP) precisará interagir de forma programática com ele para obter os candidato do ICE incluídos na chamada à Graph API e aceitar a ligação recebida.
241
+
242
+ **O que acontecerá se a mídia parar de fluir de um lado devido a problemas de conexão?**
243
+
244
+ Um exemplo simples seria se o [ponto de extremidade de encerramento de ligação](/documentation/business-messaging/whatsapp/calling/reference#terminate-call) falhar e o lado da empresa parar de enviar mídia.
245
+
246
+ Isso resultará na falta de pacotes RTCP, o que ajuda a detectar um agente WebRTC inativo. A ligação será desconectada e o webhook [terminate](/documentation/business-messaging/whatsapp/calling/reference#call-terminate-webhook) será enviado.
247
+
248
+ **O codec é sempre opus/48000?**
249
+
250
+ Sim. A taxa de bits do relógio de RTP é definida como 48.000 em SDP, conforme o [RFC 7587](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc7587%23autoid-17&h=AT0oQebnLPgiwDCZK80u5D4iJNb2R12de_NRG5Zwy9-jUyqCtYb27cnJ7q9LIfPm1NpryUG_Mb8DpLD3-LPtjxaNA-64jiwG9EspAxfGgynw0fFYdP9JCwwGNOTTb4psR0E1jL6nxZ5A2P5Fu0-fLYz-410). Os apps para celular do WhatsApp oferecem suporte apenas para o formato Opus.
251
+
252
+ **Além disso, há suporte para outros codecs?**
253
+
254
+ No momento, só oferecemos suporte para o codec Opus. Os apps para celular do WhatsApp oferecem suporte apenas para o formato Opus.
255
+
256
+ **Há suporte para DTMF?**
257
+
258
+ Sim. Para mais informações, consulte a seção [DTMF](/documentation/business-messaging/whatsapp/calling/user-initiated-calls#dual-tone-multi-frequency--dtmf--support). A maioria das implementações de SIP deve oferecer suporte para o processamento de DTMF recebido por meio do fluxo de dados do RTP ([reference](https://l.facebook.com/l.php?u=https%3A%2F%2Fvoipnuggets.com%2F2023%2F06%2F12%2Fdifferent-types-of-dtmf-in-sip-and-why-dtmf-via-rfc2833-is-more-reliable%2F&h=AT0oQebnLPgiwDCZK80u5D4iJNb2R12de_NRG5Zwy9-jUyqCtYb27cnJ7q9LIfPm1NpryUG_Mb8DpLD3-LPtjxaNA-64jiwG9EspAxfGgynw0fFYdP9JCwwGNOTTb4psR0E1jL6nxZ5A2P5Fu0-fLYz-410)).
259
+
260
+ **Quantos streams o SDP aceita?**
261
+
262
+ É possível ter apenas um stream no SDP de oferta/resposta.
263
+
264
+ **Quantas faixas são compatíveis em cada stream SDP?**
265
+
266
+ É possível ter apenas uma faixa de áudio no stream SDP.
267
+
268
+ **Para uma ligação entre consumidor e empresa, os apps de consumidor do WhatsApp funcionam com uma oferta de SDP gerada pelo navegador de um agente comercial?**
269
+
270
+ Nesse caso, o agente WebRTC no navegador deve gerar uma resposta SDP, não uma oferta.
271
+
272
+ Essa resposta SDP deve ser fornecida de volta para nós usando o [ponto de extremidade de aceitação de ligação](/documentation/business-messaging/whatsapp/calling/reference#accept-call). A Meta só pode trabalhar com a oferta de SDP que foi gerada e fornecida a você no webhook.
273
+
274
+ **Qual algoritmo de certificado é recomendado para DTLS?**
275
+
276
+ Recomendamos certificados ECDSA, pois eles levam a uma geração de certificado mais rápida e a handshakes DTLS menores devido à [ausência de fragmentação](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc6347%23autoid-26&h=AT0oQebnLPgiwDCZK80u5D4iJNb2R12de_NRG5Zwy9-jUyqCtYb27cnJ7q9LIfPm1NpryUG_Mb8DpLD3-LPtjxaNA-64jiwG9EspAxfGgynw0fFYdP9JCwwGNOTTb4psR0E1jL6nxZ5A2P5Fu0-fLYz-410).
277
+
278
+ **Quem iniciaria as ligações após aceitar a ligação iniciada pelo usuário: o BSP ou a Meta?**
279
+
280
+ O BSP deve iniciar as verificações de conectividade do ICE assim que decide aceitar a ligação.
281
+
282
+ Isso pode ser feito antes mesmo de chamar nossa API de aceitação, mas o processo do ICE só converge depois que processarmos sua resposta SDP, devido à necessidade de impressão digital do certificado DTLS.
283
+
284
+ **Quais são os números de porta usados pelos candidatos do ICE no SDP da Meta para que possamos incluir essas portas na lista de permissão dos nossos firewalls?**
285
+
286
+ Os números de porta podem ser `40012`, `3482`, `3484`, `3478`, `3480`. Essas listas estão sujeitas a alterações.
287
+
288
+ **Como podemos gerar o SDP de aceitação do WebRTC?**
289
+
290
+ Consulte a documentação da biblioteca/ferramenta de webrtc que você planeja usar.
291
+
292
+ Processar uma oferta de SDP para gerar uma resposta SDP é a funcionalidade principal de qualquer pilha de tecnologia VoIP.
293
+
294
+ **Como reduzir a latência de mídia das ligações?**
295
+
296
+ Os algoritmos de direcionamento da Meta escolherão a retransmissão da meta que recebe mídia do BSP próximo à localização do consumidor do WhatsApp. Essa retransmissão de mídia é o candidato do ICE que a Meta compartilhará no SDP. Os servidores de mídia do BSP devem estar na mesma região que os consumidores para fins de direcionamento. Isso minimiza a latência em ligações na mesma região, além de diminuir as rotas de pacotes de mídia na internet pública para ligações internacionais.
297
+
298
+ **Existe um processo de reconexão em caso de perda de conexão/possível perda de mídia?**
299
+
300
+ Os apps de consumidor do WhatsApp tentarão reconectar e recuperar automaticamente essa parte da ligação assim que a conectividade de rede for restaurada.
301
+
302
+ Do lado da empresa, esperamos condições de rede relativamente mais estáveis e, no momento, não temos suporte para um novo handshake ou renegociação de SDPs. De qualquer modo, a ligação pode ser encerrada após um determinado período de inatividade. Nesse caso, você receberá um webhook de encerramento.
303
+
304
+ **Quanta largura de banda seria necessária para a central de atendimento oferecer suporte a um determinado número de ligações simultâneas?**
305
+
306
+ Por ligação, é preciso ter aproximadamente 40 kbps para codec + 20 kbps de sobrecarga = 64 kbps. No entanto, a largura de banda do codec pode variar entre 20 e 50 kbps.
307
+
308
+ O codec Opus é capaz de alterar dinamicamente a largura de banda consumida com base nas condições da rede. Em geral, pode oferecer melhor qualidade de áudio com menor consumo de largura de banda em comparação com o codec G711.
309
+
310
+ O codec G711, por exemplo, precisa de 64 kbps para codec + 20 kbps de sobrecarga = 84 kbps por ligação.
311
+
312
+ É possível multiplicar os números acima pelo número esperado de ligações simultâneas para calcular a largura de banda cumulativa necessária. Por exemplo, uma largura de banda de 1 Mbps pode gerenciar aproximadamente 15 ligações simultâneas no Opus (1000/64) em comparação com 12 ligações simultâneas no G711 (1000/84).
313
+
314
+ Para calcular o uso total de dados, multiplique a largura de banda pela duração da ligação em segundos. No caso do opus, é um pouco mais complicado porque ele tem largura de banda variável dependendo de muitos fatores, incluindo largura de banda disponível estimada usando a estimativa de largura de banda, se o grupo local está falando ou em silêncio etc. Aproximadamente, uma ligação de 1 minuto no Opus consome 3,75 MB de dados, enquanto a mesma ligação no G711 consome 4,9 MB de dados
315
+
316
+ **É possível fazer a transferência de uma ligação de um agente para outro durante uma sessão de ligação ativa? Ou seja, um cliente está falando com o Agente A e precisa ser transferido para o Agente B?**
317
+
318
+ A Meta não oferece suporte nativo para esse caso de uso.
319
+
320
+ A Meta não tem conhecimento dos diferentes agentes do parceiro/empresa; por isso, essa é uma operação que pode ser realizada somente pelo parceiro. Por exemplo, o fluxo de mídia pode ser do servidor de mídia da Meta para o servidor de mídia do parceiro para o Agente A. Quando a transferência acontece, o fluxo passa a ser do servidor de mídia da Meta para o servidor de mídia do parceiro para o Agente B. Em ambos os casos, a etapa do servidor de mídia da Meta para o servidor de mídia do parceiro permanece constante.
321
+
322
+ ## Perguntas frequentes sobre o cliente do WhatsApp de consumidor
323
+
324
+ **Quando o ícone de ligação na barra de título da conversa fica visível nos apps do WhatsApp de consumidor?**
325
+
326
+ Ele fica visível quando **todas as seguintes condições são atendidas:**
327
+
328
+ - O número de telefone comercial tem o status de ligação definido como `ENABLED` na [API de configurações de ligação](/documentation/business-messaging/whatsapp/calling/call-settings).- O número de telefone comercial `call_icon_visibility` não é `HIDE_IN_CHAT` nem `DISABLE_ALL`- O recurso de visibilidade do ícone de ligação é compatível com as versões 2.24.10.8 e posteriores do app WhatsApp para celular no Android e iOS.- WhatsApp versão 2.23.14 ou posterior instalado no dispositivo do consumidor. Esperamos que todos os consumidores usem essa versão ou uma superior.
329
+
330
+ [Veja a API de configurações de ligação para saber mais](/documentation/business-messaging/whatsapp/calling/call-settings)
331
+
332
+ **Por que o ícone de ligação no app do WhatsApp de consumidor não reflete as configurações atuais de ligação?**
333
+
334
+ Depois da atualização da configuração de ligação, pode levar até 7 dias para ela ser exibida aos usuários do WhatsApp, embora, na maioria dos casos, leve menos tempo. Para forçar uma atualização imediata no WhatsApp, abra a janela de conversa com a empresa e a página de informações da conversa. Independentemente do comportamento do cliente do WhatsApp, a semântica das configurações ainda é respeitada no lado do servidor.
335
+
336
+ Para solucionar o problema do ícone de ligação não aparecer, siga as seguintes etapas:
337
+
338
+ - Abra a janela da conversa com a empresa e clique no nome/número dela na barra de título. Isso direcionará você para a tela de informações da empresa e forçará o app a atualizar o estado da ligação para a empresa.- Saia e depois volte para a janela de conversa da empresa.- Se o estado esperado ainda não for exibido, encerre e reinicie o app WhatsApp.- [Obtenha as configurações de ligação](/documentation/business-messaging/whatsapp/calling/call-settings) para confirmar as configurações esperadas.
339
+
340
+ **Quanto tempo leva para os clientes do WhatsApp terem acesso às alterações na configuração de ligação?**
341
+
342
+ Pode levar até 7 dias, embora a maioria dos usuários do WhatsApp deva ter acesso às mudanças muito antes.
343
+
344
+ Cada empresa no WhatsApp pode conversar com um número ilimitado de usuários entre os mais de 3 bilhões presentes no WhatsApp Business. As atualizações às configurações de ligação geram notificações de alteração a todos os usuários que tenham uma conversa com a empresa visível na Caixa de Entrada do WhatsApp. No entanto, a entrega de notificações é feita de forma otimizada; por isso, nem todos os usuários podem recebê-las.
345
+
346
+ Todos os clientes do WhatsApp atualizam os dados da empresa (incluindo a configuração de ligação) a cada 7 dias, independentemente de receberem notificações de alteração.
347
+
348
+ Em qualquer um dos casos (notificação ou atualização em 7 dias), assim que o estado local no cliente do WhatsApp for atualizado, essa mudança será apresentada na interface do usuário apenas no próximo acesso à tela de conversa ou de informações da conversa.
349
+
350
+ **Preciso criar uma lista de permissão com números de telefone dos consumidores para fazer ligações?**
351
+
352
+ Não.
353
+
354
+ **Podemos limitar o acesso de ligações a usuários individuais ou específicos do WhatsApp em vez de todos os usuários do WhatsApp?** Exemplo: um lead qualificado ou um cliente no nível premium
355
+
356
+ Não, não existe uma forma de controlar a visibilidade ou o acesso de ligações em uma base individual de usuários do WhatsApp. No entanto, você pode usar a [API de Configurações de Ligação](/documentation/business-messaging/whatsapp/calling/call-settings) para definir `call_icon_visibility` como `DISABLE_ALL`, o que ocultará todos os ícones de ligação de todos os usuários do WhatsApp. Para usuários qualificados do WhatsApp, você pode enviar uma mensagem com o botão de CTA de ligação. Assim, somente eles poderão ligar para você ao tocar no botão na mensagem
357
+
358
+ Para fornecer esse tipo de recurso, a Meta precisaria armazenar as configurações por usuário do WhatsApp, o que apresenta um risco de privacidade maior. Isso também gerará mais despesas operacionais para você manter grandes listas de usuários do WhatsApp incluídos de forma contínua.
359
+
360
+ **Quando o ícone de ligação é ocultado usando a API de Configurações de Ligação, os consumidores ainda conseguem ligar para a empresa?**
361
+
362
+ Sim.
363
+
364
+ O usuário ainda poderá ligar para a empresa usando outros pontos de entrada que não sejam afetados pela [API de Configurações de Ligação](/documentation/business-messaging/whatsapp/calling/call-settings), como:
365
+
366
+ - Salvar o número comercial como um contato e usar uma nova ligação- Registro de ligações da aba Ligações > Recentes- CTA de ligação em mensagens enviadas pela empresa- Balão de ligação na janela de conversa que aparece após qualquer ligação entre o usuário e a empresa
367
+
368
+ Por isso, a recomendação é tratar `DISABLE_ALL` apenas como um filtro amplo de nível 1 e garantir que os webhooks façam qualquer filtragem adicional com base na sua própria lógica de negócios.
369
+
370
+ **Como os consumidores do WhatsApp digitarão os dígitos para DTMF?**
371
+
372
+ Os apps de consumidor do WhatsApp foram estendidos para oferecer suporte a um novo teclado para ligações comerciais.
373
+
374
+ [Saiba mais sobre o suporte a DTMF na API de Ligações](/documentation/business-messaging/whatsapp/calling/user-initiated-calls#dual-tone-multi-frequency--dtmf--support)
375
+
376
+ **Qual é a versão mínima dos apps para celular do WhatsApp que são compatíveis com o botão de ligação de voz?**
377
+
378
+ - A versão mínima do app para iOS é 24.1- A versão mínima do app para Android é 2.24.1
379
+
380
+ **Qual é a experiência do consumidor do WhatsApp em diferentes pontos do fluxo de configuração de ligação?**
381
+
382
+ Quando um consumidor do WhatsApp liga para uma empresa, o tom de retorno local é ouvido imediatamente se o dispositivo do consumidor tiver conexão com a internet.
383
+
384
+ A interface do usuário de ligação mostra "Ligando para BUSINESS\_NAME". Quando a API de Nuvem recebe e pré-aceita a solicitação de ligação do consumidor, a interface do usuário de ligação muda para "Chamando BUSINESS\_NAME". Depois de aceitar a ligação da Graph API, a interface do usuário é alterada para uma janela de ligação ativa que mostra o temporizador ao vivo da duração.
385
+
386
+ **Os usuários finais podem fazer ligações usando os apps WhatsApp Web ou WhatsApp Desktop?**
387
+
388
+ Não. O WhatsApp Web não oferece suporte a ligações entre consumidores ou empresas. No momento, os apps para desktop oferecem suporte apenas a ligações entre consumidores.
389
+
390
+ ## Perguntas frequentes sobre ligações iniciadas pela empresa
391
+
392
+ **Quais versões do WhatsApp e plataformas de cliente oferecem suporte ao recurso de ligação iniciada pela empresa?**
393
+
394
+ As versões 2.24.14.x e posteriores do cliente do WhatsApp oferecem suporte aos pedidos de permissão de ligação e ao recurso de ligação iniciada pela empresa.
395
+
396
+ As plataformas do WhatsApp para Android e iOS oferecem suporte ao recurso.
397
+
398
+ **Como evitar 138011 em conversas iniciadas pela empresa e pelo usuário durante o desenvolvimento/integração/teste?**
399
+
400
+ Conversa iniciada pelo usuário:
401
+
402
+ - Envie uma mensagem para o número da API de Nuvem usando a conta de consumidor do WhatsApp- Envie qualquer mensagem, exceto a mensagem de permissão de ligação, para o usuário- Envie um pedido de permissão de ligação para o usuário- Aceite o pedido de permissão de ligação no dispositivo do usuário
403
+
404
+ Conversa iniciada pela empresa:
405
+
406
+ - Envie um modelo de mensagem da empresa para o usuário- Envie o pedido de permissão de ligação para o usuário- Aceite o pedido de permissão de ligação no dispositivo do usuário
407
+
408
+ **Há alguma maneira de redefinir os limites do pedido de permissão para ligação?**
409
+
410
+ Uma ligação conectada redefinirá os limites de permissão para ligação.
411
+
412
+ **O que acontece se o usuário do WhatsApp tiver configurado [Silenciar números desconhecidos](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F1238612517047244%2F%3F**cms_platform%3Dandroid&h=AT0oQebnLPgiwDCZK80u5D4iJNb2R12de_NRG5Zwy9-jUyqCtYb27cnJ7q9LIfPm1NpryUG_Mb8DpLD3-LPtjxaNA-64jiwG9EspAxfGgynw0fFYdP9JCwwGNOTTb4psR0E1jL6nxZ5A2P5Fu0-fLYz-410)?**
413
+
414
+ As ligações iniciadas pela empresa ignoram as configurações de "Silenciar números desconhecidos", já que a ligação só pode acontecer com a permissão explícita do usuário.
415
+
416
+ **Por que minha mensagem de solicitação de permissão para ligação é renderizada de maneira diferente?**
417
+
418
+ O WhatsApp renderiza mensagens em versões com e sem suporte do app do cliente de forma diferente.
419
+
420
+ Depois que o usuário do WhatsApp atualizar o app, a mensagem será renderizada corretamente.
421
+
422
+ **Recebi o erro 138001 depois de enviar um pedido de permissão de ligação. O que devo fazer?**
423
+
424
+ [Confira os códigos de erro na nossa página de solução de problemas](/documentation/business-messaging/whatsapp/calling/troubleshooting)
425
+
426
+ **A permissão expira após a realização de cinco ligações conectadas?** Estou vendo o erro `138012`.
427
+
428
+ O limite de 5 ligações conectadas em 24 horas é somente um limite da execução com base em um intervalo de tempo. A permissão permanece aberta por 7 dias, mesmo que o limite seja atingido. A 6ª ligação pode acontecer 24 horas após a 1ª ligação.
429
+
430
+ Podemos encarar isso como um limite para ligações iniciadas pela empresa. É permitido o número máximo de 35 ligações em 7 dias.
431
+
432
+ ## Perguntas frequentes sobre o Protocolo de Iniciação de Sessão (SIP)
433
+
434
+ Consulte [Erros de SIP](/documentation/business-messaging/whatsapp/calling/troubleshooting#sip-errors) para ver erros específicos de SIP e possíveis soluções.
435
+
436
+ **Por que não recebemos um convite de SIP quando os usuários do WhatsApp ligam?**
437
+
438
+ Estes são alguns dos motivos possíveis
439
+
440
+ - Erro de validação do certificado TLS: consulte [Como testar se você tem um certificado TLS válido](/documentation/business-messaging/whatsapp/calling/sip#how-to-test-if-you-have-a-valid-tls-certificate)- O SIP não está configurado. [Verifique a configuração de ligações](/documentation/business-messaging/whatsapp/calling/sip#get-phone-number-calling-settings--sip-) para garantir que o SIP está habilitado- O app que configurou o servidor SIP não tem a permissão `whatsapp_business_messaging` no número de telefone comercial. Para verificar se você tem as permissões certas, tente [enviar uma mensagem](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api) usando o mesmo número de telefone comercial
441
+
442
+ **Por que o nosso SIP TERMINATE para a Meta não está sendo desligado do lado do usuário do WhatsApp?**
443
+
444
+ O motivo mais comum é a falha no handshake do TLS quando o servidor do SIP está tentando estabelecer uma sessão TLS com o servidor do SIP da Meta. Faça uma captura do pacote de rede do seu tráfego de SIP ou verifique os registros do servidor do SIP para confirmar o handshake bem-sucedido do TLS
445
+
446
+ **Por que meu servidor do SIP responde com 401 Não autorizado em ligações iniciadas pelo usuário?**
447
+
448
+ A Meta oferece suporte para autenticação de digester de SIP para [ligações iniciadas pelo usuário](/documentation/business-messaging/whatsapp/calling/sip#user-initiated-calls). Quando o servidor SIP responde com 401 Não autorizado (consulte o [fluxo de exemplo](/documentation/business-messaging/whatsapp/calling/sip#user-initiated-calls-with-digest-auth--with-sdes-media-)), o servidor SIP da Meta reenvia o convite com o cabeçalho de autorização apropriado. Configure o servidor do SIP usando como nome de usuário o número de telefone comercial e, como senha, a senha gerada pela Meta para o número de telefone.
449
+
450
+ Como alternativa, é possível desabilitar a autenticação por resumo no servidor do SIP, mas isso NÃO é recomendado do ponto de vista das boas práticas de segurança.
451
+
452
+ **Por que meu servidor do SIP está respondendo com 488 Não aceitável aqui?**
453
+
454
+ Consulte a documentação do servidor do SIP ou o fornecedor. O motivo provável é que o servidor do SIP não oferece suporte ao protocolo do ICE (Interactive Connectivity Establishment) do WebRTC. Para corrigir o problema, você pode [configurar seu número de telefone comercial para usar SDES](/documentation/business-messaging/whatsapp/calling/sip#configure-sdes-for-srtp-key-exchange-protocol).
455
+
456
+ **Precisamos fazer o registro do SIP do número de telefone comercial no servidor de SIP da Meta?**
457
+
458
+ Não. Você não deve enviar solicitações de registro para o nosso servidor de SIP. Isso geraria um consumo desnecessário de recursos em ambos os lados. As solicitações de REGISTRO apresentarão falha o erro 403 Proibido. Assim, nosso servidor do SIP é proprietário apenas do domínio meta.vc. Os únicos usuários do SIP nesse domínio são os usuários comuns do WhatsApp. Os números do WhatsApp Business pertencem ao seu domínio do SIP, que você configura usando nossa [API de configurações](/documentation/business-messaging/whatsapp/calling/sip#configure-update-sip-settings-on-business-phone-number).
459
+
460
+ **Vocês oferecem suporte para novos convites do SIP?**
461
+
462
+ Não. No momento, não oferecemos suporte a novos convites. Você receberá o código 500 Erro de servidor interno do servidor do SIP da Meta.
463
+
464
+ Você achou esta página útil?
465
+
466
+ ![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
467
+
468
+ ![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)