IM用户映射

1.1 功能简介

IM 用户映射功能用于将第三方 IM 平台中的用户与 Data Agent 平台中的用户建立对应关系，使定时任务的触达用户配置能够准确识别 IM 端的接收人。

1.2 使用场景

• 通过用户映射关系，将平台定时任务的推送对象与第三方 IM 工具用户绑定，确保消息能准确送达目标用户或群组。

• 灵活适配不同企业的用户管理习惯，实现平台用户与 IM 用户的身份对齐。

• 支持单条添加与批量上传映射表，满足不同规模企业的用户配置需求，提升管理效率。

2.1 设置入口

以管理员身份进入「管理后台>用户管理>IM 用户映射」标签页，页面展示支持配置的 IM 平台列表，点击目标平台（如企业微信）右侧的「编辑」按钮，进入对应平台的用户映射配置页。

2.2 应用对接

IM 管理员或开发者创建对应 IM 工具的自建应用后，获取应用ID、Secret 等信息，并回填至 Dora 中，以完成 Data Agent 平台与 IM 工具的对接。

例如：将 Data Agent 官方平台与帆软企业微信对接，则需要帆软企业微信管理员或开发者创建企业微信自建应用，并将 CorpSecret 与 CorpId 回填至 Data Agent 中。

不同平台的应用对接方式可参考文档：

• 企业微信机器人-应用对接

• 飞书机器人【2-4 章节】

• 钉钉机器人【2-4 章节】

注：通过 IM 自建应用打通 IM 平台与 Data Agent 平台时，建议企业管理员创建权限覆盖全员的对接应用，确保后续用户映射环节可同步全量企业用户。

2.3 选择用户匹配方式

进入平台配置页后，支持两种用户匹配方式，可根据企业实际场景选择。

方式一：用户名/ID 匹配

选择「用户名/ID 匹配」选项后，系统将自动尝试将第三方 IM 平台中的用户名/ID 与 Data Agent 平台中的用户名/ID 进行匹配。

匹配成功的用户将自动同步至 Data Agent 平台，无需手动配置映射关系，配置完成后点击「保存」，匹配规则即时生效。

方式二：自定义匹配

选择「自定义匹配」后，支持在下方「用户映射」区域，上传用户映射表，批量上传映射，步骤如下：

1）用户可先下载导入模板，按照模板格式填写后再上传映射表文件

2）文件上传成功后，系统自动解析文件内容，页面上将同步呈现 IM 平台用户名和 Data Agent 用户名。

3）匹配后，支持手动修改 IM 平台用户对应的 Data Agent 用户名。

注：当前仅支持上传 .xls、.xlsx 格式的映射表文件。

4）若后续使用中，需要在 Dora 平台中添加 IM 平台其他用户，可点击「刷新获取」，选择对应的 Data Agent 平台用户并保存即可。

1）对接企业微信用户数据，需由企业微信管理员在后台导出用户 ID 方可完成映射。

2）使用用户名/ID 匹配时，需确保 IM 平台与 Data Agent 平台的用户名/ID 完全一致，否则无法自动匹配。

3）批量上传的映射表需严格按照模板格式填写，列名、格式不规范将导致解析失败。

4）通过「自定义匹配>添加映射」手动逐个添加用户映射关系时，IM 的用户名需使用「用户名(ID)」的形式，便于快速精准的定位用户。