Verbinden Ihres Bots mit Kanälen mit der Azure CLI

Artikel
12/29/2023

Ein Kanal ist eine Verbindung zwischen einer Kommunikationsanwendung und einem Bot. Ein bei Azure registrierter Bot verwendet Kanäle, um die Kommunikation mit Benutzern zu ermöglichen. Die Befehle in diesem Artikel verbinden einen Bot mit verschiedenen Kanälen. Mehr Informationen: Verbinden Sie einen Bot mit Kanälen.

Voraussetzungen

Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Schnellstart für Bash in Azure Cloud Shell.
Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.
- Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.
- Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.
- Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.

Ein in Azure bereitgestellter Bot Wenn Sie noch keinen haben, lesen Sie Tutorial: Bereitstellen eines Bots in Azure und Tutorial: Veröffentlichen eines einfachen Bots.

Beispielbefehle

In den folgenden Abschnitten werden Azure CLI-Befehle verwendet, um einen Bot mit einem Kanal zu verbinden. In diesen Beispielen wird ein Bot mit dem NamenContosoBot in der ContosoBotRG Ressourcengruppe verwendet.

Einige dieser Kanäle erfordern den Befehl, um zur Authentifizierung eine Verbindung mit der Anwendung herzustellen. Wenn Sie diese Befehle zu Testzwecken ausführen, können sie fehlschlagen, wenn Sie keine echten Werte verwenden.

Direct Line

Direct Line integriert Ihren Bot in eine mobile App, Webseite oder andere Anwendungen. Weitere Informationen finden Sie unter Informationen zu Direct Line.

Diese Beispielbefehle erstellen eine Verbindung mit dem Direct Line-Kanal mithilfe von az bot directline create. Das Beispiel zeigt die Verbindung in der Konsole und löscht die Verbindung.

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

Sie können Ihrem Bot die Kommunikation mit Benutzern über Office 365-E-Mails ermöglichen. Mehr Informationen finden Sie unter Einen Bot mit Office 365 E-Mails verbinden.

Diese Beispielbefehle erstellen eine Verbindung mit dem Office 365 E–Mails-Kanal mithilfe von az bot email create. Das Beispiel zeigt die Verbindung in der Konsole und löscht die Verbindung.

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

Sie können Ihren Bot sowohl mit Facebook Messenger als auch mit Facebook Workplace verbinden. Er kann mit Benutzern auf beiden Plattformen kommunizieren. Weitere Informationen finden Sie unter Einen Bot mit Facebook verbinden.

Diese Beispielbefehle erstellen eine Verbindung mit dem Facebook-Kanal mithilfe von az bot facebook create. Das Beispiel zeigt die Verbindung in der Konsole und löscht die Verbindung.

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

Sie können Ihren Bot für die Kommunikation mit Microsoft Teams konfigurieren. Weitere Informationen finden Sie unter Einen Bot mit Microsoft Teams verbinden.

Diese Beispielbefehle erstellen eine Verbindung mit dem Microsoft Teams-Kanal mithilfe von az bot msteams create. Das Beispiel zeigt die Verbindung in der Konsole und löscht die Verbindung.

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

Sie können Ihren Bot für die Kommunikation mit Skype konfigurieren. Weitere Informationen finden Sie unter Einen Bot mit Skype verbinden.

Diese Beispielbefehle erstellen eine Verbindung mit dem Skype-Kanal mithilfe von az bot skype create. Das Beispiel zeigt die Verbindung in der Konsole und löscht die Verbindung.

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

Sie können Ihren Bot so konfigurieren, dass er mit Benutzuern über Slack kommuniziert. Weitere Informationen finden Sie unter Einen Bot mit Slack verbinden.

Diese Beispielbefehle erstellen eine Verbindung mit dem Slack-Kanal mithilfe von az bot slack create. Das Beispiel zeigt die Verbindung in der Konsole und löscht die Verbindung.

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

Diese Beispielbefehle erstellen eine Verbindung zum Kanal für SMS mithilfe von az bot sms create. Das Beispiel zeigt die Verbindung in der Konsole und löscht die Verbindung.

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

Sie können Ihren Bot so konfigurieren, dass er mit Benutzern über Telegram kommuniziert. Weitere Informationen finden Sie unter Einen Bot mit Telegram verbinden.

Diese Beispielbefehle erstellen eine Verbindung zum Kanal für Telegram mithilfe von az bot telegram create. Das Beispiel zeigt die Verbindung in der Konsole und löscht die Verbindung.

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

Bereinigen der Bereitstellung

Wenn Sie eine Ressourcengruppe zum Testen erstellt haben, führen Sie denBefehl az group delete aus, um die Ressourcengruppe und alles, was sie enthält, zu entfernen.

az group delete --name ContosoBotRG

Verwenden Sie den entsprechenden Löschbefehl, um eine Verbindung mit einem Kanal zu entfernen.

In diesem Artikel verwendete Azure CLI-Befehle

In diesem Artikel werden die folgenden Azure CLI-Befehle verwendet:

Share via