发送主动消息

主动消息是机器人为响应用户聊天中发送的简单命令而发送的消息。消息响应可以使用以下格式之一：

本分步指南可帮助你从机器人发送主动消息。你将看到以下输出：

屏幕截图显示了 Teams 聊天中的主动 hello 消息。

先决条件

确保安装以下用于生成和部署应用的工具。

	安装	使用
	Microsoft Visual Studio Code	JavaScript 或 TypeScript，生成环境。使用最新版本。
	Microsoft Teams 工具包	Visual Studio Code扩展，用于为应用创建项目基架。使用最新版本。
	Node.js	后端 JavaScript 运行时环境。有关详细信息，请参阅项目类型的Node.js 版本兼容性表。
	Microsoft Teams	团队通过聊天、会议、通话等应用与你一起工作的每个人协作。
	Microsoft Edge（推荐）或 Google Chrome	包含开发人员工具的浏览器。
	Microsoft 365 开发人员帐户	具有安装应用的相应权限的 Teams 帐户的访问权限。

安装所需的工具后，设置开发环境。

Microsoft Teams 工具包通过为应用预配和部署云资源以及发布到 Teams 应用商店的工具，帮助简化开发过程。

可以将 Teams 工具包与Visual Studio Code或名为 TeamsFx CLI 的命令行界面配合使用。

还可以从 Visual Studio Code 市场安装 Teams 工具包。

若要安装 TeamsFx CLI，请使用 npm 包管理器并在命令提示符中输入以下命令：

npm install -g @microsoft/teamsfx-cli

根据配置，可能需要使用 sudo 来安装 CLI：

sudo npm install -g --unsafe-perm @microsoft/teamsfx-cli

这种情况在 Linux 和 macOS 系统上更为常见。

确保将 npm 全局缓存添加到 PATH。此步骤通常作为 Node.js 安装程序的一部分完成。

可以将 CLI 与命令一起使用 teamsfx 。通过运行 teamsfx -h验证命令是否正常工作。

警告

在 PowerShell 终端中运行 TeamsFx 之前，必须为 PowerShell 启用 远程签名 的执行策略。

租户是 Teams 中组织的空间或容器，可在其中聊天、共享文件和运行会议。此空间也是上传和测试应用的位置。让我们验证是否已准备好使用租户进行开发。

创建自定义应用后，必须使用“上传自定义应用”选项将 应用上传到 Teams。如果启用此选项，请登录到 Microsoft 365 帐户以检查。

以下步骤可帮助你验证是否可以在 Teams 中上传应用：

如果没有 Teams 开发人员帐户，请加入 Microsoft 365 开发人员计划。

若要使用 Visual Studio Code 生成主动消息机器人，请执行以下步骤：

打开 Visual Studio Code。
选择“Visual Studio Code活动栏中的 Teams 工具包”图标。
在左窗格中，选择“ 查看示例”。
从示例列表中，选择“ 主动消息传送”。此时会打开一个已准备好进行调试的预生成示例。
选择“创建”。
选择“ 默认文件夹 ”，将项目根文件夹存储在默认位置。

如果要更改默认位置，请执行以下步骤：
1. 选择“ 浏览”。
2. 选择项目工作区的位置。
3. 选择 “选择文件夹”。
主动消息机器人在几秒钟内创建，并在右下角显示主动消息机器人成功对话框，其中包含调试选项：

:::
选择左上角的 “运行和调试” 图标。
从下拉列表中选择 “调试 (Edge) ”或“调试 (Chrome) ”。

调试成功后，系统会提示将主动消息机器人上传到本地计算机上的 Teams。
在 “添加”旁边的下拉列表中，选择“ 添加到团队 ”或“ 添加到聊天 ”或 “添加到会议”。
在搜索字段中输入聊天或团队的名称，然后选择 “设置机器人”。

主动消息机器人应用将上传到 Teams 客户端，并显示以下消息以响应发送的消息。
复制并粘贴 URL 或导航到浏览器中的 URL。在聊天中触发并共享主动 hello 消息。
转到 Teams。你将收到来自机器人的 主动 hello 消息。

Teams 工具包提供用于生成应用的组件。创建项目后，可以在 Visual Studio Code 的“资源管理器”区域中查看项目文件夹和文件。

屏幕截图显示了“结构”选项卡。

新项目文件夹包含以下内容：

文件夹/文件	目录
`.vscode/`	用于调试的Visual Studio Code文件。
`appManifest/`	应用清单的模板 (以前称为 Teams 应用清单) 。
`env/`	名称/值对存储在环境文件中，由 `teamsapp.yml` 用于自定义预配和部署规则。
`manifest.json`	用于通过 Teams 开发人员门户发布的应用清单存储在中 `Properties/manifest.json`。
`teamsapp.yml`	主项目文件描述应用配置，并定义要在每个生命周期阶段运行的操作集。
`teamsapp.local.yml`	这将替代 `teamsapp.yml` 启用本地执行和调试的操作。

你已了解如何使用主动消息机器人功能生成和运行 Teams 应用。让我们使用 Teams 工具包在 Azure 上部署具有主动消息机器人功能的第一个应用。

使用帐户访问 Microsoft Azure 门户并预配新的云资源以支持你的应用。