Receba notificações de alteração de transcrições e gravações usando o Microsoft Graph

As notificações de alteração permitem que você assine alterações nas transcrições e gravações. Você pode ser notificado sempre que uma transcriçãoou gravação estiver disponível 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 Notificações de alteração para recursos do Microsoft Teams.

Observação

Se você solicitar uma expirationDateTime de assinatura superior a 1 hora no futuro, deverá assinar notificações de ciclo de vida incluindo uma propriedade lifecycleNotificationUrl em sua solicitação de assinatura. Caso contrário, sua solicitação de assinatura falhará com a seguinte mensagem de erro: lifecycleNotificationUrl é necessário para a criação de assinatura neste recurso quando o valor expirationDateTime excede 1 hora.

Controle do administrador do locatário sobre assinaturas de transcrição

Se um administrador de locatários desativar o acesso da API do Graph às transcrições, a criação ou renovação de uma assinatura de qualquer recurso de notificação de alteração de transcrição falhará com 403 Forbidden e o GraphAccessToTranscriptsDisabled código de erro interno. Ramifique no innerError.code valor, não no texto da mensagem — as mensagens estão sujeitas a alterações.

Pontos de extremidade afetados:

A configuração bloqueia a criação e renovação de assinaturas de transcrição enquanto estiver desativada. Esse controle se aplica apenas aos recursos de transcrição; As assinaturas de gravação não são afetadas. Para obter um exemplo de conteúdo de erro, consulte Obter callTranscript.

Assine as transcrições disponíveis no nível do locatário

Esta seção descreve os métodos para assinar transcrições disponíveis no nível do locatário para reuniões online e chamadas ad hoc.

Para reuniões online

Para obter notificações de alteração de qualquer transcrição disponível para qualquer reunião online em um locatário, inscreva-se communications/onlineMeetings/getAllTranscriptsno . Este recurso oferece suporte a incluindo dados de recursos na notificação. A notificação para uma transcrição será enviada somente se a assinatura ocorrer antes do início da transcrição. Esta assinatura oferece suporte a reuniões online agendadas.

Observação

No momento, esta assinatura não dá suporte a reuniões de canal privado.

Permissões

Uma das seguintes permissões é necessária para assinar o communications/onlineMeetings/getAllTranscripts.

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

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

Exemplo

O exemplo a seguir mostra como assinar transcrições de reuniões online disponíveis no nível do locatário.

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 de qualquer transcrição disponível para qualquer chamada ad hoc em um locatário, inscreva-se communications/adhocCalls/getAllTranscriptsno . Este recurso oferece suporte a incluindo dados de recursos na notificação.

Permissões

Uma das seguintes permissões é necessária para assinar o communications/adhocCalls/getAllTranscripts.

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

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

Exemplo

O exemplo a seguir mostra como assinar transcrições de chamadas ad hoc disponíveis no nível do locatário.

POST https://graph.microsoft.com/v1.0/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}"
}

Assinar transcrições disponíveis para uma reunião online específica

Para obter notificações de alteração de qualquer transcrição disponível para uma reunião online específica, assine o communications/onlineMeetings/{onlineMeetingId}/transcripts. Este recurso oferece suporte a incluindo dados de recursos na notificação. A notificação para uma transcrição será enviada somente se a assinatura ocorrer antes do início da transcrição. Esta assinatura oferece suporte a reuniões online agendadas.

Observação

No momento, esta assinatura não dá suporte a reuniões de canal privado.

Permissões

Uma das seguintes permissões é necessária para assinar o communications/onlineMeetings/{onlineMeetingId}/transcripts. Para saber mais, incluindo como escolher permissões, confira Permissões.

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

Observação

  • A OnlineMeetingTranscript.Read.Chat permissão usa o consentimento específico do recurso. Essa permissão se aplica somente a reuniões de chat privadas agendadas, não a reuniões de canal.
  • Para assinar qualquer transcrição disponível para uma reunião online específica usando apenas as permissões de consentimento específicas do recurso necessárias, use o useResourceSpecificConsentBasedAuthorization=true parâmetro query com a cadeia de caracteres de recurso.

Exemplo 1: assinar transcrições disponíveis para uma reunião online específica usando permissões clássicas

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",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

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}"
}

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

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

Permissões

Uma das seguintes permissões é necessária para assinar o communications/adhocCalls/{adhocCallId}/transcripts. Para saber mais, incluindo como escolher permissões, confira Permissões.

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

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

POST https://graph.microsoft.com/v1.0/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}"
}

Assinar transcrições disponíveis para reuniões online organizadas por um usuário

Para obter notificações de alteração de qualquer transcrição disponível para qualquer reunião online organizada por um usuário específico, inscreva-se no users/{userId}/onlineMeetings/getAllTranscripts. Este recurso oferece suporte a incluindo dados de recursos na notificação. A notificação para uma transcrição será enviada somente se a assinatura ocorrer antes do início da transcrição. Esta assinatura oferece suporte a reuniões online agendadas.

Observação

No momento, esta assinatura não dá suporte a reuniões de canal privado.

Permissões

Uma das seguintes permissões é necessária para assinar o users/{userId}/onlineMeetings/getAllTranscripts. Para saber mais, incluindo como escolher permissões, confira Permissões.

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

Exemplo

O exemplo a seguir mostra como assinar transcrições disponíveis para qualquer reunião online organizada por um usuário 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}"
}

Inscreva-se em transcrições disponíveis para chamada ad hoc em que um usuário específico inicia a transcrição

Para obter notificações de alteração de qualquer transcrição disponível para qualquer chamada ad hoc em que um usuário específico inicia a transcrição, inscreva-se users/{userId}/adhocCalls/getAllTranscriptsno . Este recurso oferece suporte a incluindo dados de recursos na notificação. A notificação para uma transcrição será enviada somente se a assinatura ocorrer antes do início da transcrição. Esta assinatura dá suporte a chamadas ad hoc.

Permissões

Uma das seguintes permissões é necessária para assinar o users/{userId}/adhocCalls/getAllTranscripts. Para saber mais, incluindo como escolher permissões, confira Permissões.

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

Exemplo

O exemplo a seguir mostra como assinar transcrições disponíveis para qualquer chamada ad hoc em que um usuário específico inicia a transcrição.

POST https://graph.microsoft.com/v1.0/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}"
}

Assine as transcrições disponíveis para qualquer reunião online em que um aplicativo específico do Teams esteja instalado

Para obter notificações de alteração de qualquer transcrição disponível para qualquer reunião online em que um aplicativo específico do Teams esteja instalado, inscreva-se appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllTranscriptsno . Este recurso oferece suporte a incluindo dados de recursos na notificação. A notificação para uma transcrição será enviada somente se a assinatura ocorrer antes do início da transcrição. Esta assinatura é compatível com reuniões online agendadas, mas não para reuniões de canal.

Permissões

Uma das seguintes permissões é necessária para assinar o appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllTranscripts. Para saber mais, incluindo como escolher permissões, confira Permissões.

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

Observação

  • A OnlineMeetingTranscript.Read.Chat permissão usa o consentimento específico do recurso.
  • Para assinar transcrições disponíveis para qualquer reunião online em que um aplicativo específico do Teams esteja instalado usando apenas permissões de consentimento específicas do recurso necessárias, use o parâmetro de consulta com a useResourceSpecificConsentBasedAuthorization=true cadeia de caracteres de recurso.

Exemplo 1: Inscreva-se para receber transcrições disponíveis para qualquer reunião online em que um aplicativo específico do Teams esteja instalado usando as permissões clássicas

POST https://graph.microsoft.com/v1.0/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}"
}

POST https://graph.microsoft.com/v1.0/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}"
}

Assinar gravações disponíveis no nível do locatário

Esta seção descreve os métodos para assinar gravações disponíveis no nível do locatário para reuniões online e chamadas ad hoc.

Para reuniões online

Para obter notificações de alteração de qualquer gravação disponível para qualquer reunião online em um locatário, inscreva-se communications/onlineMeetings/getAllRecordingsno . Este recurso oferece suporte a incluindo dados de recursos na notificação. Esta assinatura oferece suporte a reuniões online agendadas.

Observação

Esta assinatura não dá suporte a reuniões de canal privado.

Permissões

Uma das seguintes permissões é necessária para assinar o communications/onlineMeetings/getAllRecordings. Para saber mais, incluindo como escolher permissões, confira Permissões.

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

Exemplo

O exemplo a seguir mostra como assinar gravações disponíveis no nível do locatário 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 de qualquer gravação disponível para qualquer chamada ad hoc em um locatário, assine .communications/adhocCalls/getAllRecordings Este recurso oferece suporte a incluindo dados de recursos na notificação. Esta assinatura dá suporte a adhocCalls.

Permissões

Uma das seguintes permissões é necessária para assinar o communications/adhocCalls/getAllRecordings. Para saber mais, incluindo como escolher permissões, confira Permissões.

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

Exemplo

O exemplo a seguir mostra como assinar gravações disponíveis no nível do locatário.

POST https://graph.microsoft.com/v1.0/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}"
}

Assinar gravações disponíveis para uma reunião online específica

Para obter notificações de alteração de qualquer gravação disponível para uma determinada reunião online, inscreva-se no communications/onlineMeetings/{onlineMeetingId}/recordings. Este recurso oferece suporte a incluindo dados de recursos na notificação. Esta assinatura oferece suporte a reuniões online agendadas.

Observação

No momento, esta assinatura não dá suporte a reuniões de canal privado.

Permissões

Uma das seguintes permissões é necessária para assinar o communications/onlineMeetings/{onlineMeetingId}/recordings. Para saber mais, incluindo como escolher permissões, confira Permissões.

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

Observação

  • A OnlineMeetingRecording.Read.Chat permissão usa o consentimento específico do recurso. Essa permissão se aplica somente a reuniões de chat privadas agendadas, não a reuniões de canal.
  • Para assinar qualquer gravação disponível para uma reunião online específica usando apenas as permissões de consentimento específicas do recurso necessárias, use o useResourceSpecificConsentBasedAuthorization=true parâmetro query com a cadeia de caracteres de recurso.

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

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",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

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}"
}

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

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

Permissões

Uma das seguintes permissões é necessária para assinar o communications/adhocCalls/{adhocCallId}/recordings. Para saber mais, incluindo como escolher permissões, confira Permissões.

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

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

POST https://graph.microsoft.com/v1.0/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}"
}

Assinar gravações disponíveis para reuniões online organizadas por um usuário

Para obter notificações de alteração de qualquer gravação disponível para qualquer reunião online organizada por um usuário específico, inscreva-se no users/{userId}/onlineMeetings/getAllRecordings. Este recurso oferece suporte a incluindo dados de recursos na notificação. Esta assinatura oferece suporte a reuniões online agendadas.

Observação

No momento, esta assinatura não dá suporte a reuniões de canal privado.

Permissões

Uma das seguintes permissões é necessária para assinar o users/{userId}/onlineMeetings/getAllRecordings. Para saber mais, incluindo como escolher permissões, confira Permissões.

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

Inscreva-se em gravações disponíveis para chamada ad hoc em que um usuário específico inicia a transcrição

Para obter notificações de alteração de qualquer gravação disponível para qualquer chamada ad hoc em que um usuário específico inicia a transcrição, inscreva-se users/{userId}/adhocCalls/getAllRecordingsno . Este recurso oferece suporte a incluindo dados de recursos na notificação. Esta assinatura dá suporte a chamadas ad hoc.

Permissões

Uma das seguintes permissões é necessária para assinar o users/{userId}/adhocCalls/getAllRecordings. Para saber mais, incluindo como escolher permissões, confira Permissões.

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

Exemplo

O exemplo a seguir mostra como assinar gravações disponíveis para qualquer chamada ad hoc em que um usuário específico inicia a transcrição.

POST https://graph.microsoft.com/v1.0/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}"
}

Assine gravações disponíveis para qualquer reunião online em que um aplicativo específico do Teams esteja instalado

Esta seção descreve os métodos para assinar gravações disponíveis para qualquer reunião online em que um aplicativo específico do Teams esteja instalado.

Para obter notificações de alteração de qualquer gravação disponível para qualquer reunião online em que um aplicativo específico do Teams esteja instalado, inscreva-se appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllRecordingsno . Este recurso oferece suporte a incluindo dados de recursos na notificação. Esta assinatura é compatível com reuniões online agendadas, mas não para reuniões de canal.

Permissões

Uma das seguintes permissões é necessária para assinar o appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllRecordings. Para saber mais, incluindo como escolher permissões, confira Permissões.

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

Observação

  • A OnlineMeetingRecording.Read.Chat permissão usa o consentimento específico do recurso.
  • Para assinar gravações disponíveis para qualquer reunião online em que um aplicativo específico do Teams esteja instalado usando apenas permissões de consentimento específicas do recurso necessárias, use o useResourceSpecificConsentBasedAuthorization=true parâmetro de consulta com a cadeia de caracteres de recurso.

Exemplo 1: Assinar gravações disponíveis para qualquer reunião online em que um aplicativo específico do Teams esteja instalado usando as permissões clássicas necessárias

POST https://graph.microsoft.com/v1.0/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}"
}

POST https://graph.microsoft.com/v1.0/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

Dependendo da sua assinatura, você pode receber a notificação com ou sem dados do recurso. A assinatura com dados de recursos permite que você obtenha a transcrição ou os metadados de gravação junto 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 conteúdo é para uma transcrição disponível para uma reunião online. Para chamadas ad hoc, o meetingId é null.

Observação

O objeto de carga útil mostrado aqui é encurtado para facilitar a legibilidade.

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 descriptografadas para transcrições com dados de recursos

A carga de notificação descriptografada parece com a seguinte. A carga está em conformidade com o esquema de transcrição . A carga é semelhante às retornadas por operações GET.

Observação

O objeto de carga útil mostrado aqui é encurtado para facilitar a legibilidade.

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.

Observação

O objeto de carga útil mostrado aqui é encurtado para facilitar a legibilidade.

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 descriptografadas para gravações com dados de recursos

A carga de notificação descriptografada parece com a seguinte. A carga está em conformidade com o esquema de gravação . A carga é semelhante às retornadas por operações GET.

Observação

O objeto de carga útil mostrado aqui é encurtado para facilitar a legibilidade.

{
  "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

Notificações sem dados de recurso fornecem a ID do recurso para fazer chamadas GET para obter a transcrição ou gravação. As assinaturas para notificações sem dados de recurso não exigem um certificado de criptografia (porque os dados reais do recurso não são enviados).

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

Observação

O objeto de carga útil mostrado aqui é encurtado para facilitar a legibilidade.

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 conteúdo é para 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.

Observação

O objeto de carga útil mostrado aqui é encurtado para facilitar a legibilidade.

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...')"
  }
}

As propriedades resource e @odata.id podem ser usadas para chamar o Microsoft Graph para obter a transcrição ou gravação.

Conteúdo relacionado

  • Last updated on