whatsapp-docs-mcp 1.0.6 → 1.0.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/docs/ativos_da_conta/outros_ativos/display_names.md +9 -9
- package/docs/ativos_da_conta/outros_ativos/official_business_accounts.md +27 -27
- package/docs/ativos_da_conta/telefones_comerciais/phone_numbers.md +151 -27
- package/docs/business_profiles.md +72 -0
- package/docs/business_scoped_user_ids.md +1533 -0
- package/docs/dados_privacidade_e_politica/encryption.md +1 -1
- package/docs/flows/changelog.md +6 -6
- package/docs/flows/gettingstarted/health_insurance.md +12 -6
- package/docs/flows/gettingstarted/personalised_offer.md +6 -6
- package/docs/flows/gettingstarted/pre_approved_loan.md +6 -6
- package/docs/flows/gettingstarted/purchase_intent.md +2 -2
- package/docs/flows/gettingstarted.md +5 -5
- package/docs/flows/guias.md +1 -1
- package/docs/flows/playground.md +1 -1
- package/docs/flows/referencia.md +1 -1
- package/docs/flows/support.md +3 -3
- package/docs/flows.md +2 -2
- package/docs/insights/analytics.md +200 -66
- package/docs/ligacoes/call_settings.md +129 -57
- package/docs/ligacoes/calling.md +33 -16
- package/docs/ligacoes/integration_examples.md +526 -0
- package/docs/ligacoes/pricing.md +11 -300
- package/docs/ligacoes/sandbox.md +160 -0
- package/docs/ligacoes/video_calling.md +8 -0
- package/docs/mensagens/interactive_media_carousel_messages.md +256 -0
- package/docs/mensagens/interactive_product_carousel_messages.md +181 -0
- package/docs/mensagens/limites_de_mensagens/messaging_limits.md +16 -12
- package/docs/mensagens/recursos_adicionais/media.md +15 -16
- package/docs/mensagens/recursos_adicionais/payload_encryption.md +1 -1
- package/docs/mensagens/tipos_de_mensagens/audio_messages.md +11 -11
- package/docs/mensagens/tipos_de_mensagens/interactive_flow_messages.md +1 -1
- package/docs/mensagens/tipos_de_mensagens/message_with_link.md +1 -1
- package/docs/mensagens_de_marketing/changelog.md +299 -0
- package/docs/mensagens_de_marketing/features.md +184 -0
- package/docs/mensagens_de_marketing/implementacao/get_started.md +17 -21
- package/docs/mensagens_de_marketing/implementacao/send_marketing_messages.md +50 -45
- package/docs/mensagens_de_marketing/measure_conversion.md +132 -0
- package/docs/mensagens_de_marketing/onboarding.md +282 -0
- package/docs/mensagens_de_marketing/recursos/automatic_creative_optimization.md +1 -1
- package/docs/mensagens_de_marketing/recursos/conversion_measurement.md +1 -1
- package/docs/mensagens_de_marketing/visao_geral/overview.md +11 -9
- package/docs/messaging_limits/upcoming_changes.md +1 -1
- package/docs/modelos/authentication_templates/bulk_management.md +145 -0
- package/docs/modelos/authentication_templates/template_preview.md +109 -0
- package/docs/modelos/gerenciamento_de_modelos/components.md +23 -23
- package/docs/modelos/gerenciamento_de_modelos/template_media.md +1 -1
- package/docs/modelos/modelos_de_marketing/marketing_templates.md +20 -20
- package/docs/modelos/modelos_de_marketing/per_user_limits.md +7 -5
- package/docs/modelos/portfolio_pacing.md +30 -0
- package/docs/modelos/visao_geral/overview.md +17 -17
- package/docs/pagamentos/payments_br/cards.md +8 -0
- package/docs/parceiros/gerenciamento/suporte_ao_parceiro/transferring_wabas_to_customers.md +1 -1
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/onboarding_business_app_users.md +364 -75
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/overview.md +34 -30
- package/docs/parceiros/migrate_existing_whatsapp_number_to_a_business_account.md +40 -0
- package/docs/parceiros/obo_model_deprecation.md +32 -0
- package/docs/parceiros/seja_um_parceiro/get_started_for_solution_partners.md +42 -42
- package/docs/parceiros/seja_um_parceiro/get_started_for_tech_providers.md +38 -142
- package/docs/recado/precos/pricing.md +82 -50
- package/docs/recado/precos/pricing_authentication_international_rates.md +16 -18
- package/docs/recado/precos/pricing_updates_to_pricing.md +1 -1
- package/docs/recado/sobre_a_plataforma/about_the_platform.md +80 -24
- package/docs/recado/sobre_a_plataforma/access_tokens.md +19 -19
- package/docs/referencia/bot_do_whatsapp_business/bot_details_api.md +4 -758
- package/docs/referencia/business/add_phone_numbers_api.md +4 -722
- package/docs/referencia/business/business_account_api.md +8 -0
- package/docs/referencia/business/client_whatsapp_business_accounts_api.md +4 -1002
- package/docs/referencia/business/owned_whatsapp_business_accounts.md +4 -798
- package/docs/referencia/business/whatsapp_business_accounts_api.md +4 -1546
- package/docs/referencia/business/whatsapp_business_partner_onboarding_to_mm_lite_api.md +4 -779
- package/docs/referencia/business/whatsapp_business_pre_verified_phone_number_sharing_api.md +4 -786
- package/docs/referencia/business/whatsapp_business_pre_verified_phone_numbers_api.md +4 -882
- package/docs/referencia/changelog.md +1837 -3
- package/docs/referencia/conta_do_whatsapp_business/assigned_users_management_api.md +4 -2198
- package/docs/referencia/conta_do_whatsapp_business/business_account_api.md +4 -263
- package/docs/referencia/conta_do_whatsapp_business/business_account_extended_credits_api.md +4 -271
- package/docs/referencia/conta_do_whatsapp_business/conversational_automation_api.md +4 -778
- package/docs/referencia/conta_do_whatsapp_business/flows_api.md +4 -1528
- package/docs/referencia/conta_do_whatsapp_business/in_progress_on_behalf_requests_api.md +1 -1
- package/docs/referencia/conta_do_whatsapp_business/migration_intent_api.md +4 -1577
- package/docs/referencia/conta_do_whatsapp_business/obo_mobility_intent_api.md +1 -1
- package/docs/referencia/conta_do_whatsapp_business/phone_number_management_api.md +4 -1682
- package/docs/referencia/conta_do_whatsapp_business/schedules_api.md +4 -1768
- package/docs/referencia/conta_do_whatsapp_business/set_obo_mobility_intent_api.md +1 -1
- package/docs/referencia/conta_do_whatsapp_business/set_solution_migration_intent_api.md +1 -1
- package/docs/referencia/conta_do_whatsapp_business/subscribed_apps_api.md +4 -2174
- package/docs/referencia/conta_do_whatsapp_business/template_api.md +4 -972
- package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_activities_api.md +4 -838
- package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_api.md +4 -1380
- package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_solutions_list_api.md +4 -850
- package/docs/referencia/groups/groups_invite_link_api.md +8 -0
- package/docs/referencia/groups/groups_join_requests_api.md +8 -0
- package/docs/referencia/groups/groups_participants_api.md +8 -0
- package/docs/referencia/groups/groups_query_api.md +8 -0
- package/docs/referencia/grupo/groups_invite_link_api.md +4 -300
- package/docs/referencia/grupo/groups_join_requests_api.md +4 -682
- package/docs/referencia/grupo/groups_participants_api.md +4 -270
- package/docs/referencia/grupo/groups_query_api.md +4 -432
- package/docs/referencia/historico_de_mensagens/whatsapp_business_message_history_events_api.md +4 -862
- package/docs/referencia/inscricao/application_connected_client_businesses.md +4 -808
- package/docs/referencia/inscricao/application_solutions_api.md +4 -870
- package/docs/referencia/inscricao/solution_creation_api.md +4 -820
- package/docs/referencia/intencao_de_migracao_da_conta_do_whatsapp_business/migration_intent_details_api.md +4 -720
- package/docs/referencia/midias/media_api.md +4 -338
- package/docs/referencia/midias/media_download_api.md +4 -156
- package/docs/referencia/numero_da_conta_do_whatsapp/whatsapp_account_number_api.md +4 -774
- package/docs/referencia/perfil_do_whatsapp_business/whatsapp_business_profile_node_api.md +4 -1490
- package/docs/referencia/solucao_do_whatsapp_business/accept_deactivation_request_api.md +4 -758
- package/docs/referencia/solucao_do_whatsapp_business/access_token_api.md +4 -700
- package/docs/referencia/solucao_do_whatsapp_business/reject_deactivation_request_api.md +4 -808
- package/docs/referencia/solucao_do_whatsapp_business/send_deactivation_request_api.md +4 -774
- package/docs/referencia/solucao_do_whatsapp_business/solution_accept_api.md +4 -808
- package/docs/referencia/solucao_do_whatsapp_business/solution_details_api.md +4 -764
- package/docs/referencia/solucao_do_whatsapp_business/solution_reject_api.md +4 -794
- package/docs/referencia/telefone_do_whatsapp_business/block_api.md +4 -538
- package/docs/referencia/telefone_do_whatsapp_business/business_compliance_information_api.md +4 -1604
- package/docs/referencia/telefone_do_whatsapp_business/business_encryption_api.md +4 -1398
- package/docs/referencia/telefone_do_whatsapp_business/calling_api.md +4 -594
- package/docs/referencia/telefone_do_whatsapp_business/encrypted_messages_api.md +4 -478
- package/docs/referencia/telefone_do_whatsapp_business/groups_management_api.md +4 -481
- package/docs/referencia/telefone_do_whatsapp_business/marketing_messages_lite_api.md +4 -311
- package/docs/referencia/telefone_do_whatsapp_business/media_upload_api.md +4 -184
- package/docs/referencia/telefone_do_whatsapp_business/message_api.md +4 -1794
- package/docs/referencia/telefone_do_whatsapp_business/phone_number_api.md +4 -373
- package/docs/referencia/telefone_do_whatsapp_business/phone_number_deregister_api.md +4 -710
- package/docs/referencia/telefone_do_whatsapp_business/phone_number_registration.md +4 -776
- package/docs/referencia/telefone_do_whatsapp_business/phone_number_verification_request_code_api.md +4 -730
- package/docs/referencia/telefone_do_whatsapp_business/register_api.md +4 -407
- package/docs/referencia/telefone_do_whatsapp_business/settings_api.md +4 -670
- package/docs/referencia/telefone_do_whatsapp_business/verify_code_api.md +4 -742
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_message_history_api.md +4 -928
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_official_business_account_status_api.md +4 -1536
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_phone_number_api.md +4 -1596
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_profile_api.md +4 -1474
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_qr_code_api.md +4 -1175
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_qr_code_management_api.md +4 -1311
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/request_verification_code_api.md +4 -774
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/verify_code_api.md +4 -764
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/whatsapp_business_pre_verified_phone_number_api.md +4 -1378
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/whatsapp_business_pre_verified_phone_number_partners_api.md +4 -816
- package/docs/referencia/usuario/assigned_whatsapp_business_accounts_api.md +4 -860
- package/docs/referencia/webhooks/whatsapp_incoming_webhook_payload.md +4 -1651
- package/docs/referencia/whatsapp_business_account/extended_credits_api.md +8 -0
- package/docs/referencia/whatsapp_business_phone_number/commerce_settings_api.md +8 -0
- package/docs/suporte/error_codes.md +88 -89
- package/docs/suporte/migrating_from_onprem_to_cloud.md +222 -0
- package/docs/suporte/support.md +77 -186
- package/docs/suporte.md +77 -186
- package/docs/throughput.md +60 -0
- package/docs/upcoming_messaging_limits_changes.md +132 -0
- package/docs/visao_geral/overview.md +354 -306
- package/docs/webhooks/create_webhook_endpoint.md +158 -0
- package/docs/webhooks/reference/messages/group.md +182 -0
- package/docs/webhooks/referencia/account_update.md +27 -27
- package/docs/webhooks/referencia/messages/status.md +35 -35
- package/docs/webhooks/visao_geral/message_echoes.md +1 -1
- package/docs/webhooks/visao_geral/overview.md +23 -15
- package/package.json +1 -1
|
@@ -1,33 +1,37 @@
|
|
|
1
1
|
<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/overview -->
|
|
2
|
-
<!-- Scraped:
|
|
2
|
+
<!-- Scraped: 2026-01-24T00:33:16.413Z -->
|
|
3
3
|
|
|
4
4
|
# Cadastro Incorporado
|
|
5
5
|
|
|
6
|
-
Updated:
|
|
6
|
+
Updated: 25 de nov de 2025
|
|
7
7
|
|
|
8
|
-
O Cadastro Incorporado é uma interface compatível com computador e com dispositivos móveis para autenticação e autorização que
|
|
8
|
+
O Cadastro Incorporado é uma interface compatível com computador e com dispositivos móveis para autenticação e autorização que ajuda ainda mais os clientes da sua empresa a gerarem os ativos necessários para integrá-los com sucesso à Plataforma do WhatsApp Business.
|
|
9
9
|
|
|
10
|
-
O
|
|
10
|
+
O flow de Cadastro Incorporado reúne informações relacionadas com o negócio dos clientes da sua empresa, gera automaticamente todos os ativos do WhatsApp necessários para a plataforma e concede ao seu app acesso a esses ativos para que você possa fornecer de modo rápido serviços de mensagens do WhatsApp aos seus clientes empresariais.
|
|
11
11
|
|
|
12
12
|
## Como funciona
|
|
13
13
|
|
|
14
|
-
O Cadastro Incorporado faz uso do Login do Facebook para Empresas e do SDK do JavaScript. Depois de configurado, você pode adicionar um link ou botão ao seu site ou portal que lança o
|
|
14
|
+
O Cadastro Incorporado faz uso do Login do Facebook para Empresas e do SDK do JavaScript. Depois de configurado, você pode adicionar um link ou botão ao seu site ou portal que lança o flow.
|
|
15
15
|
|
|
16
16
|
Os clientes empresariais que clicarem no link ou botão verão uma nova janela onde poderão:
|
|
17
17
|
|
|
18
|
-
- autenticar sua identidade usando as Credenciais de Negócios do Facebook ou da Meta- aceitar os Termos de Serviço da API de Nuvem, do WhatsApp Business, da Meta, da API de Mensagens de Marketing Lite e das Ferramentas da Meta para Empresas- selecionar várias APIs do WhatsApp e aceitar os Termos de Serviço- conceder
|
|
18
|
+
- autenticar sua identidade usando as Credenciais de Negócios do Facebook ou da Meta- aceitar os Termos de Serviço da API de Nuvem, do WhatsApp Business, da Meta, da API de Mensagens de Marketing Lite e das Ferramentas da Meta para Empresas- selecionar várias APIs do WhatsApp e aceitar os Termos de Serviço- conceder acesso aos ativos do WhatsApp para seu app- selecionar um portfólio empresarial existente ou criar um novo- selecionar uma Conta do WhatsApp Business (WABA) ou criar uma nova- inserir e verificar seu número de telefone comercial (informado por eles ou fornecido por você)- inserir um nome de exibição que pode aparecer no lugar do número no cliente do WhatsApp
|
|
19
19
|
|
|
20
|
-
|
|
21
21
|
|
|
22
|
-
Após a conclusão bem-sucedida, o Cadastro Incorporado
|
|
22
|
+
Após a conclusão bem-sucedida, o Cadastro Incorporado fornecerá a identificação da WABA do cliente, o número de telefone comercial e um código de token fungível na janela que gerou o flow. Você deve enviar esses dados para seu servidor e usá-los em uma chamada entre servidores para:
|
|
23
23
|
|
|
24
24
|
- trocar o código por um token empresarial no escopo do cliente- registrar o número de telefone comercial do cliente para uso da API de Nuvem- inscrever seu app em webhooks na WABA do cliente- compartilhar sua linha de crédito com o cliente (apenas parceiros de soluções)
|
|
25
25
|
|
|
26
26
|
Quando essas etapas estiverem concluídas, se você for um parceiro de soluções ou tiver uma parceria com um, o cliente poderá começar a usar seu app ou o do seu parceiro para enviar mensagens imediatamente. Se você não for um parceiro de soluções ou não tem parceria com um, o cliente deverá primeiro adicionar uma forma de pagamento à WABA antes de poder começar a enviar mensagens.
|
|
27
27
|
|
|
28
|
+
Estamos testando uma nova experiência no flow de Cadastro Incorporado para todas as versões. O flow em si não foi alterado, mas, depois da conclusão, você poderá ver um novo botão **Ver seu guia de configuração**. Ao clicar nessa opção, você acessará uma nova página de orientação de configuração no Gerenciador do WhatsApp, que oferece as próximas etapas sobre:
|
|
29
|
+
|
|
30
|
+
- Verificação da empresa- Resolver problemas de integridade e acessar a Página Inicial do Suporte para Empresas- Enviar a primeira mensagem por meio de uma solução de parceiro- Enviar mensagens iniciadas pela empresa usando modelos
|
|
31
|
+
|
|
28
32
|
## Propriedade de ativo
|
|
29
33
|
|
|
30
|
-
Os clientes empresariais integrados via Cadastro Incorporado são proprietários
|
|
34
|
+
Os clientes empresariais integrados via Cadastro Incorporado são proprietários dos respectivos ativos do WhatsApp e podem utilizar esses ativos com outras soluções da Meta, como [Anúncios de clique para o WhatsApp](https://www.facebook.com/business/help/447934475640650).
|
|
31
35
|
|
|
32
36
|
Também têm acesso total ao [Gerenciador do WhatsApp](https://business.facebook.com/wa/manage/), que pode ser usado para acessar os ativos. Não é possível restringir o acesso. Consulte os ativos disponíveis [neste link](/documentation/business-messaging/whatsapp/embedded-signup/version-4).
|
|
33
37
|
|
|
@@ -37,9 +41,9 @@ Também têm acesso total ao [Gerenciador do WhatsApp](https://business.facebook
|
|
|
37
41
|
|
|
38
42
|
Por padrão, você pode integrar até 10 novos clientes empresariais em uma janela de 7 dias consecutivos. Somente clientes recém-integrados contam para esse limite. É possível ver a contagem atual de clientes integrados em **Gerenciador do WhatsApp** > **Visão geral do parceiro**. Você receberá uma notificação por email se chegar perto desse limite.
|
|
39
43
|
|
|
40
|
-
Se você concluir a verificação da empresa, a análise do app e a verificação de acesso, aumentaremos automaticamente seu limite para 200 novos clientes empresariais em uma janela de 7 dias consecutivos. Caso seja preciso integrar mais de 200 clientes por semana, inscreva-se para se tornar um [Parceiro de Negócios da Meta](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fpartners%2Fbecome-a-partner&h=
|
|
44
|
+
Se você concluir a verificação da empresa, a análise do app e a verificação de acesso, aumentaremos automaticamente seu limite para 200 novos clientes empresariais em uma janela de 7 dias consecutivos. Caso seja preciso integrar mais de 200 clientes por semana, inscreva-se para se tornar um [Parceiro de Negócios da Meta](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fpartners%2Fbecome-a-partner&h=AT0zoQbdNxaFN9g-A0XoJ2ghPxqgwUyor3H77Je5hCMoikGionTLztYd4fs5fAxdi6o84-Sa87A5Z9t-jB5TqFStZFZCU624_Q29iRt9oSOK8ykYV9yj8E_I3-QahoQgyX7lkzrSFCugkv-rkYIhMQ6xfFw).
|
|
41
45
|
|
|
42
|
-
**Observação:** contas do WhatsApp Business (WABAs) existentes que foram criadas originalmente por meio do app do desenvolvedor não podem ser selecionadas ou integradas diretamente por meio do
|
|
46
|
+
**Observação:** contas do WhatsApp Business (WABAs) existentes que foram criadas originalmente por meio do app do desenvolvedor não podem ser selecionadas ou integradas diretamente por meio do flow de Cadastro Incorporado.
|
|
43
47
|
|
|
44
48
|
### Limites de mensagens para clientes empresariais
|
|
45
49
|
|
|
@@ -47,33 +51,33 @@ Os clientes empresariais integrados via Cadastro Incorporado começam com [limit
|
|
|
47
51
|
|
|
48
52
|
### Limites de número de telefone comercial de clientes
|
|
49
53
|
|
|
50
|
-
- Números de telefone
|
|
54
|
+
- Números de telefone comercial só poderão ser registrados para uso com a API de Nuvem.- Números de telefone comerciais já registrados para uso com a API Local ou usados no WhatsApp não são aceitos.- Números de telefone comercial já em uso com o [app WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fproducts%2Fbusiness-app&h=AT0zoQbdNxaFN9g-A0XoJ2ghPxqgwUyor3H77Je5hCMoikGionTLztYd4fs5fAxdi6o84-Sa87A5Z9t-jB5TqFStZFZCU624_Q29iRt9oSOK8ykYV9yj8E_I3-QahoQgyX7lkzrSFCugkv-rkYIhMQ6xfFw) são aceitos, mas exigem que você personalize o flow para habilitar a [integração de usuários do app WhatsApp Business](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users) (também conhecida como "coexistência").- Os clientes empresariais integrados por meio do Cadastro Incorporado começam com [limites de mensagens](/documentation/business-messaging/whatsapp/messaging-limits) padrão.
|
|
51
55
|
|
|
52
|
-
##
|
|
56
|
+
## Flow da API de Nuvem
|
|
53
57
|
|
|
54
|
-
Consulte [
|
|
58
|
+
Consulte [Flow da API de Nuvem](/documentation/business-messaging/whatsapp/embedded-signup/default-flow) para ver a descrição de cada tela que será apresentada aos seus clientes empresariais como parte da implementação padrão do Cadastro Incorporado.
|
|
55
59
|
|
|
56
60
|
Se você souber informações sobre a empresa do cliente, poderá [inserir esses dados](/documentation/business-messaging/whatsapp/embedded-signup/pre-filled-data), o que pode reduzir significativamente o número de telas com as quais os clientes têm que interagir.
|
|
57
61
|
|
|
58
62
|
## Tokens de acesso
|
|
59
63
|
|
|
60
|
-
O Cadastro Incorporado gera [tokens comerciais](/documentation/business-messaging/whatsapp/access-tokens#business-integration-system-user-access-tokens). Quando um cliente empresarial conclui o
|
|
64
|
+
O Cadastro Incorporado gera [tokens comerciais](/documentation/business-messaging/whatsapp/access-tokens#business-integration-system-user-access-tokens). Quando um cliente empresarial conclui o flow de Cadastro Incorporado, um código de token fungível será retornado como um evento de mensagem e capturado pelo SDK do JavaScript. Você precisará trocar o código por um token empresarial fazendo uma chamada de servidor para servidor.
|
|
61
65
|
|
|
62
66
|
Se você for um Provedor de Tecnologia, usará exclusivamente tokens empresariais.
|
|
63
67
|
|
|
64
|
-
Caso você seja um parceiro de soluções, usará seu [token de acesso de usuário do sistema](/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens) ("token do sistema") para compartilhar sua linha de crédito com os clientes empresariais integrados,
|
|
68
|
+
Caso você seja um parceiro de soluções, usará seu [token de acesso de usuário do sistema](/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens) ("token do sistema") para compartilhar sua linha de crédito com os clientes empresariais integrados, além de tokens empresariais para todo o resto. Observe que o usuário do sistema representado pelo token deve ter concedido ao seu app a permissão **business\_management** e deve ter recebido a função de **administrador** ou **editor financeiro** no seu portfólio empresarial para poder compartilhar sua linha de crédito.
|
|
65
69
|
|
|
66
70
|
## Permissões
|
|
67
71
|
|
|
68
|
-
O Cadastro Incorporado pode ser configurado para oferecer suporte a produtos de mensagens da empresa para seus clientes. Caso você tenha interesse apenas no
|
|
72
|
+
O Cadastro Incorporado pode ser configurado para oferecer suporte a produtos de mensagens da empresa para seus clientes. Caso você tenha interesse apenas no flow da API de Nuvem, precisará provavelmente apenas das seguintes permissões:
|
|
69
73
|
|
|
70
|
-
- **whatsapp\_business\_management**: necessária caso seu app precise de acesso às configurações da Conta do WhatsApp Business e aos modelos de mensagens do cliente integrado.- **whatsapp\_business\_messaging**: necessária caso seu app precise acessar as configurações de número de telefone comercial do cliente integrado
|
|
74
|
+
- **whatsapp\_business\_management**: necessária caso seu app precise de acesso às configurações da Conta do WhatsApp Business e aos modelos de mensagens do cliente integrado.- **whatsapp\_business\_messaging**: necessária caso seu app precise acessar as configurações de número de telefone comercial do cliente integrado ou se ele for usado pelos clientes para enviar e receber mensagens.
|
|
71
75
|
|
|
72
|
-
|
|
73
77
|
|
|
74
78
|
Você pode especificar de quais permissões seu app precisa durante o processo de [implementação](/documentation/business-messaging/whatsapp/embedded-signup/implementation).
|
|
75
79
|
|
|
76
|
-
Enquanto seu app estiver em modo de desenvolvimento, essas permissões aparecerão na [tela de autorização](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#authorization-screen) do Cadastro Incorporado para qualquer pessoa que tenha uma função de**admin**, **desenvolvedor** ou **testador** no seu app. No entanto, assim que mudar seu app para o modo publicado, apenas as permissões que foram aprovadas para acesso avançado no processo de [Análise do App](/documentation/business-messaging/whatsapp/solution-providers/app-review) aparecerão no
|
|
80
|
+
Enquanto seu app estiver em modo de desenvolvimento, essas permissões aparecerão na [tela de autorização](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#authorization-screen) do Cadastro Incorporado para qualquer pessoa que tenha uma função de**admin**, **desenvolvedor** ou **testador** no seu app. No entanto, assim que mudar seu app para o modo publicado, apenas as permissões que foram aprovadas para acesso avançado no processo de [Análise do App](/documentation/business-messaging/whatsapp/solution-providers/app-review) aparecerão no flow.
|
|
77
81
|
|
|
78
82
|
## Cobrança
|
|
79
83
|
|
|
@@ -87,13 +91,13 @@ Se você for um provedor ou parceiro de tecnologia, os clientes empresariais int
|
|
|
87
91
|
|
|
88
92
|
## Contas de sandbox
|
|
89
93
|
|
|
90
|
-
É possível testar o flow Cadastro incorporado usando sua própria conta do Facebook, mas isso pode gerar portfólios empresariais, WABAs e números de telefone comerciais adicionais. Caso você não queira sobrecarregar sua conta do Facebook com dados de teste, solicite uma conta de teste de sandbox para simular um cliente empresarial concluindo o
|
|
94
|
+
É possível testar o flow Cadastro incorporado usando sua própria conta do Facebook, mas isso pode gerar portfólios empresariais, WABAs e números de telefone comerciais adicionais. Caso você não queira sobrecarregar sua conta do Facebook com dados de teste, solicite uma conta de teste de sandbox para simular um cliente empresarial concluindo o flow.
|
|
91
95
|
|
|
92
|
-
Quando você concluir o
|
|
96
|
+
Quando você concluir o flow usando a conta de sandbox, a [identificação da WABA e do número de telefone comercial](/documentation/business-messaging/whatsapp/embedded-signup/implementation#session-logging-message-event-listener), além de um [código de token que pode ser trocado](/documentation/business-messaging/whatsapp/embedded-signup/implementation#response-callback), serão retornados, como se fosse um cliente real.
|
|
93
97
|
|
|
94
98
|
### Limitações da conta de sandbox
|
|
95
99
|
|
|
96
|
-
- Elas são válidas por 30 dias
|
|
100
|
+
- Elas são válidas por 30 dias. Depois desse período, serão desativadas e deverão ser recuperadas para serem usadas novamente.- Esse tipo de conta não pode ser usado para criar portfólios empresariais de sandbox, WABAs ou números de telefone comerciais adicionais. Os ativos são gerados automaticamente e aparecerão no flow Cadastro Incorporado.- A conta de sandbox está associada ao administrador do app. Para que os ativos da conta de sandbox apareçam no flow Cadastro Incorporado, o administrador do app deve estar conectado à conta de desenvolvedor da Meta.- O portfólio empresarial da conta de sandbox não aparecerá no Meta Business Suite nem no Gerenciador do WhatsApp.- Você pode trocar o código de token retornado pelo token empresarial da conta de sandbox e usá-lo para consultar dados sobre a identificação da WABA, mas o número de telefone comercial não pode ser utilizado para enviar nem receber mensagens.
|
|
97
101
|
|
|
98
102
|
### Reivindicar contas de sandbox
|
|
99
103
|
|
|
@@ -101,7 +105,7 @@ Para reivindicar uma conta de sandbox:
|
|
|
101
105
|
|
|
102
106
|
- Acesse [Painel de Apps](/apps) > **WhatsApp** > **Início rápido**.- Encontre a seção **Integrações de teste**.- Clique no botão **Reivindicar conta de sandbox**.
|
|
103
107
|
|
|
104
|
-
|
|
105
109
|
|
|
106
110
|
### Excluir contas de sandbox
|
|
107
111
|
|
|
@@ -113,7 +117,7 @@ Para excluir uma conta de sandbox:
|
|
|
113
117
|
|
|
114
118
|
- Acesse [Painel de Apps](/apps) > **WhatsApp** > **Início rápido**.- Encontre a seção **Integrações de teste** para localizar sua conta de sandbox.- Clique no botão **Excluir conta** da sua conta de sandbox.
|
|
115
119
|
|
|
116
|
-
|
|
117
121
|
|
|
118
122
|
## Números de telefone comerciais 555
|
|
119
123
|
|
|
@@ -123,7 +127,7 @@ Clientes empresariais podem receber até dois números de telefone comerciais 55
|
|
|
123
127
|
|
|
124
128
|
Se os seus clientes empresariais estiverem qualificados, a [tela para adicionar números de telefone](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#phone-number-addition-screen) mostrará de forma automática a opção de escolher um número 555:
|
|
125
129
|
|
|
126
|
-
|
|
127
131
|
|
|
128
132
|
## Migração de ativos do WhatsApp
|
|
129
133
|
|
|
@@ -139,7 +143,7 @@ Consulte [Análise do App](/documentation/business-messaging/whatsapp/solution-p
|
|
|
139
143
|
|
|
140
144
|
O Auxiliar de integração de Cadastro Incorporado é uma ferramenta de configuração e teste no Painel de Apps. Com a ferramenta, você pode:
|
|
141
145
|
|
|
142
|
-
- lançar o Cadastro Incorporado em várias configurações de
|
|
146
|
+
- lançar o Cadastro Incorporado em várias configurações de flow- ver dados que são retornados quando um cliente empresarial conclui o flow- gerar um código de implementação e consultas de integração, que você pode copiar e colar no seu site, portal de clientes empresariais e servidor- enviar consultas de API para pontos de extremidade que você precisará usar ao integrar clientes que concluem o flow
|
|
143
147
|
|
|
144
148
|
Você pode acessar o auxiliar de integração navegando até **Painel de Apps** > **WhatsApp** > **Configurador de Cadastro Incorporado**.
|
|
145
149
|
|
|
@@ -147,13 +151,13 @@ Você pode acessar o auxiliar de integração navegando até **Painel de Apps**
|
|
|
147
151
|
|
|
148
152
|
## Webhooks
|
|
149
153
|
|
|
150
|
-
Como parte do processo de integração, você deve inscrever seu app no webhook na WABA de cada cliente empresarial que concluir o
|
|
154
|
+
Como parte do processo de integração, você deve inscrever seu app no webhook na WABA de cada cliente empresarial que concluir o flow de Cadastro Incorporado.
|
|
151
155
|
|
|
152
|
-
Webhooks serão disparados e enviados para o URL de retorno de chamada configurado no seu app, de acordo com os campos de webhook que você assinou. Isso significa que todos os webhooks para todos seus clientes empresariais integrados serão enviados para o URL de retorno de ligação do seu app. Contudo, você pode substituir o URL de retorno de ligação em uma Conta do WhatsApp Business ou número de telefone comercial individual.
|
|
156
|
+
Webhooks serão disparados e enviados para o URL de retorno de chamada configurado no seu app, de acordo com os campos de webhook que você assinou. Isso significa que todos os webhooks para todos seus clientes empresariais integrados serão enviados para o URL de retorno de ligação do seu app. Contudo, você pode substituir o URL de retorno de ligação em uma Conta do WhatsApp Business ou número de telefone comercial individual. Consulte [Substituições de webhook](/documentation/business-messaging/whatsapp/webhooks/override) para saber como fazer isso.
|
|
153
157
|
|
|
154
158
|
## Localização
|
|
155
159
|
|
|
156
|
-
O
|
|
160
|
+
O flow de Cadastro Incorporado está disponível em 30 idiomas. O flow localizado é disparado automaticamente com base no idioma em que o cliente empresarial usa o Facebook.
|
|
157
161
|
|
|
158
162
|
Árabe, tcheco, dinamarquês, grego, inglês (Reino Unido), espanhol (Espanha), espanhol, finlandês, francês (França), hebraico, hindi, húngaro, indonésio, italiano, japonês, coreano, norueguês (bokmal), holandês, polonês, português (Brasil), português (Portugal), romeno, russo, sueco, tailandês, turco, vietnamita, chinês simplificado (China), chinês tradicional (Hong Kong), chinês tradicional (Taiwan).
|
|
159
163
|
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/migrate-existing-whatsapp-number-to-a-business-account -->
|
|
2
|
+
<!-- Scraped: 2026-01-24T00:57:50.441Z -->
|
|
3
|
+
|
|
4
|
+
# Como migrar um número do WhatsApp existente para uma conta comercial
|
|
5
|
+
|
|
6
|
+
Updated: 31 de out de 2025
|
|
7
|
+
|
|
8
|
+
Para usar um número de telefone existente do WhatsApp Messenger com a API de Nuvem, primeiro exclua a conta do app.
|
|
9
|
+
|
|
10
|
+
Para usar um número de telefone existente do app WhatsApp Business com a API de Nuvem, você deverá excluir sua conta ou fazer a integração na plataforma [com um provedor de soluções](https://business.facebook.com/messaging/partner-showcase) que aceite [a integração de números de telefone do app de negócios](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users). **Lembre-se de fazer backup do seu histórico de conversas no app WhatsApp Business. Confira os guias sobre como fazer isso no [Android](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F744445782709185%2F%3Fhelpref%3Dfaq_content&h=AT3byzIYGAR6xM1i7TK6phlefz5InGjIZ_F9qovIdaiIeXJiqJRpj2r6g1XcgE0hXRgpBtNt3DVFSeLSD0Av8TJNWrtG6GKqh2NFlPYRC5Y7ExA2EvTs8AcX-KseP6WOKoH16dYZ6ZlZQ3rE5kGlNq6kdVc) ou no [iOS](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F180225246548988%2F&h=AT3byzIYGAR6xM1i7TK6phlefz5InGjIZ_F9qovIdaiIeXJiqJRpj2r6g1XcgE0hXRgpBtNt3DVFSeLSD0Av8TJNWrtG6GKqh2NFlPYRC5Y7ExA2EvTs8AcX-KseP6WOKoH16dYZ6ZlZQ3rE5kGlNq6kdVc).**
|
|
11
|
+
|
|
12
|
+
Caso você exclua o número de telefone do app WhatsApp Business e depois o registre para uso com a API de Nuvem seguindo as etapas abaixo, o histórico de mensagens será perdido e não será mais possível usar o número com o app WhatsApp Business, a menos que você cancele o registro da API de Nuvem. Se a integração for feita por meio de um provedor de soluções que aceita o número do app de empresa, você poderá usar o app do WhatsApp Business e o app do parceiro de soluções simultaneamente, e o histórico de mensagens será preservado.
|
|
13
|
+
|
|
14
|
+
## Excluir uma conta do app WhatsApp Messenger ou WhatsApp Business
|
|
15
|
+
|
|
16
|
+
- Abra o app WhatsApp ou WhatsApp Business para Android ou iPhone
|
|
17
|
+
- Navegue até **Configurações > Conta**
|
|
18
|
+
- Selecione **Excluir minha conta.** Enquanto isso, as mensagens enviadas para esse número ficarão na fila
|
|
19
|
+
- Siga as etapas para excluir a conta do WhatsApp associada a esse número de telefone. **Pode levar até três minutos para que o número desconectado fique disponível**
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
_Configurações da conta_
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
_Excluir minha conta_
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
_Etapas de exclusão_
|
|
33
|
+
|
|
34
|
+
Quando o número estiver disponível, siga as instruções para [adicionar um número de telefone](/documentation/business-messaging/whatsapp/get-started).
|
|
35
|
+
|
|
36
|
+
Você achou esta página útil?
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/obo-model-deprecation -->
|
|
2
|
+
<!-- Scraped: 2026-01-24T00:58:19.225Z -->
|
|
3
|
+
|
|
4
|
+
# Descontinuação do modelo de propriedade da conta "Em nome de"
|
|
5
|
+
|
|
6
|
+
Updated: 14 de nov de 2025
|
|
7
|
+
|
|
8
|
+
Tornamos obsoleto o modelo de propriedade de conta "em nome de" (OBO, pelas iniciais em inglês) e o substituímos pela [criação de WABA iniciada pelo parceiro](/documentation/business-messaging/whatsapp/solution-providers/partner-initiated-waba-creation). Todas as WABAs existentes criadas de acordo com o modelo OBO deverão ser transferidas para os clientes comerciais até 1º de outubro de 2025. A partir de 1º de outubro de 2025, todas as contas OBO qualificadas serão migradas automaticamente em lotes até o final de outubro de 2025.
|
|
9
|
+
|
|
10
|
+
## Linha do tempo de descontinuação
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
- **24 de março de 2025**: a [criação de WABA iniciada pelo parceiro](/documentation/business-messaging/whatsapp/solution-providers/partner-initiated-waba-creation) será disponibilizada para todos os provedores de soluções.- **29 de setembro de 2025**: último dia para integrar clientes empresariais ao modelo OBO.- **1º de outubro de 2025**: último dia para transferir a propriedade das WABAs do modelo OBO para clientes empresariais.
|
|
15
|
+
|
|
16
|
+
## Formas de pagamento
|
|
17
|
+
|
|
18
|
+
A criação de WABAs iniciada pelo parceiro não é compatível com a configuração automática de pagamento. Em vez disso, você deve compartilhar sua linha de crédito com o cliente empresarial por meio da API. Consulte [Criação da WABA iniciada pelo parceiro](/documentation/business-messaging/whatsapp/solution-providers/partner-initiated-waba-creation) para saber mais.
|
|
19
|
+
|
|
20
|
+
## Soluções multiparceiros
|
|
21
|
+
|
|
22
|
+
Os clientes comerciais não podem ser integrados a uma solução multiparceiros como parte do processo de criação da WABA iniciado pelo parceiro, mas podem ser adicionados a uma MPS depois. Consulte [Criação da WABA iniciada pelo parceiro](/documentation/business-messaging/whatsapp/solution-providers/partner-initiated-waba-creation) para saber mais.
|
|
23
|
+
|
|
24
|
+
## API de Mensagens de Marketing Lite
|
|
25
|
+
|
|
26
|
+
As WABAs existentes que usam esse modelo precisarão ser transferidas para clientes empresariais se você quiser usá-las com a API de Mensagens de Marketing Lite. Isso pode ser feito como parte do [processo de integração da API de MM Lite](/documentation/business-messaging/whatsapp/marketing-messages/onboarding#onboard-via-a-partner-using-whatsapp-manager).
|
|
27
|
+
|
|
28
|
+
Você achou esta página útil?
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
|
|
@@ -1,25 +1,25 @@
|
|
|
1
1
|
<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/get-started-for-solution-partners -->
|
|
2
|
-
<!-- Scraped:
|
|
2
|
+
<!-- Scraped: 2026-01-24T00:56:53.781Z -->
|
|
3
3
|
|
|
4
4
|
# Primeiros passos como parceiro de soluções
|
|
5
5
|
|
|
6
|
-
Updated:
|
|
6
|
+
Updated: 12 de dez de 2025
|
|
7
7
|
|
|
8
|
-
Este guia descreve as etapas para
|
|
8
|
+
Este guia descreve as etapas para [parceiros de soluções](/documentation/business-messaging/whatsapp/solution-providers/overview#solution-partners) oferecerem a API de Nuvem aos clientes. Estas são as quatro etapas principais:
|
|
9
9
|
|
|
10
10
|
- [Preparar e planejar](#prepare-plan)- [Configurar ativos](#set-up-assets)- [Assinar contratos](#sign-contracts)- [Criar integração](#build-integration)
|
|
11
11
|
|
|
12
|
-
Depois de concluir o processo, [acompanhe as atualizações mensais](#keep-up-monthly-updates).
|
|
12
|
+
Depois de concluir o processo, [acompanhe as atualizações mensais](#keep-up-with-monthly-updates).
|
|
13
13
|
|
|
14
14
|
## Preparar e planejar
|
|
15
15
|
|
|
16
16
|
### Ler a documentação
|
|
17
17
|
|
|
18
|
-
Antes de começar, leia a [documentação para desenvolvedores](/documentation/business-messaging/whatsapp/about-the-platform#whatsapp-cloud-api) e a [coleção do Postman](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.postman.com%2Fmeta%2Fworkspace%2Fwhatsapp-business-platform%2Fcollection%2F13382743-84d01ff8-4253-4720-b454-af661f36acc2&h=
|
|
18
|
+
Antes de começar, leia a [documentação para desenvolvedores](/documentation/business-messaging/whatsapp/about-the-platform#whatsapp-cloud-api) e a [coleção do Postman](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.postman.com%2Fmeta%2Fworkspace%2Fwhatsapp-business-platform%2Fcollection%2F13382743-84d01ff8-4253-4720-b454-af661f36acc2&h=AT2AyH7J6bKWTS-sOnrCZAjuE1liG_EPGqpikOGvUwQe3LQg1TkFGMFW_nPKCYdhHnZgeHSXC29y4J5N6awhI_oJY7fxedG1U_AiEYzy7D14rUaiPuIjSBrofr_ftDsFbRIy2lMFmzVubDuj96UTLFAhkC8). Dessa forma, você pode entender o funcionamento da API de Nuvem e aprender sobre os primeiros passos e a migração de números.
|
|
19
19
|
|
|
20
20
|
### Planejar a integração e a migração
|
|
21
21
|
|
|
22
|
-
**Recomendamos usar o Cadastro incorporado para integrar novos clientes comerciais à API de Nuvem.**
|
|
22
|
+
**Recomendamos usar o Cadastro incorporado para integrar novos clientes comerciais à API de Nuvem.** Implemente o [Cadastro Incorporado](/documentation/business-messaging/whatsapp/embedded-signup/overview) caso ainda não tenha feito isso. O Cadastro Incorporado é o modo mais rápido e fácil de registrar clientes, que podem começar a enviar mensagens em menos de cinco minutos.
|
|
23
23
|
|
|
24
24
|
## Configurar ativos
|
|
25
25
|
|
|
@@ -33,27 +33,27 @@ Instruções específicas
|
|
|
33
33
|
|
|
34
34
|
É possível usar um existente ou [configurar um novo](https://www.facebook.com/business/help/1710077379203657). Salve a identificação do portfólio empresarial.
|
|
35
35
|
|
|
36
|
-
**Conta do WhatsApp Business** (WABA
|
|
36
|
+
**Conta do WhatsApp Business** (WABA)
|
|
37
37
|
|
|
38
|
-
Para saber mais, consulte [
|
|
38
|
+
Para saber mais, consulte [Como criar uma conta na plataforma do WhatsApp Business](https://www.facebook.com/business/help/2087193751603668).
|
|
39
39
|
|
|
40
40
|
[**App da Meta**](/apps/)
|
|
41
41
|
|
|
42
42
|
Se você não tiver um app, será necessário [criar um](/docs/development/create-an-app) do tipo **Empresa**. Lembre-se de adicionar um nome de exibição e um email de contato ao app.
|
|
43
43
|
|
|
44
|
-
Ao atuar como um parceiro de
|
|
44
|
+
Ao atuar como um parceiro de soluções, você precisa concluir a [análise do app](/docs/app-review) e solicitar acesso avançado às seguintes permissões:
|
|
45
45
|
|
|
46
|
-
- [`whatsapp_business_management`](/docs/permissions/reference/whatsapp_business_management): usada para gerenciar números de telefone, modelos de mensagem, inscrições e o perfil comercial de uma conta do WhatsApp Business. Para receber essa permissão, o app precisa passar
|
|
46
|
+
- [`whatsapp_business_management`](/docs/permissions/reference/whatsapp_business_management): usada para gerenciar números de telefone, modelos de mensagem, inscrições e o perfil comercial de uma conta do WhatsApp Business. Para receber essa permissão, o app precisa passar pela [Análise do App](/docs/app-review).- [`whatsapp_business_messaging`](/docs/permissions/reference/whatsapp_business_messaging): usada para enviar/receber mensagens de usuários do WhatsApp, além de carregar/baixar mídia em uma conta do WhatsApp Business. Para receber essa permissão, o app precisa passar pela [Análise do App](/docs/app-review).- [`whatsapp_business_manage_events`](/docs/permissions#whatsapp_business_manage_events): usada para registrar eventos, como compras, adições ao carrinho, leads e muito mais, em uma conta do WhatsApp Business. Solicite essa permissão somente se estiver usando a [API de Mensagens de Marketing Lite](/docs/whatsapp/marketing-messages-lite-api) com a [API de Conversões](/docs/marketing-api/conversions-api). Para receber essa permissão, o app precisa passar pela [Análise do App](/docs/app-review).
|
|
47
47
|
|
|
48
|
-
Os parceiros de soluções podem usar o mesmo app da Meta para diferentes clientes e WABAs. No entanto, é importante lembrar que cada app precisa passar pela
|
|
48
|
+
Os parceiros de soluções podem usar o mesmo app da Meta para diferentes clientes e WABAs. No entanto, é importante lembrar que cada app precisa passar pela Análise do App e pode ter apenas um ponto de extremidade de webhook.
|
|
49
49
|
|
|
50
50
|
**Usuário do sistema**
|
|
51
51
|
|
|
52
|
-
Consulte [
|
|
52
|
+
Consulte [Como adicionar usuários do sistema ao portfólio empresarial](https://www.facebook.com/business/help/503306463479099) para saber mais.
|
|
53
53
|
|
|
54
54
|
No momento, um app da Meta com as permissões `whatsapp_business_messaging`, `whatsapp_business_management`, `whatsapp_business_manage_events` e `business_messaging` tem acesso a até:
|
|
55
55
|
|
|
56
|
-
- Um usuário do sistema
|
|
56
|
+
- Um administrador usuário do sistema- Um funcionário usuário do sistema
|
|
57
57
|
|
|
58
58
|
Recomendamos que você use o usuário administrador do sistema para a implantação da produção. Para saber mais, veja [Sobre o acesso ao portfólio empresarial](https://www.facebook.com/business/help/442345745885606).
|
|
59
59
|
|
|
@@ -63,7 +63,7 @@ Esse é o número de telefone que a empresa usará para enviar mensagens. Esses
|
|
|
63
63
|
|
|
64
64
|
Para parceiros de soluções e empresas diretas: se você quiser usar o próprio número, será preciso [adicionar um telefone](https://www.facebook.com/business/help/456220311516626) no Gerenciador do WhatsApp e verificá-lo com o ponto de extremidade por meio da [Graph API](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#verify-phone-numbers).
|
|
65
65
|
|
|
66
|
-
Para empresas que usam parceiros de soluções: se você quiser usar o próprio número, será preciso adicionar e verificar o telefone por meio do [fluxo de Cadastro
|
|
66
|
+
Para empresas que usam parceiros de soluções: se você quiser usar o próprio número, será preciso adicionar e verificar o telefone por meio do [fluxo de Cadastro Incorporado](/documentation/business-messaging/whatsapp/embedded-signup/overview) do parceiro de soluções.
|
|
67
67
|
|
|
68
68
|
Não há limite para a quantidade de telefones comerciais que podem ser integrados à API de Nuvem.
|
|
69
69
|
|
|
@@ -79,11 +79,11 @@ Para acessar a API de Nuvem de Mensagens do WhatsApp Business, é necessário pr
|
|
|
79
79
|
|
|
80
80
|
Para isso, acesse o [Gerenciador do WhatsApp](https://business.facebook.com/wa/manage/) e aceite os Termos de Serviço no banner informativo.
|
|
81
81
|
|
|
82
|
-
|
|
83
83
|
|
|
84
|
-
As novas empresas que usarem a API de Nuvem precisarão aceitar os Termos de Serviço antes de
|
|
84
|
+
As novas empresas que usarem a API de Nuvem precisarão aceitar os Termos de Serviço antes de começarem a usar essa API. Até que você aceite os Termos de Serviço, ocorrerá falha nas chamadas de registro.
|
|
85
85
|
|
|
86
|
-
É preciso aceitar os Termos de Serviço como desenvolvedor. Se você for um parceiro de
|
|
86
|
+
É preciso aceitar os Termos de Serviço como desenvolvedor. Se você for um parceiro de soluções, não será necessário que o cliente os aceite.
|
|
87
87
|
|
|
88
88
|
## Criar a integração
|
|
89
89
|
|
|
@@ -93,10 +93,10 @@ As chamadas da Graph API usam tokens de acesso para autenticação. Para saber m
|
|
|
93
93
|
|
|
94
94
|
Para gerar um token de acesso do usuário do sistema:
|
|
95
95
|
|
|
96
|
-
- Para ver o usuário que você criou, acesse [**
|
|
96
|
+
- Para ver o usuário que você criou, acesse [**Portfólio empresarial**](https://business.facebook.com/) > **Configurações do negócio** > **Usuários** > **Usuários do sistema**.
|
|
97
97
|
- Clique no usuário e selecione **Adicionar ativos**. Essa ação abre uma nova janela.
|
|
98
|
-
- No painel lateral esquerdo, em **Selecionar tipo de ativo**, escolha **Apps**. Em **Selecionar ativos**, escolha o app da Meta que quer usar.
|
|
99
|
-
- Selecione **Salvar alterações** para salvar as configurações e retornar à tela principal do
|
|
98
|
+
- No painel lateral esquerdo, em **Selecionar tipo de ativo**, escolha **Apps**. Em **Selecionar ativos**, escolha o app da Meta que quer usar. Seu app precisa ter as permissões corretas. Habilite a opção **Desenvolver app** correspondente.
|
|
99
|
+
- Selecione **Salvar alterações** para salvar as configurações e retornar à tela principal do usuário do sistema.
|
|
100
100
|
- Agora, está tudo pronto para gerar o token. Na tela principal do usuário do sistema, clique em **Gerar token** e selecione o app da Meta.
|
|
101
101
|
- Depois de selecionar o app, você verá uma lista de permissões disponíveis. Selecione `whatsapp_business_management`, `whatsapp_business_messaging` e `whatsapp_business_manage_events`. Clique em **Gerar token**.
|
|
102
102
|
- Uma nova janela abrirá com o usuário do sistema, o app atribuído e o token de acesso. Salve o token.
|
|
@@ -105,9 +105,9 @@ Para gerar um token de acesso do usuário do sistema:
|
|
|
105
105
|
|
|
106
106
|
### Etapa 2: configurar webhooks
|
|
107
107
|
|
|
108
|
-
Com
|
|
108
|
+
Com webhooks configurados, você recebe notificações HTTP em tempo real da Plataforma do WhatsApp Business. Isso significa que você receberá uma notificação quando um cliente enviar uma mensagem ou quando houver mudanças na sua conta do WhatsApp Business (WABA), por exemplo.
|
|
109
109
|
|
|
110
|
-
Para configurar o ponto de extremidade do webhook, é necessário criar um servidor da web que usa a internet com
|
|
110
|
+
Para configurar o ponto de extremidade do webhook, é necessário criar um servidor da web que usa a internet com um URL que atenda aos requisitos da Meta e do WhatsApp. Para ver mais informações, consulte nosso documento [Webhooks](/documentation/business-messaging/whatsapp/webhooks/overview). Se precisar de um ponto de extremidade para fins de teste, [implemente um app de teste](/documentation/business-messaging/whatsapp/webhooks/set-up-whatsapp-echo-bot) que descarrega as cargas do webhook no seu console.
|
|
111
111
|
|
|
112
112
|
#### Configuração do app
|
|
113
113
|
|
|
@@ -115,11 +115,11 @@ Quando o ponto de extremidade estiver pronto, configure-o para ser usado pelo se
|
|
|
115
115
|
|
|
116
116
|
No Painel de Apps, acesse **WhatsApp** > **Configuração** e clique no botão **Editar**.
|
|
117
117
|
|
|
118
|
-
-
|
|
118
|
+
- URL de retorno de chamada: o URL para o qual a Meta enviará os eventos. Consulte o guia de [introdução aos webhooks](/docs/graph-api/webhooks/getting-started) para ver mais informações sobre como criar o URL.- Token de verificação: essa string é configurada por você ao criar o ponto de extremidade de webhook.
|
|
119
119
|
|
|
120
120
|
Depois de adicionar essas informações, clique em **Verificar e salvar**.
|
|
121
121
|
|
|
122
|
-
Depois de salvar, volte ao painel **Configuração**, clique no botão **Gerenciar** e assine os campos específicos do webhook. Para receber notificações de mensagens de clientes, assine o campo de webhook **
|
|
122
|
+
Depois de salvar, volte ao painel **Configuração**, clique no botão **Gerenciar** e assine os campos específicos do webhook. Para receber notificações de mensagens de clientes, assine o campo de webhook **messages**.
|
|
123
123
|
|
|
124
124
|
O Webhooks precisa ser configurado apenas uma vez em cada app. É possível usar o mesmo Webhook para receber diferentes tipos de evento de várias contas do WhatsApp Business ou configurar uma substituição. Para saber mais, consulte a seção sobre Webhooks.
|
|
125
125
|
|
|
@@ -133,13 +133,13 @@ curl -X POST \
|
|
|
133
133
|
-H 'Authorization: Bearer <ACCESS_TOKEN>'
|
|
134
134
|
```
|
|
135
135
|
|
|
136
|
-
Se você receber a resposta abaixo, todos os eventos de
|
|
136
|
+
Se você receber a resposta abaixo, todos os eventos de webhook referentes aos números de telefone da conta serão enviados para o ponto de extremidade de webhook que foi configurado.
|
|
137
137
|
|
|
138
138
|
```
|
|
139
139
|
{ "success": true}
|
|
140
140
|
```
|
|
141
141
|
|
|
142
|
-
### Etapa 4: receber
|
|
142
|
+
### Etapa 4: receber a identificação do número de telefone
|
|
143
143
|
|
|
144
144
|
Para enviar mensagens, é preciso registrar o número de telefone que você quer usar. Para registrar o número, é preciso obter a identificação dele. Para isso, faça a seguinte chamada de API:
|
|
145
145
|
|
|
@@ -159,17 +159,17 @@ Salve a identificação do número de telefone que você quer registrar. Para ma
|
|
|
159
159
|
|
|
160
160
|
#### Exceção na migração
|
|
161
161
|
|
|
162
|
-
Se você estiver migrando um número de telefone da API Local para a API de Nuvem, precisará cumprir etapas adicionais antes de registrar um número com a API de Nuvem.
|
|
162
|
+
Se você estiver migrando um número de telefone da API Local para a API de Nuvem, precisará cumprir etapas adicionais antes de registrar um número com a API de Nuvem. Leia [Migrar da API Local para a API de Nuvem](/documentation/business-messaging/whatsapp/support/migrating-from-onprem-to-cloud) e confira o processo completo.
|
|
163
163
|
|
|
164
164
|
### Etapa 5: registrar um número de telefone
|
|
165
165
|
|
|
166
|
-
É possível fazer o
|
|
166
|
+
É possível fazer o registro com a identificação do número de telefone em mãos. Na chamada de API de registro, você realiza duas ações ao mesmo tempo:
|
|
167
167
|
|
|
168
|
-
- Registrar o telefone.- [
|
|
168
|
+
- Registrar o telefone.- [Habilitar a confirmação em duas etapas](/documentation/business-messaging/whatsapp/business-phone-numbers/two-step-verification) por meio de um código de cadastro de seis dígitos. Esse código deve ser configurado por você. Salve e memorize esse código, pois ele pode ser solicitado posteriormente.
|
|
169
169
|
|
|
170
170
|
**A configuração da autenticação de dois fatores é obrigatória para usar a API de Nuvem. Se não fizer isso, você receberá uma mensagem de falha na integração:**
|
|
171
171
|
|
|
172
|
-
|
|
173
173
|
|
|
174
174
|
Exemplo de solicitação:
|
|
175
175
|
|
|
@@ -187,15 +187,15 @@ Exemplo de resposta:
|
|
|
187
187
|
{ "success": true}
|
|
188
188
|
```
|
|
189
189
|
|
|
190
|
-
#### Usuários do
|
|
190
|
+
#### Usuários do Cadastro Incorporado
|
|
191
191
|
|
|
192
|
-
**É necessário** registrar um número de telefone até 14 dias após o flow Cadastro
|
|
192
|
+
**É necessário** registrar um número de telefone até 14 dias após o flow Cadastro Incorporado. Se o número não for cadastrado nesse período, será preciso realizar o flow novamente antes de fazer o registro.
|
|
193
193
|
|
|
194
194
|
### Etapa 6: receber uma mensagem do app do consumidor
|
|
195
195
|
|
|
196
196
|
Quando um cliente participante envia uma mensagem para a empresa, você tem **24 horas de mensagens gratuitas com ele**. Esse espaço de tempo é chamado de janela de atendimento ao cliente. Para fins de teste, queremos habilitar essa janela para que você envie quantas mensagens quiser.
|
|
197
197
|
|
|
198
|
-
A partir de um app iOS ou Android, envie uma mensagem ao número de telefone que você acabou de cadastrar. Quando ela for enviada, você receberá uma mensagem no seu
|
|
198
|
+
A partir de um app iOS ou Android, envie uma mensagem ao número de telefone que você acabou de cadastrar. Quando ela for enviada, você receberá uma mensagem no seu webhook com uma notificação no formato abaixo.
|
|
199
199
|
|
|
200
200
|
```
|
|
201
201
|
{ "object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "16315551234", "phone_number_id": "PHONE_NUMBER_ID" }, "contacts": [ { "profile": { "name": "Kerry Fisher" }, "wa_id": "16315555555" } ], "messages": [ { "from": "16315555555", "id": "wamid.ABGGFlA5FpafAgo6tHcNmNjXmuSf", "timestamp": "1602139392", "text": { "body": "Hello!" }, "type": "text" } ] }, "field": "messages" } ] } ]}
|
|
@@ -203,7 +203,7 @@ A partir de um app iOS ou Android, envie uma mensagem ao número de telefone que
|
|
|
203
203
|
|
|
204
204
|
### Etapa 7: enviar uma mensagem de teste
|
|
205
205
|
|
|
206
|
-
|
|
206
|
+
Depois de habilitar a janela de atendimento ao cliente, envie uma mensagem de teste para o número de telefone do consumidor usado na etapa anterior. Para isso, faça a seguinte chamada de API:
|
|
207
207
|
|
|
208
208
|
```
|
|
209
209
|
curl -X POST \
|
|
@@ -213,7 +213,7 @@ curl -X POST \
|
|
|
213
213
|
-d '{"messaging_product": "whatsapp", "to": "16315555555","text": {"body" : "hello world!"}}'
|
|
214
214
|
```
|
|
215
215
|
|
|
216
|
-
Se a chamada for bem-sucedida, a resposta incluirá
|
|
216
|
+
Se a chamada for bem-sucedida, a resposta incluirá uma identificação da mensagem. Use essa identificação para acompanhar o progresso das mensagens por meio de Webhooks. A identificação pode ter até 128 caracteres.
|
|
217
217
|
|
|
218
218
|
Exemplo de resposta:
|
|
219
219
|
|
|
@@ -221,7 +221,7 @@ Exemplo de resposta:
|
|
|
221
221
|
{ "id":"wamid.gBGGFlaCGg0xcvAdgmZ9plHrf2Mh-o"}
|
|
222
222
|
```
|
|
223
223
|
|
|
224
|
-
Com a API de Nuvem, não há uma forma de verificar de forma explícita se um número de telefone tem uma identificação do WhatsApp. Para enviar uma mensagem usando essa API, envie-a diretamente para o número de telefone do cliente do WhatsApp depois que ele [aceitar receber mensagens](/documentation/business-messaging/whatsapp/getting-opt-in).
|
|
224
|
+
Com a API de Nuvem, não há uma forma de verificar de forma explícita se um número de telefone tem uma identificação do WhatsApp. Para enviar uma mensagem usando essa API, envie-a diretamente para o número de telefone do cliente do WhatsApp depois que ele [aceitar receber mensagens](/documentation/business-messaging/whatsapp/getting-opt-in). Consulte [Como enviar mensagens](/documentation/business-messaging/whatsapp/messages/send-messages).
|
|
225
225
|
|
|
226
226
|
## Acompanhar as atualizações mensais
|
|
227
227
|
|
|
@@ -237,13 +237,13 @@ O WhatsApp desenvolve e opera a API do WhatsApp Business, que permite que as emp
|
|
|
237
237
|
|
|
238
238
|
**Há custos adicionais para a API de Nuvem?**
|
|
239
239
|
|
|
240
|
-
O acesso à API de Nuvem é gratuito
|
|
240
|
+
O acesso à API de Nuvem é gratuito. Esperamos que ela gere economias de custo adicionais para os desenvolvedores, pois é hospedada e mantida pela Meta.
|
|
241
241
|
|
|
242
242
|
### Perguntas frequentes sobre implementação técnica
|
|
243
243
|
|
|
244
244
|
**Qual é a arquitetura da API de Nuvem?**
|
|
245
245
|
|
|
246
|
-
A arquitetura da API de Nuvem simplifica significativamente os requisitos operacionais e de infraestrutura do parceiro de soluções para a integração com a Plataforma do WhatsApp Business. Primeiro, ela elimina os requisitos de infraestrutura para executar contêineres do Docker da API do WhatsApp Business (economias de CAPEX). Em segundo lugar, ela elimina a necessidade de responsabilidades operacionais para gerenciar a implantação (economias de OPEX). . Em segundo lugar, ela elimina a necessidade de responsabilidades operacionais para gerenciar a implantação (economias de OPEX). 
|
|
247
247
|
|
|
248
248
|
**Como será a recuperação de desastre: se uma região estiver indisponível, quanto tempo levará para mover as mensagens para outra região?**
|
|
249
249
|
|
|
@@ -253,11 +253,11 @@ Teremos recuperação de desastres e replicação de dados em várias regiões.
|
|
|
253
253
|
|
|
254
254
|
**Onde ficam os servidores da API de Nuvem?**
|
|
255
255
|
|
|
256
|
-
A API de Nuvem processa mensagens em servidores dos data centers da Meta, que estão localizados [neste link](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatacenters.atmeta.com%2Fall-locations%2F&h=
|
|
256
|
+
A API de Nuvem processa mensagens em servidores dos data centers da Meta, que estão localizados [neste link](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatacenters.atmeta.com%2Fall-locations%2F&h=AT2AyH7J6bKWTS-sOnrCZAjuE1liG_EPGqpikOGvUwQe3LQg1TkFGMFW_nPKCYdhHnZgeHSXC29y4J5N6awhI_oJY7fxedG1U_AiEYzy7D14rUaiPuIjSBrofr_ftDsFbRIy2lMFmzVubDuj96UTLFAhkC8). Se a empresa optar por usar o Armazenamento Local da API de Nuvem, os dados de mensagens serão armazenados em data centers localizados em outro país designado. Uma lista de locais compatíveis com o Armazenamento Local é fornecida [neste link](/documentation/business-messaging/whatsapp/business-phone-numbers/registration#limitations).
|
|
257
257
|
|
|
258
258
|
**A API de Nuvem é criptografada de ponta a ponta? Qual é o modelo de criptografia?**
|
|
259
259
|
|
|
260
|
-
|
|
260
|
+
Consulte [Visão geral da API de Nuvem, Criptografia](/documentation/business-messaging/whatsapp/about-the-platform#encryption).
|
|
261
261
|
|
|
262
262
|
**O que acontece com os dados de mensagens em repouso? Por quanto tempo eles são armazenados?**
|
|
263
263
|
|
|
@@ -265,9 +265,9 @@ As mensagens da API de Nuvem em repouso são criptografadas. As mensagens são r
|
|
|
265
265
|
|
|
266
266
|
**A Meta tem acesso a chaves de criptografia?**
|
|
267
267
|
|
|
268
|
-
Para enviar e receber mensagens por meio da API de Nuvem, essa API gerencia as chaves de criptografia/descriptografia em nome da empresa. Para saber mais,
|
|
268
|
+
Para enviar e receber mensagens por meio da API de Nuvem, essa API gerencia as chaves de criptografia/descriptografia em nome da empresa. Para saber mais, leia o [Relatório técnico Visão Geral da Criptografia do WhatsApp](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.whatsapp.com%2Fsecurity%2FWhatsApp-Security-Whitepaper.pdf&h=AT2AyH7J6bKWTS-sOnrCZAjuE1liG_EPGqpikOGvUwQe3LQg1TkFGMFW_nPKCYdhHnZgeHSXC29y4J5N6awhI_oJY7fxedG1U_AiEYzy7D14rUaiPuIjSBrofr_ftDsFbRIy2lMFmzVubDuj96UTLFAhkC8).
|
|
269
269
|
|
|
270
|
-
### Perguntas frequentes sobre conformidade
|
|
270
|
+
### Perguntas frequentes sobre conformidade regulatória
|
|
271
271
|
|
|
272
272
|
**Como a API de Nuvem cumpre as leis regionais de proteção de dados (como o RGPD, a LGPD e a PDPB)?**
|
|
273
273
|
|