使用 Azure CLI 將 Bot 連線至通道

通道是通訊應用程式與 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

Telegram

您可以設定 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
• az bot directline delete
• 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 show
• az bot msteams create
• az bot msteams delete
• az bot msteams show
• az bot skype create
• az bot skype delete
• az bot skype show
• az bot slack create
• az bot slack delete
• az bot slack show
• az bot sms create
• az bot sms delete
• az bot sms show
• az bot telegram create
• az bot telegram delete
• az bot telegram show
• az group delete

下一步

• 將 Bot 連線至通道
• 管理 Bot