如何解决Teams频道发送@提及消息时的「Message mention text needs to be specified」流错误

触发该报错的核心原因：在流操作配置@提及规则时，仅填充了被提及人/频道的身份标识（如邮箱、用户ID），未对消息内需要展示的@文本做绑定匹配，无法通过Teams消息接口的校验规则。

具体可落地的修正步骤：

• 调整「发布Microsoft Teams消息」节点的提及项配置逻辑：每添加一个被提及对象，必须填写对应的Mention text字段，该字段的内容需要和消息正文中实际展示的@文字片段完全一致——例如正文里明确输入了「@张三 请查收本周交付物」，那么绑定张三账号的提及项里，Mention text就填「@张三」，不得留空。
• 禁止直接用身份变量拼接@文本跳过手动匹配：不要直接在正文里写<@{用户邮箱变量}>这类格式的内容当@占位，这类写法不会被接口识别为有效匹配的提及文本，必然触发校验报错，需要在正文里明确写出可展示的@片段，再把该片段和对应提及对象做关联。
• 前置校验用户身份获取结果：如果是通过邮箱查询对应用户的流程环节出现返回值为空，会导致后续提及配置无法匹配到有效Mention text，需要在添加提及规则前补一个「通过邮箱获取用户资料」的动作，确认能拿到用户的公开显示名称，再把该显示名称拼到提及文本中，不要直接把邮箱地址当Mention text填充。
• 频道/团队层级的@提及遵循相同规则：配置@频道、@整个团队的操作时，不能仅填入频道ID、团队ID，必须在对应提及项中填写和正文完全一致的展示文本，例如正文里@频道名称为「产品研发通知」，对应提及项的Mention text就填「@产品研发通知」。

报错界面可参考：报错截图

完成配置后可先向个人聊天渠道测试发送一次，确认@能正常触发通知提醒，再替换为正式频道地址做批量推送。

内容的提问来源于stack exchange，提问作者Esther