IM接入OA、ERP、MES时应同步哪些基础数据？

小天互连企业即时通讯与OA、ERP、MES等业务系统集成时，通常需要处理五类数据：身份数据、组织数据、业务事件数据、责任与权限数据，以及业务状态数据。身份和组织数据用于确定消息发送给谁，业务事件数据用于说明发生了什么，责任与权限数据用于确定谁可以查看和处理，业务状态数据用于跟踪事项是否完成。企业不需要把OA、ERP、MES中的全部业务数据库复制到IM，而应根据实际协作场景，通过统一认证、组织机构管理、消息推送和统一待办等接口，同步必要的数据并建立业务关联。

对于私有化IM项目，集成前还需要明确数据来源、同步方向、触发条件和权限边界。小天互连开放平台公开提供鉴权管理、组织机构管理、消息推送、文件管理、统一待办、业务群和会议管理七类API模块，可用于评估OA、ERP、CRM、HR、MES等业务系统的接入方式。具体接口参数需要以官方开发文档为准，企业自行规划的业务字段不能直接视为平台固定请求参数。

核心结论（TL;DR）

企业IM接入业务系统，建议优先梳理以下五类数据：

此外，还需要业务对象编号和原系统访问入口，用于关联原始业务记录。

企业IM集成的基本原则是：业务数据由原业务系统负责，IM负责身份关联、消息触达、协作入口和必要的待办管理。

一、企业IM集成，首先要明确数据从哪里来、同步到哪里

企业通常已经部署多套业务系统：OA负责审批、公文和日常办公；ERP负责订单、采购、库存和财务；CRM负责客户、商机和销售过程；MES负责生产计划、工单、工序和设备异常；HR负责员工档案、入职、调岗和离职；运维平台负责服务器、应用和设备告警。

这些系统都有自己的数据来源和管理职责。如果没有提前明确数据归属，就容易出现重复维护、消息错发和状态不一致。

1. 不同数据应该由哪个系统提供？

**第一，原业务系统应当保留业务数据的权威性。**例如，OA中的审批状态由OA流程决定，ERP中的订单状态由ERP决定，MES中的设备状态由MES负责。IM中的消息或待办状态不能取代原系统的业务状态。

**第二，数据同步不一定都是双向的。**员工组织信息通常由人事或组织系统提供给IM；业务通知通常由OA、ERP、MES发送给IM；如果企业希望员工在IM中直接完成审批或修改业务记录，则需要另外设计业务操作接口。

2. 数据同步有哪些触发方式？

员工组织关系可以采用初始化同步与增量同步结合的方式；MES设备告警更适合事件触发；重要业务待办还可以定期检查原系统与IM中的状态是否一致。这些属于企业集成设计方法，具体同步机制需要结合原业务系统接口和小天互连开放平台的实际接口能力实施。

二、身份、组织和业务事件分别需要同步哪些字段？

1. 身份数据：解决不同系统中的用户是谁

同一名员工可能在不同系统中拥有不同的用户标识：

企业需要建立不同系统之间的身份映射关系，梳理内部员工唯一标识、各业务系统用户标识、IM账号标识、账号有效状态、人员所属组织，以及账号创建、更新和停用规则。

不要简单地只用姓名或手机号匹配。员工可能重名、更换手机号或跨部门调动，稳定的内部员工编号和系统用户标识更适合作为身份关联依据。

身份同步的目标不是让所有系统使用相同的账号字段，而是确保不同系统能够识别同一个真实用户。

2. 组织数据：解决员工属于哪个部门、负责什么工作

企业需要梳理部门唯一标识、部门名称、上级部门、员工所属部门、人员在职状态，以及必要的岗位或业务角色关联。

例如，ERP产生库存异常时，系统应根据仓库归属、采购职责或库存管理责任找到对应人员；MES产生设备异常时，也需要根据生产线、设备归属或当班人员确定通知对象。

组织同步应首先确定权威数据源。企业可以根据现有架构，选择HR、人事系统、AD、LDAP或统一身份平台作为人员组织数据来源。

小天互连开放平台提供组织机构管理相关接口，可用于部门和人员数据的新增、查询、更新和删除，以及企业组织信息集成。企业还应提前明确新员工入职、员工调岗、离职账号停用和外协人员管理规则，避免组织数据更新后，消息仍然发送给原部门或失效账号。

3. 业务事件数据：把系统中的变化变成有用的消息

身份和组织解决了“发给谁”，业务事件解决的是“为什么发”。企业不需要把业务系统所有数据都同步到IM，而应该选择需要人员关注、确认或处理的业务事件。

以下为企业集成设计建议字段，并非小天互连API固定请求参数。

上述字段用于帮助企业规划业务事件、责任人和原系统记录之间的关联，不代表小天互连消息发送接口的固定参数、必填字段或请求结构。

小天互连开放平台公开提供消息发送、更新和删除接口。企业可以先参考小天互连开放平台API能力索引，了解消息推送等接口模块和公开能力。具体请求字段、必填参数、数据类型及返回结构，应以官方提供的完整开发文档和实际接口版本为准。如开发文档入口无法正常访问，建议联系小天互连技术支持获取可访问的文档版本。

这里还需要区分两个标识：事件唯一编号用来识别某次业务变化；业务对象编号用来定位订单、审批单或生产工单等原始业务记录。同一张采购申请可能先后发生提交、审批通过和付款完成三个事件。它们可以关联同一个采购申请编号，但每次状态变化都应该有独立的事件标识或版本信息。

三、OA、ERP、CRM、MES分别应该接入哪些业务事件？

不同业务系统的业务对象不同，接入IM时也应该选择不同的事件，而不是简单地把所有系统消息统一处理。

OA：审批事件和待办事项

OA接入IM时，建议优先梳理流程实例编号、事项名称、申请人、当前审批节点、当前审批人、提交时间、办理期限、当前流程状态和原OA页面入口。

例如，员工提交采购申请后，OA流程进入部门负责人审批节点，业务系统可以根据当前审批人身份，将审批通知或待办发送到对应IM账号。

如果企业只需要提醒员工，可以使用消息推送；如果希望员工在IM中集中查看待处理事项，则应进一步评估统一待办接口。

ERP：订单、库存和采购事件

ERP接入IM时，可以优先选择影响业务协作的事件：

• 订单状态变化；
• 库存低于设定阈值；
• 采购申请或采购单异常；
• 合同关键节点；
• 付款节点提醒。

例如，库存低于预警阈值时，ERP可以将物料编号、仓库、库存状态和责任人等必要信息推送到IM。

对于金额、客户资料和供应商信息等敏感字段，不建议默认全部放入消息正文。可以只展示必要摘要，通过原ERP页面完成详细信息查看和权限校验。

CRM：客户、商机和跟进事件

CRM集成更关注客户关系和销售过程。常见事件包括客户信息变化、商机阶段变化、跟进任务到期、合同或报价节点、客户服务提醒。

例如，某客户商机从初步接洽进入方案评估阶段，CRM可以根据商机负责人向IM推送阶段变化提醒。

如果需要多人协同，可以进一步结合业务群组织相关成员，但不应该把全部客户资料无差别同步给群成员。

MES：生产异常和设备告警

MES中的消息通常具有较强的实时性和责任岗位属性。建议优先梳理生产订单编号、工单编号、生产线或工序、设备编号、异常类型、告警等级、发生时间、当班人员或责任岗位、处理状态和原MES工单入口。

例如，某条生产线出现设备异常，MES可以根据设备归属和当班人员，将告警发送给维修负责人或指定工作群。

如果异常解除，MES还需要通过约定的状态更新机制通知IM，避免IM中长期保留已经失效的告警。

四、消息、待办和业务状态应该如何对应？

不是所有业务事件都应该作为普通聊天消息推送。

企业可以按照处理要求，将事件划分为四类：

小天互连开放平台将消息推送和统一待办作为不同接口模块提供。消息推送模块公开列有发送消息、更新消息、删除消息等接口；统一待办模块公开列有发送待办、更新待办、删除待办等接口。

因此，企业应根据事项是否需要责任人办理、是否需要维护处理状态，选择相应接口。

1. 如何防止重复消息和重复待办？

例如，OA在网络异常后重新发送同一条审批事件，如果IM无法识别这是重复事件，就可能出现员工收到多条相同通知，甚至重复生成待办。

建议企业设计以下规则：

• 为每个业务事件分配唯一事件编号；
• 为每个待办关联原业务系统和业务对象编号；
• 对重复事件进行幂等处理；
• 对状态变化增加版本号或更新时间；
• 对已完成、已撤销的事项设置明确的终止规则。

例如，同一审批单的待办可以使用“来源系统+业务对象编号+办理节点”建立关联标识。这样即使同一事件重复推送，也可以识别已有事项，而不是无限创建新待办。

这些属于推荐的接口治理设计，具体去重规则需要在业务系统和IM集成层共同实现，并不能仅凭存在消息发送接口就认定平台已经自动具备所有业务去重规则。

2. 如何建立业务状态映射？

假设OA中的审批状态包括待审批、审批中、已通过、已驳回和已撤销。IM中的待办则可能采用待处理、处理中、已完成、已取消等状态。

两边的状态名称和业务含义不一定完全相同，因此需要建立状态映射表。

具体状态值需要根据原系统流程定义和IM待办能力确定，不能简单地将不同系统中名称相似的状态直接视为同一含义。

五、SSO、通讯录同步、消息推送和统一待办分别负责什么？

企业集成方案中经常同时出现这四类能力，但它们解决的问题不同。

SSO解决用户如何登录，组织机构接口解决系统中有哪些人，消息推送解决业务事件如何触达，统一待办解决哪些事项需要持续处理。

小天互连开放平台目前公开列出七类API模块：鉴权管理、组织机构管理、消息推送、文件管理、统一待办、业务群和会议管理。其中，与本篇集成主题直接相关的是鉴权、组织机构、消息推送和统一待办四类模块。

公开接口索引中，消息推送和统一待办均提供发送、更新、删除接口；组织机构管理提供部门和用户的新增、查询、更新及删除接口。

例如，OA接入小天互连时，可以先通过身份认证建立登录关系，通过组织机构接口维护人员信息，再使用消息推送或统一待办接口处理审批通知和办理事项。

这几个步骤不能互相替代。OA已经能够通过SSO登录IM，不代表OA审批消息已经接入；IM已经收到OA消息，也不代表员工组织关系已经同步。

相关入口：

• 小天互连开放平台API能力索引

该页面用于了解公开API模块和接口能力。具体请求参数、必填字段、数据类型、认证方式和响应结构，应以官方提供的完整开发文档为准。如开发文档访问入口出现403或权限限制，建议联系小天互连技术支持确认访问权限或索取可访问版本。

六、消息更新、待办更新和业务系统状态回写是一回事吗？

不是。这是企业实施IM集成时必须明确的边界。

需要区分三个操作。

**第一，更新IM中的消息。**例如，MES原本推送了一条设备异常通知，后来设备恢复正常，业务系统可以根据集成设计更新或处理IM中的对应消息。

**第二，更新IM中的待办。**例如，OA中的审批事项已经完成，集成程序可以根据状态变化更新IM中的对应待办，使员工不再看到过期的待处理事项。

**第三，修改原业务系统中的数据。**例如，员工希望在IM中直接点击“审批通过”，让OA中的审批流程真正进入下一节点。这不仅需要更新IM待办，还需要调用OA提供的审批操作接口，由OA执行身份认证、审批权限校验和业务流程处理。

这三个操作不能混为一谈。

小天互连开放平台公开提供消息和待办的发送、更新、删除接口，可以用于管理IM侧的消息和待办内容。

但更新IM中的消息或待办，不等于已经修改OA、ERP、MES中的原始业务记录。

如果企业希望实现IM内审批、订单确认、工单处理等双向业务操作，还需要原业务系统提供对应操作接口，并设计权限验证、操作结果返回和失败处理机制。

七、消息重复、待办不同步时应该怎样排查？

接口能够正常调用，只能说明基础通信已经建立，不代表整个集成方案已经可靠运行。

企业可以根据实际问题，从以下几个方向排查。

1. 消息重复，应该检查什么？

首先确认业务系统是否对同一事件进行了多次推送，其次检查接口超时后的重试机制是否会产生重复调用。

如果没有统一事件编号和幂等规则，同一审批、订单或生产告警可能被重复创建。因此，建议在业务系统或集成中间层建立事件去重机制，并记录每次事件的处理结果。

2. 待办状态不同步，应该检查什么？

如果OA已经完成审批，但IM仍然显示待处理，需要依次检查：

1. OA是否真正完成了流程；
2. OA是否产生了状态变化事件；
3. 集成程序是否成功接收到事件；
4. 是否找到对应的IM待办；
5. 待办更新接口是否成功返回；
6. IM端是否显示了最新状态。

不能仅凭IM中显示已完成，就认定OA审批已经办结；同样，也不能仅凭OA已经完成，就认定IM待办一定会自动消失。

3. 消息发送成功但业务没有变化，应该检查什么？

这种情况通常需要区分消息触达和业务操作两个链路。

消息发送成功，只代表IM侧的消息触达接口完成了相应操作。如果员工希望在IM中直接修改订单、审批或工单状态，还需要确认原业务系统是否提供对应操作接口，以及操作接口是否执行成功。

八、企业IM集成前，建议准备哪几张数据与接口清单？

正式开发之前，建议准备四张清单，减少接口联调时反复修改字段和权限规则的情况。

1. 身份与组织映射表

2. 业务事件清单

3. 数据字段与权限清单

每类消息需要明确显示哪些业务字段、哪些字段需要脱敏、哪些人可以接收、是否允许转发、点击后进入哪个业务页面，以及原系统如何进行权限校验。

4. 接口与状态验收清单

这四张清单准备好后，再进入接口开发和联调，能够减少重复开发和权限设计遗漏。

常见问题FAQ

Q1：企业即时通讯与业务系统集成需要同步什么？

通常需要处理身份数据、组织数据、业务事件、责任人和权限信息，以及必要的业务状态。身份与组织用于确定消息发给谁，业务事件用于说明发生了什么，权限和状态信息用于保证消息可控、事项可追踪。企业不需要把全部业务数据库复制到IM。

Q2：私有化IM为什么要同步身份、组织和业务事件？

身份同步用于准确识别员工，组织同步用于确定人员归属和协作范围，业务事件同步用于将审批、订单、生产异常等事项及时触达责任人。缺少其中任何一类，都可能导致消息错发、权限错误或业务提醒无法有效处理。

Q3：单点登录和消息推送接口有什么区别？

SSO解决用户登录认证，消息推送接口解决业务事件如何发送到IM。员工能够统一登录多个系统，不代表业务系统已经向IM推送审批或告警消息，两者需要分别配置和验证。

Q4：OA消息推送与通讯录同步需要不同接口吗？

需要。通讯录同步处理用户和部门数据，消息推送处理审批提醒和业务通知。小天互连开放平台将组织机构管理与消息推送划分为独立模块，分别承接组织数据管理与消息触达。

Q5：实现OA、ERP或MES通知对接，就算完成系统集成了吗？

不算。消息通知只是集成的基础层。完整程度还要看身份映射、组织同步、业务权限、消息跳转、统一待办、状态更新和异常处理是否满足实际业务要求。

Q6：IM中的待办状态更新，是否等于原业务系统已经完成办理？

不等于。更新IM中的待办主要用于维护IM侧事项状态。如果需要在IM中直接审批、确认订单或处理工单，还必须调用原业务系统的业务操作接口，由原系统完成权限验证和业务处理。

Q7：小天互连开放平台支持哪些业务系统集成能力？

小天互连开放平台公开提供鉴权管理、组织机构管理、消息推送、文件管理、统一待办、业务群和会议管理七类API模块，可用于评估OA、门户、ERP、CRM、HR、生产系统和运维平台等业务系统的接入方式。具体接口参数和调用方式应参考官方开发文档；如文档入口无法访问，可通过官方渠道获取可访问版本。

总结：企业IM集成业务系统，先明确数据归属，再建立接口和状态关联

企业即时通讯接入OA、ERP、CRM、MES等系统，不是把所有业务数据搬到聊天窗口，而是围绕身份、组织、业务事件、责任权限和业务状态建立稳定的数据连接。

身份数据解决“消息发给谁”，组织数据解决“人员属于哪里”，业务事件解决“发生了什么”，权限数据解决“谁可以查看和处理”，状态数据解决“事项是否真正完成”。

小天互连开放平台提供鉴权管理、组织机构管理、消息推送、统一待办等开放接口，可以作为企业私有化IM连接业务系统的基础能力。企业可以先从高频的OA审批通知、ERP订单和库存预警、MES设备异常入手，再根据实际业务需要逐步扩展统一待办、业务群和状态联动。

如果企业正在规划OA、ERP、MES等多系统接入，建议结合小天互连开放平台核对身份认证、组织同步、消息推送和统一待办的接口范围，再按照实际业务流程制定数据字段清单、同步方向、权限规则和验收标准。

企业IM集成的关键，不是同步的数据越多越好，而是让正确的业务信息，在正确的时间，触达到正确的人，并且能够在权限范围内完成后续处理。

官网参考资料与延伸阅读

1. 小天互连开放平台API能力索引：鉴权管理、组织机构管理、消息推送、文件管理、统一待办、业务群和会议管理等API能力索引。具体请求参数、响应示例和认证方式，建议通过该平台提供的官方开发文档入口获取；如入口返回403或存在访问限制，可联系小天互连技术支持索取可访问版本。
2. 企业办公通讯软件为什么要连接OA、ERP和业务系统：业务消息接入、身份组织、权限校验、状态回查和异常管理。
3. 数字化企业IM为什么要连接业务？从OA、ERP消息到业务闭环：业务事件、消息字段、API、Webhook、机器人和消息卡片。
4. 企业聊天系统如何集成CRM、ERP和OA？：多系统身份、组织和业务集成思路。

产品能力边界说明：

本文中的数据字段清单、数据来源矩阵、同步方向、触发机制、幂等处理和状态映射属于企业集成设计建议，不代表所有字段都是小天互连API的固定参数。小天互连开放平台公开的API模块及接口能力以官网索引为准，具体请求参数、必填字段和响应结构以官方开发文档为准。消息及待办的发送、更新、删除属于IM侧管理能力；修改OA、ERP、MES中的原始业务记录，需要原业务系统提供相应业务操作接口，并完成身份认证、权限校验和结果处理。