Enregistrer le bot d’appels et de réunions pour Microsoft Teams

Un bot qui participe à des appels audio ou vidéo et à des réunions en ligne est un bot Microsoft Teams normal avec les fonctionnalités supplémentaires suivantes utilisées pour inscrire le bot :

  • Il existe une nouvelle version du manifeste d’application Teams avec deux paramètres supplémentaires, supportsCalling et supportsVideo. Ces paramètres sont inclus dans le schéma de manifeste pour Microsoft Teams.
  • Microsoft Graph autorisations doivent être configurées pour l’ID d’application Microsoft de votre bot.
  • Les autorisations des API d’appels et de réunions en ligne Graph nécessitent le consentement de l’administrateur client.

Nouveaux paramètres de manifeste

Les bots d’appels et de réunions en ligne ont les deux paramètres supplémentaires suivants dans le fichier manifest.json qui activent l’audio ou la vidéo pour votre bot dans Teams.

  • bots[0].supportsCalling. S’il est présent et défini sur true, Teams permet à votre bot de participer à des appels et des réunions en ligne.
  • bots[0].supportsVideo. S’il est présent et défini sur true, Teams sait que votre bot prend en charge la vidéo.

Si vous souhaitez que votre IDE valide correctement le schéma manifest.json pour vos appels et bot de réunions pour ces valeurs, vous pouvez modifier l’attribut $schema comme suit :

"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.11/MicrosoftTeams.schema.json",

La section suivante vous permet de créer un bot ou d’ajouter des fonctionnalités d’appel à votre bot existant.

Créer un bot ou ajouter des fonctionnalités d’appel

Pour plus d’informations sur la création de bots, consultez créer un bot pour Teams.

Pour créer un bot pour Teams :

  1. Utilisez ce lien pour créer un bot, https://dev.botframework.com/bots/new. Sinon, si vous sélectionnez le bouton Créer un bot dans le portail Bot Framework, vous créez votre bot dans Microsoft Azure, pour lequel vous devez disposer d’un compte Azure.

  2. Ajoutez le canal Teams.

  3. Sélectionnez l’onglet Appel dans la page du canal Teams. Sélectionnez Activer l’appel, puis mettez à jour webhook (pour appeler) avec votre URL HTTPS où vous recevez des notifications entrantes, par exemple https://contoso.com/teamsapp/api/calling. Pour plus d’informations, consultez configuration des canaux.

    Configurer les informations de canal Teams

La section suivante fournit la liste des autorisations d’application prises en charge pour les appels et les réunions en ligne.

Ajouter des autorisations Graph

Graph fournit des autorisations granulaires pour contrôler l’accès des applications aux ressources. Vous décidez des autorisations pour Graph que demande votre application. Les API d’appel Graph prennent en charge les autorisations d’application, qui sont utilisées par les applications qui s’exécutent sans utilisateur connecté. Un administrateur client doit accorder son consentement aux autorisations d’application.

Autorisations d’application pour les appels

Le tableau suivant fournit la liste des autorisations d’application pour les appels :

Autorisation Chaîne d’affichage Description Autorisation de l’administrateur requise
Calls.Initiate.All Lancer les appels sortants 1:1 depuis l’application aperçu. Permet à l’application de passer des appels sortants à un seul utilisateur et de transférer des appels à des utilisateurs dans l’annuaire de votre organisation, sans utilisateur connecté. Oui
Calls.InitiateGroupCall.All Lancez les appels sortants 1:1 et les appels de groupe à partir de la préversion de l’application. Permet à l’application de passer des appels sortants à un seul utilisateur, plusieurs utilisateurs, de transférer des appels et d’ajouter des participants aux réunions de votre organisation, sans utilisateur connecté. Oui
Calls.JoinGroupCall.All Rejoignez des appels de groupe et des réunions en tant qu’aperçu d’application. Permet à l’application de rejoindre les appels de groupe et les réunions planifiées dans votre organisation, sans utilisateur connecté. L’application est jointe avec les privilèges d’un utilisateur d’annuaire aux réunions dans votre locataire. Oui
Calls.JoinGroupCallasGuest.All Rejoignez des appels de groupe et des réunions en tant qu’aperçu invité. Permet à l’application de rejoindre anonymement les appels de groupe et les réunions planifiées dans votre organisation, sans utilisateur connecté. L’application est jointe en tant qu’invité aux réunions de votre locataire. Oui
Calls.AccessMedia.All Accédez aux flux multimédias dans un appel en tant qu’aperçu d’application. Permet à l’application d’obtenir un accès direct aux flux multimédias dans un appel, sans utilisateur connecté. Oui

Important

Vous ne pouvez pas utiliser l’API Media Access pour enregistrer ou conserver le contenu multimédia à partir d’appels ou de réunions auxquels votre application accède ou dériver des données de cet enregistrement ou enregistrement de contenu multimédia. Vous devez d’abord appeler updateRecordingStatusl’API pour indiquer que l’enregistrement a commencé et recevoir une réponse réussie de cette API. Si votre application commence à enregistrer une réunion ou un appel, elle doit terminer l’enregistrement avant d’appeler l’API updateRecordingStatus pour indiquer que l’enregistrement est terminé.

Autorisations d’application pour les réunions en ligne

Le tableau suivant fournit la liste des autorisations d’application pour les réunions en ligne :

Autorisation Chaîne d’affichage Description Autorisation de l’administrateur requise
OnlineMeetings.Read.All Lire les détails de la réunion en ligne à partir de la préversion de l’application Permet à l’application de lire tous les détails de la réunion en ligne dans votre organisation, sans utilisateur connectée. Oui
OnlineMeetings.ReadWrite.All Lire et créer des réunions en ligne à partir de la préversion de l’application pour le compte d’un utilisateur Permet à l’application de créer des réunions en ligne dans votre organisation pour le compte d’un utilisateur, sans utilisateur connecté. Oui

Attribuer des autorisations

Vous devez configurer les autorisations d’application pour votre bot à l’avance à l’aide de l' Portail Microsoft Azure si vous préférez utiliser le point de terminaison Microsoft Azure Active Directory (Azure AD) V1.

Pour les applications utilisant le point de terminaison Azure AD V1, un administrateur client peut donner son consentement aux autorisations d’application à l’aide du Portail Microsoft Azure lorsque votre application est installée dans son organisation. Vous pouvez également fournir une expérience d’inscription dans votre application par le biais de laquelle les administrateurs peuvent donner leur consentement aux autorisations que vous avez configurées. Une fois que le consentement de l’administrateur est enregistré par Azure AD, votre application peut demander des jetons sans avoir à demander à nouveau le consentement.

Vous pouvez vous appuyer sur un administrateur pour accorder les autorisations dont votre application a besoin au Portail Microsoft Azure. Une meilleure option consiste à fournir une expérience d’inscription pour les administrateurs à l’aide du point de terminaison Azure AD V2 /adminconsent . Pour plus d’informations, consultez instructions sur la construction d’une URL de consentement administrateur.

Notes

Pour construire l’URL de consentement de l’administrateur client, un URI de redirection ou une URL de réponse configuré dans le portail d’inscription d’application est requis. Pour ajouter des URL de réponse pour votre bot, accédez à l’inscription de votre bot, choisissez Options avancées > Modifier le manifeste d’application. Ajoutez votre URL de redirection à la collection replyUrls.

Important

Chaque fois que vous apportez une modification aux autorisations de votre application, vous devez également répéter le processus de consentement de l’administrateur. Les modifications apportées dans le portail d’inscription d’application ne sont pas répercutées tant que le consentement n’a pas été réappliqué par l’administrateur du locataire.

Exemple de code

Exemple de nom Description Graph
Appeler et rencontrer un bot L’exemple d’application montre comment le bot peut créer un appel, participer à une réunion et transférer un appel. View

Guide pas à pas

Suivez le guide pas à pas pour configurer l’appel et la réunion dans un bot.

Étape suivante

Voir aussi