Cas d’utilisation de l’API de webinaire d’événements virtuels

Les API de webinaire d’événements virtuels Microsoft Graph vous permettent d’obtenir des données de webinaire Teams et de créer, mettre à jour et annuler un webinaire Teams par programme.

Pour que vous utilisiez au mieux les API de webinaire d’événements virtuels Graph, il est utile de comprendre les personnages des utilisateurs qui accèdent à l’expérience de webinaire Teams :

• Les organisateurs sont des employés (dans votre organization) qui gèrent le webinaire. Ils sont l’autorité sur le calendrier et les participants. Ils configurent les attributs du webinaire tels que le titre, le thème, l’expérience des participants et les règles de messagerie.  
• Les présentateurs sont des employés (dans votre organization) ou des invités qui dirigent le webinaire.  
• Les inscrits sont des utilisateurs (dans ou en dehors de votre organization) qui se sont inscrits à un webinaire. Ils peuvent être inscrits, mis en liste d’attente ou rejetés. Ils peuvent choisir d’annuler leur inscription au webinaire.  
• Les participants sont des inscrits qui ont rejoint le webinaire. Ils doivent s’inscrire via un portail et répondre aux questions d’inscription.
• L’administrateur client Teams doit autoriser les applications personnalisées avec les autorisations appropriées.

Vous pouvez utiliser les types de ressources suivants pour créer votre solution de webinaire :

• virtualEventWebinar : permet de créer, d’obtenir, de mettre à jour, de publier, d’annuler et de lister des webinaires Teams.
• virtualEventRegistration : permet de créer, d’obtenir, d’annuler et de lister les enregistrements d’inscription des inscrits d’un webinaire. Fournit l’URL de participation unique au webinaire Teams pour l’inscrit.
• virtualEventRegistrationQuestion : permet de créer, de répertorier et de supprimer des questions d’inscription personnalisées ou des questions d’inscription prédéfinies auxquelles les inscrits doivent répondre lorsqu’ils s’inscrivent à un webinaire.
• virtualEventRegistrationConfiguration : contient des informations sur une configuration d’inscription de webinaire qui stocke l’URL du portail d’inscription du webinaire.
• virtualEventPresenter : permet de créer, d’obtenir, de répertorier, de mettre à jour et de supprimer un présentateur pour un webinaire Teams.
• virtualEventSession : un webinaire créé via les API Microsoft Graph n’a qu’une session qui hérite des propriétés des réunions en ligne.
• meetingAttendanceReport : chaque fois qu’un webinaire se termine, un rapport de présence est généré pour la session, mais n’inclut pas les données des participants.
• attendanceRecord : fournit des données sur les participants au webinaire dans le rapport de présence.
• webhooks d’événements virtuels : peut recevoir des notifications pour les modifications apportées à un webinaire, à l’inscription à un webinaire, à une session, à un rapport de présence, etc.

Solutions que vous pouvez créer

Le tableau suivant répertorie certaines solutions que vous pouvez créer à l’aide du client Teams et des API et webhooks du webinaire Microsoft Graph.

Consentement spécifique à la ressource (RSC) pour les événements virtuels

Le consentement spécifique aux ressources (RSC) permet aux applications de demander des autorisations limitées à un webinaire ou à une assemblée publique spécifique au lieu d’exiger des privilèges d’administrateur général. Les autorisations RSC améliorent la sécurité, simplifient les flux de consentement et permettent aux développeurs de créer des intégrations qui respectent les limites de l’organisation.

API d’événements virtuels Microsoft Graph activées et autorisations RSC

Flux d’authentification traditionnel

Si RSC n’est pas obligatoire ou réalisable, vous pouvez utiliser les flux OAuth traditionnels suivants :

• Flux de jetons d’application uniquement : utilisez-le pour les services principaux ou les scénarios d’automatisation où l’application agit sans contexte utilisateur.
• Flux de jetons délégués (utilisateur) : à utiliser lorsque les actions nécessitent le contexte et le consentement de l’utilisateur.

Quand utiliser le flux de jetons RSC par rapport au flux de jeton traditionnel

Prise en main des autorisations RSC

Les étapes suivantes décrivent comment commencer à configurer votre application et à utiliser les autorisations RSC :

1. Inscrivez votre application et définissez des autorisations RSC dans le manifeste de l’application.
2. Publiez votre application via le portail des développeurs Teams ou l’Espace partenaires.
3. Administration accorde RSC dans le centre d’administration Teams.
4. Utilisez les API Microsoft Graph pour les webinaires et les assemblées avec des autorisations étendues.

Créer/mettre à jour/annuler

• Utilisez l’API Créer un webinaire pour créer un brouillon de l’événement, suivie de l’API Publier le webinaire pour terminer la création et la rendre visible pour son public.
  • Le webinaire créé via les API Microsoft Graph est un webinaire Teams visible et modifiable dans le client Teams.
  • Comme dans Teams, seul l’organisateur peut créer, publier et annuler des événements de webinaire. L’API créer un webinaire prend uniquement en charge les autorisations déléguées au nom de l’organisateur.
• Comme dans Teams, les coorganiseurs peuvent mettre à jour les webinaires. Pour mettre à jour les webinaires, utilisez l’API Mettre à jour le webinaire avec des autorisations déléguées pour le compte du coorganiseur.
• Abonnez-vous aux notifications de modification pour obtenir des mises à jour sur les modifications apportées au webinaire. 

Synchronisation des données

• Abonnez-vous aux notifications de modification pour obtenir des mises à jour sur les modifications apportées au webinaire.
• Pour obtenir des données de rapport de présence pour un webinaire, utilisez l’option Répertorier les enregistrements de présence ou Obtenir un enregistrement de présence avec une option de requête.
  • Pour obtenir les informations de présence d’un participant au webinaire, après une liste ou une demande, mappez la propriété Id dans l’inscription d’événement virtuel à la propriété registrationId dans l’enregistrement de présence (actuellement disponible uniquement dans le point de terminaison bêta).
• Obtenez des données pour un webinaire spécifique, répertoriez tous les webinaires dans un locataire, répertoriez les webinaires où l’utilisateur est organisateur ou coorganiseur, listez les webinaires où l’utilisateur spécifié est l’organisateur ou le coorganiseur.
• Pour obtenir l’URL du portail d’inscription au webinaire Teams pour votre webinaire, utilisez Obtenir la configuration de l’inscription au webinaire.

Inscription

• Utilisez Créer une inscription pour inscrire des utilisateurs par programme à votre webinaire. Les organisateurs, les coorganiseurs et les présentateurs n’ont pas besoin de s’inscrire. Le fait que les inscrits aient ou non des comptes Microsoft Entra affecte les autorisations dont vous avez besoin pour appeler l’API.
• Les questions d’inscription CREATE (prédéfinies ou personnalisées) doivent répondre aux questions requises lors de l’inscription.
• Une fois que l’inscrit s’est inscrit au webinaire, utilisez La liste des sessions pour obtenir l’unique joinWebURL pour le webinaire.

Email communication

• Vous pouvez désactiver les communications par e-mail aux participants lorsque vous créez le webinaire. Dans la propriété settings , définissez sur isAttendeeEmailNotificationEnabledfalse. Les e-mails sont toujours envoyés aux organisateurs, aux coorganiseurs et aux présentateurs (internes et externes).
• Vous pouvez vous abonner aux notifications de modification pour créer votre propre système de communication par e-mail personnalisé.