Obter notificações de alteração para registros de chamadas do Microsoft Teams

As notificações de alteração no Microsoft Graph permitem que as assinaturas registrem registos de chamadas, fornecendo um fluxo contínuo de atualizações de registos de chamadas à medida que são criadas ou modificadas. Os registros de chamadas oferecem informações valiosas de uso e diagnóstico sobre chamadas e reuniões online da sua organização ao usar o Microsoft Teams ou o Skype for Business. Esses dados podem ser aproveitados para relatórios personalizados, facilitando o monitoramento da adoção e a solução de problemas de qualidade de chamadas.

Permissões

Tipo de permissão Permissões (da com menos para a com mais privilégios) Versões com suporte
Delegado (conta corporativa ou de estudante) Sem suporte. Sem suporte.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application CallRecords.Read.All v1.0

Exemplos

Exemplo 1: solicitação de assinatura

POST https://graph.microsoft.com/v1.0/subscriptions
Content-Type: application/json

{
  "changeType": "updated",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "lifecycleNotificationUrl": "https://webhook.azurewebsites.net/api/lifecycleNotifications",
  "resource": "/communications/callRecords",
  "expirationDateTime": "2023-02-28T00:00:00.0000000Z",
  "clientState": "{Secret client state}"
}

As notificações de alteração para registros de chamadas dão suporte a tipos de create notificação e update ambos. Uma assinatura para create alterações envia apenas uma única notificação quando um registro de chamada é visto pela primeira vez em uma assinatura específica. Um registro de chamada é criado após o término de uma chamada ou reunião e permanece acessível por 30 dias.

Uma assinatura para update alterações inclui uma notificação inicial quando o registro é visto pela primeira vez em uma assinatura específica e quaisquer notificações subsequentes à medida que esse registro é modificado. Como atributos específicos do registro de chamada dependem de sinais do lado do cliente, que podem estar sujeitos a atrasos ou interrupções devido a problemas de rede, um registro de chamada pode passar por atualizações com informações novas ou revisadas após sua criação inicial. Essas alterações disparam uma update notificação, e o campo do version registro é incrementado para indicar a modificação.

A latência das notificações de alteração e o período máximo de expiração da assinatura são definidos na síntese de notificações de alteração.

Exemplo 2: solicitação de assinatura filtrada por participante ID do objeto do Microsoft Entra

POST https://graph.microsoft.com/v1.0/subscriptions
Content-Type: application/json

{
  "changeType": "updated",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "lifecycleNotificationUrl": "https://webhook.azurewebsites.net/api/lifecycleNotifications",
  "resource": "/communications/callRecords?$filter=participants/any(p:p/id eq '{Entra object id}')",
  "expirationDateTime": "2023-02-28T00:00:00.0000000Z",
  "clientState": "{Secret client state}"
}

Opcionalmente, você pode filtrar as notificações de alteração para registros de chamadas usando a ID do Objeto do Microsoft Entra de um participante. As notificações de alteração filtradas por ID de Objeto são enviadas quando a ID de Objeto do Microsoft Entra de um participante da chamada é incluída no parâmetro de filtro.

Esse filtro dá suporte a eq, ore in operadores para o participantsid atributo da coleção em um recurso callRecord. Para obter mais detalhes sobre como usar $filter, consulte Usar o parâmetro de consulta $filter.

Exemplo 3: Notificação de assinatura

{
    "value":[{
        "subscriptionId":"{Subscription id}",
        "clientState":"{Secret client state}",
        "changeType":"created",
        "resource":"communications/callRecords/{Call id}",
        "subscriptionExpirationDateTime":"2023-02-28T00:00:00.000+00:00",
        "resourceData":{
            "@odata.type":"#Microsoft.Graph.callRecord",
            "@odata.id":"communications/callRecords/{Call id}",
            "id":"{Call id}"
        },
        "tenantId":"{Organization/Tenant id}"
    }]
}

Conteúdo relacionado

  • Last updated on