whatsapp-docs-mcp 1.0.5 → 1.0.7

package/docs/ligacoes/pricing.md

@@ -1,9 +1,9 @@
 <!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/calling/pricing -->
-<!-- Scraped: 2025-12-20T17:42:00.606Z -->
+<!-- Scraped: 2026-01-24T00:28:56.798Z -->
 
 # Preços da API de Ligações
 
-Updated: 4 de nov de 2025
+Updated: 11 de dez de 2025
 
 **Todas as ligações iniciadas pelo usuário são gratuitas.**
 
@@ -11,26 +11,24 @@ Updated: 4 de nov de 2025
 
 As ligações iniciadas pela empresa são cobradas com base em:
 
--   Duração da ligação (calculada em pulsações de seis segundos)-   O código do país do número de telefone que recebe a ligação.-   Nível de volume (com base nos minutos de ligação no mês)
+-   Duração da ligação (calculada em pulsos de seis segundos)-   O código do país do número de telefone que recebe a ligação.-   Nível de volume (com base nos minutos de ligação no mês)
 
-Observação: nossos sistemas contam pulsações fracionárias como uma pulsação. Por exemplo, uma ligação de 56 segundos (9,33 pulsações) seria contada como 10 pulsações.
+Observação: nossos sistemas contam pulsos fracionários como um pulso. Por exemplo, uma ligação de 56 segundos (9,33 pulsos) seria contada como 10 pulsos.
 
-Para chamadas que ultrapassam os níveis de preços (por exemplo, do nível 0–50.000 para o nível 50.001–250.000), a ligação inteira é cobrada pela tarifa mais baixa (ou seja, a tarifa do nível de volume mais alto).
+Para ligações que ultrapassam os níveis de preços (por exemplo, do nível 0–50.000 para o nível 50.001–250.000), a ligação inteira é cobrada pela tarifa mais baixa (ou seja, a tarifa do nível de volume mais alto).
 
-É necessária ter uma forma de pagamento válida para fazer ligações.
+É necessário ter uma forma de pagamento válida para fazer ligações.
 
 **Observação:** as mensagens de solicitação de permissão de ligação estão sujeitas aos [preços por mensagem](/documentation/business-messaging/whatsapp/pricing).
 
 ## Tabelas de tarifas de preços baseados em volume (VBP)
 
-As tabelas de tarifas a seguir representam as tarifas atuais do VBP para a API de Ligações Comerciais do WhatsApp em vigor a partir de 1º de agosto de 2025:
+As tabelas de tarifas a seguir representam as tarifas atuais de VBP para a API de Ligações Comerciais do WhatsApp em vigor a partir de 1º de agosto de 2025:
 
--   [Tabela de tarifas em USD](https://l.facebook.com/l.php?u=https%3A%2F%2Fscontent-gru2-2.xx.fbcdn.net%2Fv%2Ft39.8562-6%2F520671944_623223040377923_7736077446508180620_n.csv%3F_nc_cat%3D102%26ccb%3D1-7%26_nc_sid%3Db8d81d%26_nc_ohc%3DQDzbN-OPYBYQ7kNvwHhaIXr%26_nc_oc%3DAdk8IiwPIYq-TpNQBdoPTJsSpR5wOYgbG-0o_I-jp0JuoT33HTSHzej0jiKF-DJbSeM%26_nc_zt%3D14%26_nc_ht%3Dscontent-gru2-2.xx%26_nc_gid%3Dde4XIdQLbsbLQs_66xSw8Q%26oh%3D00_AfmWSodMtOkxLu7lN2wWBLglnSJ20vuaHsNqGVbPKLcxLQ%26oe%3D694CA551&h=AT3tYsHQV1cOyjvcUb1apvgMohF2rVqd8OnwrCwAvtrNIo_RCDwhygWcqz4hzzEiAK4zxvdX8GpttsgaGe6b_tlgwVsL79qOP7dyGra6ahTkqkiN7DbjAJxscvVMncpDh9r_kpeeU_gRKTKGiQ3vVd9Fk5M)-   [Tabela de tarifas em INR](https://l.facebook.com/l.php?u=https%3A%2F%2Fscontent-gru2-2.xx.fbcdn.net%2Fv%2Ft39.8562-6%2F520297017_2631484657208999_4027192314064932495_n.csv%3F_nc_cat%3D105%26ccb%3D1-7%26_nc_sid%3Db8d81d%26_nc_ohc%3DBJEu9aZ6uLEQ7kNvwGW6Nqk%26_nc_oc%3DAdmZy7PUHPY8q_kEElDWqvmZRiAmkz3NmEK-S31bnR9f2R38iopUvz8f0vlIqzPKaLg%26_nc_zt%3D14%26_nc_ht%3Dscontent-gru2-2.xx%26_nc_gid%3Dde4XIdQLbsbLQs_66xSw8Q%26oh%3D00_Afmo1NuWDW8yNwQ6itvPnNeuZX5tXzGR3_olmEtw2BaNoQ%26oe%3D694CB6E7&h=AT3tYsHQV1cOyjvcUb1apvgMohF2rVqd8OnwrCwAvtrNIo_RCDwhygWcqz4hzzEiAK4zxvdX8GpttsgaGe6b_tlgwVsL79qOP7dyGra6ahTkqkiN7DbjAJxscvVMncpDh9r_kpeeU_gRKTKGiQ3vVd9Fk5M)-   [Tabela de tarifas em IDR](https://l.facebook.com/l.php?u=https%3A%2F%2Fscontent-gru2-2.xx.fbcdn.net%2Fv%2Ft39.8562-6%2F522403360_1317814323248646_3679642822059879321_n.csv%3F_nc_cat%3D105%26ccb%3D1-7%26_nc_sid%3Db8d81d%26_nc_ohc%3D7_xC3xP7GdQQ7kNvwEkG3Jp%26_nc_oc%3DAdmwiotVmcNew9q6hJiHGe996xxWRjsQPxWcXnrO1bPNNrxhntyfQPJK5PdIrI2m1n4%26_nc_zt%3D14%26_nc_ht%3Dscontent-gru2-2.xx%26_nc_gid%3Dde4XIdQLbsbLQs_66xSw8Q%26oh%3D00_Afm6JeEFH7Q2c1QKfjQVC4rT-lhfo5h0zBgGCR3cJ5WQ7w%26oe%3D694CC72E&h=AT3tYsHQV1cOyjvcUb1apvgMohF2rVqd8OnwrCwAvtrNIo_RCDwhygWcqz4hzzEiAK4zxvdX8GpttsgaGe6b_tlgwVsL79qOP7dyGra6ahTkqkiN7DbjAJxscvVMncpDh9r_kpeeU_gRKTKGiQ3vVd9Fk5M)-   [Tabela de tarifas em EUR](https://l.facebook.com/l.php?u=https%3A%2F%2Fscontent-gru2-2.xx.fbcdn.net%2Fv%2Ft39.8562-6%2F521916945_1437343154178501_4307701949709939168_n.csv%3F_nc_cat%3D105%26ccb%3D1-7%26_nc_sid%3Db8d81d%26_nc_ohc%3DCj2ymKwOt30Q7kNvwFeFT2d%26_nc_oc%3DAdn3xUPUqz16B_870C0o3DLApvGFMqWlCbF3CJ35oS0W-cx1AmBeNOxxECmQEIwZ2m0%26_nc_zt%3D14%26_nc_ht%3Dscontent-gru2-2.xx%26_nc_gid%3Dde4XIdQLbsbLQs_66xSw8Q%26oh%3D00_AfkUOsivycXzZTc4VPXPn_WL7q18DpJzsUGqQBRmr3RzRw%26oe%3D694CA265&h=AT3tYsHQV1cOyjvcUb1apvgMohF2rVqd8OnwrCwAvtrNIo_RCDwhygWcqz4hzzEiAK4zxvdX8GpttsgaGe6b_tlgwVsL79qOP7dyGra6ahTkqkiN7DbjAJxscvVMncpDh9r_kpeeU_gRKTKGiQ3vVd9Fk5M)-   [Tabela de tarifas em GBP](https://l.facebook.com/l.php?u=https%3A%2F%2Fscontent-gru2-1.xx.fbcdn.net%2Fv%2Ft39.8562-6%2F523820415_1707220083238148_129381165576389329_n.csv%3F_nc_cat%3D111%26ccb%3D1-7%26_nc_sid%3Db8d81d%26_nc_ohc%3DBbEOZmV5dKoQ7kNvwHDBH7Q%26_nc_oc%3DAdm8IowZcaM94BuETO11jmMPwNFeJzHnA7TNelGt9kj0RQDDAGp0JLgHMDkDaeEWsWQ%26_nc_zt%3D14%26_nc_ht%3Dscontent-gru2-1.xx%26_nc_gid%3Dde4XIdQLbsbLQs_66xSw8Q%26oh%3D00_AfkZlyafYuRuZi8sXJYDE4EXwIFMQkI5rV7Dv29QGxr0ZQ%26oe%3D694C9E76&h=AT3tYsHQV1cOyjvcUb1apvgMohF2rVqd8OnwrCwAvtrNIo_RCDwhygWcqz4hzzEiAK4zxvdX8GpttsgaGe6b_tlgwVsL79qOP7dyGra6ahTkqkiN7DbjAJxscvVMncpDh9r_kpeeU_gRKTKGiQ3vVd9Fk5M)-   [Tabela de tarifas em AUD](https://l.facebook.com/l.php?u=https%3A%2F%2Fscontent-gru2-2.xx.fbcdn.net%2Fv%2Ft39.8562-6%2F518358957_1395180011780140_6900177198446866717_n.csv%3F_nc_cat%3D106%26ccb%3D1-7%26_nc_sid%3Db8d81d%26_nc_ohc%3DOhIRZURwsgUQ7kNvwFEeTik%26_nc_oc%3DAdmcIqNOXcUzvjiFeNIs9ZOBZDUxgXidW4SVWNluJo0BlotSyqVQKpYp3aTP5NKkHC8%26_nc_zt%3D14%26_nc_ht%3Dscontent-gru2-2.xx%26_nc_gid%3Dde4XIdQLbsbLQs_66xSw8Q%26oh%3D00_Afm7BY_EvO53lCI3Es5Cs_0WHddtXFSBbvrAc0g-G9nVEQ%26oe%3D694CC086&h=AT3tYsHQV1cOyjvcUb1apvgMohF2rVqd8OnwrCwAvtrNIo_RCDwhygWcqz4hzzEiAK4zxvdX8GpttsgaGe6b_tlgwVsL79qOP7dyGra6ahTkqkiN7DbjAJxscvVMncpDh9r_kpeeU_gRKTKGiQ3vVd9Fk5M)
+-   [Tarifas em USD](https://l.facebook.com/l.php?u=https%3A%2F%2Fscontent-gru2-2.xx.fbcdn.net%2Fv%2Ft39.8562-6%2F520671944_623223040377923_7736077446508180620_n.csv%3F_nc_cat%3D102%26ccb%3D1-7%26_nc_sid%3Db8d81d%26_nc_ohc%3DpNvY_SSHD3UQ7kNvwGrn3dO%26_nc_oc%3DAdmHeB3Rbol8ZBfFFjompJHjRuMHxvjR-1KbFOmeFWoyUIs2IwUPpBKGtmeXMDPfkBo%26_nc_zt%3D14%26_nc_ht%3Dscontent-gru2-2.xx%26_nc_gid%3DyzxR2H9byHgBpPs1bochIw%26oh%3D00_Afq94FIG6cy7O-lzBdDLknzzAezv72mLMLeUlY6heH5LxA%26oe%3D6979E8D1&h=AT2-jDRqCealyHptWGFwAz-qPNjavUhKJNOALGWhQXmx6UlFiWbbqnWQ0yytYwIwrVrdcB3NdDVt2ZNcXaqs_xJ20oII-C-pLRbPT_1scdmYQLxlD5hrTz7eLtWG3_VSgOOYs8Lo8efut0kyg0faz0QOWCs)-   [Tabela de tarifas em INR](https://l.facebook.com/l.php?u=https%3A%2F%2Fscontent-gru2-2.xx.fbcdn.net%2Fv%2Ft39.8562-6%2F520297017_2631484657208999_4027192314064932495_n.csv%3F_nc_cat%3D105%26ccb%3D1-7%26_nc_sid%3Db8d81d%26_nc_ohc%3DYux56QbVlfMQ7kNvwEg5gIt%26_nc_oc%3DAdkmFdQS7bTG3VNxkoF3g37-6aVDjwtkBEJkYe5OfA6-PY-z-QcIWlq0CST8XLfSTi8%26_nc_zt%3D14%26_nc_ht%3Dscontent-gru2-2.xx%26_nc_gid%3DyzxR2H9byHgBpPs1bochIw%26oh%3D00_AfqgZtpeoNgnIM9GqRN30K1JIrqNtYvYgDOHlkci1Gv2fw%26oe%3D6979FA67&h=AT2-jDRqCealyHptWGFwAz-qPNjavUhKJNOALGWhQXmx6UlFiWbbqnWQ0yytYwIwrVrdcB3NdDVt2ZNcXaqs_xJ20oII-C-pLRbPT_1scdmYQLxlD5hrTz7eLtWG3_VSgOOYs8Lo8efut0kyg0faz0QOWCs)-   [Tarifas em IDR](https://l.facebook.com/l.php?u=https%3A%2F%2Fscontent-gru2-2.xx.fbcdn.net%2Fv%2Ft39.8562-6%2F522403360_1317814323248646_3679642822059879321_n.csv%3F_nc_cat%3D105%26ccb%3D1-7%26_nc_sid%3Db8d81d%26_nc_ohc%3DF1TFklsQ940Q7kNvwELkwQC%26_nc_oc%3DAdnkWw_N3xEBkvNhA0Pd8RBOgcUa82RAdEtp0nV3Q2tzjD5XANYwn43-331jQRs91Q4%26_nc_zt%3D14%26_nc_ht%3Dscontent-gru2-2.xx%26_nc_gid%3DyzxR2H9byHgBpPs1bochIw%26oh%3D00_AfpA5Y169kWT6K6wuPbWaL9dMxqDlT5Su7oyix0AMC6NIQ%26oe%3D6979D26E&h=AT2-jDRqCealyHptWGFwAz-qPNjavUhKJNOALGWhQXmx6UlFiWbbqnWQ0yytYwIwrVrdcB3NdDVt2ZNcXaqs_xJ20oII-C-pLRbPT_1scdmYQLxlD5hrTz7eLtWG3_VSgOOYs8Lo8efut0kyg0faz0QOWCs)-   [Tarifas em EUR](https://l.facebook.com/l.php?u=https%3A%2F%2Fscontent-gru2-2.xx.fbcdn.net%2Fv%2Ft39.8562-6%2F521916945_1437343154178501_4307701949709939168_n.csv%3F_nc_cat%3D105%26ccb%3D1-7%26_nc_sid%3Db8d81d%26_nc_ohc%3DMKeQCqV2E5sQ7kNvwF-nSnN%26_nc_oc%3DAdlFL8y_-hwoWsUYmg516GLQ0c8MwTFHFB4dDfD7p8VoSNBPFSz9SFzp94-qD5bIPhU%26_nc_zt%3D14%26_nc_ht%3Dscontent-gru2-2.xx%26_nc_gid%3DyzxR2H9byHgBpPs1bochIw%26oh%3D00_AfpY2H5GaYIkn3KdeAsSWGiCrN2fZURsrSOE1KGirNZM1A%26oe%3D6979E5E5&h=AT2-jDRqCealyHptWGFwAz-qPNjavUhKJNOALGWhQXmx6UlFiWbbqnWQ0yytYwIwrVrdcB3NdDVt2ZNcXaqs_xJ20oII-C-pLRbPT_1scdmYQLxlD5hrTz7eLtWG3_VSgOOYs8Lo8efut0kyg0faz0QOWCs)-   [Tarifas em GBP](https://l.facebook.com/l.php?u=https%3A%2F%2Fscontent-gru2-1.xx.fbcdn.net%2Fv%2Ft39.8562-6%2F523820415_1707220083238148_129381165576389329_n.csv%3F_nc_cat%3D111%26ccb%3D1-7%26_nc_sid%3Db8d81d%26_nc_ohc%3DJcn3H866meQQ7kNvwEIFi_2%26_nc_oc%3DAdmm7KYYEFSimhgsPYvQc-Chgcm8Q6I51DGB0YvtZR4_eRGWElsCeeJGHEhvRGCPvFo%26_nc_zt%3D14%26_nc_ht%3Dscontent-gru2-1.xx%26_nc_gid%3DyzxR2H9byHgBpPs1bochIw%26oh%3D00_AfqfmPpz0rZdXel33O-TXHrgN2DvZLMSFn26jOLFLUzK6g%26oe%3D6979E1F6&h=AT2-jDRqCealyHptWGFwAz-qPNjavUhKJNOALGWhQXmx6UlFiWbbqnWQ0yytYwIwrVrdcB3NdDVt2ZNcXaqs_xJ20oII-C-pLRbPT_1scdmYQLxlD5hrTz7eLtWG3_VSgOOYs8Lo8efut0kyg0faz0QOWCs)-   [Tarifas em AUD](https://l.facebook.com/l.php?u=https%3A%2F%2Fscontent-gru2-2.xx.fbcdn.net%2Fv%2Ft39.8562-6%2F518358957_1395180011780140_6900177198446866717_n.csv%3F_nc_cat%3D106%26ccb%3D1-7%26_nc_sid%3Db8d81d%26_nc_ohc%3Dbf4RP_5nChYQ7kNvwE7GZpv%26_nc_oc%3DAdkYKpeGmVuZuMOhdMLyRrJuB4MiL-hW2wYMJ3Z43cE-ci8lMItxpXr1pb_qYxUOfyo%26_nc_zt%3D14%26_nc_ht%3Dscontent-gru2-2.xx%26_nc_gid%3DyzxR2H9byHgBpPs1bochIw%26oh%3D00_AfqG5i0UOr5zV4JoDp9hTTVQkA7sPu4AwUlp-6J2_LPJTQ%26oe%3D6979CBC6&h=AT2-jDRqCealyHptWGFwAz-qPNjavUhKJNOALGWhQXmx6UlFiWbbqnWQ0yytYwIwrVrdcB3NdDVt2ZNcXaqs_xJ20oII-C-pLRbPT_1scdmYQLxlD5hrTz7eLtWG3_VSgOOYs8Lo8efut0kyg0faz0QOWCs)-   [Tarifas em MXN](https://l.facebook.com/l.php?u=https%3A%2F%2Fscontent-gru1-2.xx.fbcdn.net%2Fv%2Ft39.8562-6%2F597620135_866494415956770_7234843917023384648_n.csv%3F_nc_cat%3D108%26ccb%3D1-7%26_nc_sid%3Db8d81d%26_nc_ohc%3DJfqB_TMWgF8Q7kNvwEQmq8L%26_nc_oc%3DAdk4cfjThQBFBJM18mjpS9qebxIXTj9Ny9BhTpijTdayhiwzwXz4aQkgJb72sBe5mx4%26_nc_zt%3D14%26_nc_ht%3Dscontent-gru1-2.xx%26_nc_gid%3DyzxR2H9byHgBpPs1bochIw%26oh%3D00_AfrSMdN-ad-JQ1M4j1AQphRr4aWEpmYoOpzTSi30yDmJWQ%26oe%3D6979C91D&h=AT2-jDRqCealyHptWGFwAz-qPNjavUhKJNOALGWhQXmx6UlFiWbbqnWQ0yytYwIwrVrdcB3NdDVt2ZNcXaqs_xJ20oII-C-pLRbPT_1scdmYQLxlD5hrTz7eLtWG3_VSgOOYs8Lo8efut0kyg0faz0QOWCs)
 
 ## Como as ligações alteram a janela de atendimento ao cliente de 24 horas
 
-Disponível desde 1º de outubro de 2024
-
 Atualmente, quando um usuário do WhatsApp envia uma mensagem para você, uma [janela de atendimento ao cliente de 24 horas](/documentation/business-messaging/whatsapp/messages/send-messages#customer-service-windows) começa ou é atualizada.
 
 Durante esse período, a empresa pode enviar ao usuário do WhatsApp qualquer tipo de mensagem que não seria permitida fora da janela.
@@ -39,298 +37,11 @@ Com a introdução da API de Ligações, a janela de atendimento ao cliente agor
 
 -   Quando um usuário do WhatsApp liga para você, independentemente de você aceitar a ligação ou não-   Quando um usuário do WhatsApp aceita a ligação.
 
-## Obter análises de custo e de ligações
-
-É possível chamar o ponto de extremidade `GET /<WHATSAPP_BUSINESS_ACCOUNT_ID>` com um parâmetro de consulta `?fields=call_analytics` a fim de obter análises de ligações para a sua conta do WhatsApp Business (WABA).
-
-Os pontos de extremidade podem fornecer informações úteis, como custo, contagem de ligações concluídas e duração média da ligação.
-
-### Obter análise de ligações
-
-Use esse ponto de extremidade para receber análises das suas ligações, como custo, contagem de ligações concluídas e duração média.
-
-#### Sintaxe da solicitação
-
-```
-GET /<WHATSAPP_BUSINESS_ACCOUNT_ID>?fields=call_analytics
-  .<FILTERING_PARAMETERS>
-  &access_token=<ACCESS_TOKEN>
-```
-
-Parâmetro
-
-Descrição
-
-Exemplo de valor
-
-`<WHATSAPP_BUSINESS_ACCOUNT_ID>`
-
-_String_
-
-**Obrigatório**
-
-  
-A identificação da sua conta do WhatsApp Business.
-
-[Saiba como encontrar a identificação da WABA](/documentation/business-messaging/whatsapp/whatsapp-business-accounts)
-
-`102290129340398`
-
-`<FILTERING_PARAMETERS>`
-
-_Vários_
-
-**Obrigatório**
-
-  
-Parâmetros de filtragem para dados de análise de ligações.
-
-[Consulte Parâmetros de filtragem abaixo](/documentation/business-messaging/whatsapp/calling/pricing#filtering-parameters)
-
-[Consulte Parâmetros de filtragem abaixo](/documentation/business-messaging/whatsapp/calling/pricing#filtering-parameters)
-
-`<ACCESS_TOKEN>`
-
-_String_
-
-**Obrigatório**
-
-  
-Seu token de acesso.
-
-#### Exemplo de resposta
-
-```
-{
-  "call_analytics": {
-    "data": [
-      {
-        "data_points": [
-          {
-            "start": 1676361600,
-            "end": 1676448000,
-            "cost": 10,
-            "count": 10,
-            "average_duration": 1
-          }
-        ]
-      }
-    ]
-  },
-  "id": "114525791557199"
-}
-```
-
-#### Parâmetros de filtragem
-
-Parâmetro
-
-Descrição
-
-Exemplo de valor
-
-`start`
-
-_Número inteiro_
-
-**Obrigatório**
-
-  
-A data de início do registro de data e hora UNIX do intervalo para o qual você quer consultar as análises de ligações.
-
-`1676361600`
-
-`end`
-
-_Número inteiro_
-
-**Obrigatório**
-
-  
-A data de término do registro de data e hora UNIX do intervalo para o qual você quer consultar as análises de ligações.
-
-`1676448000`
-
-`granularity`
-
-_Enumeração_
-
-**Obrigatório**
-
-  
-A amostragem desejada das análises que você quer recuperar.
-
-Opções com suporte: `HALF_HOUR` | `DAILY` | `MONTHLY`
-
-`MONTHLY`
-
-`country_codes`
-
-_Matriz de strings_
-
-**Opcional**
-
-  
-Filtre dados por códigos dose países aos quais você fez ligações.
-
-Forneça uma matriz com códigos de duas letras para os países a serem incluídos.
-
-Se `country_codes` não for fornecido nos seus parâmetros de filtro, as análises de todos aos quais você ligou serão retornadas.
-
-[Ver lista de códigos de país aprovados](/documentation/business-messaging/whatsapp/calling/faq#supported-codes)
-
-`["011","55"]`
-
-`phone_numbers`
-
-_Matriz de strings_
-
-**Opcional**
-
-  
-Filtre dados por números de telefone comercial específicos na sua WABA.
-
-Caso `phone_numbers` não seja fornecido, todos os números de telefone adicionados à sua WABA serão incluídos.
-
-`["550987659923","17862258930"]`
-
-`metric_types`
-
-_Lista de enumeração_
-
-**Opcional**
-
-  
-É a lista de métricas que você quer receber.
-
-Se metric\_types não for fornecido, retornaremos resultados para todos os tipos de métrica.
-
-Opções aceitas:
-
-`COST` – Para calcular o custo da duração total da ligação, aplica-se a tabela de tarifas com base na direção da ligação e no código do país do consumidor.
-
-`COUNT` – O número total de ligações concluídas.
-
-`AVERAGE_DURATION` – Duração média das ligações concluídas computada pela soma da duração de todas as ligações dividida pelo número de ligações
-
-`[COST, COUNT]`
-
-`directions`
-
-_Enumeração_
-
-**Opcional**
-
-  
-Filtre os dados pela direção da ligação realizada.
-
-Caso `directions` não seja fornecido, todos os números de telefone adicionados à sua WABA serão incluídos.
-
-Opções com suporte: `USER_INITIATED` | `BUSINESS_INITIATED`
-
-`BUSINESS_INITIATED`
-
-`dimensions`
-
-_Enumeração_
-
-**Obrigatório**
-
-  
-É a lista de detalhamentos que você quer aplicar às suas métricas.
-
-Se `dimensions` não for fornecido, retornaremos resultados sem detalhamentos.
-
-Opções com suporte: `DIRECTION` | `COUNTRY` | `PHONE`
-
-`DIRECTION`
-
-#### Resposta de erro
-
-[Consulte Códigos de erro e solução de problemas da API de Ligações para saber mais](/documentation/business-messaging/whatsapp/calling/troubleshooting)
-
-[Veja os códigos de erro gerais da API de Nuvem aqui](/documentation/business-messaging/whatsapp/support/error-codes)
-
-## Exemplo de solicitações de custo e análise de ligações
-
-### Apenas parâmetros obrigatórios
-
-#### Solicitação
-
-```
-GET /{whatsapp-business-account-id}?fields=call_analytics
-      .start(1643702400).end(1646121600)
-      .granularity(MONTHLY)
-      .phone_numbers([])
-  &access_token={access-token}
-```
-
-#### Resposta
-
-```
-{
-  "call_analytics": {
-    "data": [
-      {
-        "data_points": [
-          {
-            "start": 1676361600,
-            "end": 1676448000,
-            "cost": 10,
-            "count": 10,
-            "average_duration": 1
-          }
-        ]
-      }
-    ]
-  },
-  "id": "114525791557199"
-}
-```
-
-### Com detalhamentos
-
-#### Solicitação
-
-```
-GET /{whatsapp-business-account-id}?fields=call_analytics
-      .start(1643702400).end(1646121600)
-      .granularity(MONTHLY)
-      .dimensions([DIRECTION])
-  &access_token={access-token}
-```
+## Como obter análises de custo e de ligações
 
-#### Resposta
+Você pode chamar o ponto de extremidade `GET /<WHATSAPP_BUSINESS_ACCOUNT_ID>` com um parâmetro de consulta `?fields=call_analytics` a fim de obter análises de ligações para sua conta do WhatsApp Business (WABA).
 
-```
-{
-  "call_analytics": {
-    "data": [
-      {
-        "data_points": [
-          {
-            "start": 1676361600,
-            "end": 1676448000,
-            "direction":"USER_INITIATED",
-            "cost": 0.6,
-            "count": 5,
-            "average_duration": 1
-          },
-          {
-            "start": 1676361600,
-            "end": 1676448000,
-            "direction": "BUSINESS_INITIATED",
-            "cost": 0.4,
-            "count": 5,
-            "average_duration": 1
-          }
-        ]
-      }
-    ]
-  },
-  "id": "114525791557199"
-}
-```
+Os pontos de extremidade podem fornecer informações úteis, como custo, contagem de ligações concluídas e duração média da ligação. Saiba mais sobre as [análises de ligações neste link](documentation/business-messaging/whatsapp/analytics#call-analytics).
 
 Você achou esta página útil?
 

package/docs/ligacoes/sandbox.md

@@ -0,0 +1,160 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/calling/sandbox -->
+<!-- Scraped: 2026-01-24T00:29:14.746Z -->
+
+# Como usar uma conta de sandbox para fazer ligações
+
+Updated: 31 de out de 2025
+
+As contas de sandbox estão disponíveis apenas para parceiros de tecnologia.
+
+## Visão geral
+
+As contas de sandbox do WhatsApp fornecem aos parceiros de soluções uma conta simulada do WhatsApp Business para testar a integração. As contas de sandbox podem ser usadas para diversos testes, inclusive para testar a integração de ligações. Use uma conta de sandbox de ligações para:
+
+-   Iniciar e receber ligações usando a API de Ligações-   Validar eventos de webhook de ligações-   Simular fluxos de integração sem criar ativos de negócios reais
+
+## Diferenças nos limites de ligações ao usar uma conta de sandbox
+
+Limite
+
+Descrição
+
+Limite de números de produção
+
+Limite de números de teste público
+
+Limite de ligações conectadas
+
+O número de ligações que uma empresa pode fazer dentro das permissões aprovadas.
+
+10 ligações conectadas por 24 horas
+
+100 ligações por dia
+
+Limites de mensagem de pedido de permissão para ligação
+
+Limita o número de mensagens de pedido de permissão para ligação que podem ser enviadas para o mesmo consumidor
+
+1 solicitação por dia  
+2 solicitações por semana
+
+25 solicitações por dia  
+100 solicitações por semana
+
+Limites de ligações não respondidas
+
+Quando uma ligação iniciada pela empresa fica sem resposta (ou seja, é rejeitada ou perdida pelo usuário).
+
+Cutucar em 2 ligações consecutivas não respondidas  
+Revogar permissão em 4 ligações consecutivas não respondidas
+
+Cutucar em 5 ligações consecutivas não respondidas  
+Revogar após 10 ligações consecutivas não respondidas
+
+Duração da ligação temporária
+
+O período durante o qual a empresa pode ligar para o usuário após a permissão ser aprovada.
+
+7 dias
+
+Nenhuma alteração
+
+## Como configurar a conta de sandbox de ligações
+
+### Etapa 1. Acesse o sandbox do WhatsApp para desenvolvedores
+
+-   Navegue até o [Painel de Apps](https://developers.facebook.com/apps).-   Clique no app que você está usando com o WhatsApp.-   Selecione **Casos de uso** (ícone de lápis) na barra lateral.-   Em **Conectar-se com clientes pelo WhatsApp**, clique em **Personalizar**.-   No menu à esquerda, selecione **Ferramentas para parceiros**.-   Na seção **Obter conta de sandbox**, em **Recursos**, clique no menu suspenso. Selecione **API de Nuvem e ligações**.-   Clique em **Obter conta de sandbox**.-   Em **Habilitar funcionalidade de ligação**, clique no menu suspenso e depois em **Gerenciar lista de números de telefone**.-   Adicione seu número de telefone como destinatário.
+
+### Etapa 2. Obtenha as credenciais e os identificadores da sua conta de sandbox
+
+-   Na mesma página, em **Personalize um novo fluxo de integração**, clique em **Começar** para abrir a experiência de Cadastro Incorporado.
+    -   **Observação: mantenha esta aba aberta e disponível, pois você a usará várias vezes ao longo do processo.**-   Na seção **Início do Cadastro Incorporado**, verifique se o menu suspenso **Recursos** está vazio e clique em **Entrar com o Facebook**.-   Uma notificação pop-up com a experiência de Cadastro Incorporado será exibida. Em **Portfólio empresarial**, selecione **Sandbox Business**.-   Preencha o restante das informações necessárias e clique em **Avançar**.-   Na próxima tela, no menu suspenso **Crie ou selecione um perfil do WhatsApp Business**, selecione **Número de teste**.-   Quando o fluxo de login for concluído, na seção **Trocar token**, clique em **Obter token**.
+    -   **Observação: guarde esse token para uso futuro com a API da conta de sandbox.**-   Na seção **Obtenha a conta do WhatsApp Business compartilhada**, clique em **Obter detalhes da conta do WhatsApp Business**.-   Em **Campo da conta do WhatsApp Business**, copie o **valor** da linha `id`.
+    -   **Observação: guarde essa identificação, pois ela é a identificação da conta do WhatsApp Business do sandbox.**-   Na seção **Obter números de telefone**, clique em **Obter números de telefone**.-   Em **Identificação**, copie o valor.
+    -   **Observação: guarde essa identificação, pois ela é a identificação do número de telefone usado como número de teste da sua conta de sandbox.**
+
+### Etapa 3. Registre seu número de telefone de teste e inscreva-o na sua conta do WhatsApp Business
+
+_Pré-requisitos_
+
+_Verifique se você tem as seguintes informações das etapas anteriores:_
+
+-   _A string do token da sua conta de sandbox_-   _A identificação da conta do WhatsApp Business da sua conta de sandbox_-   _A identificação do seu número de telefone de teste_
+
+Para concluir as próximas etapas, você usará a [ferramenta Explorador da Graph API](https://developers.facebook.com/tools/explorer/).
+
+-   **Observação: mantenha esta janela aberta, pois você usará novamente a configuração criada nas etapas posteriores deste guia.**
+
+-   Navegue até a ferramenta [Explorador da Graph API](https://developers.facebook.com/tools/explorer/).-   Verifique se você está usando a versão mais recente da API.-   Clique em **Gerar token de acesso** e siga as instruções.-   Em **Permissões**, adicione as permissões `whatsapp_business_management` e `whatsapp_business_messaging`.-   No configurador de ponto de extremidade, insira `/<YOUR_SANDBOX_WABA_ID>/subscribed_apps` e clique em **Enviar**.
+
+```
+{  "success": true}
+```
+
+-   Depois, registre o número de telefone de teste inserindo `/<YOUR_SANDBOX_TEST_PHONE_NUMBER_ID>/register` no configurador de ponto de extremidade.-   Na barra lateral esquerda, clique em JSON e insira o seguinte corpo JSON. Depois, clique em Enviar:
+
+```
+{  "messaging_product": "whatsapp",  "pin": "123456"}
+```
+
+-   Você receberá uma resposta padrão `success`:
+
+```
+{  "success": true}
+```
+
+### Etapa 4. Teste a funcionalidade de mensagens
+
+-   Na [ferramenta Explorador da Graph API](https://developers.facebook.com/tools/explorer/), insira `/<YOUR_SANDBOX_TEST_PHONE_NUMBER_ID>/messages` no configurador de ponto de extremidade.-   Na barra lateral esquerda, clique em **JSON** e insira o seguinte corpo JSON. Depois, clique em **Enviar**:
+
+```
+{  "messaging_product": "whatsapp",  "to": "YOUR_NUMBER", // Replace this value with phone number of your device.  "type": "template",  "template": {    "name": "hello_world",    "language": { "code": "en_US" }  }}
+```
+
+-   Você receberá uma resposta com o valor `"message_status": "accepted"` e deverá receber uma mensagem de texto no seu dispositivo.
+
+### Etapa 5. Configure webhooks e permissões
+
+-   Navegue até o [Painel de Apps](https://developers.facebook.com/apps).-   Clique no app que você está usando com o WhatsApp.-   Selecione **Casos de uso** (ícone de lápis) na barra lateral.-   Em **Conectar-se com clientes pelo WhatsApp**, clique em **Personalizar**.-   Na barra lateral esquerda, clique em **Configuração**.-   Em **URL de retorno de chamada**, adicione o URL de retorno de chamada do servidor do webhook.
+    -   Se você não tiver um servidor de webhook, siga as nossas [instruções para criar um servidor de webhook de teste](/documentation/business-messaging/whatsapp/webhooks/set-up-whatsapp-echo-bot).-   Em **Verificar token**, adicione uma string de verificação arbitrária.-   Clique em **Verificar e salvar**.-   Na próxima página, no menu suspenso **Selecionar produto**, clique em **Conta do WhatsApp Business**.-   Em **Campos de webhook**, na linha **Ligações**, clique no botão de alternância para se inscrever no campo de webhook `calls`.
+
+### Conclua: habilitar recursos de ligação no número de telefone de teste
+
+-   Na [ferramenta Explorador da Graph API](https://developers.facebook.com/tools/explorer/), insira `/<YOUR_SANDBOX_TEST_PHONE_NUMBER_ID>/settings` no configurador de ponto de extremidade.-   Na barra lateral esquerda, clique em **JSON** e insira o seguinte corpo JSON. Depois, clique em **Enviar**:
+
+```
+{  "calling": {    "status": "ENABLED",    "call_icon_visibility": "DEFAULT",    "callback_permission_status": "ENABLED"  }}
+```
+
+-   Você receberá uma resposta padrão `success`:
+
+```
+{  "success": true}
+```
+
+-   Por fim, em **Token de acesso**, copie o token de acesso para uso futuro.
+    -   **Observação: guarde esse token de acesso, pois você o usará para fazer chamadas de API ao testar a integração da API de Ligações.**
+
+## Como testar ligações iniciadas pela empresa (BIC)
+
+Antes de testar ligações iniciadas pela empresa, você deve conceder permissões de ligação de usuário à sua conta de sandbox.
+
+É possível fazer isso no dispositivo cliente que você está usando para testar da seguinte maneira:
+
+-   No dispositivo cliente, abra o WhatsApp.-   Navegue até a conversa que você criou com o número de telefone comercial da sua conta de sandbox.-   Na parte superior da tela, toque no número de telefone comercial da sua conta de sandbox.-   Role a tela para baixo e toque em **Permissão para ligações da empresa**.-   Toque em **Permitir ligações**.
+
+Agora você pode testar sua integração da API de Ligações ligando para o dispositivo cliente.
+
+[Saiba mais sobre como fazer ligações iniciadas pela empresa.](/documentation/business-messaging/whatsapp/calling/business-initiated-calls)
+
+## Como testar ligações iniciadas pelo usuário (UIC)
+
+-   No dispositivo cliente, abra o WhatsApp.-   Navegue até a conversa que você criou com o número de telefone comercial da sua conta de sandbox.-   Toque no ícone de telefone no canto superior direito da tela para ligar para o número de telefone comercial da sua conta de sandbox.-   Confirme que a ligação foi estabelecida com sucesso.
+
+[Saiba mais sobre como gerenciar ligações iniciadas pelo usuário.](/documentation/business-messaging/whatsapp/calling/user-initiated-calls)
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

package/docs/ligacoes/video_calling.md

@@ -0,0 +1,8 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/calling/video-calling -->
+<!-- Scraped: 2026-01-24T00:29:56.626Z -->
+
+## Esta página não está disponível no momento
+
+Isso pode ter ocorrido devido a um erro técnico que estamos trabalhando para corrigir. Tente recarregar esta página.
+
+Recarregar página