Compartilhar via


Trabalhar com a API de registros de chamadas no Microsoft Graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

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 chamada para assinar registros de chamadas, listar 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 Listar callRecords
Obter callRecord
directRoutingLogRow getDirectRoutingCalls
participante Listar participants_v2
pstnBlockedUsersLogRow getPstnBlockedUsersLog
pstnCallLogRow getPstnCalls
pstnOnlineMeetingDialoutReport getPstnOnlineMeetingDialoutReport
segmento Listar sessões
Obter callRecord
sessão Listar sessões
Obter callRecord
smsLogRow getSmsLog

Estrutura do registro de chamadas

A entidade callRecord representa uma única chamada ponto a ponto ou uma chamada em grupo entre vários participantes, às vezes chamada 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.