Inscrire un bot auprès de l’API de communications cloud

  • Article

Vous pouvez utiliser l’API de communications cloud dans Microsoft Graph pour créer des bots afin de répondre aux besoins de vos clients et de faciliter la collaboration. Cet article explique comment inscrire votre bot, puis gérer l’état de celui-ci.

Configuration requise

Avant de commencer, familiarisez-vous avec les rubriques suivantes :

  • Microsoft Entra ID (Microsoft Entra ID) et comment le service aide les employés à se connecter et à accéder aux ressources.
  • Azure Bot Service et ses fonctionnalités.

Inscrire un bot

Les termes « application de service » et « bot » peuvent être utilisés indifféremment. Vous pouvez créer un bot directement via le Portail Azure ou inscrire un bot qui n’est pas hébergé sur Azure. Pour plus d’informations, consultez Inscription d’un bot appelant.

Pour faciliter les choses plus tard, il est utile de comprendre les différents types d’autorisations dans Microsoft Entra ID. Les applications avec des autorisations déléguées nécessitent un utilisateur connecté. Les autorisations basées sur l’application n’ont pas besoin d’un utilisateur connecté et peuvent souvent s’exécuter en tant que service en arrière-plan.

Après avoir inscrit votre bot, si vous souhaitez ajouter votre bot à Microsoft Teams, assurez-vous de comprendre comment utiliser le portail des développeurs pour les équipes et de définir les métadonnées requises.

Gérer l’état du bot

Après avoir inscrit votre bot, décidez si vous souhaitez que votre média audio et vidéo soit hébergé par une application ou un service. À un niveau élevé, cela implique de décider si vous souhaitez ou non accéder à un flux en direct de médias bruts.

Ensuite, vous pouvez décider si votre bot doit être avec état ou sans état.

Bots sans état

N’importe quelle machine virtuelle peut gérer n’importe quel bot instance, ce qui signifie que si une machine tombe en panne, une autre peut s’en occuper. Cela permet d’obtenir une solution résiliente.

En revanche, un cache partagé, tel que REDIS, doit être accessible à toutes les machines virtuelles.

Bots avec état

Une machine virtuelle ne peut gérer qu’un seul bot instance à la fois. Étant donné que tous les états se trouvent sur une seule machine, il n’y a pas de mémoire supplémentaire ni de vérification du cache REDIS.

L’inconvénient est qu’il n’est pas aussi résilient, car le bot instance se trouve uniquement sur un ordinateur.

Remarque

Les bots multimédias hébergés par le service peuvent être avec état ou sans état. Les bots multimédias hébergés par l’application doivent être avec état pour utiliser le Kit de développement logiciel (SDK) Bot Media.

Utilisez les kits de développement logiciel (SDK)

Les kits SDK suivants sont disponibles en C#. Nous assurerons la prise en charge d’autres langues à l’avenir.

Exemples

Découvrez comment implémenter différents scénarios à l’aide de bots avec état, par exemple répondre à un appel entrant avec des médias hébergés par une application ou un service.

Pour plus d’exemples, consultez le référentiel d’exemples communications.

Confidentialité et conformité

Dans les requêtes adressées à nos API, les données sensibles ne doivent pas être envoyées dans les ID générés côté client (tels que les ID de scénario, les ID de requête ou d’autres ID de corrélation) dans les en-têtes ou le corps de la demande. Ces ID sont enregistrés côté serveur pour diagnostics.

Contenu connexe