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 连接。 有关配置 OAuth 连接的更多信息，请参阅 创建 OAuth 连接。
- 聊天
- 指定基于聊天的触发器配置。 聊天名称是基于聊天接收者的电子邮件 ID，而不是接收者的显示名称。
- 监听事件
- 指定要订阅的聊天事件。 您可以从以下选项中选择一个或多个事件：
- 添加聊天消息时
- 更新聊天消息时
- 删除聊天消息时
- 聊天名称
- 指定聊天名称。 您可以手动输入聊天名称，或使用获取聊天名称按钮，通过聊天模态框选择聊天。
- 过滤器
- 指定用于过滤消息的关键字。
- 团队和频道
- 指定团队或基于频道的触发器配置。 您可以根据团队聊天或团队成员资格变更来定义配置。
- 团队聊天
- 指定基于团队聊天的触发器配置。 此配置基于 Teams 变更中发布的消息。 以下设置适用于此选项：
- 选择一个或多个事件
- 指定要订阅的聊天事件。 您可以从以下选项中选择一个或多个事件：
- 添加聊天消息时
- 更新聊天消息时
- 删除聊天消息时
- 团队名称
- 指定频道所在的团队名称。 您可以直接输入团队名称，或者使用选择团队名称按钮，通过团队模态框选择团队。
- 频道名称
- 指定聊天所在的频道名称。 您可以直接输入频道名称，或者使用选择频道名称按钮，通过频道模态框选择团队。
- 过滤器
- 指定用于过滤消息的关键字。
- 团队成员
- 指定基于团队成员资格的触发器配置。 此配置基于团队中的团队成员资格变更。 以下设置适用于此选项：
- 成员选项
- 指定要订阅的团队成员资格事件。 您可以从以下选项中选择一个或多个事件：
- 添加团队成员时
- 更新团队成员时
- 移除团队成员时
- 团队名称
- 指定成员资格更改发生所在团队的名称。 您可以直接输入团队名称，或者使用选择团队名称按钮，通过团队模态框选择团队。
- 证书
- 指定用于验证连接和加密数据的 Microsoft Azure 证书。 选择以下选项之一
- 凭据： 使用选择选项，并按照选择凭据模态框中的提示，选择 Credential Vault 中保存的 Microsoft Azure 证书。
- 不安全字符串： 使用不安全字符串选项可直接在输入字段中输入证书文件的内容。 在不安全字段中输入证书内容会暴露证书。
- 响应
- 指定用于存储响应数据的变量。 触发器将响应数据以键值对格式保存，您可以在会话中的下游操作中使用此数据。 您可以使用以下任一选项：
-
多个变量： 创建并指定单独的变量以存储特定的响应数据。
使用添加变量映射选项来指定键和值对应的变量类型，以存储特定的响应数据。
- 记录： 创建并指定一个记录变量以存储完整的响应数据。
-
多个变量： 创建并指定单独的变量以存储特定的响应数据。
在 审核日志 中读取触发器响应数据
触发器响应数据包含事件记录中发生变更的所有信息。 此响应数据以键值对格式存储。 您可以提取这些数据，并将其作为自动化中其他操作的输入。 一旦机器人运行完成，触发器数据信息将作为由触发器运行的机器人事件类型记录在审核日志中。