你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
通道是通信应用程序与机器人之间的连接。 在 Azure 注册的机器人可使用通道实现与用户的通信。 本文中的命令将机器人连接到各种通道。 有关详细信息,请参阅将机器人连接到频道。
先决条件
在 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 中部署机器人。 如果还没有机器人,请参阅 教程:在 Azure 中预配机器人和教程:发布基本机器人。
示例命令
以下部分使用 Azure CLI 命令将机器人连接到通道。 这些示例使用ContosoBot资源组中命名为ContosoBotRG的机器人。
其中一些通道要求使用该命令与应用程序连接以进行身份验证。 如果出于测试目的运行这些命令,且不使用实际值,则测试可能会失败。
Direct Line
Direct Line 将机器人集成到移动应用、网页或其他应用程序中。 有关详细信息,请参阅关于 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 电子邮件使机器人能够与用户通信。 有关详细信息,请参阅 将机器人连接到 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 Messenger 和 Facebook Workplace。 它可以与两个平台上的用户通信。 有关详细信息,请参阅 将机器人连接到 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
您可以配置您的机器人与 Microsoft Teams 进行通信。 有关详细信息,请参阅将机器人连接到 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
可以将机器人配置为与 Skype 通信。 有关详细信息,请参阅 将机器人连接到 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 与用户通信。 有关详细信息,请参阅 将机器人连接到 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 与用户通信。 有关详细信息,请参阅 将机器人连接到 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 删除
- az bot slack 显示
- az bot sms create
- az bot sms delete
- az bot 短信显示
- az bot telegram create
- az bot 电报删除
- az bot 电报显示
- az group delete