whatsapp-docs-mcp 1.0.0

package/docs/ligacoes/integration_patterns.md

@@ -0,0 +1,121 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/calling/integration-patterns -->
+<!-- Scraped: 2025-12-20T17:41:24.950Z -->
+
+# Padrões de integração
+
+Updated: 22 de out de 2025
+
+## Possíveis abordagens de alto nível
+
+Abordagem
+
+Configuração de número
+
+Responsabilidades do provedor de soluções de negócios
+
+Responsabilidades do Provedor de Tecnologia da Ligação
+
+Responsabilidades da empresa final
+
+**BSP da mensagem capaz de realizar chamadas**
+
+Número de telefone existente estendido para ligação ou novo número
+
+-   O BSP de mensagens reutiliza o próprio app e inscreve-o em webhooks de ligações. A criação de um novo app específico para ligações também funciona, mas [não é recomendada](/documentation/business-messaging/whatsapp/calling/integration-patterns#single-app-vs--multiple-apps)-   Processar webhooks de ligações e coordene com infraestruturas de mídia em tempo real-   As chamadas relacionadas à Graph API são semelhantes às chamadas à Graph API para mensagens
+
+Não se aplica porque envolve apenas um parceiro.
+
+-   Habilitar e usar ligações-   Continue pagando a fatura do BSP, que agora inclui ligações relacionadas a itens de linha de uso
+
+[**Conversas multisoluções**](/documentation/business-messaging/whatsapp/solution-providers/multi-solution-conversations)
+
+Número único operado de forma independente pelo BSP de mensagens e pelo BSP/provedor de tecnologia de ligações
+
+-   O BSP de mensagens não faz alterações
+
+-   Hosts de BSP/provedor de tecnologia de ligações do Cadastro incorporado no próprio site apontando para o próprio app-   Recebe a empresa final para passar pelo Cadastro incorporado
+
+-   Integrar usando o Cadastro incorporado do parceiro de ligação-   Pague as faturas ao BSP de mensagens como antes-   Para atividades incorridas por parceiros de ligação, pague a fatura ao parceiro se ele for um BSP ou para a Meta se ele não for um BSP
+
+ISV de ligação exclusiva
+
+Novo número para ligações
+
+Não aplicável porque não há BSP de mensagens
+
+-   Chamada de host do ISV para o Cadastro Incorporado no site que aponta para o próprio app-   Recebe a empresa final para passar pelo Cadastro incorporado-   Se o ISV for um parceiro/provedor de tecnologia, a Meta cobrará diretamente a empresa final. O ISV e a empresa final devem resolver a própria cobrança-   Se o ISV for um BSP, ele poderá estender a própria linha de crédito para a empresa final
+
+-   Integração com Cadastro incorporado no TP-   Se o ISV for um parceiro ou provedor de tecnologia, pague diretamente à Meta
+    -   Nesse caso, a empresa final precisa ter uma relação de pagamento direta com a Meta. A configuração dessa relação pode levar várias semanas-   Se o ISV for um BSP, pague a fatura do BSP
+
+[Solução multiplataforma](/documentation/business-messaging/whatsapp/solution-providers/multi-partner-solutions) usando o ISV de ligações registrado como Provedor de Tecnologia (TP)
+
+Novo número de ligação exclusivo atendido (**apenas**) pelo TP de ligação
+
+-   O BSP e o TP trabalham juntos para criar/aprovar uma solução multiparceiro. O BSP e o provedor de tecnologia têm os próprios apps-   Relação comercial entre BSP de mensagens e ISV de ligações-   Estender linha de crédito para a empresa final-   Pode receber mensagens ou ligações, mas não pode enviar mensagens ou fazer ligações, porque é possível selecionar apenas um dos dois parceiros para enviar mensagens/fazer ligações em uma solução multiplataforma
+
+-   O BSP e o TP trabalham juntos para criar/aprovar uma solução multiparceiro. O BSP e o provedor de tecnologia têm os próprios apps-   Organizar a relação comercial entre BSP de mensagens e ISV de ligações-   Integrar clientes finais usando o Cadastro incorporado e indicando a solução criada-   Enviar/receber mensagens ou ligações
+
+-   Integração com Cadastro incorporado no TP-   A empresa é informada sobre o TP no Cadastro incorporado-   Pague a fatura do BSP
+
+## Conversas multisoluções (MSC)
+
+A API de MM Lite oferece suporte a Conversas com Múltiplas Soluções, permitindo que diferentes parceiros e soluções compartilhem o mesmo número de telefone, com mensagens e ligações reunidas em uma única conversa.
+
+[Saiba mais sobre as Conversas multisoluções](/documentation/business-messaging/whatsapp/solution-providers/multi-solution-conversations)
+
+## Integração por meio de um design detalhado do provedor de ligações
+
+Veja abaixo uma arquitetura lógica ilustrativa da integração das ligações comerciais do WhatsApp por meio de um provedor de ligações de terceiros (3p).
+
+Nesse cenário, você usaria o fornecedor terceirizado por trás das câmeras, e esse fornecedor não ficaria visível para a Meta. Esse padrão é semelhante ao de qualquer outro serviço SaaS que você possa estar usando.
+
+O diagrama também mostra como essa arquitetura pode ser opcionalmente estendida para se integrar à infraestrutura de SIP do seu lado.
+
+**Nossos termos não permitem o uso de PSTN em _qualquer_ parte da ligação do WhatsApp no fluxo geral da ligação.**
+
+Mesmo que você transforme a ligação do WhatsApp em uma ligação do mundo do SIP, ela deve permanecer exclusivamente no VoIP e nunca chegar à PSTN. O tronco SIP por si só não é proibido porque, tecnicamente, é possível usá-lo sem PSTN.
+
+  
+![Image](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/565132736_1339318364593481_1182320683426712488_n.jpg?_nc_cat=110&ccb=1-7&_nc_sid=e280be&_nc_ohc=1nrIZPVzxZ4Q7kNvwGQStKq&_nc_oc=AdnjxUxAK49JUWrlh4QmIhD6ffQiSkMwYWqDfbY-c3voJOqeVnKkPoERQURlHZka9r0&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=dRZy3m7ZO1dK3dpn5hvKQQ&oh=00_Afk_D30-g9flR2XEo6y-1a_zOCfGwXoBNl5javMnD-wc0g&oe=696116D8) (_Clique com o botão direito do mouse na imagem e escolha "Abrir em uma nova aba" para ampliar a imagem_)
+
+## Um app vs. vários apps
+
+Esta seção abrange algumas diretrizes e considerações sobre reutilizar o seu app de mensagens atual para fazer ligações ou criar um novo app especificamente para usar os recursos da API de Ligações
+
+Para integrar com a API de Ligação do WhatsApp, é preciso chamar [pontos de extremidade da Graph API](/documentation/business-messaging/whatsapp/about-the-platform#whatsapp-cloud-api) e processar Webhooks da Meta. Para isso, [é preciso ter um app](/docs/development/create-an-app), e, na maioria dos casos, você já tem um app que serve para enviar mensagens.
+
+Resumindo: é possível reutilizar um app existente para [Cadastro Incorporado](/documentation/business-messaging/whatsapp/embedded-signup/overview) e para um caso de uso de mensagens.
+
+Nessa configuração, o URI de retorno de webhook é o mesmo para webhooks relacionados a mensagens e ligações, mas a carga do webhook pode ser usada para distinguir as duas categorias de funções (mensagem e ligação). Portanto, você ainda pode encaminhar webhooks específicos da API de Ligações para um componente relacionado a ligações da lógica comercial principal do seu webhook.
+
+Confira abaixo as vantagens de reutilizar o mesmo app
+
+-   Redução de despesas operacionais (por exemplo, análise do app, manutenção contínua)-   Presença simplificada dos parceiros na Meta-   Igualdade entre o app usado para o cadastro incorporado e aquele usado para invocar Graph APIs e receber webhooks-   Isso não afetaria a funcionalidade existente de usar o app para fazer ligações. Você só precisa ter certeza de que o servidor de webhook consiga lidar corretamente com webhooks relacionados a "ligações".
+
+Ainda é possível ter apps separados. Para saber mais, consulte [Perguntas frequentes sobre como começar](/documentation/business-messaging/whatsapp/calling/faq#getting-started-faq).
+
+## Diretrizes para integração do caminho de mídia
+
+A pilha de VoIP para ligações do WhatsApp Business foi desenvolvida para oferecer suporte ao WebRTC. No entanto, para garantir uma integração eficaz com o protocolo do WhatsApp, estamos restringindo as funcionalidades com suporte. Como resultado, publicamos os seguintes requisitos e algumas recomendações.
+
+### Requisitos obrigatórios
+
+Se um requisito obrigatório não for atendido, a ligação falhará. Essa falha pode ocorrer durante a fase de sinalização da ligação, resultando em uma ligação rejeitada, ou durante a fase de decodificação do pacote de mídia.
+
+-   Use apenas o codec de áudio Opus.-   Defina a taxa de relógio de mídia para 48 kHz.-   Defina a frequência de relógio de DTMF para 8 kHz.-   Use um ptime de 20 ms.
+
+### Recomendações
+
+Os aspectos a seguir não são obrigatórios, mas são recomendados para garantir a alta qualidade e a confiabilidade da ligação.
+
+-   **Processo do ICE**
+    -   Nossa pilha de VoIP é ICE-LITE; por isso, recomendamos que a pilha de VoIP dos BSPs seja ICE-FULL. ([RFC 5245, seção 2.7](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc5245%23section-2.7&h=AT3-iGSHocR-Ip60_nTZsqnoUH2UWYpC1TASfhECkmxsZYCKeqq9w4Sbu6fUKKRIDVRq-Xf3rVOdIiD1_bJFO1oNIzI73OuF1lKBJ7AXMRZs4gDWrTatb14QiSe9XL5ejL4FL7vLiOL50PEh_A6lcYUSYA4))-   A pilha VoIP dos BSPs deve iniciar o processo do ICE enviando verificações de conectividade STUN.-   A pilha de VoIP dos BSPs deve assumir a função de "CONTROLADOR" do ICE, já que a Meta assumirá apenas a função de "CONTROLADO".-   Use a indicação regular em vez da indicação agressiva. ([RFC 5245, Seção 8.1.1.2](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc5245%23section-8.1.1.2&h=AT3-iGSHocR-Ip60_nTZsqnoUH2UWYpC1TASfhECkmxsZYCKeqq9w4Sbu6fUKKRIDVRq-Xf3rVOdIiD1_bJFO1oNIzI73OuF1lKBJ7AXMRZs4gDWrTatb14QiSe9XL5ejL4FL7vLiOL50PEh_A6lcYUSYA4))-   Aguarde o término do processo ICE antes de indicar o candidato e iniciar o DTLS.-   Não troque o candidato no meio da ligação.-   **DTLS**
+    -   Use chaves ECDH para os certificados DTLS a fim de evitar a fragmentação de pacotes durante a transmissão.-   O BSP deve atuar como um cliente DTLS. ([RFC 6347, seção 4.2](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc6347%23section-4.2&h=AT3-iGSHocR-Ip60_nTZsqnoUH2UWYpC1TASfhECkmxsZYCKeqq9w4Sbu6fUKKRIDVRq-Xf3rVOdIiD1_bJFO1oNIzI73OuF1lKBJ7AXMRZs4gDWrTatb14QiSe9XL5ejL4FL7vLiOL50PEh_A6lcYUSYA4))-   **Como resolver o corte de áudio**
+    -   Atrase o áudio do segmento do SIP até que a conexão de mídia com a Meta seja estabelecida.-   Integre com a [API de pré-aceitação](/documentation/business-messaging/whatsapp/calling/reference#pre-accept-call) para ajudar a mitigar o corte de áudio em ligações iniciadas pelo usuário.
+
+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/pricing.md

@@ -0,0 +1,339 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/calling/pricing -->
+<!-- Scraped: 2025-12-20T17:42:00.606Z -->
+
+# Preços da API de Ligações
+
+Updated: 4 de nov de 2025
+
+**Todas as ligações iniciadas pelo usuário são gratuitas.**
+
+## Visão geral
+
+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)
+
+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.
+
+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).
+
+É necessária 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:
+
+-   [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)
+
+## 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.
+
+Com a introdução da API de Ligações, a janela de atendimento ao cliente agora também é iniciada ou atualizada para ligações:
+
+-   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}
+```
+
+#### Resposta
+
+```
+{
+  "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"
+}
+```
+
+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)