Partager via

Recevoir des notifications de modification pour les enregistrements d’appels Microsoft Teams

  • Article

Les notifications de modification dans Microsoft Graph permettent aux abonnements d’appeler des enregistrements, en fournissant un flux continu de mises à jour des enregistrements d’appels à mesure qu’ils sont créés ou modifiés. Les enregistrements d’appels offrent des informations précieuses sur l’utilisation et le diagnostic des appels et des réunions en ligne de votre organization lors de l’utilisation de Microsoft Teams ou de Skype Entreprise. Ces données peuvent être exploitées pour créer des rapports personnalisés, ce qui facilite la surveillance de l’adoption et la résolution des problèmes de qualité des appels.

Autorisations

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins) Versions prises en charge
Déléguée (compte professionnel ou scolaire) Non prise en charge. Non prise en charge.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application CallRecords.Read.All v1.0

Exemples

Exemple 1 : demande d’abonnement

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

Les notifications de modification pour les enregistrements d’appel prennent en charge les create types de notification et update . Un abonnement aux create modifications n’envoie qu’une seule notification lorsqu’un enregistrement d’appel est généré pour la première fois. Un enregistrement d’appel est créé après la fin d’un appel ou d’une réunion et reste accessible pendant 30 jours.

Un abonnement aux update modifications inclut une notification initiale lorsque l’enregistrement est généré pour la première fois et toutes les notifications suivantes lors de la modification de cet enregistrement. Étant donné que des attributs d’enregistrement d’appel spécifiques dépendent de signaux côté client, qui peuvent être soumis à des retards ou des interruptions en raison de problèmes réseau, un enregistrement d’appel peut subir des mises à jour avec des informations nouvelles ou révisées après sa création initiale. Ces modifications déclenchent une update notification et le champ de l’enregistrement version est incrémenté pour indiquer la modification.

La latence des notifications de modification et la période d’expiration maximale de l’abonnement sont définies dans la vue d’ensemble des notifications de modification.

Exemple 2 : demande d’abonnement filtrée par participant Microsoft Entra ID d’objet

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

Vous pouvez éventuellement filtrer les notifications de modification pour les enregistrements d’appels à l’aide de l’ID d’objet Microsoft Entra d’un participant. Les notifications de modification filtrées par ID d’objet sont envoyées lorsque l’ID d’objet Microsoft Entra d’un participant à l’appel est inclus dans le paramètre de filtre.

Ce filtre prend en charge eqles opérateurs , oret in pour l’attribut id de la participants collection dans une ressource callRecord. Pour plus d’informations sur l’utilisation de $filter, consultez Utiliser le paramètre de requête $filter.

Exemple 3 : notification d’abonnement

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

Contenu connexe