Partilhar via


Trabalhar com a API de registros de chamadas no Microsoft Graph

Os registros das chamadas fornecem informações de uso e diagnóstico das chamadas e reuniões on-line que ocorrem na sua organização ao usar o Microsoft Teams ou o Skype for Business. Pode utilizar as APIs de registos de chamadas para subscrever registos de chamadas, listar registos de chamadas e procurar registos de chamadas por IDs. É criado um registo de chamada após o fim de uma chamada ou reunião e o registo é retido durante 30 dias.

A API de registros de chamadas é definida no subnamespace OData, microsoft.graph.callRecords.

Principais tipos de recursos

Resource Métodos
callRecord Listar chamadasRegistos
Obter callRecord
directRoutingLogRow getDirectRoutingCalls
participante Listar participants_v2
pstnCallLogRow getPstnCalls
segmento Listar sessões
Obter callRecord
sessão Listar sessões
Obter callRecord

Estrutura do registro de chamadas

A entidade callRecord representa uma única chamada ponto a ponto ou uma chamada de grupo entre vários participantes, por vezes referida como uma reunião online.

Uma chamada ponto a ponto contém uma única sessão entre os dois participantes da chamada. As chamadas de grupo contêm uma ou mais entidades de sessão. Em uma chamada de grupo, cada sessão fica entre o participante e um ponto de extremidade do serviço.

Cada sessão contém uma ou mais entidades do segmento. Um segmento representa um link de mídia entre dois pontos de extremidade. Para a maioria das chamadas, apenas um segmento estará presente em cada sessão. Entretanto, às vezes, poderá haver um ou mais pontos de extremidade intermediários.

Imagem de uma estrutura de dados que representa um registro de chamada concluída

No diagrama acima, o número denota quantas crianças de cada tipo podem estar presentes. Por exemplo: uma relação 1..N entre um callRecord e uma sessão significa que uma instância callRecord pode conter uma ou mais instâncias da sessão. Da mesma forma, uma relação 1..N entre um segmento e uma mídia significa que uma instância do segmento pode conter um ou mais fluxos de mídia.