使用 Azure CLI 將 Bot 連線至通道

發行項
10/24/2023

通道是通訊應用程式與 Bot 之間的連線。向 Azure 註冊的 Bot 會使用通道來啟用與使用者的通訊。本文中的命令會將 Bot 連線到各種通道。如需詳細資訊，請參閱將 Bot 連線至通道。

必要條件

在 Azure Cloud Shell 中使用 Bash 環境。如需詳細資訊，請參閱 Azure Cloud Shell 中的 Bash 快速入門。
若要在本地執行 CLI 參考命令，請安裝 Azure CLI。若您在 Windows 或 macOS 上執行，請考慮在 Docker 容器中執行 Azure CLI。如需詳細資訊，請參閱〈如何在 Docker 容器中執行 Azure CLI〉。
- 如果您使用的是本機安裝，請使用 az login 命令，透過 Azure CLI 來登入。請遵循您終端機上顯示的步驟，完成驗證程序。如需其他登入選項，請參閱使用 Azure CLI 登入。
- 出現提示時，請在第一次使用時安裝 Azure CLI 延伸模組。如需擴充功能詳細資訊，請參閱使用 Azure CLI 擴充功能。
- 執行 az version 以尋找已安裝的版本和相依程式庫。若要升級至最新版本，請執行 az upgrade。

部署至 Azure 的 Bot。如果您還沒有 Bot，請參閱教學課程：在 Azure 中布建 Bot 和教學課程：發佈基本 Bot 。

命令範例

下列各節使用 Azure CLI 命令將 Bot 連線到通道。這些範例會在資源群組中使用名為 ContosoBot 的 ContosoBotRG Bot。

其中有些通道需要命令才能與應用程式連線以驗證。如果您執行這些命令以供測試之用，如果您未使用實際值，這些命令可能會失敗。

Direct Line

Direct Line 會將 Bot 整合到行動應用程式、網頁或其他應用程式。如需詳細資訊，請參閱關於 Direct Line 。

這些範例命令會使用 az bot directline create 建立 Direct Line 通道的連線。此範例會顯示主控台中的連線，並刪除連線。

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 電子郵件

您可以讓使用者使用 Office 365 電子郵件與使用者通訊。如需詳細資訊，請參閱將 Bot 連線至 Office 365 電子郵件。

這些範例命令會使用 az bot email create 建立 Office 365 電子郵件通道的連線。此範例會顯示主控台中的連線，並刪除連線。

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

您可以將 Bot 連線到 Facebook Messenger 和 Facebook Workplace。它可以在兩個平臺上與使用者通訊。如需詳細資訊，請參閱將 Bot 連線至 Facebook 。

這些範例命令會使用 az bot facebook create 建立與 Facebook 通道的連線。此範例會顯示主控台中的連線，並刪除連線。

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

您可以將 Bot 設定為與 Microsoft Teams 通訊。如需詳細資訊，請參閱將 Bot 連線至 Microsoft Teams 。

這些範例命令會使用 az bot msteams create 建立與 Microsoft Teams 通道的連線。此範例會顯示主控台中的連線，並刪除連線。

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

您可以將 Bot 設定為與 Skype 通訊。如需詳細資訊，請參閱將 Bot 連線至 Skype 。

這些範例命令會使用 az bot skype create 建立與 Skype 通道的連線。此範例會顯示主控台中的連線，並刪除連線。

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

您可以設定 Bot 透過 Slack 與使用者通訊。如需詳細資訊，請參閱將 Bot 連線至 Slack 。

這些範例命令會使用 az bot slack create 建立與 Slack 通道的連線。此範例會顯示主控台中的連線，並刪除連線。

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

簡訊

這些範例命令會使用 az bot sms create 建立與 SMS 通道的連線。此範例會顯示主控台中的連線，並刪除連線。

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

您可以設定 Bot 透過 Telegram 與使用者通訊。如需詳細資訊，請參閱將 Bot 連線至 Telegram 。

這些範例命令會使用 az bot telegram create 建立與 Telegram 通道的連線。此範例會顯示主控台中的連線，並刪除連線。

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

清除部署

如果您已建立要測試的資源群組，請執行 az group delete 命令來移除資源群組及其包含的所有專案。

az group delete --name ContosoBotRG

若要移除通道的連線，請使用適當的 delete 命令。

本文中使用的 Azure CLI 命令

本文使用下列 Azure CLI 命令：

Share via