使用 Azure CLI 將 Bot 連線到通道

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

先決條件

• 在 Azure Cloud Shell 中使用 Bash 環境。 如需詳細資訊，請參閱開始使用 Azure Cloud Shell。

  

• 若要在本地執行 CLI 參考命令，請安裝 Azure CLI。 如果您正在 Windows 或 macOS 上執行，請考慮在 Docker 容器中執行 Azure CLI。 如需詳細資訊，請參閱〈如何在 Docker 容器中執行 Azure CLI〉。

  • 如果您使用的是本機安裝，請使用 az login 命令，透過 Azure CLI 來登入。 若要完成驗證程式，請遵循終端機中顯示的步驟。 如需其他登入選項，請參閱 使用 Azure CLI 向 Azure 進行驗證。

  • 出現提示時，請在第一次使用時安裝 Azure CLI 延伸模組。 如需擴充功能的詳細資訊，請參閱 使用和管理 Azure CLI 的擴充功能。

  • 執行 az version 以尋找已安裝的版本和相依程式庫。 若要升級至最新版本，請執行 az upgrade。

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

範例命令

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

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

直達線路

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

臉書

您可以將 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 團隊

您可以將 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

鬆弛

您可以設定 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 命令：

• az bot directline create（創建 Azure 機器人 Direct Line 連接）
• az 機器人 directline 刪除
• az bot directline show
• az bot email create
• az bot email delete（用於刪除機器人電子郵件的指令）
• az bot email show
• az bot facebook create
• az bot facebook delete
• az bot facebook 顯示
• az bot msteams 建立
• az bot msteams delete
• az bot msteams show
• az bot skype create
• az bot skype delete
• az bot skype show
• az bot slack create（用於在 Slack 上創建機器人）
• az bot slack 刪除
• az bot slack 顯示
• az bot sms create
• az bot sms delete
• az bot 簡訊顯示
• az bot telegram 建立
• az bot 電報刪除
• az bot 電報顯示
• az group delete（刪除群組）

後續步驟

• 將機器人連接到頻道
• 管理 Bot