Obter notificações de alteração para transcrições e gravações com o Microsoft Graph

As notificações de alteração permitem-lhe subscrever alterações a transcrições e gravações. Pode ser notificado sempre que estiver disponível uma transcrição ou uma gravação após uma reunião online ou uma chamada ad hoc.

Este artigo descreve cenários para os recursos de transcrição e gravação . Para obter mais informações, consulte Alterar notificações para recursos do Microsoft Teams.

Subscrever transcrições disponíveis ao nível do inquilino

Esta secção descreve os métodos para subscrever transcrições disponíveis ao nível do inquilino para reuniões online e chamadas ad hoc.

Para reuniões online

Para obter notificações de alteração para qualquer transcrição disponível para qualquer reunião online num inquilino, subscreva communications/onlineMeetings/getAllTranscripts. Este recurso oferece suporte a incluindo dados de recursos na notificação. A notificação de uma transcrição só é enviada se a subscrição ocorrer antes do início da transcrição. Esta subscrição suporta onlineMeetings agendados.

Permissões

É necessária uma das seguintes permissões para subscrever communications/onlineMeetings/getAllTranscriptso .

Para saber mais, incluindo como escolher permissões, confira Permissões.

Exemplo

O exemplo seguinte mostra como subscrever transcrições de reuniões online disponíveis ao nível do inquilino.

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

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/getAllTranscripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Para chamadas ad hoc

Para obter notificações de alteração para qualquer transcrição disponível para qualquer chamada ad hoc num inquilino, subscreva communications/adhocCalls/getAllTranscripts. Este recurso oferece suporte a incluindo dados de recursos na notificação.

Permissões

É necessária uma das seguintes permissões para subscrever communications/adhocCalls/getAllTranscriptso .

Para saber mais, incluindo como escolher permissões, confira Permissões.

Exemplo

O exemplo seguinte mostra como subscrever transcrições de chamadas ad hoc disponíveis ao nível do inquilino.

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

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/adhocCalls/getAllTranscripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "{expirationDateTime}",
  "clientState": "{secretClientState}"
}

Subscrever transcrições disponíveis para uma determinada reunião online

Para obter notificações de alteração para qualquer transcrição disponível para uma determinada reunião online, subscreva communications/onlineMeetings/{onlineMeetingId}/transcripts. Este recurso oferece suporte a incluindo dados de recursos na notificação. A notificação de uma transcrição só é enviada se a subscrição ocorrer antes do início da transcrição. Esta subscrição suporta onlineMeetings agendados.

Permissões

É necessária uma das seguintes permissões para subscrever communications/onlineMeetings/{onlineMeetingId}/transcriptso . Para saber mais, incluindo como escolher permissões, confira Permissões.

Exemplo 1: subscrever transcrições disponíveis para uma determinada reunião online com permissões clássicas

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

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/{onlineMeetingId}/transcripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Exemplo 2: subscrever transcrições disponíveis para uma determinada reunião online com permissões de consentimento específicas de recursos

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

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/{onlineMeetingId}/transcripts?useResourceSpecificConsentBasedAuthorization=true",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Subscrever transcrições disponíveis para uma chamada ad hoc específica

Para obter notificações de alteração para qualquer transcrição disponível para uma chamada ad hoc específica, subscreva communications/adhocCalls/{adhocCallId}/transcripts.

Permissões

É necessária uma das seguintes permissões para subscrever communications/adhocCalls/{adhocCallId}/transcriptso . Para saber mais, incluindo como escolher permissões, confira Permissões.

Exemplo: Subscrever transcrições disponíveis para uma chamada ad hoc específica com permissões clássicas

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

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/adhocCalls/{adhocCallId}/transcripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Subscrever transcrições disponíveis para reuniões online organizadas por um utilizador

Para obter notificações de alteração para qualquer transcrição disponível para qualquer reunião online organizada por um utilizador específico, subscreva users/{userId}/onlineMeetings/getAllTranscripts. Este recurso oferece suporte a incluindo dados de recursos na notificação. A notificação de uma transcrição só é enviada se a subscrição ocorrer antes do início da transcrição. Esta subscrição suporta onlineMeetings agendados.

Permissões

É necessária uma das seguintes permissões para subscrever users/{userId}/onlineMeetings/getAllTranscriptso . Para saber mais, incluindo como escolher permissões, confira Permissões.

Exemplo

O exemplo seguinte mostra como subscrever transcrições disponíveis para qualquer reunião online organizada por um utilizador específico.

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

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "users/{userId}/onlineMeetings/getAllTranscripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Subscrever transcrições disponíveis para chamadas ad hoc em que um utilizador específico inicia a transcrição

Para obter notificações de alteração para qualquer transcrição disponível para qualquer chamada ad hoc em que um utilizador específico inicie a transcrição, subscreva users/{userId}/adhocCalls/getAllTranscripts. Este recurso oferece suporte a incluindo dados de recursos na notificação. A notificação de uma transcrição só é enviada se a subscrição ocorrer antes do início da transcrição. Esta subscrição suporta chamadas ad hoc.

Permissões

É necessária uma das seguintes permissões para subscrever users/{userId}/adhocCalls/getAllTranscriptso . Para saber mais, incluindo como escolher permissões, confira Permissões.

Exemplo

O exemplo seguinte mostra como subscrever transcrições disponíveis para qualquer chamada ad hoc em que um utilizador específico inicia a transcrição.

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

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "users/{userId}/adhocCalls/getAllTranscripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Subscrever transcrições disponíveis para qualquer reunião online em que esteja instalada uma aplicação específica do Teams

Para obter notificações de alteração para qualquer transcrição disponível para qualquer reunião online em que esteja instalada uma aplicação específica do Teams, subscreva appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllTranscripts. Este recurso oferece suporte a incluindo dados de recursos na notificação. A notificação de uma transcrição só é enviada se a subscrição ocorrer antes do início da transcrição. Esta subscrição suporta onlineMeetings agendadas , mas não reuniões de canal.

Permissões

É necessária uma das seguintes permissões para subscrever appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllTranscriptso . Para saber mais, incluindo como escolher permissões, confira Permissões.

Exemplo 1: subscrever transcrições disponíveis para qualquer reunião online em que uma aplicação específica do Teams esteja instalada com permissões clássicas

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

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "appCatalogs/teamsApps/386bbcdb-1e1c-4f3f-b7d0-ad7b9ea6cf7c/installedToOnlineMeetings/getAllTranscripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Exemplo 2: subscrever transcrições disponíveis para qualquer reunião online em que uma aplicação específica do Teams esteja instalada utilizando apenas permissões de consentimento específicas de recursos

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

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "appCatalogs/teamsApps/386bbcdb-1e1c-4f3f-b7d0-ad7b9ea6cf7c/installedToOnlineMeetings/getAllTranscripts?useResourceSpecificConsentBasedAuthorization=true",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Subscrever gravações disponíveis ao nível do inquilino

Esta secção descreve os métodos para subscrever gravações disponíveis ao nível do inquilino para reuniões online e chamadas ad hoc.

Para reuniões online

Para obter notificações de alteração para qualquer gravação disponível para qualquer reunião online num inquilino, subscreva communications/onlineMeetings/getAllRecordings. Este recurso oferece suporte a incluindo dados de recursos na notificação. Esta subscrição suporta onlineMeetings agendados.

Permissões

É necessária uma das seguintes permissões para subscrever communications/onlineMeetings/getAllRecordingso . Para saber mais, incluindo como escolher permissões, confira Permissões.

Exemplo

O exemplo seguinte mostra como subscrever gravações disponíveis ao nível do inquilino para reuniões online.

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

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/getAllRecordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Para chamadas ad hoc

Para obter notificações de alteração para qualquer gravação disponível para qualquer chamada ad hoc num inquilino, subscreva communications/adhocCalls/getAllRecordings. Este recurso oferece suporte a incluindo dados de recursos na notificação. Esta subscrição suporta adhocCalls.

Permissões

É necessária uma das seguintes permissões para subscrever communications/adhocCalls/getAllRecordingso . Para saber mais, incluindo como escolher permissões, confira Permissões.

Exemplo

O exemplo seguinte mostra como subscrever gravações disponíveis ao nível do inquilino.

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

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/adhocCalls/getAllRecordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Subscrever gravações disponíveis para uma determinada reunião online

Para obter notificações de alteração para qualquer gravação disponível para uma determinada reunião online, subscreva communications/onlineMeetings/{onlineMeetingId}/recordings. Este recurso oferece suporte a incluindo dados de recursos na notificação. Esta subscrição suporta onlineMeetings agendados.

Permissões

É necessária uma das seguintes permissões para subscrever communications/onlineMeetings/{onlineMeetingId}/recordingso . Para saber mais, incluindo como escolher permissões, confira Permissões.

Exemplo 1: subscrever gravações disponíveis para uma determinada reunião online com permissões clássicas

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

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/{onlineMeetingId}/recordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Exemplo 2: subscrever gravações disponíveis para uma determinada reunião online utilizando apenas permissões de consentimento específicas de recursos

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

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/{onlineMeetingId}/recordings?useResourceSpecificConsentBasedAuthorization=true",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Subscrever gravações disponíveis para uma chamada ad hoc específica

Para obter notificações de alteração para qualquer gravação disponível para uma chamada ad hoc específica, subscreva communications/adhocCalls/{adhocCallId}/recordings. Este recurso oferece suporte a incluindo dados de recursos na notificação. Esta subscrição suporta chamadas ad hoc.

Permissões

É necessária uma das seguintes permissões para subscrever communications/adhocCalls/{adhocCallId}/recordingso . Para saber mais, incluindo como escolher permissões, confira Permissões.

Exemplo: Subscrever gravações disponíveis para uma chamada ad hoc específica com permissões clássicas

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

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/adhocCalls/{adhocCallId}/recordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Subscrever gravações disponíveis para reuniões online organizadas por um utilizador

Para obter notificações de alteração para qualquer gravação disponível para qualquer reunião online organizada por um utilizador específico, subscreva users/{userId}/onlineMeetings/getAllRecordings. Este recurso oferece suporte a incluindo dados de recursos na notificação. Esta subscrição suporta onlineMeetings agendados.

Permissões

É necessária uma das seguintes permissões para subscrever users/{userId}/onlineMeetings/getAllRecordingso . Para saber mais, incluindo como escolher permissões, confira Permissões.

Subscrever gravações disponíveis para chamadas ad hoc em que um utilizador específico inicia a transcrição

Para obter notificações de alteração para qualquer gravação disponível para qualquer chamada ad hoc em que um utilizador específico inicie a transcrição, subscreva users/{userId}/adhocCalls/getAllRecordings. Este recurso oferece suporte a incluindo dados de recursos na notificação. Esta subscrição suporta chamadas ad hoc.

Permissões

É necessária uma das seguintes permissões para subscrever users/{userId}/adhocCalls/getAllRecordingso . Para saber mais, incluindo como escolher permissões, confira Permissões.

Exemplo

O exemplo seguinte mostra como subscrever gravações disponíveis para qualquer chamada ad hoc em que um utilizador específico inicia a transcrição.

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

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "users/{userId}/adhocCalls/getAllRecordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Subscrever gravações disponíveis para qualquer reunião online em que esteja instalada uma aplicação específica do Teams

Esta secção descreve os métodos para subscrever gravações disponíveis para qualquer reunião online em que esteja instalada uma aplicação específica do Teams.

Para obter notificações de alteração para qualquer gravação disponível para qualquer reunião online em que esteja instalada uma aplicação específica do Teams, subscreva appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllRecordingso . Este recurso oferece suporte a incluindo dados de recursos na notificação. Esta subscrição suporta onlineMeetings agendadas , mas não reuniões de canal.

Permissões

É necessária uma das seguintes permissões para subscrever appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllRecordingso . Para saber mais, incluindo como escolher permissões, confira Permissões.

Exemplo 1: subscrever gravações disponíveis para qualquer reunião online em que uma aplicação específica do Teams esteja instalada com as permissões clássicas necessárias

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json
{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "appCatalogs/teamsApps/386bbcdb-1e1c-4f3f-b7d0-ad7b9ea6cf7c/installedToOnlineMeetings/getAllRecordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Exemplo 2: subscrever gravações disponíveis para qualquer reunião online em que uma aplicação específica do Teams esteja instalada utilizando apenas permissões de consentimento específicas de recursos

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json
{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "appCatalogs/teamsApps/386bbcdb-1e1c-4f3f-b7d0-ad7b9ea6cf7c/installedToOnlineMeetings/getAllRecordings?useResourceSpecificConsentBasedAuthorization=true",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Cargas de notificação

Consoante a sua subscrição, pode receber a notificação com ou sem dados de recursos. Subscrever dados de recursos permite-lhe obter a transcrição ou gravar metadados juntamente com a notificação.

Notificações com dados de recursos para transcrições

Para notificações com dados de recursos, a carga se parece com a seguinte. Este payload destina-se a uma transcrição disponível para uma reunião online. Para chamadas ad hoc, o meetingId é null.

Para reuniões online

{
  "value": [
    {
      "subscriptionId": "516220d0-0f88-46cc-ac39-02b687687526",
      "changeType": "created",
      "clientState": "<<--SpecifiedClientState-->>",
      "subscriptionExpirationDateTime": "2023-09-17T08:13:26.3265566+00:00",
      "resource": "users/{organizer-id}/onlineMeetings('Mso...')/transcripts('MSM...')",
      "resourceData": {
        "id": "MSM...",
        "@odata.type": "#Microsoft.Graph.callTranscript",
        "@odata.id": "users/{organizer-id}/onlineMeetings('Mso...')/transcripts('MSM...')"
      },
      "encryptedContent": {
        "data": "<<--EncryptedContent-->>",
        "dataKey": "<<--EnryptedDataKeyUsedForEncryptingContent-->>",
        "encryptionCertificateId": "<<--IdOfTheCertificateUsedForEncryptingDataKey-->>",
        "encryptionCertificateThumbprint": "<<--ThumbprintOfTheCertificateUsedForEncryptingDataKey-->>"
      },
      "tenantId": "<<--TenantForWhichNotificationWasSent-->>"
    }
  ],
  "validationTokens": [
    "<<--ValidationTokens-->>"
  ]
}

Para chamadas ad hoc

{
  "value": [
    {
      "subscriptionId": "8c0ff21a-ca3b-45db-b570-e589a7d3d02d",
      "changeType": "created",
      "clientState": "null",
      "subscriptionExpirationDateTime": "2025-08-08T06:29:30.356Z",
      "resource": "users/f2e8e111-3887-4936-87f8-639292c70d34/adhoccalls/5f3640e7-a59c-4bec-82ca-e66251f795b7/transcripts('MyM...')",
      "resourceData": {
        "id": "f2e8e111-3887-4936-87f8-639292c70d34",
        "@odata.type": "#Microsoft.Graph.callTranscript",
        "@odata.id": "users/{user-id}/adhoccalls/5f3640e7-a59c-4bec-82ca-e66251f795b7/transcripts('MyM...')"
      },
      "encryptedContent": {
        "data": "<<--EncryptedContent-->>",
        "dataKey": "<<--EnryptedDataKeyUsedForEncryptingContent-->>",
        "encryptionCertificateId": "<<--IdOfTheCertificateUsedForEncryptingDataKey-->>",
        "encryptionCertificateThumbprint": "<<--ThumbprintOfTheCertificateUsedForEncryptingDataKey-->>"
      },
      "tenantId": "<<--TenantForWhichNotificationWasSent-->>"
    }
  ],
  "validationTokens": [
    "<<--ValidationTokens-->>"
  ]
}

Notificações desencriptadas para transcrições com dados de recursos

A carga de notificação descriptografada parece com a seguinte. O payload está em conformidade com o esquema de transcrição . O payload é semelhante aos devolvidos pelas operações GET.

Para reuniões online

{
  "id": "MSM...",
  "meetingId": "MSo...",
  "callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
  "transcriptContentUrl": "users/{organizer-id}/onlineMeetings/MSo.../transcripts/MSM.../content",
  "createdDateTime": null,
  "endDateTime": "2023-04-10T08:27:25.2346000Z",
  "contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
  "meetingOrganizer": {
    "application": null,
    "device": null,
    "user": {
      "userIdentityType": "aadUser",
      "id": "976f4b31-fd01-4e0b-9178-29cc40c14438",
      "displayName": null,
      "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34"
    }
  }
}

Para chamadas ad hoc

{
  "id": "MyM...",
  "meetingId": null,
  "callId": "5f3640e7-a59c-4bec-82ca-e66251f795b7",
  "transcriptContentUrl": "users/f2e8e111-3887-4936-87f8-639292c70d34/adhoccalls/5f3640e7-a59c-4bec-82ca-e66251f795b7/transcripts/MyM.../content",
  "createdDateTime": null,
  "endDateTime": "2025-08-11T06:57:28.2265904Z",
  "contentCorrelationId": "58cfc66a-710f-4be7-adc0-1ca5a28f2c0c-0",
  "meetingOrganizer": {
    "application": null,
    "device": null,
    "user": {
      "userIdentityType": "aadUser",
      "id": "f2e8e111-3887-4936-87f8-639292c70d34",
      "displayName": null,
      "tenantId": "8393309d-9fb7-4cce-aafb-eedc8c5781e2"
    }
  }
}

Notificações com dados de recursos para gravações

Para notificações com dados de recursos, a carga se parece com a seguinte.

Para reuniões online

{
  "value": [
    {
      "subscriptionId": "7a62d59e-a789-4dd7-9c85-cf7d6567890d",
      "changeType": "created",
      "clientState": "<<--SpecifiedClientState-->>",
      "subscriptionExpirationDateTime": "2023-09-17T08:20:06.9211285+00:00",
      "resource": "users/{organizer-id}/onlineMeetings('Mso...')/recordings('VjI...')",
      "resourceData": {
        "id": "VjI...",
        "@odata.type": "#Microsoft.Graph.callRecording",
        "@odata.id": "users/{organizer-id}/onlineMeetings('Mso...')/recordings('VjI...')"
      },
      "encryptedContent": {
        "data": "<<--EncryptedContent-->>",
        "dataKey": "<<--EnryptedDataKeyUsedForEncryptingContent-->>",
        "encryptionCertificateId": "<<--IdOfTheCertificateUsedForEncryptingDataKey-->>",
        "encryptionCertificateThumbprint": "<<--ThumbprintOfTheCertificateUsedForEncryptingDataKey-->>"
      },
      "tenantId": "<<--TenantForWhichNotificationWasSent-->>"
    }
  ],
  "validationTokens": [
    "<<--ValidationTokens-->>"
  ]
}

Para chamadas ad hoc

{
  "value": [
    {
      "subscriptionId": "871b5d27-6f77-4100-b78d-bc443873324e",
      "changeType": "created",
      "clientState": "<<--SpecifiedClientState-->>",
      "subscriptionExpirationDateTime": "2025-07-24T18:04:24.3511596+00:00",
      "resource": "users/{user-id}/adhoccalls('1c9ddbc9-82be-46b6-8edd-bf833fe33a03')/recordings('MyMjMTk6ODA4MTExMTNiYWQzNDNhYzkzNGI2YTVmYzc1ZThmZGJAdGhyZWFkLnYyIyM1MTYwNzQ4MC1kM2FjLTRlZTQtOTQ3NS1lYjM2NTk5MjM4ZDYtMTc1MzM0NTA2OC1UcmFuc2NyaXB0VjI=')",
      "resourceData": {
        "id": "MyM...",
        "@odata.type": "#Microsoft.Graph.callRecording",
        "@odata.id": "users/{user-id}/adhoccalls('1c9ddbc9-82be-46b6-8edd-bf833fe33a03')/recordings(MyMjMTk6ODA4MTExMTNiYWQzNDNhYzkzNGI2YTVmYzc1ZThmZGJAdGhyZWFkLnYyIyM1MTYwNzQ4MC1kM2FjLTRlZTQtOTQ3NS1lYjM2NTk5MjM4ZDYtMTc1MzM0NTA2OC1UcmFuc2NyaXB0VjI=)",
      },
      "encryptedContent": {
        "data": "<<--EncryptedContent-->>",
        "dataKey": "<<--EnryptedDataKeyUsedForEncryptingContent-->>",
        "encryptionCertificateId": "<<--IdOfTheCertificateUsedForEncryptingDataKey-->>",
        "encryptionCertificateThumbprint": "<<--ThumbprintOfTheCertificateUsedForEncryptingDataKey-->>"
      },
      "tenantId": "<<--TenantForWhichNotificationWasSent-->>"
    }
  ],
  "validationTokens": [
    "<<--ValidationTokens-->>"
  ]
}

Notificações desencriptadas para gravações com dados de recursos

A carga de notificação descriptografada parece com a seguinte. O payload está em conformidade com o esquema de gravação . O payload é semelhante aos devolvidos pelas operações GET.

{
  "id": "VjI...",
  "meetingId": "MSo...",
  "callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
  "createdDateTime": "2023-07-25T09:35:02.85022Z",
  "endDateTime": "2023-04-10T08:27:25.2346000Z",
  "contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
  "recordingContentUrl": "users/{organizer-id}/MSo.../recordings/VjI.../content",
  "meetingOrganizer": {
    "application": null,
    "device": null,
    "user": {
      "userIdentityType": "aadUser",
      "id": "976f4b31-fd01-4e0b-9178-29cc40c14438",
      "displayName": null,
      "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34"
    }
  },
  "content": null
}

Notificações sem dados de recursos

As notificações sem dados de recursos dão-lhe o ID do recurso para efetuar chamadas GET para obter a transcrição ou gravação. As subscrições para notificações sem dados de recursos não necessitam de um certificado de encriptação (porque os dados de recursos reais não são enviados).

Para notificações sem dados de recursos, a carga se parecerá com o seguinte.

Para transcrições de reuniões online

{
  "subscriptionId": "0cc28c98-4d2a-4a34-b850-815d7e6486ea",
  "changeType": "created",
  "tenantId": "<<--TenantForWhichNotificationWasSent-->>",
  "clientState": "<<--SpecifiedClientState-->>",
  "subscriptionExpirationDateTime": "2023-09-17T08:29:11.3173971+00:00",
  "resource": "users/{organizer-id}/onlineMeetings('Mso...')/transcripts('MSM...')",
  "resourceData": {
    "id": "MSM...",
    "@odata.type": "#Microsoft.Graph.callTranscript",
    "@odata.id": "users/{organizer-id}/onlineMeetings('Mso...')/transcripts('MSM...')"
  }
}

Para transcrições de chamadas ad hoc

Para notificações sem dados de recursos, a carga se parecerá com o seguinte. Este payload destina-se a uma transcrição disponível para uma chamada ad hoc. Para chamadas ad hoc, o meetingId é null.

{
  "subscriptionId": "871b5d27-6f77-4100-b78d-bc443873324e",
  "changeType": "created",
  "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34",
  "clientState": "<<--SpecifiedClientState-->>",
  "subscriptionExpirationDateTime": "2025-07-24T18:04:24.3511596+00:00",
  "resource": "users/{user-id}/adhocCalls/1c9ddbc9-82be-46b6-8edd-bf833fe33a03/transcripts/MyMjMTk6ODA4MTExMTNiYWQzNDNhYzkzNGI2YTVmYzc1ZThmZGJAdGhyZWFkLnYyIyM1MTYwNzQ4MC1kM2FjLTRlZTQtOTQ3NS1lYjM2NTk5MjM4ZDYtMTc1MzM0NTA2OC1UcmFuc2NyaXB0VjI=",
  "resourceData": {
    "id": "MyM...",
    "@odata.type": "#Microsoft.Graph.callTranscript",
    "@odata.id": "users/{user-id}/adhoccalls/1c9ddbc9-82be-46b6-8edd-bf833fe33a03/transcripts('MyM...')"
  }
}

Para notificações sem dados de recursos, a carga se parecerá com o seguinte.

Para gravações de reuniões online

{
  "subscriptionId": "6aa5ced2-0a5a-4643-9274-3109c731d986",
  "changeType": "created",
  "tenantId": "<<--TenantForWhichNotificationWasSent-->>",
  "clientState": "<<--SpecifiedClientState-->>",
  "subscriptionExpirationDateTime": "2023-09-17T08:27:05.0241757+00:00",
  "resource": "users/{organizer-id}/onlineMeetings('Mso...')/recordings('VjI...')",
  "resourceData": {
    "id": "VjI...",
    "@odata.type": "#Microsoft.Graph.callRecording",
    "@odata.id": "users/{organizer-id}/onlineMeetings('Mso...')/recordings('VjI...')"
  }
}

Para gravações de chamadas ad hoc

{
"subscriptionId": "871b5d27-6f77-4100-b78d-bc443873324e",
  "changeType": "created",
  "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34",
  "clientState": "<<--SpecifiedClientState-->>",
  "subscriptionExpirationDateTime": "2025-07-24T18:04:24.3511596+00:00",
  "resource": "users/{user-id}/adhoccalls/adhocCalls/1c9ddbc9-82be-46b6-8edd-bf833fe33a03/recordings('MyM...')",
  "resourceData": {
    "id": "MyM...",
    "@odata.type": "#Microsoft.Graph.callRecording",
    "@odata.id": "users/{user-id}/adhoccalls/1c9ddbc9-82be-46b6-8edd-bf833fe33a03/recordings('MyM...')"
  }
}

O recurso e as propriedades @odata.id podem ser utilizadas para chamar o Microsoft Graph para obter a transcrição ou gravação.

Conteúdo relacionado

• Notificações de alteração do Microsoft Graph
• Obter notificações de alteração para equipes e canais usando o Microsoft Graph
• Obter notificações de alteração para alterações de associação em canais com o Microsoft Graph
• Obter notificações de alteração para alterações de associação em equipas com o Microsoft Graph
• Obter notificações de alteração para mensagens nos canais e bate-papos do Teams usando o Microsoft Graph
• Obtenha as notificações de alteração para associação de chat o usando o Microsoft Graph
• Visão geral da API do Microsoft Teams
• Alterar o exemplo de C# da equipa de notificações ou do canal
• Alterar a equipa de notificações ou o canal Node.js exemplo