Microsoft Teams 触发器节点
使用Microsoft Teams触发器节点来响应Microsoft Teams中的事件,并将Microsoft Teams与其他应用程序集成。
在此页面上,您将找到Microsoft Teams触发器节点可以响应的事件列表以及更多资源的链接。
提示
Credentials 凭证
您可以在Microsoft 凭据文档找到此节点的身份验证信息。此节点还支持 Microsoft Entra Service Principal 凭据,可在没有已登录用户的情况下实现仅应用访问:在 Authentication 身份验证 下拉菜单中选择 Service Principal (App-Only)。
提示
Government Cloud Support 政府云支持
如果您使用的是政府云租户(美国政府、美国政府国防部或中国),请确保在 Microsoft 凭据配置中选择适当的 Microsoft Graph API Base URL Microsoft Graph API 基本 URL。
事件
- New Channel 新频道
- New Channel Message 新频道消息
- New Chat 新聊天
- New Chat Message 新聊天消息
- New Team Member 新团队成员
所需 scope
每个事件都会订阅一个 Microsoft Graph 资源,并需要下表中的一项委托权限(按权限从低到高排列):
| 事件 | 委托权限 |
|---|---|
| New Channel 新频道 | Channel.ReadBasic.All |
| New Channel Message 新频道消息 | ChannelMessage.Read.All |
| New Chat 新聊天 | Chat.ReadBasic、Chat.Read 或 Chat.ReadWrite |
| New Chat Message 新聊天消息 | Chat.Read 或 Chat.ReadWrite |
| New Team Member 新团队成员 | TeamMember.Read.All |
在节点中列出团队需要 Team.ReadBasic.All,列出频道需要 Channel.ReadBasic.All。ChannelMessage.Read.All 和 TeamMember.Read.All 需要 Microsoft Entra 管理员同意。Team、Channel 和 Chat 权限不需要管理员同意。
从 n8n 2.45.0 起,Teams OAuth2 凭据默认涵盖每个事件:TeamMember.Read.All 是它为 Microsoft Teams 设置的默认 scopes之一。
凭据默认的 User.Read.All 和 Group.ReadWrite.All scope 是权限更高的替代项,同样覆盖团队列表、频道列表和 New Channel 新频道订阅。凭据不需要为这些功能额外授权。两个 scope 都需要管理员同意。
在 n8n 2.45.0 之前连接的凭据会在你重新连接时请求 TeamMember.Read.All。重新连接前,Microsoft Entra 管理员必须同意该 scope,否则登录会失败。请参阅新 scopes 需要再次批准。
订阅续期
提示
功能可用性
Microsoft Teams Trigger 节点中的自动订阅续期从 n8n 2.45.1 起可用。
发布工作流时,Microsoft Teams Trigger 节点会为它监视的每个资源创建一个 Microsoft Graph 变更通知订阅。Microsoft Graph 会在三天后让 Teams 订阅过期。触发器会在到期前续订订阅。
在 n8n 2.45.1 之前,触发器不会续订订阅,因此大约在你发布工作流三天后就停止接收事件。在这些版本上,取消发布工作流再重新发布,可以重建订阅。触发器随后大约还能再接收三天的新事件。
升级后,只要更早 n8n 版本创建的订阅尚未过期,触发器也会续订它们。如果工作流在升级前已经停止接收事件,请取消发布再重新发布。
从 n8n 2.45.1 起,生命周期通知(reauthorizationRequired 和 subscriptionRemoved)不再作为数据项进入工作流。在 n8n 2.45.1 之前,每条生命周期通知都会启动一次执行。如果你的工作流依赖这些数据项,请改为查看实例日志。
只有当你的 n8n 实例可达时,续期才会生效。如果订阅在 n8n 停机或不可达期间过期,触发器会停止接收事件。取消发布工作流再重新发布,可以重建订阅。
触发器不会为没有存储订阅密钥的工作流续订订阅,例如丢失了静态数据或导入工作流之后。这些订阅会过期,触发器会停止接收事件。实例日志会显示 Microsoft Teams Trigger: skipped lifecycle notifications: no stored secret, republish the workflow。取消发布再重新发布可以重建它们。
续期也可能因其他原因失败,例如 Microsoft Graph 速率限制、过期的 refresh token 或被撤销的同意。触发器不会重试,工作流也不会显示失败的执行。实例日志会包含以下之一:
Microsoft Teams Trigger: failed to renew subscriptionMicrosoft Teams Trigger: failed to re-create subscriptionMicrosoft Teams Trigger: failed to list subscriptions or resolve resources, skipped re-create
如果在订阅过期前没有一次续期成功,触发器会停止接收事件。如果触发器未能重建订阅,它已经停止接收该资源的事件。
对于过期的 refresh token,请重新连接凭据。对于被撤销的同意,Microsoft Entra 管理员必须再次授予同意,然后你再重新连接 OAuth2 凭据。如果你在 n8n 2.45.0 之前连接了凭据,重新连接还会请求 TeamMember.Read.All,这需要管理员同意,如所需 scope所述。然后取消发布工作流并重新发布,以重建订阅。
使用默认日志设置时,这些日志行不包含工作流 ID 或错误消息。如果你自托管 n8n,把 N8N_LOG_FORMAT 设为 json 即可包含它们。请参阅日志环境变量。
如果触发器停止接收事件,而你找不到上述日志行,请取消发布工作流再重新发布。
使用 Microsoft OAuth2 (Graph) 凭据时,请在凭据的 Scope 字段中输入 scope。请包含 openid offline_access,使凭据可以刷新 token。例如,要使用权限最小的 scope 支持每个事件,请输入:
openid offline_access Team.ReadBasic.All Channel.ReadBasic.All Chat.Read ChannelMessage.Read.All TeamMember.Read.All
而 Service Principal (App-Only) 凭据使用应用权限。有关每个事件所需的权限,请参阅 Microsoft Entra Service Principal 凭据文档中的各节点所需的应用权限。此凭据不支持 Chat 事件。
相关资源
n8n 为 Microsoft Teams 提供应用程序节点。您可以在Microsoft Teams 节点文档找到节点文档。
在 n8n 的网站上查看示例工作流程和相关内容。
有关 API 的详细信息,请参阅 Microsoft Teams 文档。