whatsapp-docs-mcp 1.0.7 → 1.0.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/docs/ativos_da_conta/telefones_comerciais/phone_numbers.md +40 -42
- package/docs/business_scoped_user_ids.md +855 -244
- package/docs/dados_privacidade_e_politica/encryption.md +1 -1
- package/docs/dados_privacidade_e_politica/local_storage.md +33 -33
- package/docs/flows/changelog.md +7 -7
- package/docs/flows/gettingstarted/health_insurance.md +8 -14
- package/docs/flows/gettingstarted/personalised_offer.md +8 -8
- package/docs/flows/gettingstarted/pre_approved_loan.md +8 -8
- package/docs/flows/gettingstarted/purchase_intent.md +3 -3
- package/docs/flows/gettingstarted.md +6 -6
- package/docs/flows/guias.md +2 -2
- package/docs/flows/playground.md +2 -2
- package/docs/flows/referencia.md +2 -2
- package/docs/flows/support.md +4 -4
- package/docs/flows.md +7 -7
- package/docs/insights/analytics.md +130 -28
- package/docs/ligacoes/sip.md +53 -97
- package/docs/ligacoes/video_calling.md +1 -1
- package/docs/mensagens/interactive_product_carousel_messages.md +9 -11
- package/docs/mensagens/recursos_adicionais/payload_encryption.md +1 -1
- 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/features.md +4 -4
- package/docs/mensagens_de_marketing/implementacao/get_started.md +7 -6
- package/docs/mensagens_de_marketing/implementacao/onboard_business_customers.md +160 -58
- package/docs/mensagens_de_marketing/implementacao/send_marketing_messages.md +83 -39
- package/docs/mensagens_de_marketing/onboarding.md +11 -11
- 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 +2 -2
- package/docs/messaging_limits/upcoming_changes.md +1 -1
- package/docs/modelos/gerenciamento_de_modelos/template_media.md +1 -1
- package/docs/modelos/modelos_de_autenticacao/authentication_best_practices.md +78 -17
- package/docs/modelos/modelos_de_marketing/per_user_limits.md +4 -2
- package/docs/pagamentos/pagamentos_na_india/overview.md +21 -21
- package/docs/pagamentos/payments_br/cards.md +1 -1
- package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/manage_webhooks.md +23 -39
- package/docs/parceiros/gerenciamento/gerenciar_ativos_do_cliente/share_and_revoke_credit_lines.md +16 -16
- package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_phone_numbers_among_solution_partners_programmatically.md +33 -33
- package/docs/parceiros/gerenciamento/suporte_ao_parceiro/transferring_wabas_to_customers.md +1 -1
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/implementation.md +35 -33
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/onboarding_business_app_users.md +98 -24
- package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/versions/version_3.md +9 -9
- package/docs/parceiros/integracao_de_clientes/outras_opcoes_de_integracao/multi_partner_solutions.md +55 -57
- package/docs/recado/precos/ai_providers.md +80 -0
- package/docs/recado/precos/pricing.md +208 -78
- package/docs/recado/precos/pricing_updates_to_pricing.md +1 -1
- package/docs/recado/sobre_a_plataforma/access_tokens.md +22 -22
- package/docs/referencia/bot_do_whatsapp_business/bot_details_api.md +758 -4
- package/docs/referencia/business/add_phone_numbers_api.md +722 -4
- package/docs/referencia/business/business_account_api.md +164 -4
- package/docs/referencia/business/client_whatsapp_business_accounts_api.md +1002 -4
- package/docs/referencia/business/owned_whatsapp_business_accounts.md +798 -4
- package/docs/referencia/business/whatsapp_business_accounts_api.md +1546 -4
- package/docs/referencia/business/whatsapp_business_partner_onboarding_to_mm_lite_api.md +779 -4
- package/docs/referencia/business/whatsapp_business_pre_verified_phone_number_sharing_api.md +786 -4
- package/docs/referencia/business/whatsapp_business_pre_verified_phone_numbers_api.md +882 -4
- package/docs/referencia/changelog.md +89 -23
- package/docs/referencia/conta_do_whatsapp_business/assigned_users_management_api.md +2194 -4
- package/docs/referencia/conta_do_whatsapp_business/business_account_api.md +263 -4
- package/docs/referencia/conta_do_whatsapp_business/business_account_extended_credits_api.md +271 -4
- package/docs/referencia/conta_do_whatsapp_business/conversational_automation_api.md +778 -4
- package/docs/referencia/conta_do_whatsapp_business/flows_api.md +1518 -4
- 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 +1577 -4
- 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 +1682 -4
- package/docs/referencia/conta_do_whatsapp_business/schedules_api.md +1768 -4
- 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 +2174 -4
- package/docs/referencia/conta_do_whatsapp_business/template_api.md +972 -4
- package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_activities_api.md +838 -4
- package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_api.md +1380 -4
- package/docs/referencia/conta_do_whatsapp_business/whatsapp_business_account_solutions_list_api.md +850 -4
- package/docs/referencia/groups/groups_invite_link_api.md +300 -4
- package/docs/referencia/groups/groups_join_requests_api.md +682 -4
- package/docs/referencia/groups/groups_participants_api.md +270 -4
- package/docs/referencia/groups/groups_query_api.md +432 -4
- package/docs/referencia/grupo/groups_invite_link_api.md +300 -4
- package/docs/referencia/grupo/groups_join_requests_api.md +682 -4
- package/docs/referencia/grupo/groups_participants_api.md +270 -4
- package/docs/referencia/grupo/groups_query_api.md +432 -4
- package/docs/referencia/historico_de_mensagens/whatsapp_business_message_history_events_api.md +862 -4
- package/docs/referencia/inscricao/application_connected_client_businesses.md +808 -4
- package/docs/referencia/inscricao/application_solutions_api.md +870 -4
- package/docs/referencia/inscricao/solution_creation_api.md +820 -4
- package/docs/referencia/intencao_de_migracao_da_conta_do_whatsapp_business/migration_intent_details_api.md +720 -4
- package/docs/referencia/midias/media_api.md +338 -4
- package/docs/referencia/midias/media_download_api.md +156 -4
- package/docs/referencia/numero_da_conta_do_whatsapp/whatsapp_account_number_api.md +774 -4
- package/docs/referencia/perfil_do_whatsapp_business/whatsapp_business_profile_node_api.md +1490 -4
- package/docs/referencia/solucao_do_whatsapp_business/accept_deactivation_request_api.md +758 -4
- package/docs/referencia/solucao_do_whatsapp_business/access_token_api.md +700 -4
- package/docs/referencia/solucao_do_whatsapp_business/reject_deactivation_request_api.md +808 -4
- package/docs/referencia/solucao_do_whatsapp_business/send_deactivation_request_api.md +774 -4
- package/docs/referencia/solucao_do_whatsapp_business/solution_accept_api.md +808 -4
- package/docs/referencia/solucao_do_whatsapp_business/solution_details_api.md +764 -4
- package/docs/referencia/solucao_do_whatsapp_business/solution_reject_api.md +794 -4
- package/docs/referencia/telefone_do_whatsapp_business/block_api.md +538 -4
- package/docs/referencia/telefone_do_whatsapp_business/business_compliance_information_api.md +1604 -4
- package/docs/referencia/telefone_do_whatsapp_business/business_encryption_api.md +1396 -4
- package/docs/referencia/telefone_do_whatsapp_business/calling_api.md +594 -4
- package/docs/referencia/telefone_do_whatsapp_business/encrypted_messages_api.md +1 -1
- package/docs/referencia/telefone_do_whatsapp_business/groups_management_api.md +481 -4
- package/docs/referencia/telefone_do_whatsapp_business/marketing_messages_lite_api.md +311 -4
- package/docs/referencia/telefone_do_whatsapp_business/media_upload_api.md +184 -4
- package/docs/referencia/telefone_do_whatsapp_business/message_api.md +1794 -4
- package/docs/referencia/telefone_do_whatsapp_business/phone_number_api.md +373 -4
- package/docs/referencia/telefone_do_whatsapp_business/phone_number_deregister_api.md +710 -4
- package/docs/referencia/telefone_do_whatsapp_business/phone_number_registration.md +776 -4
- package/docs/referencia/telefone_do_whatsapp_business/phone_number_verification_request_code_api.md +730 -4
- package/docs/referencia/telefone_do_whatsapp_business/register_api.md +405 -4
- package/docs/referencia/telefone_do_whatsapp_business/settings_api.md +670 -4
- package/docs/referencia/telefone_do_whatsapp_business/verify_code_api.md +742 -4
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_message_history_api.md +1 -1
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_official_business_account_status_api.md +1536 -4
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_account_phone_number_api.md +1596 -4
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_profile_api.md +1474 -4
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_qr_code_api.md +1175 -4
- package/docs/referencia/telefone_do_whatsapp_business/whatsapp_business_qr_code_management_api.md +1311 -4
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/request_verification_code_api.md +774 -4
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/verify_code_api.md +764 -4
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/whatsapp_business_pre_verified_phone_number_api.md +1378 -4
- package/docs/referencia/telefone_pre_verificado_do_whatsapp_business/whatsapp_business_pre_verified_phone_number_partners_api.md +816 -4
- package/docs/referencia/usuario/assigned_whatsapp_business_accounts_api.md +860 -4
- package/docs/referencia/webhooks/whatsapp_incoming_webhook_payload.md +1651 -4
- package/docs/referencia/whatsapp_business_account/extended_credits_api.md +166 -4
- package/docs/referencia/whatsapp_business_phone_number/commerce_settings_api.md +292 -4
- package/docs/suporte/migrating_from_onprem_to_cloud.md +4 -218
- package/docs/throughput.md +12 -12
- package/docs/visao_geral/overview.md +91 -127
- package/docs/webhooks/reference/messages/edit.md +126 -0
- package/docs/webhooks/reference/messages/revoke.md +90 -0
- package/docs/webhooks/visao_geral/message_echoes.md +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -20,7 +20,7 @@ Tanto o **Cursor** quanto o **Claude Desktop** usam o mesmo método de configura
|
|
|
20
20
|
"mcpServers": {
|
|
21
21
|
"whatsapp-docs-mcp": {
|
|
22
22
|
"command": "npx",
|
|
23
|
-
"args": ["whatsapp-docs-mcp"],
|
|
23
|
+
"args": ["whatsapp-docs-mcp@latest"],
|
|
24
24
|
"env": {
|
|
25
25
|
"MCP_MODE": "stdio",
|
|
26
26
|
"LOG_LEVEL": "error"
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers -->
|
|
2
|
-
<!-- Scraped: 2026-
|
|
2
|
+
<!-- Scraped: 2026-03-10T21:36:43.860Z -->
|
|
3
3
|
|
|
4
4
|
# Números de telefone comerciais
|
|
5
5
|
|
|
6
|
-
Updated:
|
|
6
|
+
Updated: 27 de fev de 2026
|
|
7
7
|
|
|
8
8
|
Este documento descreve os números de telefone comerciais do WhatsApp, bem como os requisitos, as informações de gerenciamento e os recursos únicos relacionados.
|
|
9
9
|
|
|
@@ -11,7 +11,7 @@ Este documento descreve os números de telefone comerciais do WhatsApp, bem como
|
|
|
11
11
|
|
|
12
12
|
É preciso registrar um número de telefone comercial válido para enviar e receber mensagens via API de Nuvem. Os números registrados ainda funcionam para fins gerais, como ligações e mensagens de texto, mas não podem ser usados com o WhatsApp Messenger ("WhatsApp").
|
|
13
13
|
|
|
14
|
-
Os números que já estiverem em uso no WhatsApp não poderão ser registrados, a menos que sejam [excluídos](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F2138577903196467%2F%3Fhelpref%3Duf_share&h=
|
|
14
|
+
Os números que já estiverem em uso no WhatsApp não poderão ser registrados, a menos que sejam [excluídos](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F2138577903196467%2F%3Fhelpref%3Duf_share&h=AT5a-FFlmOmSzBfGvZ4HIvKXn8tvzybFsrMyUTflTkMVwiBELpOdEZmS10UUMGeg9eYUxy-p5bhNRmofL_DxB7auXlsn-oCDt3Rgd8RDpkfdIaE8ylF9KiJXsrcmSyURTwPQ-qND0bdjTx3GnbxqVm6l6c0) primeiro. Se o seu número for banido do WhatsApp e você quiser registrá-lo, primeiro será preciso cancelar o banimento por meio do [processo de apelação](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F465883178708358&h=AT5a-FFlmOmSzBfGvZ4HIvKXn8tvzybFsrMyUTflTkMVwiBELpOdEZmS10UUMGeg9eYUxy-p5bhNRmofL_DxB7auXlsn-oCDt3Rgd8RDpkfdIaE8ylF9KiJXsrcmSyURTwPQ-qND0bdjTx3GnbxqVm6l6c0).
|
|
15
15
|
|
|
16
16
|
Após a conclusão das etapas descritas no nosso documento [Introdução](/documentation/business-messaging/whatsapp/get-started), um número de telefone comercial de **teste** será gerado e registrado para você automaticamente.
|
|
17
17
|
|
|
@@ -19,13 +19,13 @@ Após a conclusão das etapas descritas no nosso documento [Introdução](/docum
|
|
|
19
19
|
|
|
20
20
|
Os números de telefone qualificados devem:
|
|
21
21
|
|
|
22
|
-
- pertencer a você- ter código do país e código de área (códigos curtos não são compatíveis)- poder receber chamadas de voz ou SMS- o número deve ter [recursos dimensionados](https://www.facebook.com/business/help/595597942906808)
|
|
22
|
+
- pertencer a você- ter código do país e código de área (códigos curtos não são compatíveis)- poder receber chamadas de voz ou SMS- o número deve ter [recursos dimensionados](https://www.facebook.com/business/help/595597942906808)
|
|
23
23
|
|
|
24
24
|
Para registrar um número 0800, consulte [0800 e números gratuitos](#1-800-and-toll-free-numbers).
|
|
25
25
|
|
|
26
26
|
### Métodos de registro
|
|
27
27
|
|
|
28
|
-
- **Painel de Apps:** conclua as etapas descritas no nosso documento [Introdução](/documentation/business-messaging/whatsapp/get-started), caso ainda não tenha feito isso, e use o painel [Painel de Apps](https://developers.facebook.com/apps) > **WhatsApp** > **Configuração da API** para adicionar um número de telefone.- **Meta Business Suite:** você pode registrar um número de telefone comercial ao [usar o Meta Business Suite para criar uma conta do WhatsApp Business](/documentation/business-messaging/whatsapp/whatsapp-business-accounts#create-a-waba-via-meta-business-suite).- **Gerenciador do WhatsApp**: consulte o artigo [Como conectar seu número de telefone à sua conta do WhatsApp Business](https://www.facebook.com/business/help/456220311516626) na Central de Ajuda.- **Cadastro incorporado**: se você estiver trabalhando com um parceiro de soluções, ele fornecerá um link para o cadastro incorporado, que poderá ser usado para registrar um número.
|
|
28
|
+
- **Painel de Apps:** conclua as etapas descritas no nosso documento [Introdução](/documentation/business-messaging/whatsapp/get-started), caso ainda não tenha feito isso, e use o painel [Painel de Apps](https://developers.facebook.com/apps) > **WhatsApp** > **Configuração da API** para adicionar um número de telefone.- **Meta Business Suite:** você pode registrar um número de telefone comercial ao [usar o Meta Business Suite para criar uma conta do WhatsApp Business](/documentation/business-messaging/whatsapp/whatsapp-business-accounts#create-a-waba-via-meta-business-suite).- **Gerenciador do WhatsApp**: consulte o artigo [Como conectar seu número de telefone à sua conta do WhatsApp Business](https://www.facebook.com/business/help/456220311516626) na Central de Ajuda.- **Cadastro incorporado**: se você estiver trabalhando com um parceiro de soluções, ele fornecerá um link para o cadastro incorporado, que poderá ser usado para registrar um número.
|
|
29
29
|
|
|
30
30
|
## Tipos de número de telefone comercial
|
|
31
31
|
|
|
@@ -157,9 +157,9 @@ Os números de telefone comerciais têm um status, que reflete a classificação
|
|
|
157
157
|
|
|
158
158
|
### Como ver o status via Gerenciador do WhatsApp
|
|
159
159
|
|
|
160
|
-
O status atual do seu número de telefone comercial é exibido na coluna **Status** no painel [Gerenciador do WhatsApp](https://business.facebook.com/latest/whatsapp_manager/) > **Ferramentas da conta** > **Números de telefone**.
|
|
160
|
+
O status atual do seu número de telefone comercial é exibido na coluna **Status** no painel [Gerenciador do WhatsApp](https://business.facebook.com/latest/whatsapp_manager/) > **Ferramentas da conta** > **Números de telefone**.
|
|
161
161
|
|
|
162
|
-
Consulte o artigo [Sobre a classificação por qualidade do seu número de telefone do WhatsApp Business](https://www.facebook.com/business/help/896873687365001) para saber mais sobre as classificações de qualidade e o status que aparecem no Gerenciador do WhatsApp.
|
|
162
|
+
Consulte o artigo [Sobre a classificação por qualidade do seu número de telefone do WhatsApp Business](https://www.facebook.com/business/help/896873687365001) para saber mais sobre as classificações de qualidade e o status que aparecem no Gerenciador do WhatsApp.
|
|
163
163
|
|
|
164
164
|
### Como receber o status via API
|
|
165
165
|
|
|
@@ -168,7 +168,7 @@ Peça o campo `status` na sua identificação de número de telefone do WhatsApp
|
|
|
168
168
|
#### Exemplo de pedido
|
|
169
169
|
|
|
170
170
|
```
|
|
171
|
-
curl 'https://graph.facebook.com/
|
|
171
|
+
curl 'https://graph.facebook.com/v25.0/106540352242922?fields=status' \
|
|
172
172
|
-H 'Authorization: Bearer EAAJB...'
|
|
173
173
|
```
|
|
174
174
|
|
|
@@ -182,19 +182,19 @@ curl 'https://graph.facebook.com/v24.0/106540352242922?fields=status' \
|
|
|
182
182
|
|
|
183
183
|
Para registrar um número de telefone comercial, é preciso fornecer informações de nome de exibição. O nome de exibição aparece no perfil do WhatsApp do seu número de telefone comercial e também pode ser mostrado na parte superior de **conversas individuais** e na **lista de conversas** se determinadas condições forem atendidas. Consulte o documento [Nomes de exibição](/documentation/business-messaging/whatsapp/display-names) para saber como funcionam os nomes de exibição.
|
|
184
184
|
|
|
185
|
-

|
|
186
186
|
|
|
187
187
|
## Perfis empresariais
|
|
188
188
|
|
|
189
189
|
O perfil empresarial fornece informações adicionais sobre sua empresa, como endereço, site, descrição, entre outras. Você pode fornecer essas informações ao registrar o número de telefone comercial. Consulte o documento [Perfis comerciais](/documentation/business-messaging/whatsapp/business-profiles) para saber como os perfis comerciais funcionam.
|
|
190
190
|
|
|
191
|
-

|
|
192
192
|
|
|
193
|
-
## Status
|
|
193
|
+
## Status da conta comercial oficial
|
|
194
194
|
|
|
195
|
-
Os números de telefone comerciais podem receber o status
|
|
195
|
+
Os números de telefone comerciais podem receber o status da conta comercial oficial ("OBA", nas iniciais em inglês). Os números de OBA têm uma marca de seleção azul ao lado do nome na visualização de contatos.
|
|
196
196
|
|
|
197
|
-

|
|
198
198
|
|
|
199
199
|
Consulte o documento sobre [contas comerciais oficiais](/documentation/business-messaging/whatsapp/official-business-accounts) para saber como pedir o status de OBA para um número de telefone comercial.
|
|
200
200
|
|
|
@@ -206,7 +206,7 @@ Consulte o documento sobre [contas comerciais oficiais](/documentation/business-
|
|
|
206
206
|
|
|
207
207
|
Você precisará do código de identificação pessoal atual para alterar seu PIN via Gerenciador do WhatsApp. Para alterar seu PIN:
|
|
208
208
|
|
|
209
|
-
- Acesse [Gerenciador do WhatsApp](https://business.facebook.com/latest/whatsapp_manager/) > **Ferramentas da conta** > **Números de telefone**.- Selecione o número de telefone da empresa.- Clique na aba **Confirmação em duas etapas**.- Clique no botão **Alterar PIN** e complete o flow.
|
|
209
|
+
- Acesse [Gerenciador do WhatsApp](https://business.facebook.com/latest/whatsapp_manager/) > **Ferramentas da conta** > **Números de telefone**.- Selecione o número de telefone da empresa.- Clique na aba **Confirmação em duas etapas**.- Clique no botão **Alterar PIN** e complete o flow.
|
|
210
210
|
|
|
211
211
|
Caso você não tenha seu PIN, será possível alterá-lo usando a API.
|
|
212
212
|
|
|
@@ -217,7 +217,7 @@ Use o ponto de extremidade [POST /<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>](/docu
|
|
|
217
217
|
#### Exemplo de pedido
|
|
218
218
|
|
|
219
219
|
```
|
|
220
|
-
curl 'https://graph.facebook.com/
|
|
220
|
+
curl 'https://graph.facebook.com/v25.0/106540352242922/' \
|
|
221
221
|
-H 'Content-Type: application/json' \
|
|
222
222
|
-H 'Authorization: Bearer EAAJB...' \
|
|
223
223
|
-d '
|
|
@@ -242,7 +242,7 @@ Não é possível desabilitar a confirmação em duas etapas usando a API.
|
|
|
242
242
|
|
|
243
243
|
## 0800 e números gratuitos
|
|
244
244
|
|
|
245
|
-
Talvez você queira registrar um 0800 ou outro número gratuito na plataforma.
|
|
245
|
+
Talvez você queira registrar um 0800 ou outro número gratuito na plataforma. Em geral, esses números são associados a um sistema de IVR (resposta de voz interativa, pelas iniciais em inglês). Uma ligação de registro do WhatsApp não pode navegar por um IVR. Esse tipo de número de telefone pode ser registrado, mas é necessário que ele aceite ligação de números internacionais e redirecione o SMS ou a ligação de voz para um agente humano.
|
|
246
246
|
|
|
247
247
|
Veja as etapas para registrar números de telefone com sistema IVR:
|
|
248
248
|
|
|
@@ -254,7 +254,7 @@ Não há compatibilidade com números de telefone com sistema IVR que não podem
|
|
|
254
254
|
|
|
255
255
|
Novos portfólios empresariais são limitados inicialmente a dois números de telefone comercial registrados.
|
|
256
256
|
|
|
257
|
-
Se a empresa for [verificada](https://www.facebook.com/business/help/1095661473946872) ou você atingir o [limite de mensagens](/documentation/business-messaging/whatsapp/messaging-limits) de 2
|
|
257
|
+
Se a empresa for [verificada](https://www.facebook.com/business/help/1095661473946872) ou você atingir o [limite de mensagens](/documentation/business-messaging/whatsapp/messaging-limits) de 2 mil, aumentaremos automaticamente o limite para 20. Após o aumento, você receberá uma notificação do Meta Business Suite informando o novo limite e um webhook [business\_capability\_update](/documentation/business-messaging/whatsapp/webhooks/reference/business_capability_update) será disparado com `max_phone_numbers_per_business` definido como o novo limite.
|
|
258
258
|
|
|
259
259
|
## Verificar números de telefone
|
|
260
260
|
|
|
@@ -299,7 +299,7 @@ O código de dois caracteres [do idioma](/documentation/business-messaging/whats
|
|
|
299
299
|
### Exemplo de pedido
|
|
300
300
|
|
|
301
301
|
```
|
|
302
|
-
curl -X POST 'https://graph.facebook.com/
|
|
302
|
+
curl -X POST 'https://graph.facebook.com/v25.0/106540352242922/request_code?code_method=SMS&language=en_US' \
|
|
303
303
|
-H 'Authorization: Bearer EAAJB...'
|
|
304
304
|
```
|
|
305
305
|
|
|
@@ -331,11 +331,11 @@ O código recebido depois de fazer a chamada a `FROM_PHONE_NUMBER_ID/request_cod
|
|
|
331
331
|
|
|
332
332
|
### Exemplo
|
|
333
333
|
|
|
334
|
-
Exemplo de
|
|
334
|
+
Exemplo de solicitação:
|
|
335
335
|
|
|
336
336
|
```
|
|
337
337
|
curl -X POST \
|
|
338
|
-
'https://graph.facebook.com/
|
|
338
|
+
'https://graph.facebook.com/v25.0/FROM_PHONE_NUMBER_ID/verify_code' \
|
|
339
339
|
-H 'Authorization: Bearer ACCESS_TOKEN' \
|
|
340
340
|
-F 'code=000000'
|
|
341
341
|
```
|
|
@@ -390,13 +390,13 @@ Observação: no Brasil e no México, o prefixo extra adicionado ao número de t
|
|
|
390
390
|
|
|
391
391
|
Podemos verificar a identidade de um cliente antes de enviarmos sua mensagem para ele. Para isso, habilite a verificação de alteração de identidade no seu número de telefone comercial.
|
|
392
392
|
|
|
393
|
-
Se o cliente realizar uma ação no WhatsApp que
|
|
393
|
+
Se o cliente realizar uma ação no WhatsApp que for considerada uma alteração de identidade, a Meta gerará um novo hash de identidade para ele. Para obter esse hash ao enviar mensagem a um cliente, habilite a verificação de alteração de identidade no seu número de telefone comercial. Nesse caso, sempre que você receber ou enviar uma mensagem para um cliente sem um hash de identidade, [webhooks de mensagens recebidas](/documentation/business-messaging/whatsapp/webhooks/reference/messages#incoming-messages) ou [webhooks de mensagens de status](/documentation/business-messaging/whatsapp/webhooks/reference/messages/status) incluirão o hash dele. Assim, você pode capturar e armazenar esse hash para uso futuro.
|
|
394
394
|
|
|
395
|
-
Quando quiser usar o hash, inclua-o no pedido de envio de mensagem.
|
|
395
|
+
Quando quiser usar o hash, inclua-o no pedido de envio de mensagem. A Meta vai comparar o hash do pedido com o atual do cliente. Se eles forem iguais, a mensagem será entregue. Caso haja incompatibilidade, isso significa que a identidade do cliente foi alterada depois do seu último contato com ele. Por isso, a mensagem não será entregue. Nesse caso, enviaremos um webhook de status de mensagem com o código de erro `137000`, notificando sobre a falha e a discrepância dos hashes.
|
|
396
396
|
|
|
397
|
-
Ao receber esse tipo de webhook, considere que o número de telefone do cliente deixou de ser confiável. Para reestabelecer a confiança, verifique a identidade do cliente por meio de outro canal que não seja o WhatsApp. Depois, reenvie a mensagem com falha para a nova identidade (se houver), sem um hash.
|
|
397
|
+
Ao receber esse tipo de webhook, considere que o número de telefone do cliente deixou de ser confiável. Para reestabelecer a confiança, verifique a identidade do cliente por meio de outro canal que não seja o WhatsApp. Depois, reenvie a mensagem com falha para a nova identidade (se houver), sem um hash. Por fim, armazene o novo hash do cliente incluído no webhook de status de entrega de mensagem.
|
|
398
398
|
|
|
399
|
-
### Sintaxe
|
|
399
|
+
### Sintaxe da solicitação
|
|
400
400
|
|
|
401
401
|
Envie um pedido POST ao ponto de extremidade **Número de telefone do WhatsApp Business > Configurações** para habilitar ou desabilitar a verificação de alteração de identidade.
|
|
402
402
|
|
|
@@ -416,7 +416,7 @@ Defina `<ENABLE_IDENTITY_KEY_CHECK>` como `true` para habilitar a verificação
|
|
|
416
416
|
### Exemplo de pedido para habilitar a configuração
|
|
417
417
|
|
|
418
418
|
```
|
|
419
|
-
curl 'https://graph.facebook.com/
|
|
419
|
+
curl 'https://graph.facebook.com/v25.0/106850078877666/settings' \
|
|
420
420
|
-H 'Content-Type: application/json' \
|
|
421
421
|
-H 'Authorization: Bearer EAAJB...' \
|
|
422
422
|
-d '
|
|
@@ -427,7 +427,7 @@ curl 'https://graph.facebook.com/v24.0/106850078877666/settings' \
|
|
|
427
427
|
}'
|
|
428
428
|
```
|
|
429
429
|
|
|
430
|
-
### Exemplo de resposta
|
|
430
|
+
### Exemplo de resposta de habilitação
|
|
431
431
|
|
|
432
432
|
```
|
|
433
433
|
{ "success": true}
|
|
@@ -438,7 +438,7 @@ curl 'https://graph.facebook.com/v24.0/106850078877666/settings' \
|
|
|
438
438
|
Esta mensagem só seria entregue se o valor `recipient_identity_key_hash` correspondesse ao hash atual do cliente.
|
|
439
439
|
|
|
440
440
|
```
|
|
441
|
-
curl 'https://graph.facebook.com/
|
|
441
|
+
curl 'https://graph.facebook.com/v25.0/106850078877666/messages' \
|
|
442
442
|
-H 'Content-Type: application/json' \
|
|
443
443
|
-H 'Authorization: Bearer EAAJB...' \
|
|
444
444
|
-d '
|
|
@@ -461,7 +461,7 @@ Em webhooks de mensagens recebidas com o objeto `contacts`, como o [webhook de m
|
|
|
461
461
|
|
|
462
462
|
Em webhooks de mensagens enviadas ([webhooks de mensagens de status](/documentation/business-messaging/whatsapp/webhooks/reference/messages/status)), o hash do cliente é atribuído à propriedade `recipient_identity_key_hash` no objeto `statuses`.
|
|
463
463
|
|
|
464
|
-
##
|
|
464
|
+
## Obter o nível de taxa de transferência de dados
|
|
465
465
|
|
|
466
466
|
Use o ponto de extremidade [Número de telefone do WhatsApp Business](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-phone-number-api#Reading) para saber o [nível de taxa de transferência de dados](/documentation/business-messaging/whatsapp/throughput) atual de um número de telefone:
|
|
467
467
|
|
|
@@ -473,7 +473,7 @@ Para receber uma lista de todos os números de telefone associados a uma conta d
|
|
|
473
473
|
|
|
474
474
|
Além disso, os números de telefone podem ser classificados em ordem crescente ou decrescente de acordo com o `last_onboarded_time`, que é baseado em quando o usuário concluiu a integração do [Cadastro Incorporado](/documentation/business-messaging/whatsapp/embedded-signup/overview). Se não for especificada, a ordem padrão será decrescente.
|
|
475
475
|
|
|
476
|
-
### Sintaxe
|
|
476
|
+
### Sintaxe da solicitação
|
|
477
477
|
|
|
478
478
|
```
|
|
479
479
|
curl -X GET "https://graph.facebook.com/<API_VERSION>/<WABA_ID>/phone_numbers?access_token=<ACCESS_TOKEN>"
|
|
@@ -487,7 +487,7 @@ Em caso de sucesso, um objeto JSON será retornado com uma lista de nomes, telef
|
|
|
487
487
|
{ "data": [ { "verified_name": "Jasper's Market", "display_phone_number": "+1 631-555-5555", "id": "1906385232743451", "quality_rating": "GREEN" }, { "verified_name": "Jasper's Ice Cream", "display_phone_number": "+1 631-555-5556", "id": "1913623884432103", "quality_rating": "NA" } ]}
|
|
488
488
|
```
|
|
489
489
|
|
|
490
|
-
### Sintaxe
|
|
490
|
+
### Sintaxe da solicitação
|
|
491
491
|
|
|
492
492
|
```
|
|
493
493
|
curl -X GET "https://graph.facebook.com/<API_VERSION>/<WABA_ID>/phone_numbers?access_token=<SYSTEM_USER_ACCESS_TOKEN>]&sort=['last_onboarded_time_ascending']"
|
|
@@ -523,7 +523,7 @@ Descrição
|
|
|
523
523
|
|
|
524
524
|
**Valores:**`SANDBOX`, `LIVE`
|
|
525
525
|
|
|
526
|
-
#### Sintaxe
|
|
526
|
+
#### Sintaxe da solicitação
|
|
527
527
|
|
|
528
528
|
```
|
|
529
529
|
curl -i -X GET "https://graph.facebook.com/<API_VERSION>/<WABA_ID>/phone_numbers?filtering=[{"field":"account_mode","operator":"EQUAL","value":"SANDBOX"}]&access_token=<ACCESS_TOKEN>
|
|
@@ -539,13 +539,13 @@ curl -i -X GET "https://graph.facebook.com/<API_VERSION>/<WABA_ID>/phone_numbers
|
|
|
539
539
|
|
|
540
540
|
Para consultar informações sobre um número de telefone, envie um pedido GET ao ponto de extremidade [Número de telefone do WhatsApp Business](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-phone-number-api):
|
|
541
541
|
|
|
542
|
-
### Sintaxe
|
|
542
|
+
### Sintaxe da solicitação
|
|
543
543
|
|
|
544
544
|
```
|
|
545
545
|
GET https://graph.facebook.com/<API_VERSION>/<PHONE_NUMBER_ID>
|
|
546
546
|
```
|
|
547
547
|
|
|
548
|
-
### Exemplo de
|
|
548
|
+
### Exemplo de solicitação
|
|
549
549
|
|
|
550
550
|
```
|
|
551
551
|
curl \'https://graph.facebook.com/v15.0/105954558954427/' \-H 'Authorization: Bearer EAAFl...'
|
|
@@ -561,13 +561,13 @@ Em caso de sucesso, um objeto JSON é retornado com o nome, o número de telefon
|
|
|
561
561
|
|
|
562
562
|
Inclua `fields=name_status` como um parâmetro da string de consulta para consultar o status do nome de exibição associado a um número de telefone específico. No momento, esse campo está na versão beta e não está disponível para todos os desenvolvedores.
|
|
563
563
|
|
|
564
|
-
### Exemplo de
|
|
564
|
+
### Exemplo de solicitação
|
|
565
565
|
|
|
566
566
|
```
|
|
567
567
|
curl \'https://graph.facebook.com/v15.0/105954558954427?fields=name_status' \-H 'Authorization: Bearer EAAFl...'
|
|
568
568
|
```
|
|
569
569
|
|
|
570
|
-
###
|
|
570
|
+
### Modelo de resposta
|
|
571
571
|
|
|
572
572
|
```
|
|
573
573
|
{ "id" : "105954558954427", "name_status" : "AVAILABLE_WITHOUT_REVIEW"}
|
|
@@ -575,11 +575,9 @@ curl \'https://graph.facebook.com/v15.0/105954558954427?fields=name_status' \-
|
|
|
575
575
|
|
|
576
576
|
O valor `name_status` pode ser um dos seguintes:
|
|
577
577
|
|
|
578
|
-
- `APPROVED`: o nome foi aprovado
|
|
579
|
-
|
|
580
|
-
Os certificados têm validade de sete dias.
|
|
578
|
+
- `APPROVED`: o nome foi aprovado.- `AVAILABLE_WITHOUT_REVIEW`: o nome de exibição está pronto para ser usado sem análise.- `DECLINED`: o nome não foi aprovado.- `EXPIRED`: o certificado do número de telefone expirou e não é possível usá-lo a fim de registrar o número de telefone para uso com a API.- `PENDING_REVIEW`: o pedido de nome está em análise.- `NONE`: o número de telefone não tem um certificado e não pode ser usado ao registrar o número de telefone para uso da API.
|
|
581
579
|
|
|
582
|
-
##
|
|
580
|
+
## Excluir números de telefone comerciais
|
|
583
581
|
|
|
584
582
|
Apenas os administradores do portfólio empresarial podem excluir números de telefone comerciais. Além disso, os números não poderão ser excluídos se tiverem sido usados para enviar mensagens pagas nos últimos 30 dias.
|
|
585
583
|
|
|
@@ -587,7 +585,7 @@ Apenas os administradores do portfólio empresarial podem excluir números de te
|
|
|
587
585
|
|
|
588
586
|
Caso o número de telefone comercial tenha o status "Conectado", você precisará do seu PIN de confirmação em duas etapas para excluir o número.
|
|
589
587
|
|
|
590
|
-
- Carregue seu portfólio empresarial no [Gerenciador do WhatsApp](https://business.facebook.com/wa/manage/home/).- Se o painel Números de telefone não carregar automaticamente, navegue até **Ferramentas da conta** (ícone de caixa de ferramentas) > **Telefones**.- Clique no ícone da lixeira do número de telefone e conclua o flow.
|
|
588
|
+
- Carregue seu portfólio empresarial no [Gerenciador do WhatsApp](https://business.facebook.com/wa/manage/home/).- Se o painel Números de telefone não carregar automaticamente, navegue até **Ferramentas da conta** (ícone de caixa de ferramentas) > **Telefones**.- Clique no ícone da lixeira do número de telefone e conclua o flow.
|
|
591
589
|
|
|
592
590
|
Caso o número tenha sido usado para enviar mensagens pagas nos últimos 30 dias, redirecionaremos você para o painel **Insights**, que mostra a data da última mensagem paga. A exclusão do número de telefone poderá ser feita 30 dias após a data listada.
|
|
593
591
|
|
|
@@ -595,9 +593,9 @@ Caso o número tenha sido usado para enviar mensagens pagas nos últimos 30 dias
|
|
|
595
593
|
|
|
596
594
|
Não é possível excluir um número de telefone comercial via API.
|
|
597
595
|
|
|
598
|
-
##
|
|
596
|
+
## Migrar números de telefone comerciais
|
|
599
597
|
|
|
600
|
-
|
|
598
|
+
Você pode [migrar números de telefone de uma WABA para outra](/documentation/business-messaging/whatsapp/solution-providers/support/migrating-phone-numbers-among-solution-partners-via-embedded-signup).
|
|
601
599
|
|
|
602
600
|
## Componentes de conversa
|
|
603
601
|
|