Q：首次安装后，登录报错。常见报错信息以及对应处理方法：

A：【钉钉登录失败】常见原因：首页地址配置错误

【飞书点击应用无反应】常见原因：可信域名配置错误

Q：企业微信代自建应用，无法建立绑定？

A：代自建应用没有通讯录权限，无法同步员工。需要员工在企业微信存在且手机号一致，需要员工在应用可见范围，才能建立绑定。

解决：保证手机号一致，员工在应用可见范围。企业微信接口有失败过多限流机制，如果可见范围给的不够，此时操作了批量绑定，会触发企业微信的限流。

Q：IM消息发送，是否支持测试阶段想要小范围使用

A：

飞书、企业微信，支持根据应用可见范围发送消息

钉钉，不支持根据应用可见范围发送消息（只要「绑定成功」，就会发送消息）

Q：IM消息发送，某些员工没收到消息

A：

• 首先确认业务方是否发送消息，如业务配置是否正确

• 如果业务方确认发送了，确认发送时是否建立了im绑定关系，没有绑定成功无法发送

• 最后确认员工端是否开启了【接收消息】
  

Q：IM中员工发生了不如预期的删除/同步

A：

检查IM的操作日志：人员删除/禁用等

• 企微查看操作记录：登录企微管理后台，【管理工具】→ 【使用分析】→ 【管理端操作日志】

• 飞书查看操作记录：登录飞书管理后台，【合规】→ 【日志审计】→ 【管理员日志】/【OpenAPI日志】，两个都可以看下，是谁操作的。

• 钉钉查看操作记录：登录钉钉管理后台，【安全与权限】→ 【审计日志】

Q：飞书员工绑定失败，常见现象是部分员工能成功，部分员工不能成功。

A：

• 确认员工手机号同im侧是否一致？

• 参照安装文档，确保【应用可见范围】，【权限】等是否开通完整。如飞书需要同时满足【权限范围】包含对应员工，同时【应用可见范围】也要包含对应员工：

Q：初始化开通的注意事项

A：初始化逻辑

1、第一步

将IM侧的部门全量拉过来和people侧的部门进行全路径匹配(不包含根部门)

case:

people:     希瑞亚斯/ 客户成功部/全国实施/华北实施

企业微信:     moka/客户成功部/全国实施/华北实施

这样就可以匹配成功

将people的手机号和姓名去查询IM的人查到就匹配

最终默认勾选匹配成功的部门展示在页面上

注意事项：未匹配成功的部门，如果勾选了同步，会在IM侧新增部门

2、第二步

默认加载系统预置的字段。和IM那边的字段匹配

手动添加的除了内置字段其余的必须名字匹配

参考这个连接服务对接默认字段映射关系

3、第三步

第一步匹配的人员在这里展示。如果匹配成功。默认绑定和同步都勾选。

绑定：不会创建人员只会拿手机号去IM那边查询查到就把两个关系绑定起来。

同步：一定是在绑定的基础上。后续人员信息变更会直接同步到IM。部门不同步是不可以点击同步的。

如果取消了绑定勾选则一定会把同步取消掉。

如果添加了同步勾选一定会把绑定勾选上。

注意事项：未匹配成功的人员，如果勾选了同步，会在IM侧新增人员

Q：部门同步逻辑

A：

部门逻辑:

永远以people的部门为主。接管IM部门后对未建立关联的部门不进行任何操作。

手动同步:

习惯性去看侧拉列表。点击同步前先看两边有没有路径一致的部门。

• 有直接绑定   

• 没有新建一个部门。

70%的情况是可以看到一个具体的报错。---当前页面直接搜索对应报错能看到对应处理方案。

自动增量:

停用部门会把IM的部门删掉。

启用部门会在IM直接创建一个部门。

Q：员工同步逻辑

A：

1、先根据手机号查询IM侧有没有人如果没有人则新建。如果有人则绑定并且将信息进行更新。如果绑定成功后续的入转调离会进行IM信息及组织架构的同步。

2、如果在IM侧手动增加的人，后再people增加的人员。这个时候存在部分场景没法正常绑定和同步。参考 【不支持同步IM的场景】 。 用户初次在IM侧登录【员工自助】只会将两边建立绑定关系，后续其它信息变更时才会触发员工信息的同步

【不支持同步IM的场景】

• 花名册导入创建在职员工

• 花名册导入创建离职员工

• 异动记录导入入职/重新入职，更新生效日期由未来改到当前

• 花名册导入创建模式，覆盖当前入职信息，修改入职日期由未来到当前

• 异动记录导入，更新当前异动记录或添加新的生效中的异动记录

• 花名册导入创建模式，覆盖当前任职信息

• 异动记录导入主动离职/被动离职/实习结束，更新生效日期由当前改到未来

• 花名册导入创建模式，覆盖当前离职信息，修改离职日期由当前改到未来

• 审批撤回 同步撤销IM的业务逻辑

Q：IM侧人员userId生成逻辑

A：

1、UserID生成规则，目前只能选择一次，选择后不允许修改，建议选择：姓名拼音+ID

2、IM侧人员userId首次生成后无法进行修改

Q：员工离职删除逻辑

A：

离职审批       

1、 12月1的离职日期12月2号审批通过 直接删     

2、12月3号的离职日期，12月1号审批通过，基于规则配置进行删除

离职办理：离职办理走完直接删

*以上是默认配置的情况

自定义离职禁用、删除时间参考下面规则：

Q：钉钉特殊逻辑

待接收邀请：客户手机端设置，加入企业需要验证。

1、10点people加了。  下午四点了还是待接收邀请。发消息收不到。—客户自己填验证码。

----没有回调的企业手动登一下people才能绑定上 

----有回调则直接绑定成功。

不确定有没有回调的情况下直接登录一下员工自助。

2、10点入职  因为开启了这个开关导致人员是待接受邀请 状态 people未绑定成功   3点离职  people无法删掉  只能客户自己去删   

3、如果在当天入职触发了待接收邀请状态。一直未绑定成功到次日凌晨4点触发两边数据同步就会绑定成功。

4、如果是新入职的部门负责人在当天入职触发了待接收邀请状态。新入职员工点击了接受邀请，同步在钉钉里创建了账号且加入了组织，但是moka当中还是待接受邀请状态，未绑定时，就直接在组织上维护了部门负责人，此时不会向钉钉同步主管标识。

Q：员工登录报错

问题1：手机号查询找不到用户，通常原因，员工二次入职绑定状态错误（历史数据问题），反馈服务人员修复下数据

问题2：有绑定关系，但是没有账户。原因通常是ATS账号冲突，反馈服务人员进行冲突账号的处理