构建可向 Microsoft Teams 发送主动消息的机器人

已完成

Teams Toolkit for Visual Studio Code 扩展提供了多个用于构建机器人的基于方案的应用模板。 基于 聊天通知机器人 方案的应用模板会创建一个机器人,该机器人可以触发以向 Microsoft Teams 发送主动通知。 主动消息是为响应外部事件或触发器而发送的消息。 你将使用此模板在下一单元中创建机器人。

注意

本模块中的练习使用 Teams 工具包 v5.0.0。

用于生成机器人的组件

若要开发适用于 Teams 的机器人,需要:

  • 用于托管和运行机器人代码的 Web 服务器
  • 一个 Azure 机器人服务机器人 ,用于使机器人可供 Teams 使用。
  • 用于将机器人注册到 Microsoft 云的 Microsoft Entra 应用
  • HTTP 隧道服务 ,用于为用于从机器人服务接收消息的本地终结点提供可公开访问的 URL。
  • 用于将机器人部署到 Teams 的 Microsoft Teams 应用包 。 此包包含应用清单文件,该文件描述机器人功能以及机器人可以安装的位置, (聊天、频道、会议、个人应用) 。

简化设置

Teams Toolkit for Visual Studio Code 处理创建和配置开发机器人所需的资源的复杂性。 首次运行机器人时,它会为你执行以下步骤:

  1. 验证并安装先决条件。
  2. 使用 VisualStudio Dev Tunnels 服务启动 HTTP 隧道。
  3. 创建 Microsoft Entra 应用注册。
  4. 创建 Azure 机器人服务注册。
  5. 编译机器人代码并启动本地 Web 服务器。
  6. 生成 Teams 应用包。
  7. 将应用包部署到 Teams。
  8. 启动调试会话。
  9. 打开浏览器窗口,转到 Teams Web 客户端,并显示应用安装对话框。

主动邮件

若要触发要发送到 Teams 的主动消息,请向本地 Web 服务器上托管的通知终结点发送 HTTP POST 请求。 可以使用任何 HTTP 客户端发送请求。 例如,可以使用命令行工具(如 cURL 或 PowerShell),使用桌面应用程序(如 Postman)或云服务(如 Azure Functions)。

自适应卡片

机器人可以将名为 自适应卡片 的交互式卡片作为主动消息发送到 Teams。 自适应卡提供了一种强大而灵活的方法来创建丰富、一致的交互式体验,这些体验可用于各种平台和设备。

在下一练习中,你将了解如何使用基于通知机器人方案的应用模板创建适用于 Teams 的 机器人 。 你还将了解如何触发机器人以从命令行将自适应卡片发送到 Teams。