npm - whatsapp-docs-mcp - Versions diffs - 1.0.5 → 1.0.7 - Mend

whatsapp-docs-mcp 1.0.5 → 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.

Files changed (159) hide show

package/docs/insights/analytics.md CHANGED Viewed

@@ -1,13 +1,13 @@
 <!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/analytics -->
-<!-- Scraped: 2025-12-20T17:43:24.987Z -->
+<!-- Scraped: 2026-01-24T00:25:48.873Z -->
 # Análise
-Updated: 13 de nov de 2025
+Updated: 12 de dez de 2025
-A partir de 1º de dezembro de 2025, a janela máxima de retrospectiva para análises de mensagens, conversas e preços será alterado de dez para um ano. A janela de retrospectiva para análises de modelos e grupos de modelos não será afetado e continuará sendo de 90 dias.
+A partir de 1º de dezembro de 2025, a janela máxima de retrospectiva para análises de mensagens, conversas e preços será alterada de dez anos para um ano. A janela de retrospectiva para análises de modelos e grupos de modelos não será afetada e continuará sendo de 90 dias.
-Este documento descreve como consultar análises de mensagens, conversas e modelos. Isso inclui o número de mensagens enviadas de um número de telefone comercial, o número de conversas e os respectivos custos para uma conta comercial do WhatsApp (WABA, pelas iniciais em inglês) ou o número de vezes que determinado modelo foi lido.
+Este documento descreve como consultar análises de mensagens, conversas e modelos. Isso inclui o número de mensagens enviadas de um número de telefone comercial, o número de conversas e os respectivos custos para uma conta comercial do WhatsApp (WABA) ou o número de vezes que determinado modelo foi lido.
 Somente métricas de números de telefone comerciais e modelos associados à sua WABA no momento da solicitação serão incluídas nas respostas.
@@ -22,13 +22,13 @@ curl -g 'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_ACCOUNT_ID>
 -H 'Authorization: Bearer <ACCESS_TOKEN>'
 ```
-### Parâmetros de solicitação
+### Parâmetros da solicitação
 Espaço reservado
 Descrição
-Valor de exemplo
+Exemplo de valor
 `<FIELD>`
@@ -36,7 +36,7 @@ Valor de exemplo
 Métrica. O valor pode ser um destes:
--   [`analytics`](#analytics-2)-   [`conversation_analytics`](#conversation-analytics)-   [`pricing_analytics`](#pricing-analytics)-   [`template_analytics`](#template-analytics)-   [`template_group_analytics`](#template-group-analytics)
+-   [`analytics`](#messaging-analytics)-   [`conversation_analytics`](#conversation-analytics)-   [`pricing_analytics`](#pricing-analytics)-   [`template_analytics`](#template-analytics)-   [`template_group_analytics`](#template-group-analytics)-   [`call_analytics`](#call-analytics)
 `analytics`
@@ -44,11 +44,11 @@ Métrica. O valor pode ser um destes:
 **Obrigatório.**
-O parâmetro de filtragem de métrica. Inclua parâmetros adicionais de filtragem usando pontos.
+Parâmetro de filtragem de métricas. Inclua parâmetros adicionais de filtragem usando pontos.
 Consulte possíveis valores nestas seções:
--   [Parâmetros de análise de mensagens](#messaging-analytics-parameters)-   [Parâmetros de análise de conversas](#conversation-analytics-parameters)-   [Parâmetros de análise de modelos](#template-analytics-parameters)-   [Parâmetros de análise de grupo de modelos](#template-group-analytics-parameters)
+-   [Parâmetros de análise de mensagens](#messaging-analytics-parameters)-   [Parâmetros de análise de conversas](#conversation-analytics-parameters)-   [Parâmetros de análise de modelos](#template-analytics-parameters)-   [Parâmetros de análise de grupo de modelos](#template-group-analytics-parameters)-   [Parâmetros de análise de ligações](#call-analytics-parameters)
 `.start(1543543200).end(1544148000).granularity(DAY)`
@@ -80,7 +80,7 @@ Tipo: registro de data e hora UNIX
 `granularity`
-tipo: Cadeia de caracteres
+Tipo: string
 **Obrigatório.**
@@ -90,7 +90,7 @@ tipo: Cadeia de caracteres
 `phone_numbers`
-tipo: matriz
+Tipo: matriz
 **Opcional.**
@@ -98,15 +98,19 @@ tipo: matriz
 `product_types`
-tipo: matriz
+Tipo: matriz
 **Opcional.**
-São os tipos de mensagens referentes à análise que você quer recuperar (mensagens de notificação e/ou de suporte ao cliente). Forneça uma matriz e inclua `0` para mensagens de notificação e `2` para mensagens de suporte ao cliente. Caso a matriz não seja fornecida, retornaremos análises para todas as mensagens.
+São os tipos de mensagens (mensagens de notificação e/ou de suporte ao cliente) para os quais você quer recuperar notificações. Caso a matriz não seja fornecida, retornaremos análises para todas as mensagens.
+Valores compatíveis:
+-   `0` – para mensagens de modelo enviadas a usuários do WhatsApp-   `2` – para mensagens que não são de modelo enviadas a usuários do WhatsApp-   `100` – para mensagens recebidas enviadas por usuários do WhatsApp para você
 `country_codes`
-tipo: matriz
+Tipo: matriz
 **Opcional.**
@@ -116,15 +120,15 @@ São os países referentes à análise que você quer recuperar. Forneça uma ma
 **Cenário**: você precisa do número de mensagens enviadas e entregues por todos os números de telefone associados à sua WABA.
-**Solução sugerida**: [monte o URL que você quer chamar](#getting-the-data) e inclua os parâmetros de filtragem `start`, `end` e `granularity`. Depois disso, faça uma solicitação `GET` à URL:
+**Solução sugerida:** use os seguintes parâmetros de filtragem: `start`, `end`, `granularity`.
 ```
 curl -i -X GET "https://graph.facebook.com/v24.0/102290129340398
-      ?fields=analytics
-      .start(1543543200)
-      .end(1544148000)
-      .granularity(DAY)
-      &access_token=BLI8lkj..."
+  ?fields=analytics
+  .start(1543543200)
+  .end(1544148000)
+  .granularity(DAY)
+  &access_token=BLI8lkj..."
 ```
 Uma resposta bem-sucedida retornará um objeto `analytics` com os dados solicitados:
@@ -135,7 +139,7 @@ Uma resposta bem-sucedida retornará um objeto `analytics` com os dados solicita
 ## Análise de conversas
-O campo `conversation_analytics` fornece [informações de custo e conversa](/documentation/business-messaging/whatsapp/pricing#conversations) para uma WABA específica. Quando você chamar `/<WHATSAPP_BUSINESS_ACCOUNT_ID>?fields=conversation_analytics.{filtering-parameters}`, será possível anexar os seguintes parâmetros.
+O campo `conversation_analytics` fornece [informações de custo e conversa](/documentation/business-messaging/whatsapp/pricing#conversations) para uma WABA específica. Quando você chamar `/<WHATSAPP_BUSINESS_ACCOUNT_ID>?fields=conversation_analytics.{filtering-parameters}`, será possível anexar os parâmetros a seguir.
 ### Parâmetros de análise de conversas
@@ -161,7 +165,7 @@ Tipo: registro de data e hora UNIX
 `granularity`
-tipo: Cadeia de caracteres
+Tipo: string
 **Obrigatório.**
@@ -171,7 +175,7 @@ tipo: Cadeia de caracteres
 `phone_numbers`
-tipo: matriz
+Tipo: matriz
 **Opcional.**
@@ -181,24 +185,30 @@ tipo: matriz
 **Opcional.**
-É a lista de métricas que você quer receber. Se você enviar uma lista vazia, retornaremos resultados para todos os tipos de métrica. Opções compatíveis {#supported}
+É a lista de métricas que você quer receber. Se você enviar uma lista vazia, retornaremos resultados para todos os tipos de métrica.
+Opções compatíveis: {#supported}
 -   `COST`: inclui cobranças aproximadas para esse período, na moeda da WABA.-   `CONVERSATION`: inclui a contagem de conversas para esse período.
-**Desde 1º de julho de 2023, `COST` não é mais exibido para empresas que cobram por meio de um parceiro de solução.** Para entender as cobranças, entre em contato com seu parceiro. Se você cobra por meio de um parceiro, este é o comportamento esperado:
+**Exceção:**
+**`COST` não será retornado para WABAs que compartilham a linha de crédito de um parceiro de solução. Caso sua WABA compartilhe a linha de crédito de um parceiro de solução, entre em contato com ele para entender as cobranças.** Saiba o que acontece se você consultar uma WABA que compartilha a linha de crédito de um parceiro de solução:
--   Se nenhum `metric_types` for especificado na solicitação, somente `CONVERSATION` será retornado.-   Se apenas `CONVERSATION` for especificado, somente `CONVERSATION` será retornado.-   Caso somente COST seja especificado, a seguinte exceção será retornada:
+-   Se nenhum `metric_types` for especificado na solicitação, somente `CONVERSATION` será retornado.-   Se apenas `CONVERSATION` for especificado, somente `CONVERSATION` será retornado.-   Caso somente `COST` seja especificado, a seguinte exceção será retornada:
     -   Título: "Custo não disponível"-   Mensagem: "O custo não é mais exibido para empresas que cobram por meio de um parceiro (ou seja, BSP). Para entender as cobranças, entre em contato com seu parceiro."
 Se você consultar um período que inclua 1º de julho de 2023 (por exemplo, 1º de maio a 1º de agosto de 2023), a resposta incluirá a exceção acima.
-**_Não há alterações para parceiros que consultarem o ponto de extremidade `conversation_analytics`._**
+Isso não se aplica se a consulta for sobre o ponto de extremidade `conversation_analytics`.
 `conversation_categories`
 **Opcional.**
-Lista de [categorias de conversa](/documentation/business-messaging/whatsapp/pricing#conversation-categories). Se você enviar uma lista vazia, retornaremos resultados para todas as categorias de conversa. Opções compatíveis:
+Lista de [categorias de conversa](/documentation/business-messaging/whatsapp/pricing#conversation-categories). Se você enviar uma lista vazia, retornaremos resultados para todas as categorias de conversa.
+Opções compatíveis:
 -   `AUTHENTICATION`-   `MARKETING`-   `SERVICE`-   `UTILITY`
@@ -208,7 +218,7 @@ Lista de [categorias de conversa](/documentation/business-messaging/whatsapp/pri
 É uma lista de tipos de conversa. Se você enviar uma lista vazia, retornaremos resultados para todos os tipos de conversa. Opções compatíveis:
--   `FREE_ENTRY`: conversas que têm origem em um [ponto de entrada gratuito](/documentation/business-messaging/whatsapp/pricing#free-entry-point-windows).-   `FREE_TIER`: conversas realizadas dentro do [nível gratuito](/documentation/business-messaging/whatsapp/pricing#free-entry-point-windows) mensal.-   `REGULAR`: qualquer conversa que não tenha sido originada em um [ponto de entrada gratuito](/documentation/business-messaging/whatsapp/pricing#free-entry-point-windows) ou que ultrapasse a cota mensal do nível gratuito.
+-   `FREE_ENTRY`: conversas que têm origem em um [ponto de entrada gratuito](/documentation/business-messaging/whatsapp/pricing#free-entry-point-windows).-   `FREE_TIER`: conversas realizadas dentro do [período gratuito](/documentation/business-messaging/whatsapp/pricing#free-entry-point-windows) mensal.-   `REGULAR`: qualquer conversa que não tenha sido originada em um [ponto de entrada gratuito](/documentation/business-messaging/whatsapp/pricing#free-entry-point-windows) ou que ultrapasse a cota mensal do período gratuito.
 `conversation_directions`
@@ -216,13 +226,13 @@ Lista de [categorias de conversa](/documentation/business-messaging/whatsapp/pri
 É uma lista de direções de conversa. Se você enviar uma lista vazia, retornaremos resultados para todas as direções de conversa. Opções compatíveis:
--   `BUSINESS_INITIATED`: conversas iniciadas pela empresa.-   `USER_INITIATED`: conversas iniciadas por um usuário/cliente.-   `UNKNOWN`: o sistema não consegue determinar a direção.
+-   `BUSINESS_INITIATED`: conversas iniciadas pela empresa.-   `USER_INITIATED`: conversas iniciadas por um usuário final/cliente.-   `UNKNOWN`: o sistema não consegue determinar a direção.
 `dimensions`
 **Opcional.**
-É a lista de detalhamentos que você quer aplicar às suas métricas. Se você enviar uma lista vazia, retornaremos os resultados sem detalhamento. Opções compatíveis:
+É a lista de detalhamentos que você quer aplicar às suas métricas. Se você enviar uma lista vazia, retornaremos os resultados sem detalhamentos. Opções compatíveis:
 -   `CONVERSATION_CATEGORY`-   `CONVERSATION_DIRECTION`-   `CONVERSATION_TYPE`-   `COUNTRY`-   `PHONE`
@@ -236,9 +246,9 @@ Ao definir um período, você pode consultar informações de conversas e custos
 **Cenário**: em um determinado mês, você quer recuperar informações de conversa e custo de todos os números de telefone associados a uma WABA.
-**Solução sugerida**: [monte o URL que você quer chamar](#getting-the-data) e inclua estes parâmetros de filtragem.
+**Solução sugerida:** use os seguintes parâmetros de filtragem:
--   `start`: indica o início do período. Nesse caso, é o início do mês referente às métricas que você quer ver.-   `end`: indica o término do período. Nesse caso, é o término do mês para o qual você que ver as métricas.-   `granularity`: representa o detalhamento desejado para os pontos de dados. No exemplo abaixo, usamos `MONTHLY` para que cada ponto represente o valor de um mês de dados.-   `phone_numbers`: ao enviar uma matriz vazia, retornaremos informações para todos os números de telefone associados à WABA.-   `dimensions`: defina todos os detalhamentos disponíveis: `"CONVERSATION_CATEGORY"`, `"CONVERSATION_TYPE"`, `"COUNTRY"` e `"PHONE"`.
+-   `start`: indica o início do período. Nesse caso, é o início do mês referente às métricas que você quer ver.-   `end`: indica o término do período. Nesse caso, é o início do mês referente às métricas que você quer ver.-   `granularity`: representa o detalhamento desejado para os pontos de dados. No exemplo abaixo, usamos `MONTHLY` para que cada ponto represente o valor de um mês de dados.-   `phone_numbers`: ao enviar uma matriz vazia, retornaremos informações para todos os números de telefone associados à WABA.-   `dimensions`: defina todos os detalhamentos disponíveis: `"CONVERSATION_CATEGORY"`, `"CONVERSATION_TYPE"`, `"COUNTRY"` e `"PHONE"`.
 Nesse caso, não é preciso especificar `country_codes`, `metric_types`, `conversation_types` nem `conversation_categories`. Se você não enviar um valor para esses campos, retornaremos todas as opções disponíveis. Depois de configurar o URL, faça uma solicitação GET:
@@ -261,9 +271,9 @@ Uma resposta bem-sucedida retornará um objeto `conversation_analytics` com os d
 #### Como consultar dados de um número específico usando todos os detalhamentos e a granularidade de meia hora
-**Cenário**: em um determinado período, você quer recuperar informações de conversa e custo de um número de telefone específico associado a uma WABA. Sua intenção é usar todos os detalhamentos possíveis nos resultados. É preciso que cada ponto represente meia hora de dados.
+**Cenário**: em um determinado período, você quer recuperar informações de conversas e custos de um número de telefone específico associado a uma WABA. Sua intenção é usar todos os detalhamentos possíveis nos resultados. É preciso que cada ponto represente meia hora de dados.
-**Solução sugerida**: [monte a URL que você quer chamar](#getting-the-data) e inclua estes parâmetros de filtragem:
+**Solução sugerida**: use os seguintes parâmetros de filtragem:
 -   `start`: indica o início do período.-   `end`: indica o término do período.-   `granularity`: representa o detalhamento desejado para os pontos de dados. No exemplo abaixo, usamos `HALF_HOUR` para que cada ponto represente o valor de meia hora de dados.-   `phone_numbers`: o número de telefone sobre o qual você precisa de informações.-   `dimensions`: defina todos os detalhamentos disponíveis: `CONVERSATION_CATEGORY`, `CONVERSATION_TYPE`, `COUNTRY` e `PHONE`.
@@ -291,7 +301,7 @@ Uma resposta bem-sucedida retornará um objeto `conversation_analytics` com os d
 **Cenário**: em um determinado período, você quer recuperar as informações de conversa e custo de todos os números de telefone associados a uma WABA. Sua intenção é detalhar os resultados por tipo de conversa.
-**Solução sugerida**: [monte o URL que você quer chamar](#getting-the-data) e inclua estes parâmetros de filtragem:
+**Solução sugerida**: use os seguintes parâmetros de filtragem:
 -   `start`: indica o início do período.-   `end`: indica o término do período.-   `granularity`: representa o detalhamento desejado para os pontos de dados. No exemplo abaixo, usamos `MONTHLY` para que cada ponto represente o valor de meio mês de dados.-   `phone_numbers`: se você enviar uma matriz vazia, retornaremos informações sobre todos os números de telefone associados à WABA.-   `dimensions`: defina como `CONVERSATION_TYPE`.
@@ -382,7 +392,7 @@ Filtro
 Descrição
-Valor de exemplo
+Exemplo de valor
 `<COUNTRY_CODES>`
@@ -400,7 +410,7 @@ _Matriz de strings_
 **Opcional.**
-É a lista de detalhamentos que você quer aplicar às suas métricas. Se você enviar uma lista vazia, retornaremos os resultados sem detalhamento.
+É a lista de detalhamentos que você quer aplicar às suas métricas. Se você enviar uma lista vazia, retornaremos os resultados sem detalhamentos.
 Os valores podem ser os seguintes:
@@ -440,7 +450,9 @@ _Matriz de strings_
 Os valores podem ser os seguintes:
--   `COST`: cobranças aproximadas por mensagens entregues nesse período na moeda da WABA.-   `VOLUME`: inclui o número de mensagens entregues nesse período.
+-   `COST`: cobranças aproximadas por mensagens entregues nesse período, na moeda da WABA.-   `VOLUME`: inclui o número de mensagens entregues nesse período.
+**Informamos que `COST` não será retornado para WABAs que compartilham a linha de crédito de um parceiro de soluções. Caso sua WABA compartilhe a linha de crédito de um parceiro de solução, entre em contato com ele para entender as cobranças.**
 `[COST, VOLUME]`
@@ -498,7 +510,7 @@ _String_
 **Obrigatório.**
-É a identificação da conta do WhatsApp Business.
+Identificação da conta do WhatsApp Business.
 `102290129340398`
@@ -528,7 +540,7 @@ O valor da propriedade `tier` representa uma concatenação dos limites inferior
 **Observações**
--   Para verificar o nível de volume atual, leia os valores `tier`, `country` e `pricing_category`. O número inteiro `<UPPER>` de `tier` (o número inteiro depois dos dois pontos) indica o seu nível atual para `country` e `pricing_category` (por exemplo, Índia e utilidade, respectivamente).-   Se quiser saber quantas mensagens você precisa enviar para atingir o próximo nível em um `country` e uma `pricing_category`, subtraia o número inteiro de `volume` do número inteiro `<UPPER>` do valor do nível.-   Os níveis de volume estarão disponíveis somente para mensagens de modelo de autenticação e utilidade. Para mensagens de modelo de marketing (às quais os níveis de volume não serão aplicados), o nível será definido como `0:MAX`.-   A propriedade `tier` será omitida em pontos de dados que representam mensagens gratuitas, já que elas não contribuem para a contagem dos níveis.-   Os níveis de volume serão determinados exclusivamente pela Meta. Todos os dados de insights são aproximados devido a pequenas variações no processamento de dados. Não se deve depositar confiança excessiva nos dados de insights.
+-   Para verificar o nível de volume atual, leia os valores `tier`, `country` e `pricing_category`. O número inteiro `tier` de `<UPPER>` (o número inteiro depois dos dois pontos) indica seu nível atual para `country` e `pricing_category` (por exemplo, Índia e utilidade, respectivamente).-   Se quiser saber quantas mensagens você precisa enviar para atingir o próximo nível em um `country` e uma `pricing_category`, subtraia o número inteiro de `volume` do número inteiro `<UPPER>` do valor do nível.-   Os níveis de volume estarão disponíveis somente para mensagens de modelo de autenticação e utilidade. Para mensagens de modelo de marketing (às quais os níveis de volume não serão aplicados), o nível será definido como `0:MAX`.-   A propriedade `tier` será omitida em pontos de dados que representam mensagens gratuitas, já que elas não contribuem para a contagem dos níveis.-   Os níveis de volume serão determinados exclusivamente pela Meta. Todos os dados de insights são aproximados devido a pequenas variações no processamento de dados. Não se deve depositar confiança excessiva nos dados de insights.
 ### Exemplo de solicitação
@@ -545,7 +557,7 @@ curl 'https://graph.facebook.com/v24.0/161311403722088?fields=pricing_analytics.
 ## Análise de modelos
-A análise de modelos descreve o número de vezes que um modelo foi enviado, entregue e lido, além da quantidade de cliques que os botões de [URL](/documentation/business-messaging/whatsapp/templates/components#url-buttons) ou de [resposta rápida](/documentation/business-messaging/whatsapp/templates/components#quick-reply-buttons) receberam no modelo. Além disso, as empresas [MM Lite](/documentation/business-messaging/whatsapp/marketing-messages/overview) integradas podem rastrear métricas de conversão fora do site.
+A análise de modelos descreve o número de vezes que um modelo foi enviado, entregue e lido, além da quantidade de cliques que os botões de [URL](/documentation/business-messaging/whatsapp/templates/components#url-buttons) ou de [resposta rápida](/documentation/business-messaging/whatsapp/templates/components#quick-reply-buttons) receberam no modelo. Além disso, as empresas [integradas à API de Mensagens de Marketing para o WhatsApp](/documentation/business-messaging/whatsapp/marketing-messages/overview) podem rastrear métricas de conversão fora do site.
 Os dados são retornados com granularidade diária no fuso horário padrão UTC e no fuso horário da WABA, com uma janela de retrospectiva de até 90 dias. Para mostrar dados no fuso horário configurado da WABA, transmita o parâmetro use\_waba\_timezone com um valor true.
@@ -557,7 +569,7 @@ Exibir dados no fuso horário configurado da WABA transmitindo o parâmetro `use
 ### Limitações
--   As análises de modelos só estarão disponíveis na API Local se a conta não estiver usando a API de Nuvem para isso.-   A análise de cliques no botão está disponível apenas para modelos categorizados como `MARKETING` ou `UTILITY`.-   Não há compatibilidade com WABAs pertencentes ou compartilhadas com contas empresariais da Meta na União Europeia, no Reino Unido ou no Japão, tampouco com WABAs que tenham um número de telefone comercial com código do país desses locais.-   As métricas de conversão fora do site estão disponíveis apenas para empresas integradas à MM Lite.-   Os dados de eventos de leitura e clique em mensagens de modelo do WhatsApp estão disponíveis por até sete dias a partir da data de envio da mensagem. Depois desse período, o número de leituras/cliques correspondente será redefinido para zero, e nenhuma outra atualização será registrada para essas mensagens.
+-   As análises de modelos só estarão disponíveis na API Local se a conta não estiver usando a API de Nuvem para isso.-   A análise de cliques no botão está disponível apenas para modelos categorizados como `MARKETING` ou `UTILITY`.-   Não há compatibilidade com WABAs pertencentes ou compartilhadas com contas empresariais da Meta na União Europeia, no Reino Unido ou no Japão, tampouco com WABAs que tenham um número de telefone comercial com código do país desses locais.-   As métricas de conversão fora do site estão disponíveis apenas para empresas integradas à API de Mensagem de Marketing para o WhatsApp.-   Os dados de eventos de leitura e clique em mensagens de modelo do WhatsApp estão disponíveis por até sete dias a partir da data de envio da mensagem. Depois desse período, o número de leituras/cliques correspondente será redefinido para zero e nenhuma outra atualização será registrada para essas mensagens.
 ### Como confirmar as análises de modelos
@@ -585,7 +597,7 @@ Nome
 Descrição
-Valor de exemplo
+Exemplo de valor
 `start`
@@ -639,15 +651,15 @@ _Matriz de enumerações_
 **Opcional.**
-O nó `COST` NÃO está disponível para empresas que fazem o faturamento através de um parceiro de solução. Para entender as cobranças, entre em contato com seu parceiro.
 Os tipos de métricas a serem recuperadas. Se a matriz for omitida ou estiver vazia, serão retornadas as análises de todos os tipos de métricas.
 Valores possíveis:
--   `COST`-   `CLICKED`-   `DELIVERED`-   `READ`-   `SENT`-   `APP_ACTIVATIONS (MM Lite only)`-   `APP_ADD_TO_CART (MM Lite only)`-   `APP_CHECKOUTS_INITIATED (MM Lite only)`-   `APP_PURCHASES (MM Lite only)`-   `APP_PURCHASES_CONVERSION_VALUE (MM Lite only)`-   `WEBSITE_ADD_TO_CART (MM Lite only)`-   `WEBSITE_CHECKOUTS_INITIATED (MM Lite only)`-   `WEBSITE_PURCHASES (MM Lite only)`-   `WEBSITE_PURCHASES_CONVERSION_VALUE (MM Lite only)`
+-   `COST`-   `CLICKED`-   `DELIVERED`-   `READ`-   `SENT`-   `APP_ACTIVATIONS (MM API for WhatsApp only)`-   `APP_ADD_TO_CART (MM API for WhatsApp only)`-   `APP_CHECKOUTS_INITIATED (MM API for WhatsApp only)`-   `APP_PURCHASES (MM API for WhatsApp only)`-   `APP_PURCHASES_CONVERSION_VALUE (MM API for WhatsApp only)`-   `WEBSITE_ADD_TO_CART (MM API for WhatsApp only)`-   `WEBSITE_CHECKOUTS_INITIATED (MM API for WhatsApp only)`-   `WEBSITE_PURCHASES (MM API for WhatsApp only)`-   `WEBSITE_PURCHASES_CONVERSION_VALUE (MM API for WhatsApp only)`
+[Acesse este link para saber mais sobre as métricas de custo e clique](#template-analytics-cost-and-click-metrics).
-Saiba mais sobre custos e métricas de clique [neste link](/documentation/business-messaging/whatsapp/analytics#cost-and-click-metrics).
+**Informamos que `COST` não será retornado para WABAs que compartilham a linha de crédito de um parceiro de soluções. Caso sua WABA compartilhe a linha de crédito de um parceiro de solução, entre em contato com ele para entender as cobranças.**
 `[SENT,DELIVERED,READ]`
@@ -661,9 +673,9 @@ O tipo de produto das métricas a serem recuperadas. Se omitido, serão retornad
 Valores possíveis:
--   `CLOUD_API` – Para filtrar métricas de modelos enviados por meio da API de Nuvem-   `CLOUD_API` – Para filtrar métricas de modelos enviados por meio da API de Mensagens de Marketing Lite
+-   `CLOUD_API`: para filtrar métricas de modelos enviados por meio da API de Nuvem-   `MARKETING_MESSAGES_API_FOR_WHATSAPP`: para filtrar métricas de modelos enviados por meio da API de Mensagens de Marketing para WhatsApp
-`MARKETING_MESSAGES_LITE_API`
+`MARKETING_MESSAGES_API_FOR_WHATSAPP`
 `<USE_WABA_TIMEZONE>`
@@ -690,23 +702,23 @@ curl -g 'https://graph.facebook.com/v24.0/109259195336416/template_analytics?sta
 -H 'Authorization: Bearer EAAJB...'
 ```
-Exemplo de resposta:
+Exemplo de resposta
 ```
-{  "data": [    {      "granularity": "DAILY",      "product_type": "cloud_api", // Only available to businesses in the Marketing Messages Lite API alpha      "data_points": [        {          "template_id": "1421988012088524",          "start": 1718064000,          "end": 1718150400,          "sent": 1,          "delivered": 1,          "read": 1,          "cost": [            {              "type": "amount_spent",              "value": 0.01            },            {              "type": "cost_per_delivered",              "value": 0.01            }          ]        },        {          "template_id": "2632273056924580",          "start": 1718064000,          "end": 1718150400,          "sent": 1,          "delivered": 1,          "read": 1,          "clicked": [            {              "type": "quick_reply_button",              "button_content": "Contact Support",              "count": 108            },            {              "type": "unique_url_button",              "button_content": "Tell me more",              "count": 16            }          ],          "cost": [            {              "type": "amount_spent",              "value": 0.03            },            {              "type": "cost_per_delivered",              "value": 0.03            },            {              "type": "cost_per_url_button_click",              "value": 0.03            }          ]        }      ]    }  ],  "paging": {    "cursors": {      "before": "MAZDZD",      "after": "MjQZD"    }  }}
+{  "data": [    {      "granularity": "DAILY",      "product_type": "cloud_api", // Only available to businesses in the Marketing Messages API for WhatsApp alpha      "data_points": [        {          "template_id": "1421988012088524",          "start": 1718064000,          "end": 1718150400,          "sent": 1,          "delivered": 1,          "read": 1,          "cost": [            {              "type": "amount_spent",              "value": 0.01            },            {              "type": "cost_per_delivered",              "value": 0.01            }          ]        },        {          "template_id": "2632273056924580",          "start": 1718064000,          "end": 1718150400,          "sent": 1,          "delivered": 1,          "read": 1,          "clicked": [            {              "type": "quick_reply_button",              "button_content": "Contact Support",              "count": 108            },            {              "type": "unique_url_button",              "button_content": "Tell me more",              "count": 16            }          ],          "cost": [            {              "type": "amount_spent",              "value": 0.03            },            {              "type": "cost_per_delivered",              "value": 0.03            },            {              "type": "cost_per_url_button_click",              "value": 0.03            }          ]        }      ]    }  ],  "paging": {    "cursors": {      "before": "MAZDZD",      "after": "MjQZD"    }  }}
 ```
-### Métricas de custo e clique
+### Custo de análise de modelos e métricas de cliques
 As **métricas de custo** são retornadas como uma matriz de objetos de custo, cada um com um tipo e valor. Os tipos podem ser:
--   `amount_spent`: o valor total gasto em conversas abertas no período entre `start` e `end` como resultado do envio do modelo. Veja a seção [Preços baseados em conversas](/documentation/business-messaging/whatsapp/pricing#opening-conversations).-   `cost_per_delivered`: o valor `amount_spent` dividido pelo número de vezes que o modelo foi entregue no período entre `start` e `end`.-   `cost_per_url_button_click`: o valor `amount_spent` dividido pelo número de cliques no botão de URL do modelo no período entre `start` e `end`. Cliques no botão de resposta rápida não são incluídos. Objeto omitido se o modelo não tiver um botão de URL.
+-   `amount_spent`: o valor total gasto em conversas abertas no período entre `start` e `end` como resultado do envio do modelo. Consulte a seção [Preços baseados em conversas](/documentation/business-messaging/whatsapp/pricing#opening-conversations).-   `cost_per_delivered`: o valor `amount_spent` dividido pelo número de vezes que o modelo foi entregue no período entre `start` e `end`.-   `cost_per_url_button_click`: o valor `amount_spent` dividido pelo número de cliques no botão de URL do modelo no período entre `start` e `end`. Cliques no botão de resposta rápida não são incluídos. Objeto omitido se o modelo não tiver um botão de URL.
 As **métricas de clique** são retornadas como uma matriz de objetos JSON, cada um com um tipo e valor. Os cliques são retornados apenas para botões de URL e de resposta rápida em modelos categorizados como `MARKETING` ou `UTILITY`.
 Os tipos podem ser:
--   `url_button` – O número total de cliques no botão de URL.-   `unique_url_button` – Cliques únicos acompanham o número de contas distintas do WhatsApp que clicaram em um botão. Essa métrica ajuda você a compreender quantos usuários individuais estão interagindo com seus CTAs, eliminando cliques duplicados do mesmo destinatário e proporcionando uma mensuração precisa do engajamento.
+-   `url_button`: o número total de cliques no botão de URL.-   `unique_url_button`: cliques únicos acompanham o número de contas distintas do WhatsApp que clicaram em um botão. Essa métrica ajuda você a compreender quantos usuários individuais estão interagindo com seus CTAs, eliminando cliques duplicados do mesmo destinatário e proporcionando uma mensuração precisa do engajamento.
 ### Como desabilitar a análise de cliques no botão
@@ -720,13 +732,13 @@ POST /<TEMPLATE_ID>
   &category=<TEMPLATE_CATEGORY>
 ```
-#### Parâmetros de solicitação
+#### Parâmetros da solicitação
 Espaço reservado
 Descrição
-Valor de exemplo
+Exemplo de valor
 `<WHATSAPP_TEMPLATE_ID>`
@@ -734,7 +746,7 @@ _ID do modelo_
 **Obrigatório.**
-O ID do modelo.
+ID do modelo.
 `245435364965041`
@@ -816,7 +828,7 @@ GET /<WHATSAPP_BUSINESS_ACCOUNT_ID>/template_group_analytics
   &template_group_ids=[<TEMPLATE_GROUP_IDS>]
 ```
-### Parâmetros de solicitação
+### Parâmetros de análise de grupo de modelos
 Espaço reservado
@@ -828,7 +840,7 @@ Valor de exemplo
 **Obrigatório.**
-É a identificação da conta do WhatsApp Business.
+Identificação da conta do WhatsApp Business.
 `102290129340398`
@@ -866,15 +878,15 @@ _Matriz de strings_
 **Opcional.**
-É a matriz de métricas que você quer receber. Se você enviar uma matriz vazia, a API retornará resultados para todos os tipos de métrica.
+É a matriz de métricas que você quer receber. Se você enviar uma matriz vazia, a API retornará resultados para todos os tipos de métricas.
 Os valores podem ser os seguintes:
 -   `cost`-   `clicked`-   `delivered`-   `read`-   `sent`
-`COST` não está disponível para clientes empresariais que recebem cobranças através de um parceiro de solução.
+`COST` não está disponível para clientes empresariais que recebem cobranças por meio de um parceiro de solução.
-Veja [Métricas de custo e clique](#cost-and-click-metrics-2) para saber mais sobre esses tipos de métricas.
+Consulte [Métricas de custo e clique](#template-group-cost-and-click-metrics) para saber mais sobre esses tipos de métricas.
 ```
 [
@@ -921,17 +933,139 @@ O exemplo abaixo foi truncado com uma elipse (`...`) para fins de concisão.
 {  "data": [    {      "granularity": "DAILY",      "data_points": [        {          "template_group_id": "1044106240855852",          "start": 1739491200,          "end": 1739577600,          "sent": 1460,          "delivered": 1460,          "read": 1399        },        {          "template_group_id": "1044106240855852",          "start": 1739404800,          "end": 1739491200,          "sent": 673,          "delivered": 673,          "read": 645        },        ...      ]    }  ],  "paging": {    "cursors": {      "before": "MAZDZD",      "after": "MjQZD"    }  }}
 ```
-### Métricas de custo e clique
+### Custo de grupo de modelos e métricas de cliques
 As **métricas de custo** são retornadas como uma matriz de objetos de custo, cada um com um tipo e valor. Os tipos podem ser:
--   `amount_spent`: o valor total gasto em conversas abertas no período entre `start` e `end` como resultado do envio do modelo. Veja a seção [Preços baseados em conversas](/documentation/business-messaging/whatsapp/pricing#opening-conversations).-   `cost_per_delivered`: o valor `amount_spent` dividido pelo número de vezes que o modelo foi entregue no período entre `start` e `end`.-   `cost_per_url_button_click`: o valor `amount_spent` dividido pelo número de cliques no botão de URL do modelo no período entre `start` e `end`. Cliques no botão de resposta rápida não são incluídos. Objeto omitido se o modelo não tiver um botão de URL.
+-   `amount_spent`: o valor total gasto em conversas abertas no período entre `start` e `end` como resultado do envio do modelo. Consulte a seção [Preços baseados em conversas](/documentation/business-messaging/whatsapp/pricing#opening-conversations).-   `cost_per_delivered`: o valor `amount_spent` dividido pelo número de vezes que o modelo foi entregue no período entre `start` e `end`.-   `cost_per_url_button_click`: o valor `amount_spent` dividido pelo número de cliques no botão de URL do modelo no período entre `start` e `end`. Cliques no botão de resposta rápida não são incluídos. Objeto omitido se o modelo não tiver um botão de URL.
 As **métricas de clique** são retornadas como uma matriz de objetos JSON, cada um com um tipo e valor. Os cliques são retornados apenas para botões de URL e de resposta rápida em modelos categorizados como `marketing` ou `utility`.
 Os tipos podem ser:
--   `url_button` – O número total de cliques no botão de URL.-   `unique_url_button` – Cliques únicos acompanham o número de contas distintas do WhatsApp que clicaram em um botão. Essa métrica ajuda você a compreender quantos usuários individuais estão interagindo com seus CTAs, eliminando cliques duplicados do mesmo destinatário e proporcionando uma mensuração precisa do engajamento.
+-   `url_button`: o número total de cliques no botão de URL.-   `unique_url_button`: cliques únicos acompanham o número de contas distintas do WhatsApp que clicaram em um botão. Essa métrica ajuda você a compreender quantos usuários individuais estão interagindo com seus CTAs, eliminando cliques duplicados do mesmo destinatário e proporcionando uma mensuração precisa do engajamento.
+## Análise das ligações
+O campo `call_analytics` fornece o número e o tipo de ligações feitas e recebidas por números de telefone associados a uma WABA específica. Quando você chamar `/<WHATSAPP_BUSINESS_ACCOUNT_ID>?fields=call_analytics.{filtering-parameters}`, será possível anexar os parâmetros a seguir.
+### Parâmetros de análise de ligações
+Nome
+Descrição
+Valor de exemplo
+`start`
+Tipo: registro de data e hora UNIX
+**Obrigatório.**
+A data de início do intervalo para o qual você está recuperando análises.
+`1728581152`
+`end`
+Tipo: registro de data e hora UNIX
+**Obrigatório.**
+É a data de término do intervalo para o qual você está recuperando análises.
+`1728581152`
+`granularity`
+Tipo: string
+**Obrigatório.**
+É o detalhamento desejado para a análise. Opções compatíveis:
+-   `HALF_HOUR`-   `DAILY`-   `MONTHLY`
+`DAILY`
+`phone_numbers`
+Tipo: matriz
+**Opcional.**
+É a matriz de números de telefone referentes à análise que você quer recuperar. Caso não seja fornecida, todos os números de telefone adicionados à sua WABA serão incluídos.
+`[15550783881,15550783882]`
+`country_codes`
+Tipo: matriz
+**Opcional.**
+São os países referentes à análise que você quer recuperar. Forneça uma matriz com códigos de duas letras para os países a serem incluídos. Caso a matriz não seja fornecida, retornaremos análises para todos os países com os quais você se comunicou.
+`[US,BR]`
+`directions`
+_Matriz de enumerações_
+**Opcional.**
+É a direção da ligação referente à análise que você quer recuperar. Opções compatíveis:
+-   `USER_INITIATED`-   `BUSINESS_INITIATED`
+`USER_INITIATED`
+`dimensions`
+_Matriz de enumerações_
+**Opcional.**
+É a lista de detalhamentos que você quer aplicar às suas métricas. Se você enviar uma lista vazia, retornaremos os resultados sem detalhamentos. Opções compatíveis:
+-   `phone`-   `direction`-   `country`
+`direction`
+`metric_types`
+_Matriz de enumerações_
+**Opcional.**
+É a matriz de métricas que você quer receber. Se você enviar uma matriz vazia, a API retornará resultados para todos os tipos de métricas. Opções compatíveis:
+-   `COUNT`-   `COST`-   `AVERAGE_DURATION`
+`AVERAGE_DURATION`
+### Exemplo
+**Cenário**: você precisa do número de ligações iniciadas pelo usuário e recebidas por todos os números de telefone associados à sua WABA com granularidade por dia.
+**Solução sugerida:** use estes parâmetros de filtragem: `start`, `end`, `granularity`, `directions`.
+```
+curl -i -X GET "https://graph.facebook.com/v24.0/102290129340398
+  ?fields=call_analytics
+  .start(1759302000)
+  .end(1767168000)
+  .granularity(DAILY)
+  .directions(USER_INITIATED)
+  &access_token=BLI8lkj..."
+```
+Uma resposta bem-sucedida retornará um objeto `call_analytics` com os dados solicitados:
+```
+{  "call_analytics": {    "granularity": "DAILY",    "directions": "USER_INITIATED",    "data_points": [      {          "start": 1765958400,          "end": 1766044800,          "cost": 0.47795,          "count": 35,          "average_duration": 106      },      {          "start": 1760943600,          "end": 1761030000,          "cost": 0,          "count": 20,          "average_duration": 103      },      {          "start": 1760857200,          "end": 1760943600,          "cost": 0,          "count": 24,          "average_duration": 103      },      # more data points    ]  },  "id": "102290129340398"}
+```
 ## Referência