Relatório de uso PSTN do Microsoft Teams

• Aplica-se a:

  Microsoft Teams

O relatório de uso do Teams PSTN (Rede Telefônica Comutada Pública) e SMS no centro de administração do Microsoft Teams fornece uma visão geral da atividade de chamada e conferência de áudio em sua organização. Você pode exibir atividade de chamada detalhada para Planos de Chamada se usar a Microsoft como sua operadora de telefonia e para Roteamento Direto se você usar sua própria operadora de telefonia.

A guia Planos de Chamada mostra informações, incluindo o número de minutos que os usuários gastaram em chamadas PSTN de entrada e saída e o custo dessas chamadas. A guia Roteamento Direto mostra informações, incluindo o endereço SIP e os horários de início e término da chamada. Use as informações neste relatório para obter informações sobre o uso de PSTN em sua organização e ajudá-lo a investigar, planejar e tomar decisões de negócios.

Nota

Se você tiver um plano de chamada telstra ou softbank, não verá nenhum registro de detalhes de chamada no relatório de uso do PSTN. Entre em contato com a Telstra ou o Softbank para obter suas necessidades de relatório.

Exibir o relatório de uso do PSTN

1. Na navegação à esquerda do centro de administração do Microsoft Teams, clique em Análise & relatórios>Relatórios de uso. Na guia Exibir relatórios, em Relatório, selecione Uso de PSTN e SMS (versão prévia).
2. Em Intervalo de datas, selecione um intervalo predefinido de 7 ou 28 dias ou defina um intervalo personalizado e selecione Executar relatório.

Interpretar relatório

Planos de Chamadas

Texto Explicativo	Descrição
1	O relatório pode ser exibido para tendências nos últimos 7 dias, 28 dias ou um intervalo de datas personalizado que você definiu.
2	Cada relatório tem uma data para quando foi gerado. O relatório geralmente reflete um período de latência de atividade de 24 a 48 horas.
3	O eixo X é o intervalo de datas selecionado para o relatório específico. O eixo Y é o número total de chamadas durante o período de tempo selecionado. Passe o mouse sobre o ponto em uma determinada data para ver o total de chamadas nessa data.
4	A tabela fornece uma divisão do uso de PSTN por chamada. O carimbo de hora (UTC) é a hora em que a chamada foi iniciada. Nome de exibição é o nome de exibição do usuário. Você pode clicar no nome de exibição para acessar a página de configuração do usuário no centro de administração do Microsoft Teams. Nome de usuário é o nome de entrada do usuário. Número de telefone é o número que recebeu a chamada para chamadas de entrada ou o número discado para chamadas de saída. Tipo de chamada é se a chamada era uma chamada de saída ou de entrada PSTN e o tipo de chamada, como uma chamada feita por um usuário ou uma conferência de áudio. Os tipos de chamadas que você pode ver incluem: Tipos de chamada de usuário do Teams user_in - o usuário recebeu uma chamada PSTN de entrada user_out - o usuário fez uma chamada PSTN de saída user_out_conf - o usuário adicionou dois ou mais participantes PSTN à chamada, como uma teleconferência de três vias user_out_transfer - o usuário transferiu a chamada para um número PSTN user_out_forwarding - o usuário encaminhou a chamada para um número PSTN conf_in - uma chamada de entrada para a ponte de conferência de áudio conf_out - uma chamada de saída da ponte de conferência de áudio geralmente para adicionar um número PSTN à conferência unassigned_in - uma chamada PSTN de entrada por meio do Plano de Chamada para um número não atribuído Tipos de chamada de bots do Teams ucap_in - uma chamada PSTN de entrada para o bot do Teams, como atendimento automático ou fila de chamadas ucap_out - uma chamada PSTN de saída de um bot do Teams, como atendimento automático ou fila de chamadas Chamado para é o número discado. Para país ou região é o país ou região discado. Chamado de é o número que fez a chamada. De país ou região é o país ou região de onde a chamada foi feita. A cobrança é a quantidade de dinheiro ou custo da chamada cobrada para sua conta. Conversor de Moedas é o tipo de moeda usada para calcular o custo da chamada. Duração é o tempo em que a chamada esteve conectada. Doméstico/Internacional informa se a chamada foi doméstica (dentro de um país ou região) ou internacional (fora de um país ou região) com base na localização do usuário. ID de chamada é a ID de chamada para uma chamada. É um identificador para a chamada que você pode usar ao chamar Suporte da Microsoft. O tipo de número é o tipo de número de telefone do usuário, como um serviço de número gratuito. País ou região é o local de uso. A ID da conferência é a ID da conferência de áudio. A funcionalidade é a licença usada para a chamada. Os tipos de licença que você pode ver incluem: MCOEV ou MCOEV_VIRTUALUSER ou MCOEV_VIRTUALUSER_GOV – Aplicativos de voz, como Atendimento Automático ou Filas de Chamadas FREECALL – No caso de um problema técnico que nos impede de precificar uma chamada, a chamada é fornecida gratuitamente e aparecerá com esse recurso MCOPSTN1 - Plano de Chamada Doméstica (3000 min de planos da UE / 1200 min) MCOPSTN2 – Plano de Chamada Internacional MCOPSTN5 - Plano de Chamada Doméstica (plano de chamada de 120 minutos) MCOPSTN6 – Plano de Chamada Doméstica (plano de chamada de 240 minutos) MCOPSTN8 – Plano de Chamada Doméstica 120 min por usuário (não agrupado entre usuários como os outros planos de chamada) MCOPSTN9 – Plano de Chamada Internacional MCOPSTNCAP – Common Area Phone MCOPSTNPP - Créditos de comunicação MCOMEETADD – Conferência de áudio MCOMEETADD_DIALOUT_US - Plano de discagem dos EUA e canadá MCOMEETADD_CN_GLOBAL – Conferência de áudio para usuários que não são da China MCOMEETADD_TATA – Tata Communications Connections MCOMEETACPEA - Conferência de áudio paga por minuto MCOMEETACPEA_GOV - Pagamento por minuto de conferência de áudio para o governo Para ver as informações desejadas na tabela, certifique-se de adicionar as colunas à tabela.
5	Selecione Editar colunas para adicionar ou remover colunas na tabela.
6	Selecione Filtrar para filtrar o relatório por nome de usuário ou tipo de chamada.
7	Selecione Tela inteira para exibir o relatório no modo de tela inteira.
8	Você pode exportar o relatório para um arquivo CSV para análise offline. Clique em Exportar para o Excel e, na guia Downloads , clique em Baixar para baixar o relatório quando estiver pronto.

Roteamento Direto

Texto Explicativo	Descrição
1	O relatório pode ser exibido para tendências nos últimos 7 dias ou 28 dias.
2	Cada relatório tem uma data para quando foi gerado. O relatório geralmente reflete um período de latência de atividade de 24 a 48 horas.
3	O eixo X é o intervalo de datas selecionado para o relatório específico. O eixo Y é o número total de chamadas durante o período de tempo selecionado. Passe o mouse sobre o ponto em uma determinada data para ver o total de chamadas nessa data.
4	A tabela fornece uma divisão do uso de PSTN por chamada. O carimbo de hora (UTC) é a hora em que a chamada foi iniciada. Nome de exibição é o nome de exibição do usuário. Você pode clicar no nome de exibição para acessar a página de configurações do usuário no centro de administração do Microsoft Teams. O nome também pode ser o nome de um bot, por exemplo, o Call Queue ou o Cloud Auto Attendant. O endereço SIP é o endereço SIP do usuário ou de um bot que recebeu ou fez a chamada. O número do chamador é o número do usuário ou do bot que fez a chamada. O número do destinatário de chamada é o número do usuário ou do bot que recebeu a chamada. Em uma chamada de entrada para um usuário do Teams, ele será o usuário do Teams, em uma chamada de saída de um usuário do Teams, ele será o Usuário PSTN. Tipo de chamada é se a chamada era uma chamada de saída ou de entrada PSTN e o tipo de chamada, como uma chamada feita por um usuário ou uma conferência de áudio. Os tipos de chamada que você pode ver incluem: Tipos de chamada de usuário do Teams dr_in - o usuário recebeu uma chamada PSTN de entrada dr_out - o usuário fez uma chamada PSTN de saída dr_out_user_conf - o usuário adicionou um participante PSTN à chamada dr_out_user_forwarding - o usuário encaminhou a chamada para um número PSTN dr_out_user_transfer - o usuário transferiu a chamada para um número PSTN dr_emergency_out - o usuário fez uma chamada de emergência dr_unassigned_in - uma chamada PSTN de entrada por meio do Roteamento Direto para um número não atribuído Tipos de chamada de bots do Teams dr_in_bot - uma chamada PSTN de entrada para um bot do Teams, como atendimento automático ou fila de chamadas dr_out_bot - uma chamada PSTN de saída de um bot do Teams, como atendimento automático ou fila de chamadas Chamado para é o número do usuário que recebeu a chamada. A hora de início (UTC) é a hora em que o proxy SIP recebeu a resposta final (MENSAGEM SIP "200 OK") do SBC em uma chamada de saída (Teams/Bot para um usuário PSTN) ou depois que o Proxy SIP enviar o Convite para o próximo salto dentro do back-end do Teams em uma chamada de entrada (Usuário PSTN para um Teams/Bot). Tempo de convite (UTC) é a hora em que o Convite inicial foi enviado em uma chamada de saída de um usuário ou bot do Teams para o SBC ou recebido em uma chamada de entrada para uma chamada do Teams ou bot pelo componente proxy SIP do Roteamento Direto do SBC. O tempo de falha (UTC) é a hora em que a chamada falhou. Somente para chamadas com falha. O Código SIP final, o Subcodificado Final da Microsoft e a Frase SIP Final fornecem os motivos pelos quais a chamada falhou e podem ajudar na solução de problemas. Tempo de término (UTC) é a hora em que a chamada terminou (somente para chamadas bem-sucedidas). A duração é quanto tempo a chamada foi conectada, desde o convite até o fim ou falha da chamada. Para encaminhamento de chamadas, a duração inclui o toque na Fila de Chamadas. O tipo de número é o tipo de número de telefone do usuário, como um serviço de número gratuito. O bypass de mídia indica se o tronco estava habilitado para bypass de mídia. O SBC FQDN é o FQDN (nome de domínio totalmente qualificado) do SBC (Controlador de Borda de Sessão). A região do Azure para Mídia é o data center que foi usado como caminho de mídia em uma chamada sem bypass. A região do Azure para Sinalização é o data center usado para sinalização para chamadas de bypass e não bypass. Tipo de evento é o tipo de evento da chamada. Você verá Sucesso para chamadas bem-sucedidas e Tentativa de chamadas com falha. O código SIP final é o código com o qual a chamada terminou. O subcodificado final da Microsoft é um código que indica ações específicas que ocorreram. A frase SIP final é a descrição do código SIP e do subcodificado da Microsoft. A ID de correlação é um identificador exclusivo para a chamada que você pode usar ao chamar Suporte da Microsoft. A ID de Correlação Compartilhada só está visível no arquivo CSV para download e não existe no portal. A ID de correlação compartilhada existe em pelo menos duas chamadas relacionadas. Confira a descrição detalhada abaixo. Para ver as informações desejadas na tabela, certifique-se de adicionar as colunas à tabela.
5	Selecione Editar colunas para adicionar ou remover colunas na tabela.
6	Selecione Tela inteira para exibir o relatório no modo de tela inteira.
7	Selecione Exportar para Excel para baixar os dados em um CSV (arquivo separado por vírgulas) para análise offline ou usá-los como entrada para seu sistema de cobrança.

Considerações sobre campos de chamador/callee

Dependendo da direção da chamada, os nomes de chamador ou de chamada podem conter números não E164.

Esses campos podem vir dos SBC(s) do cliente. Há três formatos que o SBC pode enviar para o Roteamento Direto: números E.164, números não E.164 e cadeias de caracteres.

• E.164 número de telefone de um usuário que tem um número E.164 para um usuário que também tem um número E.164.
• Chame de um número não E.164. Um usuário de um PBX de terceiros interconectado com o Roteamento Direto faz uma chamada para um usuário do Teams. Nesse caso, o número do chamador pode ser qualquer número que não seja E.164, por exemplo +1001.
• Um spammer chama e não apresenta um número, apenas um nome, por exemplo, "Receita Federal". Essa cadeia de caracteres será mostrada nos relatórios.

Ofuscação do número de telefone

Os requisitos de privacidade por país/região incluem a ofuscação dos números de telefone externos (não pertencentes ao cliente). Os três ou quatro últimos dígitos do número de telefone são substituídos por asteriscos (+123 456789***).

Para chamadas recebidas, o número do chamador é ofuscado, para chamadas de saída, o número do destinatário de chamada é ofuscado. Observe que essas regras se aplicam aos relatórios PSTN e Roteamento Direto no Tenant Administração Center, à exportação de dados e aos logs de chamadas PSTN disponíveis por meio do Microsoft Graph. As regras de ofuscação de número de telefone em outros relatórios, como Análise de Chamadas e Painel de Qualidade de Chamada, podem ser diferentes.

A ofuscação baseia-se na localização da organização (país/região). Os números de telefone completos são mostrados para os países/regiões que não estão listados na tabela a seguir:

País/Região	Número de dígitos de ofuscação
BE – Bélgica	3
CH – Suíça	4
DE – Alemanha	3
DK – Dinamarca	3
ES – Espanha	3
FI – Finlândia	3
FR – França	4
TI – Itália	3
NL – Países Baixos	3
NÃO – Noruega	3
SE – Suécia	3

Sobre a ID de Correlação Compartilhada

A ID de Correlação Compartilhada só existe no arquivo do Excel exportado que você baixa e indica que duas ou mais chamadas estão relacionadas. O seguinte explica os diferentes cenários e quando a ID de Correlação Compartilhada está presente.

1. Usuário PSTN 1 em um ponto de extremidade PSTN chamado Usuário do Teams 1 no cliente teams, tipo de chamada Dr_In, ID de correlação 57f28917-42k5-4c0c-9433-79734873f2ac, nenhuma ID de correlação compartilhada.
2. O usuário do Teams 1 no cliente do Teams chamado PSTN User 1 em um ponto de extremidade PSTN, tipo de chamada Dr_Out 2c12b8ca-62eb-4c48-b68d-e451f518ff4, nenhuma ID de correlação compartilhada.
3. Usuário PSTN 1 em um ponto de extremidade PSTN chamado usuário do Teams 2 no cliente do Teams, tipo de chamada Dr_In f45e9a25-9f94-46e7-a457-84f5940efde9, ID de correlação compartilhada f45e9a25-9f94-46e7-a457-84f5940efde9.
4. Chamada 3 existente com iD de correlação "f45e9a25-9f94-46e7-a457-84f5940efde9". Usuário PSTN 1 em uma chamada com o Usuário do Teams 2. O Usuário do Teams 2 transferiu (cego ou consultivo) uma chamada para o Teams ou usuário PSTN, tipo de chamada Dr_Out_User_Transfer 45a1da7c-9e97-481a-8a05-3fe19a9a77e0, ID de correlação compartilhada f45e9a25-9f94-46e7-a457-84f5940efde9.

Retenção de dados

Os requisitos regulatórios por país especificam a retenção de dados de registros de chamadas detalhados. O período de retenção por país em dias é listado na seguinte tabela:

País	Planos de Chamada PSTN	Roteamento Direto
AC – Canadá	150	150
CH – Suíça	365	365
DK – Dinamarca	365	365
FI – Finlândia	365	365
FR – França	365	365
TI – Itália	730	730
KR – Coreia do Sul	365	365
MX – México	720	730
NL – Países Baixos	180	180
NÃO – Noruega	150	150
SE – Suécia	180	180
GB – Grã-Bretanha	450	450
Todos os outros países	365	150

Observe que essas regras se aplicam aos relatórios PSTN e Roteamento Direto no Centro de Administração de Locatários, à exportação de dados e aos logs de chamadas PSTN e Roteamento Direto disponíveis por meio do Microsoft Graph. A retenção de dados em outros relatórios, como Análise de Chamadas e Painel de Qualidade de Chamada, pode ser diferente.

O período de retenção é baseado na localização do usuário (país). Se o administrador do locatário não definir a localização de um usuário, o valor padrão para a localização de um usuário será o local do locatário.

Exportando os relatórios

Clique em Exportar para o Excel e, na guia Downloads , clique em Baixar para baixar o relatório quando estiver pronto. O processo de exportação pode levar de alguns segundos a vários minutos para ser concluído, dependendo da quantidade dos dados.

Esse protocolo exporta os dados de todos os usuários e permite que você execute a classificação e a filtragem simples para análises posteriores. Os arquivos exportados contêm campos adicionais que não estão disponíveis no relatório online. Eles podem ser usados para solução de problemas e fluxos de trabalho automatizados.

Você receberá um arquivo zip chamado "Chamadas.Exportar.[identifier].zip", com o identificador sendo uma ID exclusiva para a exportação que pode ser usada para solução de problemas.

Se você tiver planos de chamada e roteamento direto, o arquivo exportado poderá conter dados para ambos os produtos. O arquivo de relatório de uso PSTN terá o nome do arquivo "PSTN.calls.[UTC date].csv" e roteamento direto "DirectRouting.calls.[UTC date].csv".

Além dos arquivos PSTN e Direct Routing, o arquivo contém o arquivo "parameters.json", com o intervalo de tempo de exportação e os recursos selecionados.

Os arquivos exportados estão no formato CSV (Valores Separados por Vírgula), em conformidade com o padrão RFC 4180 . Os arquivos podem ser abertos no Excel ou em qualquer outro editor compatível com padrões sem exigir transformações.

A primeira linha do CSV contém nomes de coluna. Todas as datas são UTC e no formato ISO 8601 .

Relatório de uso PSTN exportado

Você pode exportar dados até um ano a partir da data atual, a menos que regulamentos específicos do país/região proíbam a retenção dos dados por 12 meses.

#	Nome	Tipo de dados (SQL Server)	Descrição
0	UsageId	uniqueidentifier	Identificador de chamada exclusivo
1	ID da chamada	nvarchar(64)	Identificador de chamada. Não é garantido ser exclusivo
2	ID de conferência	nvarchar(64)	ID da conferência de áudio
3	Localização do usuário	nvarchar(2)	Código de país do usuário, ISO 3166-1 alfa-2
4	Microsoft Entra ObjectId	uniqueidentifier	Chamando a ID do usuário em Microsoft Entra ID. Essa e outras informações de usuário serão nulas/vazias para tipos de chamada de bot (ucap_in, ucap_out)
5	UPN	nvarchar(128)	UserPrincipalName (nome de entrada) no Microsoft Entra ID. Isso geralmente é o mesmo que o endereço SIP do usuário e pode ser o mesmo que o endereço de email do usuário
6	Nome de exibição do usuário	nvarchar(128)	Nome de exibição do usuário
7	ID do chamador	nvarchar(128)	Número que recebeu a chamada para chamadas de entrada ou o número discado para chamadas de saída. Formato E.164
8	Tipo de Chamada	nvarchar(32)	Se a chamada era uma chamada de saída ou de entrada do PSTN e o tipo de chamada, como uma chamada feita por um usuário ou uma conferência de áudio
9	Direção de chamada	nvarchar(32)	Se a chamada era uma chamada de saída ou de entrada do PSTN
10	Tipo de Número	nvarchar(16)	Tipo de número de telefone do usuário, como um serviço de número gratuito
11	Doméstico/Internacional	nvarchar(16)	Se a chamada era doméstica (dentro de um país ou região) ou internacional (fora de um país ou região) com base na localização do usuário
12	Destino Discado	nvarchar(64)	País ou região discado
13	Número de destino	nvarchar(32)	Número discado no formato E.164
14	País Externo	nvarchar(16)	Código de país de dois dígitos discado
15	Hora de Início	datetimeoffset	Hora de início da chamada
16	Hora de Término	datetimeoffset	Hora do término da chamada
17	Segundos de Duração	int	Quanto tempo a chamada foi conectada
18	Taxa de Conexão	numeric(16, 2)	Preço da taxa de conexão
19	Carga	numeric(16, 2)	Quantidade de dinheiro ou custo da chamada que é cobrada em sua conta
20	Moeda	nvarchar(3)	Tipo de moeda usada para calcular o custo da chamada (ISO 4217)
21	Recursos	nvarchar(32)	A licença usada para a chamada
22	Operador	nvarchar(32)	Microsoft
23	Origem da duração da chamada	nvarchar(32)	Microsoft
24	Unidades Administrativas	uniqueidentifier	Coleção de unidades administrativas associadas a uma chamada.

Relatório de uso de roteamento direto exportado

Você pode exportar dados de até cinco meses (150 dias) da data atual, a menos que regulamentos específicos do país/região proíbam a retenção dos dados para esse período.

#	Nome	Tipo de dados (SQL Server)	Descrição
0	Correlationid	uniqueidentifier	Identificador de chamada. Várias pernas da mesma chamada podem compartilhar a mesma CorrelaçãoId
1	Microsoft Entra ObjectId	uniqueidentifier	Chamando a ID do usuário em Microsoft Entra ID. Essa e outras informações de usuário podem ser nulas/vazias para tipos de chamada de bot
2	UPN	nvarchar(128)	UserPrincipalName (nome de entrada, Microsoft Entra ID) do usuário ou bot que fez ou recebeu a chamada. Isso geralmente é o mesmo que o endereço SIP do usuário e pode ser o mesmo que o endereço de email do usuário
3	Nome de exibição	nvarchar(128)	O nome de um usuário ou um bot de chamada (por exemplo, Fila de Chamadas ou Atendente Automático) conforme definido em Centro de administração do Microsoft 365
4	País de usuário	nvarchar(2)	Código de país do usuário, ISO 3166-1 alfa-2
5	Hora do convite	datetimeoffset	Quando o convite inicial enviar na saída do usuário ou bot do Teams para o SBC ou recebido na entrada do Teams ou na chamada de bot pelo componente proxy SIP do Roteamento Direto do SBC
6	Hora de início	datetimeoffset	Hora em que o proxy SIP recebeu a resposta final (MENSAGEM SIP "200 OK") do SBC na saída (Teams/Bot para um usuário PSTN) ou depois que o Proxy SIP enviar o Convite para o próximo salto dentro do back-end do Teams na chamada de entrada (Usuário PSTN para um Teams/Bot). Para chamadas com falha e sem resposta, isso pode ser igual ao tempo de convite ou falha
7	Tempo de falha	datetimeoffset	Só existe para chamadas com falha (não totalmente estabelecidas)
8	Hora de término	datetimeoffset	Só existe para chamadas bem-sucedidas (totalmente estabelecidas). Hora em que a chamada terminou
9	Duração (segundos)	int	Duração da chamada, do convite ao fim ou à falha da chamada. Para encaminhamento de chamadas, a duração inclui o toque na Fila de Chamadas.
10	Sucesso	nvarchar(3)	Sim/Não. Sucesso ou tentativa
11	Número do chamador	nvarchar(32)	Número do usuário ou bot que fez a chamada. Na entrada de uma chamada de usuário da Equipe, ele será um usuário PSTN, na saída da chamada de usuário do Teams será o número de usuário do Teams
12	Número do callee	nvarchar(32)	Número do usuário ou bot que recebeu a chamada. Na entrada de uma chamada de usuário da Equipe, ele será o usuário do Teams, na saída da chamada de usuário do Teams, ele será o Usuário PSTN
13	Tipo de chamada	nvarchar(32)	Tipo e direção de chamada
14	Direção de chamada	nvarchar(32)	Se a chamada era uma chamada de saída ou de entrada do PSTN
15	Região do Azure para Mídia	nvarchar(8)	O datacenter usado para o caminho da mídia em chamada não bypass
16	Região do Azure para Sinalização	nvarchar(8)	O datacenter usado para sinalização para chamadas de bypass e não bypass
17	Código SIP final	int	O código com o qual a chamada terminou, RFC 3261
18	Subcodificado final da Microsoft	int	Além dos códigos SIP, a Microsoft tem subcódigos próprios que indicam o problema específico
19	Frase SIP final	nvarchar(256)	Descrição do código SIP e do subcodificado da Microsoft
20	SBC FQDN	nvarchar(64)	Nome de domínio totalmente qualificado do controlador de borda de sessão
21	Bypass de mídia	nvarchar(3)	Sim/Não. Indica se o tronco estava habilitado para bypass de mídia ou não
22	ID de correlação compartilhada	uniqueidentifier	Indica que duas ou mais chamadas estão relacionadas
23	Unidades Administrativas	uniqueidentifier	Coleção de unidades administrativas associadas a uma chamada.
24	ID de transferência ou correlação	uniqueidentifier	Indica CorrelaçãoId de chamada entre Transferee e Transferor

Tópicos relacionados

• Análises e relatórios do Teams
• Relatório de chamada PSTN no Microsoft Graph
• Relatório de roteamento direto no Microsoft Graph