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. Você pode usar as APIs de registros de chamadas para se inscrever nos registros de chamadas e procurar registros de chamadas por IDs. Um registro de chamada é criado após o término de uma chamada ou reunião e o registro é mantido por 30 dias.

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

Principais tipos de recursos

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

Estrutura do registro de chamadas

A entidade callRecord representa uma única chamada ponto a ponto ou uma chamada de grupo entre vários participantes, às vezes chamada de reunião on-line.

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.