Connecter votre bot à des canaux avec Azure CLI

Article
01/03/2024

Un canal est une connexion entre une application de communication et un bot. Un bot, inscrit auprès d’Azure, utilise des canaux pour permettre la communication avec les utilisateurs. Les commandes de cet article connectent un bot à différents canaux. Pour en savoir plus, reportez-vous à Connecter un bot à des canaux.

Prérequis

Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.
Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.
- Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.
- Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.
- Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

Bot déployé dans Azure. Si vous n’en avez pas encore, consultez Tutoriel : approvisionner un bot dans Azure et Tutoriel : publier un bot de base.

Exemples de commandes

Les sections suivantes utilisent des commandes Azure CLI pour connecter un bot à un canal. Ces exemples utilisent un bot appelé ContosoBot dans le groupe de ressources ContosoBotRG.

Certains de ces canaux nécessitent la commande pour se connecter à l’application pour s’authentifier. Si vous exécutez ces commandes à des fins de test, elles peuvent échouer si vous n’utilisez pas de valeurs réelles.

Direct Line

Direct Line intègre votre bot dans une application mobile, une page Web ou d’autres applications. Pour plus d’informations, consultez À propos de Direct Line.

Ces exemples de commandes créent une connexion au canal Direct Line à l’aide d’az bot directline create. L’exemple montre la connexion dans la console et supprime la connexion.

az bot directline create --resource-group ContosoBotRG --name ContosoBot --disablev1
az bot directline show --resource-group ContosoBotRG --name ContosoBot
az bot directline delete --resource-group ContosoBotRG --name ContosoBot

Office 365 e-mail

Vous pouvez permettre à votre bot de communiquer avec les utilisateurs à l’aide de Office 365 e-mail. Pour plus d'informations, consultez Connecter un bot à Office 365 e-mail.

Ces exemples de commandes créent une connexion au canal pour Office 365 e-mail à l’aide d’az bot email create. L’exemple montre la connexion dans la console et supprime la connexion.

az bot email create --resource-group ContosoBotRG --name ContosoBot \
   --email-address ContosoBot@outlook.com --password <password>
az bot email show --resource-group ContosoBotRG --name ContosoBot
az bot email delete --resource-group ContosoBotRG --name ContosoBot

Facebook

Vous pouvez connecter votre bot à Facebook Messenger et Facebook Workplace. Il peut communiquer avec les utilisateurs sur les deux plateformes. Pour plus d'informations, consultez Connecter un bot à Facebook.

Ces exemples de commandes créent une connexion au canal pour Facebook à l’aide d’az bot facebook create. L’exemple montre la connexion dans la console et supprime la connexion.

az bot facebook create --resource-group ContosoBotRG --name ContosoBot --appid <myAppId> \
   --page-id <myPageId> --secret <secret> --token <token>
az bot facebook show --resource-group ContosoBotRG --name ContosoBot
az bot facebook delete --resource-group ContosoBotRG --name ContosoBot

Microsoft Teams

Vous pouvez configurer votre bot pour communiquer avec Microsoft Teams. Pour plus d’informations, consultez Se connecter à Microsoft Teams.

Ces exemples de commandes créent une connexion au canal pour Microsoft Teams à l’aide d’az bot msteams create. L’exemple montre la connexion dans la console et supprime la connexion.

az bot msteams create --resource-group ContosoBotRG --name ContosoBot --calling-web-hook https://www.contosoapp.com/ \
   --enable-calling 
az bot msteams show --resource-group ContosoBotRG --name ContosoBot 
az bot msteams delete --resource-group ContosoBotRG --name ContosoBot

Skype

Vous pouvez configurer votre bot pour communiquer avec Skype. Pour plus d'informations, consultez Connecter un bot à Skype.

Ces exemples de commandes créent une connexion au canal pour Skype à l’aide d’az bot skype create. L’exemple montre la connexion dans la console et supprime la connexion.

az bot skype create --resource-group ContosoBotRG --name ContosoBot --enable-messaging --enable-screen-sharing
az bot skype show --resource-group ContosoBotRG --name ContosoBot 
az bot skype delete --resource-group ContosoBotRG --name ContosoBot

Slack

Vous pouvez configurer votre bot pour communiquer avec des utilisateurs de Slack. Pour plus d'informations, consultez Connecter un bot à Slack.

Ces exemples de commandes créent une connexion au canal pour Slack à l’aide d’az bot slack create. L’exemple montre la connexion dans la console et supprime la connexion.

az bot slack create --resource-group ContosoBotRG --name ContosoBot --client-id <clientid> \
   --client-secret <secret> --verification-token <token>
az bot slack show --resource-group ContosoBotRG --name ContosoBot
az bot slack delete --resource-group ContosoBotRG --name ContosoBot

SMS

Ces exemples de commandes créent une connexion au canal pour SMS à l’aide d’az bot sms create. L’exemple montre la connexion dans la console et supprime la connexion.

az bot sms create --resource-group ContosoBotRG --name ContosoBot --account-sid <sid> --auth-token <token> \
   --phone <smsphonenumber> --is-validated
az bot sms show --resource-group BotRG
az bot sms delete --resource-group BotRG

Vous pouvez configurer votre bot pour communiquer avec des utilisateurs via Telegram. Pour plus d'informations, consultez Connecter un bot à Telegram.

Ces exemples de commandes créent une connexion au canal pour Telegram à l’aide d’az bot telegram create. L’exemple montre la connexion dans la console et supprime la connexion.

az bot telegram create --resource-group ContosoBotRG --name ContosoBot --access-token <token> --is-validated
az bot telegram show --resource-group ContosoBotRG --name ContosoBot 
az bot telegram delete --resource-group ContosoBotRG --name ContosoBot

Nettoyer le déploiement

Si vous avez créé un groupe de ressources à des fins de test, exécutez la commande az group delete pour supprimer le groupe de ressources et tout ce qu’il contient.

az group delete --name ContosoBotRG

Pour supprimer une connexion à un canal, utilisez la commande delete appropriée.

Commandes Azure CLI utilisées dans cet article

Cet article utilise les commandes Azure CLI suivantes :

Partager via