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,926 @@
1
+ <!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users -->
2
+ <!-- Scraped: 2025-12-20T17:48:59.384Z -->
3
+
4
+ # Como integrar usuários do app WhatsApp Business (também conhecido como "Coexistência")
5
+
6
+ Updated: 14 de nov de 2025
7
+
8
+ Você pode configurar o Cadastro Incorporado para permitir que os clientes empresariais façam a integração usando a conta do [app WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fproducts%2Fbusiness-app&h=AT24k-icRRGXIU9-xCKhbZ-aJmURa-CT8nYYgjmUn6fJ60gpPMGVEHyl7g-YU6QwgivG7m-__7OPnj-lJ--xFlWJY4JV3kuUlHUeoF1y5cydFaXSRcp62KQv-5D0hd9qyuZQKzyVDbnntoSPsQw2Q0wSeNQ) e o número de telefone. Depois de escolher essa opção e concluir a integração, os clientes poderão usar o app para enviar mensagens aos clientes em escala, além de enviar mensagens individuais pelo app WhatsApp Business. Além disso, o histórico de mensagens será sincronizado entre ambos os apps.
9
+
10
+ ## Como funciona
11
+
12
+ Se você configurar o Cadastro Incorporado para números de telefone do app WhatsApp Business, os clientes que passarem pelo fluxo terão a opção de conectar uma conta existente do app WhatsApp Business à API de Nuvem:
13
+
14
+ ![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/477341352_1809983926468415_3794578338113490554_n.png?_nc_cat=108&ccb=1-7&_nc_sid=e280be&_nc_ohc=-P3Z4_dfNugQ7kNvwHUBsMp&_nc_oc=AdlQPynWj1X9MVV6D3-74b1XS0aiMmW6OXMAOgVQV2R8kKQxqdigKk7KjvV-3maGNcs&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=7F2Tu9qNmA97srPxw_WPJA&oh=00_Afm2KwXRTsjqxwzOU_mXOmi21Jbux-isGlMhCYZDT96hOw&oe=69612E1B)
15
+
16
+ As empresas que escolherem essa opção e inserirem o número de telefone do app WhatsApp Business verão um QR code e instruções para verificar se há uma nova mensagem no app:
17
+
18
+ ![](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/476874241_1103155901556528_14057604674080564_n.png?_nc_cat=101&ccb=1-7&_nc_sid=e280be&_nc_ohc=IsG1P5Ml-AAQ7kNvwFq-Tqz&_nc_oc=AdltbONQpvyE8vfIx-CaIxE3hUpkE9Q31PuZMb0xQoTIJ-AqU0AZqZEQZ3G5QprqR18&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=7F2Tu9qNmA97srPxw_WPJA&oh=00_AfnNMNrM9W1BRW_rERkk_pfRbpp5DQiNsyOSMUVYMA0U5Q&oe=69613C7A)
19
+
20
+ A mensagem instrui a empresa a usar o app para ler o QR code exibido no Cadastro Incorporado:
21
+
22
+ ![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/476873473_616116514348816_8673957842559211679_n.png?_nc_cat=111&ccb=1-7&_nc_sid=e280be&_nc_ohc=kAl_2KKRNGsQ7kNvwHFOrMH&_nc_oc=AdmlM8chf5fPTEsu-znsjUMTBAe4IXPjFHbfIZSefRy0W2dauIvzm8G4Ot_-xVl-1Ng&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=7F2Tu9qNmA97srPxw_WPJA&oh=00_AfkRg-UJihqinw84nCc9t_ZGPOoaWQKRhM7RIY7ATSBfzQ&oe=696129CD)
23
+
24
+ Ao tocar no botão da mensagem, a empresa sabe que terá a opção de compartilhar o histórico de mensagens do app WhatsApp Business com você:
25
+
26
+ ![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/477590274_9196294333760175_2201939451536422781_n.png?_nc_cat=105&ccb=1-7&_nc_sid=e280be&_nc_ohc=jr-noVaPj3wQ7kNvwHn7tmp&_nc_oc=AdkfJ5aS0kNw4SjBg2fVj_vA_AZEj0xkisJI-ISUGVKKY3KCCE7LmpHpSqf36xcY5Sw&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=7F2Tu9qNmA97srPxw_WPJA&oh=00_AflRHNXH2ArxOxt_yqjnb7CGKP-8L0h3Q62ox_0jul1kiA&oe=6961385B)
27
+
28
+ Ao tocar no botão **Ler QR code** no app, a empresa terá a opção de compartilhar o histórico de conversas com você.
29
+
30
+ ![](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/476778869_1320577675644293_7907818991070430153_n.png?_nc_cat=104&ccb=1-7&_nc_sid=e280be&_nc_ohc=z3IMj5t9zqoQ7kNvwHL7FYw&_nc_oc=AdnoQShuRnrhfYnT2oSILkbFEKjSVs4ZPPbAHJxLPw46ZMmFA8e-8Q04VMwIoRCY4Vg&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=7F2Tu9qNmA97srPxw_WPJA&oh=00_AfkkhygoAJEu19HsuTvuAmOpqmfLBwpw625NvLxCNPgiiw&oe=69612C71)
31
+
32
+ Depois de escolher uma opção e ler o código, ela poderá concluir o fluxo de Cadastro Incorporado. Isso retorna o [número de identificação do ativo](/documentation/business-messaging/whatsapp/embedded-signup/implementation#session-logging-message-event-listener) e o [código de token trocável](/documentation/business-messaging/whatsapp/embedded-signup/implementation#response-callback) para a janela de criação, como de costume. Depois, você pode usar essas informações em chamadas de API para (1) integrar o cliente empresarial da mesma forma que faria com qualquer outro cliente empresarial e (2) sincronizar os respectivos contatos e histórico de mensagens (se a empresa permitir) para que você possa preencher essas informações no seu app.
33
+
34
+ ## Requisitos
35
+
36
+ - O cliente comercial deve usar o app WhatsApp Business versão **2.24.17** ou posterior;- O código de país do número de telefone do cliente comercial deve ser compatível- É preciso ser um [Parceiro de Soluções](/documentation/business-messaging/whatsapp/solution-providers/get-started-for-solution-partners) ou [Provedor de Tecnologia](/documentation/business-messaging/whatsapp/solution-providers/get-started-for-tech-providers)- É necessário saber como usar a [API de Nuvem](/documentation/business-messaging/whatsapp/about-the-platform#whatsapp-cloud-api)- O retorno de chamada do webhook deve ser capaz de aceitar e processar webhooks- É necessário usar o Cadastro Incorporado com [registro de sessão](/documentation/business-messaging/whatsapp/embedded-signup/implementation#session-logging-message-event-listener)
37
+
38
+ ## Limitações
39
+
40
+ - Para manter a compatibilidade com o app WhatsApp Business, os números de telefone comercias que estão em uso no app WhatsApp Business e na API de Nuvem têm a taxa de transferência fixa de 20 mps.- Caso o cliente corporativo tenha trabalhado com um parceiro no passado e ainda compartilhe a linha de crédito anterior, ele poderá ver um erro ao tentar mudar para um novo parceiro. Siga o [guia](/documentation/business-messaging/whatsapp/solution-providers/support/business-customer-support) para resolver o erro.
41
+
42
+ ## Países incompatíveis
43
+
44
+ Números de telefone de contas do WhatsApp Business com códigos dos seguintes países não são compatíveis:
45
+
46
+ - Nigéria- África do Sul
47
+
48
+ ## Preços
49
+
50
+ Depois que um cliente empresarial tiver sido integrado à API de Nuvem, as mensagens enviadas pela empresa por meio do app WhatsApp Business continuarão sendo gratuitas, mas as mensagens enviadas por meio da API estarão sujeitas aos preços da [API de Nuvem](/documentation/business-messaging/whatsapp/pricing).
51
+
52
+ Confira o PDF de detalhamento de preços [Soluções de API para usuários do WhatsApp Business App](https://developers.facebook.com/resources/API-solutions-for-WhatsApp-Business-App-users.pdf) para ver detalhamentos de cenários comuns.
53
+
54
+ ## Janela de atendimento ao cliente
55
+
56
+ As [janelas de atendimento ao cliente](/documentation/business-messaging/whatsapp/messages/send-messages#customer-service-windows) serão abertas apenas quando um usuário do WhatsApp enviar mensagem a um cliente empresarial que já tenha feito a integração à API de Nuvem. Se um usuário do WhatsApp enviar uma mensagem para a empresa antes da integração da API de Nuvem, a empresa só poderá responder com um modelo de mensagem, já que nenhum atendimento ao cliente foi aberto. Se o usuário enviar uma mensagem à empresa depois da integração da API de Nuvem, uma janela de atendimento ao cliente será aberta normalmente, e a empresa poderá responder com uma mensagem que não seja um modelo.
57
+
58
+ ## Comparação de recursos
59
+
60
+ A tabela a seguir descreve os recursos disponíveis para clientes empresariais que fizeram a integração à API de Nuvem, bem como quaisquer alterações na funcionalidade do app WhatsApp Business após a integração.
61
+
62
+ Recurso existente no app WhatsApp Business
63
+
64
+ Alterações de recursos do app WhatsApp Business APÓS a integração à API de Nuvem
65
+
66
+ O recurso do app WhatsApp Business é compatível com a API de Nuvem?
67
+
68
+ Conversas individuais (1:1)
69
+
70
+ A edição ou revogação de mensagens não é mais compatível.
71
+
72
+ Com suporte.
73
+
74
+ É possível sincronizar todas as mensagens de conversas dos últimos seis meses.
75
+
76
+ As mensagens enviadas e recebidas são espelhadas entre a API de Nuvem e o app WhatsApp Business.
77
+
78
+ Contatos
79
+
80
+ Nenhuma alteração.
81
+
82
+ Com suporte.
83
+
84
+ Todos os contatos com um número do WhatsApp podem ser sincronizados.
85
+
86
+ Conversas em grupo
87
+
88
+ Nenhuma alteração.
89
+
90
+ Não há suporte.
91
+
92
+ As conversas em grupo não serão sincronizadas.
93
+
94
+ Mensagens temporárias
95
+
96
+ O recurso de mensagens temporárias será desativado para todas as conversas individuais
97
+
98
+ Não há suporte.
99
+
100
+ [Mensagem de visualização única](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F1077018839582332&h=AT24k-icRRGXIU9-xCKhbZ-aJmURa-CT8nYYgjmUn6fJ60gpPMGVEHyl7g-YU6QwgivG7m-__7OPnj-lJ--xFlWJY4JV3kuUlHUeoF1y5cydFaXSRcp62KQv-5D0hd9qyuZQKzyVDbnntoSPsQw2Q0wSeNQ)
101
+
102
+ O recurso de visualização única será desabilitado para todas as conversas individuais
103
+
104
+ Não há suporte.
105
+
106
+ Mensagem de localização em tempo real
107
+
108
+ As mensagens de localização em tempo real serão desabilitadas para todas as conversas individuais
109
+
110
+ Não há suporte.
111
+
112
+ Listas de transmissão
113
+
114
+ A lista de transmissão será desabilitada.
115
+
116
+ As empresas não poderão criar novas listas de transmissão.
117
+
118
+ As listas de transmissão existentes se tornarão de somente leitura.
119
+
120
+ Não há suporte.
121
+
122
+ Ligações de voz e de vídeo
123
+
124
+ Nenhuma alteração.
125
+
126
+ Não há suporte.
127
+
128
+ Ferramentas comerciais (por exemplo, catálogo, pedidos e status)
129
+
130
+ Nenhuma alteração.
131
+
132
+ Não há suporte.
133
+
134
+ Ferramentas de mensagens (por exemplo, mensagens de marketing, mensagem de saudação, mensagem de ausência, respostas rápidas e rótulos)
135
+
136
+ Nenhuma alteração.
137
+
138
+ Não há suporte.
139
+
140
+ Perfil empresarial (por exemplo, nome comercial, endereço, site)
141
+
142
+ Nenhuma alteração.
143
+
144
+ Não há suporte.
145
+
146
+ Canais
147
+
148
+ Nenhuma alteração.
149
+
150
+ Não há suporte.
151
+
152
+ ## Dispositivos conectados
153
+
154
+ As empresas podem conectar até quatro clientes "companheiros" do WhatsApp à conta do app WhatsApp Business em outros dispositivos (descrito como "[dispositivos conectados](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F378279804439436%2F&h=AT24k-icRRGXIU9-xCKhbZ-aJmURa-CT8nYYgjmUn6fJ60gpPMGVEHyl7g-YU6QwgivG7m-__7OPnj-lJ--xFlWJY4JV3kuUlHUeoF1y5cydFaXSRcp62KQv-5D0hd9qyuZQKzyVDbnntoSPsQw2Q0wSeNQ)" na Central de Ajuda).
155
+
156
+ Todos os clientes complementares são compatíveis, exceto [WhatsApp para Windows](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F1317564962315842%2F%3Fcms_platform%3Dwindows-desktop&h=AT24k-icRRGXIU9-xCKhbZ-aJmURa-CT8nYYgjmUn6fJ60gpPMGVEHyl7g-YU6QwgivG7m-__7OPnj-lJ--xFlWJY4JV3kuUlHUeoF1y5cydFaXSRcp62KQv-5D0hd9qyuZQKzyVDbnntoSPsQw2Q0wSeNQ) e [WhatsApp para WearOS](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F564431798835071%2F&h=AT24k-icRRGXIU9-xCKhbZ-aJmURa-CT8nYYgjmUn6fJ60gpPMGVEHyl7g-YU6QwgivG7m-__7OPnj-lJ--xFlWJY4JV3kuUlHUeoF1y5cydFaXSRcp62KQv-5D0hd9qyuZQKzyVDbnntoSPsQw2Q0wSeNQ).
157
+
158
+ Quando um cliente empresarial integrar a API de Nuvem com uma conta existente do app WhatsApp Business e um número de telefone, todos os apps complementares serão desvinculados da conta. Em seguida, a empresa poderá vincular novamente os apps complementares compatíveis.
159
+
160
+ Os usuários do WhatsApp que utilizam um cliente complementar incompatível para enviar mensagens a uma empresa integrada poderão fazer isso, mas a mensagem não acionará webhooks de [mensagens](/documentation/business-messaging/whatsapp/webhooks/reference/messages). Por isso, a empresa não conseguirá espelhar a mensagem no próprio app.
161
+
162
+ As mensagens enviadas por uma empresa integrada (por qualquer meio) e visualizadas em um dispositivo adicional incompatível aparecerão com um espaço reservado para texto, instruindo o usuário do WhatsApp a visualizar a mensagem no dispositivo principal.
163
+
164
+ ## Como configurar seu app
165
+
166
+ ### Etapa 1: assinar webhooks
167
+
168
+ Vá até o painel [**Painel de Apps**](/apps) > **WhatsApp** > **Configuração** e inscreva seu app nos seguintes campos de tópicos de webhook da conta do WhatsApp Business. Além disso, verifique se o código de retorno de ligação do app é capaz de processar as cargas de cada um deles. Esses campos são adicionais aos que você já assina como provedor de soluções.
169
+
170
+ - [history](#history): descreve mensagens anteriores que o cliente empresarial enviou/recebeu- [smb\_app\_state\_sync](#smb-app-state-sync): descreve os contatos novos e atuais do cliente comercial- [smb\_message\_echoes](#smb-message-echoes): descreve as novas mensagens que o cliente empresarial envia com o app WhatsApp Business após a integração
171
+
172
+ ### Etapa 2: personalizar o Cadastro Incorporado
173
+
174
+ Adicione uma propriedade `featureType` definida como `whatsapp_business_app_onboarding` ao objeto `extras` no método de inicialização e parte de [registro de retorno de chamada do código de implementação do Cadastro Incorporado](/documentation/business-messaging/whatsapp/embedded-signup/implementation#launch-method-and-callback-registration).
175
+
176
+ ```
177
+ // Launch method and callback registration
178
+ {
179
+ "config_id": "<CONFIGURATION_ID>",
180
+ "response_type": "code",
181
+ "override_default_response_type": true,
182
+ "extras": {
183
+ setup: {},
184
+ "featureType": "whatsapp_business_app_onboarding", // set to 'whatsapp_business_app_onboarding'
185
+ "sessionInfoVersion": "3"
186
+ }
187
+ }
188
+ ```
189
+
190
+ Para verificar se você habilitou o recurso corretamente, acesse sua implementação do Cadastro Incorporado. Se a tela de seleção de [conta do WhatsApp Business](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#business-asset-selection-screen) for substituída por uma tela que oferecer a opção de conectar sua conta do WhatsApp Business existente, o recurso será habilitado:
191
+
192
+ ![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/477341352_1809983926468415_3794578338113490554_n.png?_nc_cat=108&ccb=1-7&_nc_sid=e280be&_nc_ohc=-P3Z4_dfNugQ7kNvwHUBsMp&_nc_oc=AdlQPynWj1X9MVV6D3-74b1XS0aiMmW6OXMAOgVQV2R8kKQxqdigKk7KjvV-3maGNcs&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=7F2Tu9qNmA97srPxw_WPJA&oh=00_Afm2KwXRTsjqxwzOU_mXOmi21Jbux-isGlMhCYZDT96hOw&oe=69612E1B)
193
+
194
+ ### Etapa 3: exibir o Cadastro Incorporado para os clientes
195
+
196
+ Depois de confirmar que o recurso foi habilitado, mostre o Cadastro Incorporado aos clientes da sua empresa.
197
+
198
+ Quando uma empresa concluir o fluxo e você [integrar o cliente](#onboarding-business-customers), será necessário [sincronizar o histórico de mensagens](#synchronizing-whatsapp-business-app-data) em até 24 horas. Caso contrário, será necessário desligar o cliente e concluir o fluxo novamente. Por isso, recomendamos:
199
+
200
+ - integrar e sincronizar assim que a empresa concluir o fluxo;- informar à empresa que você está sincronizando os dados do app WhatsApp Business dela;- orientá-los a manter o app WhatsApp Business aberto para facilitar o processo de sincronização.
201
+
202
+ A integração e a sincronização podem levar vários minutos, dependendo de diversos fatores, como o tamanho do histórico de mensagens da empresa, a velocidade da internet, a rapidez de processamento de webhooks, entre outros.
203
+
204
+ Quando você concluir o **processo de integração**, o app WhatsApp Business será atualizado automaticamente e indicará à empresa que o número de telefone agora está conectado à API:
205
+
206
+ ![](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/476788868_1168860751914222_5506074718266109385_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=e280be&_nc_ohc=Ev7MBcAWYmUQ7kNvwH9Tlzl&_nc_oc=AdmI3QYXyyFS5hwm8GHibJsq3rK_N9Q0JtiukLm139f7CL2FoJeL1_XwKQ8DdvSUC94&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=7F2Tu9qNmA97srPxw_WPJA&oh=00_Afkhw9S82bI00NoVMwANjNLn5KkNLvXttUpgpveOC3ApqA&oe=69610CD0)
207
+
208
+ Depois de concluir a sincronização do histórico de mensagens da empresa, informe ao cliente que o processo foi finalizado.
209
+
210
+ ## Integrar clientes comerciais
211
+
212
+ Quando um cliente empresarial concluir com sucesso o fluxo de Cadastro Incorporado, as identificações de ativos e um código de token trocável serão retornados para a janela que gerou o fluxo, como de costume. Entretanto, a carga de [evento da sessão](/documentation/business-messaging/whatsapp/embedded-signup/implementation#session-logging-message-event-listener) terá `event` definido como `FINISH_WHATSAPP_BUSINESS_APP_ONBOARDING`:
213
+
214
+ ```
215
+ {
216
+ data: {
217
+ waba_id: "<CUSTOMER_WABA_ID>"
218
+ },
219
+ type: "WA_EMBEDDED_SIGNUP",
220
+ event: "FINISH_WHATSAPP_BUSINESS_APP_ONBOARDING",
221
+ version: 3
222
+ }
223
+ ```
224
+
225
+ Capture o ID de ativo e o código de token trocável do cliente e use-os para integrá-lo como faria normalmente. Porém, **pule a etapa de registro do número de telefone**, uma vez que ele já está registrado.
226
+
227
+ - [Integrar clientes empresariais como provedor de soluções](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-customers-as-a-solution-partner)- [Integrar clientes empresariais como Provedor de Tecnologia](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-customers-as-a-tech-provider)
228
+
229
+ Depois de concluir essas etapas de integração, você poderá começar o processo de [sincronização do histórico de mensagens](#synchronizing-messaging-history).
230
+
231
+ ### Verificar o status da integração (opcional)
232
+
233
+ Se quiser, você pode verificar se o número de telefone comercial do cliente está registrado para uso da API de Nuvem e do app WhatsApp Business. Para isso, solicite os campos `is_on_biz_app` e `platform_type` na identificação do número de telefone comercial:
234
+
235
+ Exemplo de solicitação:
236
+
237
+ ```
238
+ curl 'https://graph.facebook.com/v24.0/106540352242922?fields=is_on_biz_app,platform_type' \
239
+ -H 'Authorization: Bearer EAAJB...'
240
+ ```
241
+
242
+ Exemplo de resposta:
243
+
244
+ Se `is_on_biz_app` for `true` e `platform_type` for `CLOUD_API`, o número de telefone comercial poderá usar a API de Nuvem e o app WhatsApp Business:
245
+
246
+ ```
247
+ {  "is_on_biz_app": true,  "platform_type": "CLOUD_API",  "id": "106540352242922"}
248
+ ```
249
+
250
+ ## Como sincronizar os dados do app WhatsApp Business
251
+
252
+ Depois de integrar o cliente empresarial, você terá 24 horas para sincronizar os respectivos contatos e histórico de mensagens. Caso contrário, será necessário desligar o cliente e concluir o fluxo novamente. Por esse motivo, recomendamos que você inicie o processo de sincronização assim que concluir a integração da empresa.
253
+
254
+ Verifique se você assinou a WABA da empresa quando [a integrou](#onboarding-business-customers) e se [assinou os campos de webhook adicionais](#step-1--subscribe-to-webhooks) para não perder webhooks importantes.
255
+
256
+ ### Etapa 1: iniciar a sincronização de contatos
257
+
258
+ Use o ponto de extremidade [POST /<BUSINESS\_PHONE\_NUMBER\_ID>/smb\_app\_data](/docs/graph-api/reference/whats-app-business-account-to-number-current-status/smb_app_data#Creating) para solicitar as informações de contato do cliente empresarial.
259
+
260
+ Se a solicitação for bem-sucedida, um conjunto de webhooks [smb\_app\_state\_sync](#smb-app-state-sync) será disparado descrevendo os contatos do WhatsApp no app WhatsApp Business da empresa. Adições ou alterações futuras aos [contatos](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F1270784217226727%2F&h=AT24k-icRRGXIU9-xCKhbZ-aJmURa-CT8nYYgjmUn6fJ60gpPMGVEHyl7g-YU6QwgivG7m-__7OPnj-lJ--xFlWJY4JV3kuUlHUeoF1y5cydFaXSRcp62KQv-5D0hd9qyuZQKzyVDbnntoSPsQw2Q0wSeNQ) do WhatsApp da empresa acionarão um webhook smb\_app\_state\_sync correspondente.
261
+
262
+ Essa etapa pode ser realizada apenas uma vez. Se for necessário executá-lo novamente, o cliente precisará cancelar a integração e, depois, concluir o fluxo de Cadastro Incorporado outra vez.
263
+
264
+ #### Exemplo de solicitação
265
+
266
+ ```
267
+ curl -X POST \
268
+ 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/smb_app_data \
269
+ -H 'Authorization: <ACCESS_TOKEN>' \
270
+ -H 'Content-Type: application/json' \
271
+ -d '
272
+ {
273
+ "messaging_product": "whatsapp",
274
+ "sync_type": "smb_app_state_sync"
275
+ }'
276
+ ```
277
+
278
+ #### Exemplo de resposta
279
+
280
+ Caso a solicitação seja bem-sucedida:
281
+
282
+ ```
283
+ {
284
+ "messaging_product": "whatsapp",
285
+ "request_id" : "<REQUEST_ID>"
286
+ }
287
+ ```
288
+
289
+ Recomendamos que você armazene o valor `request_id` caso precise entrar em contato com o suporte.
290
+
291
+ ### Etapa 2: iniciar a sincronização do histórico de mensagens
292
+
293
+ Use o ponto de extremidade [POST /<BUSINESS\_PHONE\_NUMBER\_ID>/smb\_app\_data](/docs/graph-api/reference/whats-app-business-account-to-number-current-status/smb_app_data#Creating) novamente, dessa vez para iniciar a sincronização do histórico de mensagens.
294
+
295
+ Em caso de sucesso, um ou mais webhooks de histórico serão disparados, dependendo de se a empresa optou por compartilhar o histórico de mensagens com você.
296
+
297
+ Essa etapa pode ser realizada apenas uma vez. Se for necessário executá-lo novamente, o cliente precisará cancelar a integração e, depois, concluir o fluxo de Cadastro Incorporado outra vez.
298
+
299
+ #### Histórico de mensagens compartilhado
300
+
301
+ Caso a empresa tenha optado por compartilhar o histórico de mensagens com você, uma série de webhooks de histórico será disparada, descrevendo cada mensagem enviada para ou recebida de usuários do WhatsApp em um determinado período.
302
+
303
+ Confira [history](#history) para ver uma descrição do conteúdo desses webhooks e como eles são organizados.
304
+
305
+ #### Histórico de mensagens não compartilhado
306
+
307
+ Caso a empresa opte por não compartilhar o histórico de mensagens, um webhook [history](#history) com o código de erro `2593109` será disparado.
308
+
309
+ #### Exemplo de solicitação
310
+
311
+ ```
312
+ curl -X POST \
313
+ 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/smb_app_data \
314
+ -H 'Authorization: <ACCESS_TOKEN>' \
315
+ -H 'Content-Type: application/json' \
316
+ -d '
317
+ {
318
+ "messaging_product": "whatsapp",
319
+ "sync_type": "history"
320
+ }'
321
+ ```
322
+
323
+ #### Exemplo de resposta
324
+
325
+ Se a solicitação for bem-sucedida, a API responderá com a seguinte carga JSON. Observe que essa resposta indica apenas a aceitação da solicitação com sucesso; ela não indica se a empresa compartilhou o histórico de mensagens com você.
326
+
327
+ ```
328
+ {
329
+ "messaging_product": "whatsapp",
330
+ "request_id" : "<REQUEST_ID>"
331
+ }
332
+ ```
333
+
334
+ Recomendamos que você armazene o valor `request_id` caso precise entrar em contato com o suporte.
335
+
336
+ ### Etapa 3: espelhar novas mensagens do app WhatsApp Business
337
+
338
+ As empresas integradas ainda poderão usar o app WhatsApp Business e os [dispositivos adicionais](#linked-devices) compatíveis para enviar e receber mensagens. Sempre que uma empresa envia uma mensagem com um desses apps, é disparado um webhook [smb\_message\_echoes](#smb-message-echoes), que você deve processar e exibir no histórico de conversas do contato no app.
339
+
340
+ ## Relatórios de atividades de conversão
341
+
342
+ Os clientes empresariais integrados podem veicular anúncios de clique para o WhatsApp. Por isso, recomendamos que você registre os sinais de geração de cadastros/compra em nome da empresa por meio da API de Conversões. Veja [API de Conversões para mensagens da empresa](/docs/marketing-api/conversions-api/business-messaging).
343
+
344
+ ## Remover clientes comerciais
345
+
346
+ Não é possível usar o ponto de extremidade [POST /<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>/deregister](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/phone-number-deregister-api#Updating) para cancelar o registro de um número de telefone comercial que esteja em uso com a API de Nuvem e o app WhatsApp Business.
347
+
348
+ Em vez disso, os clientes empresariais podem usar o app WhatsApp Business para se desconectar da API de Nuvem. Para isso, basta acessar **Configurações** > **Conta** > **Plataforma comercial** e clicar no botão **Desconectar conta**. Quando um cliente empresarial se desconecta da API de Nuvem, um webhook [account\_update](#account-update) com um evento `PARTNER_REMOVED` é disparado.
349
+
350
+ ## Erros
351
+
352
+ Se você integrar um cliente comercial com um número de telefone do app WhatsApp Business, poderá receber mais tarde um webhook de **mensagens** com o código de erro `131060`. Isso pode acontecer quando um usuário do WhatsApp com um [dispositivo adicional](#linked-devices) não compatível envia ou recebe uma mensagem da empresa. Se você receber esse webhook, instrua a empresa a verificar a mensagem no app WhatsApp Business.
353
+
354
+ ## Webhooks
355
+
356
+ ### account\_update
357
+
358
+ Descreve as alterações feitas em uma conta do WhatsApp Business ("WABA").
359
+
360
+ #### Eventos de gatilho
361
+
362
+ - O número de telefone comercial associado às alterações da WABA- O status da WABA é alterado
363
+
364
+ #### Sintaxe da carga
365
+
366
+ ```
367
+ {
368
+ "object": "whatsapp_business_account",
369
+ "entry": [
370
+ {
371
+ "id": "<WABA_ID>",
372
+ "time": <WEBHOOK_TIMESTAMP>,
373
+ "changes": [
374
+ {
375
+ "value": {
376
+ "phone_number": "<BUSINESS_PHONE_NUMBER>",
377
+ "event": "<EVENT>",
378
+ },
379
+ "field": "account_update"
380
+ }
381
+ ]
382
+ }
383
+ ]
384
+ }
385
+ ```
386
+
387
+ #### Exemplo de carga
388
+
389
+ ```
390
+ {  "object": "whatsapp_business_account",  "entry": [    {      "id": "102290129340398",      "time": 1739212624,      "changes": [        {          "value": {              "phone_number": "15550783881",              "event": "PARTNER_REMOVED",           },          "field": "account_update"        }      ]    }  ]}
391
+ ```
392
+
393
+ ### Histórico
394
+
395
+ Descreve o histórico de conversas do app WhatsApp Business de uma empresa que escolheu compartilhar o próprio histórico de conversas com um [provedor de soluções](/documentation/business-messaging/whatsapp/solution-providers/overview) ou a decisão da empresa de recusar o compartilhamento do histórico de conversas.
396
+
397
+ #### Eventos de gatilho
398
+
399
+ - um provedor de soluções [sincronizar o histórico de conversas do app WhatsApp Business](#step-2--initiate-message-history-synchronization) de um cliente corporativo integrado com um número de telefone do app WhatsApp Business e que tenha aceitado compartilhar o histórico de conversas- um provedor de soluções [sincronizar o histórico de conversas do app WhatsApp Business](#step-2--initiate-message-history-synchronization) de um cliente comercial integrado com um número de telefone do app WhatsApp Business, mas o cliente recusou compartilhar o histórico de conversas
400
+
401
+ #### Conteúdo do histórico de conversas
402
+
403
+ Se a empresa já tiver aprovado o compartilhamento do histórico de conversas quando o provedor de soluções solicitar o histórico de conversas da empresa, uma série de webhooks de histórico será disparada, descrevendo todas as mensagens enviadas ou recebidas em até 180 dias a partir do momento da integração da empresa na API de Nuvem.
404
+
405
+ - As mensagens que fazem parte de uma conversa em grupo não serão incluídas- As mensagens de mídia não incluirão identificações de ativos de mídia; em vez disso, webhooks adicionais de histórico contendo identificações de ativos de mensagem de mídia serão enviados separadamente, mas somente para mensagens de mídia enviadas dentro de 14 dias após a integração
406
+
407
+ Observe que, para fins de eficiência, um único webhook pode descrever milhares de mensagens. Por isso, recomendamos que você capture o conteúdo primeiro e depois o processe de forma assíncrona.
408
+
409
+ #### Fases e partes
410
+
411
+ Os webhooks são divididos em três fases do histórico, sendo o dia 0 o momento em que a empresa foi integrada à API de Nuvem:
412
+
413
+ - Fase 0: do dia 0 ao dia 1- Fase 1: do dia 1 ao dia 90- Fase 2: do dia 90 até o dia 180
414
+
415
+ Para cada fase, os webhooks do histórico de conversas podem ser enviados em partes separadas, dependendo do número total de mensagens que compõem a conversa.
416
+
417
+ - É possível usar o valor do parâmetro `chunk_order` para organizar essas partes na ordem sequencial, já que elas podem não ser entregues de maneira sequencial.- É possível usar o valor do parâmetro `phase` para monitorar o progresso da fase. O valor `2` indica que a fase atual foi concluída.- É possível usar o valor do parâmetro `progress` para monitorar o progresso geral. O valor `100` indica que a sincronização foi concluída.
418
+
419
+ Se não houver histórico de conversas disponível para determinada fase, nenhum webhook correspondente será enviado.
420
+
421
+ #### Sintaxe da carga – compartilhamento do histórico de conversas aprovado
422
+
423
+ ```
424
+ {
425
+ "object": "whatsapp_business_account",
426
+ "entry": [
427
+ {
428
+ "id": "<WABA_ID>",
429
+ "changes": [
430
+ {
431
+ "value": {
432
+ "messaging_product": "whatsapp",
433
+ "metadata": {
434
+ "display_phone_number": "<BUSINESS_PHONE_NUMBER>",
435
+ "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
436
+ },
437
+ "history": [
438
+ {
439
+ "metadata": {
440
+ "phase": <PHASE>,
441
+ "chunk_order": <CHUNK_ORDER>,
442
+ "progress": <PROGRESS>
443
+ },
444
+ "threads": [
445
+ /* First chat history thread object */
446
+ {
447
+ "id": "<WHATSAPP_USER_PHONE_NUMBER>",
448
+ "messages": [
449
+ /* First message object in thread */
450
+ {
451
+ "from": "<BUSINESS_OR_WHATSAPP_USER_PHONE_NUMBER>",
452
+ "to": "<WHATSAPP_USER_PHONE_NUMBER>", // only included if SMB message echo
453
+ "id": "<WHATSAPP_MESSAGE_ID>",
454
+ "timestamp": "<DEVICE_TIMESTAMP>,
455
+ "type": "<MESSAGE_TYPE>",
456
+ "<MESSAGE_TYPE>": {
457
+ <MESSAGE_CONTENTS>
458
+ },
459
+ "history_context": {
460
+ "status": "<MESSAGE_STATUS>"
461
+ }
462
+ },
463
+ /* Additional message objects in thread would follow, if any */
464
+ ]
465
+ },
466
+ /* Additional chat history thread objects would follow, if any */
467
+ ]
468
+ }
469
+ ]
470
+ },
471
+ "field": "history"
472
+ }
473
+ ]
474
+ }
475
+ ]
476
+ }
477
+ ```
478
+
479
+ #### Conteúdo da carga – compartilhamento do histórico de conversa aprovado
480
+
481
+
482
+
483
+ Espaço reservado
484
+
485
+ Descrição
486
+
487
+ Valor de exemplo
488
+
489
+ `<WABA_ID>`
490
+
491
+ _String_
492
+
493
+ Identificação da conta do WhatsApp Business do cliente corporativo.
494
+
495
+ `102290129340398`
496
+
497
+ `<BUSINESS_PHONE_NUMBER>`
498
+
499
+ _String_
500
+
501
+ Número de telefone comercial do cliente.
502
+
503
+ `15550783881`
504
+
505
+ `<BUSINESS_PHONE_NUMBER_ID>`
506
+
507
+ _String_
508
+
509
+ Identificação do número de telefone comercial do cliente.
510
+
511
+ `106540352242922`
512
+
513
+ `<PHASE>`
514
+
515
+ _Número inteiro_
516
+
517
+ Indica a [fase](#phases-and-chunks) do histórico. Os valores podem ser os seguintes:
518
+
519
+ - `0`: indica que as mensagens são do dia 0 (tempo de integração da empresa) até o dia 1- `1` – indica que as mensagens são do dia 1 até o dia 90- `2` – indica que as mensagens são do dia 90 até o dia 180
520
+
521
+ `1`
522
+
523
+ `<CHUNK_ORDER>`
524
+
525
+ _Número inteiro_
526
+
527
+ Indica o número de [fragmento](#phases-and-chunks), que pode ser usado para ordenar conjuntos de webhooks de forma sequencial.
528
+
529
+ `1`
530
+
531
+ `<PROGRESS>`
532
+
533
+ _Número inteiro_
534
+
535
+ Indica a porcentagem total do progresso da sincronização.
536
+
537
+ Mínimo `0`, máximo `100`.
538
+
539
+ `55`
540
+
541
+ `<WHATSAPP_USER_PHONE_NUMBER>`
542
+
543
+ _String_
544
+
545
+ O número de telefone do usuário do WhatsApp.
546
+
547
+ `16505551234`
548
+
549
+ `<BUSINESS_OR_WHATSAPP_USER_PHONE_NUMBER>`
550
+
551
+ _String_
552
+
553
+ O número de telefone do cliente corporativo ou do usuário do WhatsApp.
554
+
555
+ Se o valor for o número de telefone da empresa, o objeto da mensagem descreverá uma mensagem enviada pela empresa a um usuário do WhatsApp.
556
+
557
+ Se o valor for o número de telefone do usuário do WhatsApp, o objeto da mensagem descreverá uma mensagem enviada pelo usuário do WhatsApp à empresa.
558
+
559
+ `15550783881`
560
+
561
+ `<WHATSAPP_USER_PHONE_NUMBER>`
562
+
563
+ _String_
564
+
565
+ O número de telefone do usuário do WhatsApp.
566
+
567
+ A propriedade `to` é incluída apenas se o objeto da mensagem representar um [eco de mensagem de PME](#step-3--mirror-new-whatsapp-business-app-messages).
568
+
569
+ `16505551234`
570
+
571
+ `<WHATSAPP_MESSAGE_ID>`
572
+
573
+ _String_
574
+
575
+ Identificação da mensagem do WhatsApp.
576
+
577
+ `wamid.HBgLMTY0NjcwNDM1OTUVAgARGBIyNDlBOEI5QUQ4NDc0N0FCNjMA`
578
+
579
+ `<DEVICE_TIMESTAMP>`
580
+
581
+ _String_
582
+
583
+ Registro de data e hora UNIX que indica quando a mensagem foi recebida pelo dispositivo do destinatário.
584
+
585
+ `1738796547`
586
+
587
+ `<MESSAGE_TYPE>`
588
+
589
+ _String_
590
+
591
+ [Tipo de mensagem](/documentation/business-messaging/whatsapp/messages/send-messages#message-types). Esse espaço reservado aparece duas vezes na sintaxe acima, pois serve para o valor da propriedade `type` e o nome correspondente da propriedade. Confira [abaixo um exemplo de carga](#example-history-approved) de uma conversa com vários tipos de mensagens.
592
+
593
+ Se esse valor for definido como `media_placeholder`, o objeto da mensagem descreverá uma mensagem com um ativo de mídia. Nesse caso, o conteúdo da mensagem será omitido. Em vez disso, um webhook do histórico separado será enviado, descrevendo o conteúdo da mensagem e a identificação do ativo de mídia, mas somente se a mensagem tiver sido enviada nas duas últimas semanas da sua consulta. Confira [abaixo um exemplo de carga](#example-media-asset) descrevendo o conteúdo de uma mensagem de mídia.
594
+
595
+ `text`
596
+
597
+ `<MESSAGE_CONTENTS>`
598
+
599
+ _Objeto_
600
+
601
+ Um objeto que descreve o conteúdo da mensagem. Esse valor variará com base no tipo de mensagem, assim como no conteúdo da mensagem.
602
+
603
+ Por exemplo, se uma empresa enviar uma mensagem `image` sem legenda, o objeto não incluirá a propriedade `caption`.
604
+
605
+ Consulte [Como enviar mensagens](/documentation/business-messaging/whatsapp/messages/send-messages) para ver exemplos de carga de cada tipo de mensagem.
606
+
607
+ `{"body":"Here's the info you requested! https://www.meta.com/quest/quest-3/"}`
608
+
609
+ `<MESSAGE_STATUS>`
610
+
611
+ _String_
612
+
613
+ Indica as estatísticas de entrega mais recentes da mensagem. Os valores podem ser os seguintes:
614
+
615
+ - `DELIVERED`- `ERROR`- `PENDING`- `PLAYED`- `READ`- `SENT`
616
+
617
+ `READ`
618
+
619
+ #### Exemplo de carga: compartilhamento de histórico de conversa aprovado
620
+
621
+ Exemplo de carga para duas conversas por mensagens: (1) uma contendo uma mensagem de texto e uma mensagem de vídeo enviadas a um usuário do WhatsApp e a resposta desse usuário, e (2) uma contendo uma mensagem de texto enviada a um usuário do WhatsApp, agradecendo o pedido.
622
+
623
+ Observe que o conteúdo da mensagem de mídia na primeira conversa não é descrito. Em vez disso, um segundo webhook será disparado, descrevendo o conteúdo da mensagem de mídia.
624
+
625
+ ```
626
+ {  "object": "whatsapp_business_account",  "entry": [    {      "id": "102290129340398",      "changes": [        {          "value": {            "messaging_product": "whatsapp",            "metadata": {              "display_phone_number": "15550783881",              "phone_number_id": "106540352242922"            },            "history": [              {                "metadata": {                  "phase": 0,                  "chunk_order": 1,                  "progress": 55                },                "threads": [                  {                    "id": "16505551234",                    "messages": [                      {                        "from": "15550783881",                        "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBIyNDlBOEI5QUQ4NDc0N0FCNjMA",                        "timestamp": "1739230955",                        "type": "text",                        "text": {                          "body": "Here's the info you requested! https://www.meta.com/quest/quest-3/"                        },                        "history_context": {                          "status": "READ"                        }                      },                      {                        "from": "15550783881",                        "id": "wamid.QyNUEHBgLMTY0NjcwNDM1OTUVAgARGBI1Rj3NEYxMzAzMzQ5MkEA",                        "timestamp": "1739230970",                        "type": "media_placeholder",                        "history_context": {                          "status": "PLAYED"                        }                      },                      {                        "from": "16505551234",                        "id": "wamid.N0FCNjMAHBgLMTY0NjcwNDM1OTUVAgARGBIyNDlBOEI5QUQ4NDc0",                        "timestamp": "1739230970",                        "type": "text",                        "text": {                          "body": "Thanks!"                        },                        "history_context": {                          "status": "READ"                        }                      }                    ]                  },                  {                    "id": "12125557890",                    "messages": [                      {                        "from": "15550783881",                        "id": "wamid.BIyNDlBOEI5N0FCNjMAHBgLMTY0NjcwNDM1OTUVAgARGQUQ4NDc0",                        "timestamp": "1739230970",                        "type": "text",                        "text": {                          "body": "Thanks for your order! As a thank you, use code THANKS30 to get 30% of your next order."                        },                        "history_context": {                          "status": "DELIVERED"                        }                      }                    ]                  }                ]              }            ]          },          "field": "history"        }      ]    }  ]}
627
+ ```
628
+
629
+ #### Exemplo de carga de ativo de mensagem de mídia
630
+
631
+ ```
632
+ {  "object": "whatsapp_business_account",  "entry": [    {      "id": "102290129340398",      "changes": [        {          "value": {            "messaging_product": "whatsapp",            "metadata": {              "display_phone_number": "15550783881",              "phone_number_id": "106540352242922"            },            "messages": [              {                "from": "16505551234",                "id": "wamid.QyNUEHBgLMTY0NjcwNDM1OTUVAgARGBI1Rj3NEYxMzAzMzQ5MkEA",                "timestamp": "1738796547",                "type": "image",                "image": {                  "caption": "Black Prince echeveria",                  "mime_type": "image/jpeg",                  "sha256": "3f9d94d399fa61c191bc1d4ca71375a035cd9b9f5b1128e1f0963a415c16b0cc",                  "id": "24230790383178626"                }              }            ]          },          "field": "history"        }      ]    }  ]}
633
+ ```
634
+
635
+ #### Sintaxe da carga: compartilhamento do histórico de conversas recusado
636
+
637
+ ```
638
+ {
639
+ "messaging_product": "whatsapp",
640
+ "metadata": {
641
+ "display_phone_number": "<BUSINESS_PHONE_NUMBER>",
642
+ "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
643
+ },
644
+ "history": [
645
+ {
646
+ "errors": [
647
+ {
648
+ "code": 2593109,
649
+ "title": "History sync is turned off by the business from the WhatsApp Business App",
650
+ "message": "History sync is turned off by the business from the WhatsApp Business App",
651
+ "error_data": {
652
+ "details": "History sharing is turned off by the business"
653
+ }
654
+ }
655
+ ]
656
+ }
657
+ ]
658
+ }
659
+ ```
660
+
661
+ #### Exemplo de carga: compartilhamento do histórico de conversa recusado
662
+
663
+ ```
664
+ {  "messaging_product": "whatsapp",  "metadata": {    "display_phone_number": "15550783881",    "phone_number_id": "106540352242922"  },  "history": [    {      "errors": [        {          "code": 2593109,          "title": "History sync is turned off by the business from the WhatsApp Business App",          "message": "History sync is turned off by the business from the WhatsApp Business App",          "error_data": {            "details": "History sharing is turned off by the business"          }        }      ]    }  ]}
665
+ ```
666
+
667
+ ### smb\_app\_state\_sync
668
+
669
+ Descreve um ou mais [contatos](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F1270784217226727%2F&h=AT24k-icRRGXIU9-xCKhbZ-aJmURa-CT8nYYgjmUn6fJ60gpPMGVEHyl7g-YU6QwgivG7m-__7OPnj-lJ--xFlWJY4JV3kuUlHUeoF1y5cydFaXSRcp62KQv-5D0hd9qyuZQKzyVDbnntoSPsQw2Q0wSeNQ) do WhatsApp no app WhatsApp Business de um cliente comercial.
670
+
671
+ #### Eventos de gatilho:
672
+
673
+ - um provedor de soluções [sincroniza os contatos do WhatsApp](#step-1--initiate-contacts-synchronization) de um cliente empresarial que foi integrado com um número de telefone do app WhatsApp Business- um cliente empresarial, integrado por um provedor de soluções, com um número de telefone do app WhatsApp Business adiciona, edita ou remove um [contato do WhatsApp](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F1270784217226727%2F&h=AT24k-icRRGXIU9-xCKhbZ-aJmURa-CT8nYYgjmUn6fJ60gpPMGVEHyl7g-YU6QwgivG7m-__7OPnj-lJ--xFlWJY4JV3kuUlHUeoF1y5cydFaXSRcp62KQv-5D0hd9qyuZQKzyVDbnntoSPsQw2Q0wSeNQ)
674
+
675
+ #### Sintaxe da carga
676
+
677
+ ```
678
+ {
679
+ "object": "whatsapp_business_account",
680
+ "entry": [
681
+ {
682
+ "id": "<WABA_ID>",
683
+ "changes": [
684
+ {
685
+ "value": {
686
+ "messaging_product": "whatsapp",
687
+ "metadata": {
688
+ "display_phone_number": "<BUSINESS_PHONE_NUMBER>",
689
+ "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
690
+ },
691
+ "state_sync": [
692
+ {
693
+ "type": "contact",
694
+ "contact": {
695
+ "full_name": "<CONTACT_FULL_NAME>",
696
+ "first_name": "<CONTACT_FIRST_NAME>",
697
+ "phone_number": "<CONTACT_PHONE_NUMBER>"
698
+ },
699
+ "action": "<ACTION>",
700
+ "metadata": {
701
+ "timestamp": "<WEBHOOK_TIMESTAMP>"
702
+ }
703
+ },
704
+ * Additional contacts would follow, if any */
705
+ ]
706
+ },
707
+ "field": "smb_app_state_sync"
708
+ }
709
+ ]
710
+ }
711
+ ]
712
+ }
713
+ ```
714
+
715
+ #### Conteúdo da carga
716
+
717
+
718
+
719
+ Espaço reservado
720
+
721
+ Descrição
722
+
723
+ Valor de exemplo
724
+
725
+ `<WABA_ID>`_String_
726
+
727
+ Identificação da conta do WhatsApp Business do cliente corporativo.
728
+
729
+ `102290129340398`
730
+
731
+ `<BUSINESS_PHONE_NUMBER>`_String_
732
+
733
+ Número de telefone comercial do cliente.
734
+
735
+ `15550783881`
736
+
737
+ `<BUSINESS_PHONE_NUMBER_ID>`_String_
738
+
739
+ Identificação do número de telefone comercial do cliente.
740
+
741
+ `106540352242922`
742
+
743
+ `<CONTACT_FULL_NAME>`_String_
744
+
745
+ O nome completo do contato, conforme aparece na lista de contatos telefônicos do app WhatsApp Business do cliente corporativo.
746
+
747
+ Não é incluído quando o cliente corporativo remove um contato da lista de contatos telefônicos do app WhatsApp Business.
748
+
749
+ `Pablo Morales`
750
+
751
+ `<CONTACT_FIRST_NAME>`_String_
752
+
753
+ O nome do contato, conforme aparece na lista de contatos telefônicos do app WhatsApp Business do cliente corporativo.
754
+
755
+ Não é incluído quando o cliente corporativo remove um contato da lista de contatos telefônicos do app WhatsApp Business.
756
+
757
+ `Pablo`
758
+
759
+ `<CONTACT_PHONE_NUMBER>`_String_
760
+
761
+ O número de telefone do WhatsApp do contato.
762
+
763
+ `16505551234`
764
+
765
+ `<ACTION>`_String_
766
+
767
+ Indica se o cliente corporativo adicionou, editou ou excluiu um contato da lista de contatos telefônicos do app WhatsApp Business. Os valores podem ser os seguintes:
768
+
769
+ - `add` – a empresa adicionou ou editou um contato- `remove` – a empresa removeu um contato
770
+
771
+ `add`
772
+
773
+ `<CONTACT_CHANGE_TIMESTAMP>`_String_
774
+
775
+ Registro de data e hora UNIX indicando quando o contato foi adicionado, editado ou removido.
776
+
777
+ `1738346006`
778
+
779
+ ### smb\_message\_echoes
780
+
781
+ Descreve uma mensagem enviada por um cliente comercial para um usuário do WhatsApp com o app WhatsApp Business ou um [dispositivo adicional](#linked-devices) compatível.
782
+
783
+ #### Eventos de gatilho
784
+
785
+ - Um cliente empresarial usa o app WhatsApp Business ou um dispositivo adicional compatível para enviar mensagem a um usuário do WhatsApp.
786
+
787
+ #### Sintaxe da carga
788
+
789
+ ```
790
+ {
791
+ "object": "whatsapp_business_account",
792
+ "entry": [
793
+ {
794
+ "id": "<WABA_ID>",
795
+ "changes": [
796
+ {
797
+ "value": {
798
+ "messaging_product": "whatsapp",
799
+ "metadata": {
800
+ "display_phone_number": "<BUSINESS_PHONE_NUMBER>",
801
+ "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
802
+ },
803
+ "message_echoes": [
804
+ {
805
+ "from": "<BUSINESS_PHONE_NUMBER>",
806
+ "to": "<WHATSAPP_USER_PHONE_NUMBER>",
807
+ "id": "<WHATSAPP_MESSAGE_ID>",
808
+ "timestamp": "<WEBHOOK_TIMESTAMP>",
809
+ "type": "<MESSAGE_TYPE>",
810
+ "<MESSAGE_TYPE>": {
811
+ <MESSAGE_CONTENTS>
812
+ }
813
+ }
814
+ ]
815
+ },
816
+ "field": "smb_message_echoes"
817
+ }
818
+ ]
819
+ }
820
+ ]
821
+ }
822
+ ```
823
+
824
+ #### Conteúdo da carga
825
+
826
+
827
+
828
+ Espaço reservado
829
+
830
+ Descrição
831
+
832
+ Valor de exemplo
833
+
834
+ `<WABA_ID>`
835
+
836
+ _String_
837
+
838
+ Identificação da conta do WhatsApp Business do cliente corporativo.
839
+
840
+ `102290129340398`
841
+
842
+ `<BUSINESS_PHONE_NUMBER>`
843
+
844
+ _String_
845
+
846
+ Número de telefone comercial do cliente.
847
+
848
+ `15550783881`
849
+
850
+ `<BUSINESS_PHONE_NUMBER_ID>`
851
+
852
+ _String_
853
+
854
+ Identificação do número de telefone comercial do cliente.
855
+
856
+ `106540352242922`
857
+
858
+ `<WHATSAPP_USER_PHONE_NUMBER>`
859
+
860
+ _String_
861
+
862
+ O número de telefone do usuário do WhatsApp.
863
+
864
+ `16505551234`
865
+
866
+ `<WHATSAPP_MESSAGE_ID>`
867
+
868
+ _String_
869
+
870
+ Identificação da mensagem do WhatsApp.
871
+
872
+ `wamid.HBgLMTY0NjcwNDM1OTUVAgARGBIyNDlBOEI5QUQ4NDc0N0FCNjMA`
873
+
874
+ `<WEBHOOK_TIMESTAMP>`
875
+
876
+ _String_
877
+
878
+ Registro de data e hora UNIX indicado quando o webhook foi disparado.
879
+
880
+ `1738796547`
881
+
882
+ `<MESSAGE_TYPE>`
883
+
884
+ _String_
885
+
886
+ [Tipo de mensagem](/documentation/business-messaging/whatsapp/messages/send-messages#message-types). Esse espaço reservado aparece duas vezes na sintaxe acima, pois serve para o valor da propriedade `type` e o nome correspondente da propriedade.
887
+
888
+ `text`
889
+
890
+ `<MESSAGE_CONTENTS>`
891
+
892
+ _Objeto_
893
+
894
+ Um objeto que descreve o conteúdo da mensagem.
895
+
896
+ Esse valor variará com base na mensagem `type`, bem como no conteúdo da mensagem.
897
+
898
+ Por exemplo, se uma empresa enviar uma mensagem `image` sem legenda, o objeto não incluirá a propriedade `caption`.
899
+
900
+ Consulte [Como enviar mensagens](/documentation/business-messaging/whatsapp/messages/send-messages) para ver exemplos de carga de cada tipo de mensagem.
901
+
902
+ `{"body":"Here's the info you requested! https://www.meta.com/quest/quest-3/"}`
903
+
904
+ #### Exemplo de carga
905
+
906
+ Esta carga de exemplo descreve uma mensagem de texto (`type` é `text`) enviada a um usuário do WhatsApp por um cliente corporativo com o app WhatsApp Business.
907
+
908
+ ```
909
+ {  "object": "whatsapp_business_account",  "entry": [    {      "id": "102290129340398",      "changes": [        {          "value": {            "messaging_product": "whatsapp",            "metadata": {              "display_phone_number": "15550783881",              "phone_number_id": "106540352242922"            },            "message_echoes": [              {                "from": "15550783881",                "to": "16505551234",                "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBIyNDlBOEI5QUQ4NDc0N0FCNjMA",                "timestamp": "1700255121",                "type": "text"                "text": {                  "body": "Here's the info you requested! https://www.meta.com/quest/quest-3/"                }              }            ]          },          "field": "smb_message_echoes"        }      ]    }  ]}
910
+ ```
911
+
912
+ ## Precisa de ajuda?
913
+
914
+ Para a integração de _Coexistência_, escolha:
915
+
916
+ - Tópico da pergunta: “WABiz: integração” e “TechProvider: integração”- Tipo de solicitação: "Cadastro incorporado – Integração de coexistência"
917
+
918
+ Para _problemas da API_ de Coexistência, escolha:
919
+
920
+ - Tópico da pergunta: “WABiz: API de nuvem”- Tipo de solicitação: "Webhooks e APIs de sincronização de dados de coexistência"
921
+
922
+ Você achou esta página útil?
923
+
924
+ ![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
925
+
926
+ ![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)