Microsoft Teams 网页触发器
- Updated: 2026/01/13
Microsoft Teams 网页触发器
Microsoft Teams 网页触发器使您能够根据 Microsoft Teams 聊天或频道中发生的事件自动处理任务。 网页触发器监听 Microsoft Teams 中发生的特定事件。 一旦事件发生，触发器将启动已配置的操作。
概览
Microsoft Teams 网页触发器使您能够基于 Microsoft Teams 中的事件（例如，直接聊天消息、群聊消息和频道成员变更）创建触发器。 您可以使用触发器在 Microsoft Teams 中事件发生时立即触发工作流，从而减少对关键通信的手动监控和响应时间。 Microsoft Teams 网页触发器中提供的选项，使您能够为诸如工单分配、从任何聊天消息中提取信息，以及启动邮件线程以通知相关方等场景创建基于触发器的自动化流程。
在 Microsoft Teams 应用中事件发生与基于该事件触发自动化之间的延迟小于 30 秒。 如果事件传递到会话失败，触发器会自动重试获取该事件。
Microsoft Teams 网页触发器可通过关键词对消息进行过滤。 过滤器选项使您能够在需要根据特定关键词触发自动化的场景中配置触发条件。 此选项将事件响应限制为包含指定关键词的消息。
该触发器以结构化 JSON 格式从 Microsoft 服务器捕获事件响应有效负载信息。 此有效负载包含用于验证数据的身份验证信息。 您可以在 审核日志 页面以键值对的形式查看响应有效负载。 您可以将此键值对信息作为会话中后续操作的输入。
身份验证
Microsoft Teams 网页触发器使用 OAuth 验证与 Microsoft 365 账户的连接。 请使用适用于 Microsoft Entra 的参数为 Microsoft Teams 设置 OAuth 连接。 有关设置 OAuth 连接的更多信息，请参阅 创建 OAuth 连接。
Microsoft Teams 网页触发器使用 Microsoft Azure 证书验证 Microsoft 账户订阅并解密来自 Microsoft 服务器的传入数据。 登录到您的 Microsoft Azure 门户并创建证书。 有关在 Microsoft Azure 门户中创建证书的详细信息，请参阅 Microsoft Learn 门户中的 Certificate creation methods。 有关管理证书的详细信息，请参阅 Managing encryption keys。
确保您在 Credential Vault 中添加已创建的证书。 执行以下操作，将证书数据添加到 Credential Vault：
- 在任何文本编辑器中打开证书文件。
- 复制证书文件的全部内容。
- 以管理员身份登录 Control Room。
- 转到，然后单击创建凭据。
- 输入该凭据的适当凭据名称和描述。
- 在属性部分的属性名称中输入一个合适的名称。
- 选择标准，并在属性 输入部分的值字段中粘贴证书内容。
- 单击创建凭据，将证书数据保存在 Credential Vault。
支持的事件
以下事件在个人和团队聊天触发器配置中均受支持：
| 事件 | 描述 |
|---|---|
| 添加新聊天信息时 | 当有新消息到达时。 |
| 更新聊天消息时 | 编辑现有聊天消息时。 |
| 删除聊天消息时 | 删除现有聊天消息时。 |
以下事件在团队成员资格触发器配置中受支持：
| 事件 | 描述 |
|---|---|
| 添加新团队成员时 | 当团队所有者向所选团队添加新成员时。 |
| 更新团队成员时 | 当团队所有者编辑现有团队成员的详细信息时。 |
| 移除团队成员时 | 当团队所有者将某个团队成员从所选团队中移除时。 |
先决条件
确保满足以下先决条件：
- Bot Creator 或 平民开发者 许可证。
- 事件触发器和查看我的机器人权限。
- 自动化所在文件夹的签入和签出权限。
- Microsoft 365 账户的活动 OAuth 连接。
- Microsoft Azure 证书。
设置
以下设置适用于 Microsoft Teams 网页触发器：
- Control Room OAuth 连接
- 使用选择选项，并按照选择 OAuth 连接模态框中的提示，选择 OAuth 连接。 OAuth 用于验证 Control Room 与 Microsoft 365 账户之间的连接。
- 聊天
- 使用此选项可根据单个聊天配置触发器。 聊天名称是基于聊天接收者的电子邮件 ID，而不是接收者的显示名称。
- 监听事件： 指定触发器必须监听的事件类型。
- 聊天名称： 输入聊天名称。 您还可以使用获取聊天名称按钮，通过聊天模态框选择聊天。
- 过滤器： 选中复选框并输入关键词，以过滤器消息。
- 团队和频道
-
团队聊天： 使用团队聊天选项根据 Teams 频道中发布的消息配置触发器。 以下设置适用于此选项：
- 选择一个或多个事件： 指定触发器必须监听的一个或多个事件类型。
- 团队名称： 输入团队名称。 您还可以使用 选择团队名称 按钮，通过 团队 模态框选择团队。
- 频道名称： 输入频道名称。 您还可以使用选择频道名称，通过频道模态框选择团队。
- 过滤器： 选中复选框并输入关键词，以过滤器消息。
-
团队成员： 使用团队成员资格选项，根据团队内成员资格的变更来配置触发器。 以下设置适用于此选项：
- 成员选项： 指定触发器必须监听的一个或多个事件类型。
- 团队名称： 输入团队名称。 您还可以使用 选择团队名称 按钮，通过 团队 模态框选择团队。
- 证书
- 使用证书选项选择用于身份验证和加密的证书。
- 凭据： 使用选择选项，并按照选择凭据模态框中的提示，选择 Credential Vault 中保存的 Microsoft Azure 证书。
- 不安全字符串： 使用不安全字符串选项可直接在输入字段中输入证书文件的内容。
- 响应
- 使用响应选项将触发器响应数据保存到记录变量中。 您可以创建一个新变量，或选择一个已有变量来存储此响应数据。
在 审核日志 中读取触发器响应数据
触发器响应数据包含事件记录中发生变更的所有信息。 此响应数据以键值对格式存储。 您可以提取这些数据，并将其作为自动化中其他操作的输入。 一旦机器人运行完成，触发器数据信息将作为由触发器运行的机器人事件类型记录在审核日志中。