Obtenha notificações de alteração para insights de IA do Copilot usando o Microsoft Graph

As notificações de alteração permitem que você assine o Copilot AI Insights. Você pode receber notificações sempre que um resumo gerado por IA estiver disponível para uma reunião gravada. Isso elimina a necessidade de sondar continuamente a API de insights de IA e aguardar até que o resumo esteja pronto.

Observação

Se você solicitar uma assinatura expirationDateTime que esteja mais de uma hora no futuro, deverá assinar as notificações do ciclo de vida incluindo uma lifecycleNotificationUrl propriedade em sua solicitação de assinatura; caso contrário, sua solicitação de assinatura falhará com a seguinte mensagem de erro: lifecycleNotificationUrl is a required property for subscription creation on this resource when the expirationDateTime value is set to greater than 1 hour

Assinar os insights de IA do Copilot para um usuário específico

Para receber notificações de insights de IA do Copilot de uma reunião da qual um determinado usuário faz parte, inscreva-se /copilot/users/{user-id}/onlineMeetings/getAllAiInsightsno .

Permissões

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

Requisitos de licenciamento

Para acessar esse recurso de notificação de alteração, o usuário no caminho do recurso deve ter uma licença do Microsoft 365 Copilot.

Exemplo: assinar o Copilot AI Insights para 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": "/copilot/users/{user-id}/onlineMeetings/getAllAiInsights",
  "includeResourceData": false,
  "expirationDateTime": "2026-01-02T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Inscrever-se para receber insights de IA do Copilot para uma reunião específica

Para receber notificações sobre insights de IA do Copilot para uma reunião específica, inscreva-se no /copilot/users/{user-id}/onlineMeetings/{online-meeting-id}/aiInsights.

Permissões

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

Requisitos de licenciamento

Para acessar esse recurso de notificação de alteração, o usuário no caminho do recurso deve ter uma licença do Microsoft 365 Copilot.

Exemplo: Inscrever-se para receber insights de IA do Copilot para uma reunião específica

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

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "/copilot/users/{user-id}/onlineMeetings/{online-meeting-id}/aiInsights",
  "includeResourceData": false,
  "expirationDateTime": "2026-01-02T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

Notificações

As notificações fornecem informações suficientes para fazer chamadas GET para obter o conteúdo dos insights de IA.

O conteúdo a seguir descreve as informações enviadas para notificações. Esse conteúdo indica que um novo resumo de IA foi gerado. As IDs no exemplo foram reduzidas para facilitar a leitura.

{
  "subscriptionId": "10493aa0...",
  "changeType": "created",
  "clientState": "<<--SpecifiedClientState-->>",
  "subscriptionExpirationDateTime": "2026-01-02T10:30:34.9097561-08:00",
  "resource": "copilot/users/b935e675.../onlineMeetings/YTc3OT.../aiInsights/Z2HWbT...",
  "resourceData": {
    "id": "Z2HWbT...",
    "@odata.type": "#Microsoft.Graph.callAiInsight",
    "@odata.id": "copilot/users/b935e675.../onlineMeetings/YTc3OT.../aiInsights/Z2HWbT..."
  }
}

Conteúdo relacionado

Notificações de alteração do Microsoft Graph

  • Last updated on