# 致远微协同-钉钉集成配置
# 一、使用条件
- 请确认协同产品的版本为V6.1SP2及以上（A6、A8、G6均支持）。
- 请确认协同系统的访问地址（IP）是公网地址。
- 请确认协同系统可以访问外网，否则无法推送消息。
- 已申请开通企业钉钉并通过认证（未认证的钉钉无法使用组织同步功能）。
- OA服务器需能访问到钉钉的API接口地址“oapi.dingtalk.com”、“api.dingtalk.com”，如果无法访问到，需要配置DNS域名解析。为保证配置后能够正常使用微协同，请务必在OA服务器上ping通上述两个地址，并且配置下DNS解析。必须要保证OA能够访问这两个地址。
# 二、钉钉后台配置
# 1、登录【钉钉开放平台】
访问地址：https://open.dingtalk.com， 然后点击开发者后台，通过钉钉管理员扫码登录
# 2、获取CorpId
另外点击资源管理可以看到，付费 API 调用量的相关信息。根据钉钉政策，普通版钉钉集成微协同后，每月只有1W条消息可以收到，只有升级钉钉版本才能收到更多的消息。因此出现钉钉收不到消息的时候可以到此处排查。
# 3、创建自建应用并获取应用凭证相关信息AgentId、AppKey、AppSecret
# 4、配置接口权限
- 配置权限范围为全部员工，才可以使用同步功能
要用到组织架构同步钉钉、消息推送钉钉、待办推送钉钉，必须开启【通讯录】【个人权限】【待办任务】里的所有权限
- 开启待办任务权限，钉钉待办集成才会收到待办信息（此功能只有8.2及其以上版本OA集成才需要配置）
# 5、应用发布
发布并设置可使用范围，只有在范围内的人员才可以在钉钉的工作台中看到当前应用（默认在未分组应用中）
# 三、【协同OA】配置
# 1、V6.1SP2
登录系统管理员，在《信息集成配置》-《微协同平台》（A8）或《功能应用设置》-《微协同平台》（A6），按页面中说明依次完成以下步骤：
- 微协同基础设置
- 微协同连接设置（如果打过最新月度包，则可选）
- 钉钉集成配置
- 钉钉组织机构同步（可选）
# 2、V7.X-V8.0
A8集团版：登录集团管理员，在《微协同管理平台》， A8企业版：登录单位管理员，在《微协同管理平台》， A6：登录系统管理员，在《微协同管理平台》， 按页面中说明依次完成以下步骤：
- 微协同基础设置
- 微协同连接设置（如果打过最新月度包，则可选）
- 钉钉集成配置
- 钉钉组织机构同步（可选）
# 3、V8.0及其以上
1、填充相关参数后，点击确定按钮，提示成功后即可，如果不成功，可以先排查OA地址外网是否可以访问；如有内网环境与外网环境映射，请确保OA能够访问微协同（可以OA服务器通过curl -I https://weixin.seeyon.com看是否成功，如果是unknownhost，则在OA服务器上多次ping weixin.seeyon.com该域名，不同地区会返回不同ip地址，请以实时测试返回的ip地址为准，配置host文件）；还需要确保微协同环境能够访问OA环境，请在OA访问策略配置白名单（微协同服务器出口ip:59.110.227.61）。
# 四、OA后台配置
# 1、进入OA后台钉钉集成——>集成配置,新建绑定，把对应的信息填充好后点击提交按钮，检测通过后会自动回填"钉钉开发管理"的配置信息
注： 1、目前钉钉集成都使用AppKey和AppSecret的模式 2、只有OA版本满足8.1SP1及其以上，才会生成应用首页和PC端首页地址
3、8.2版本及其以上支持钉钉待办集成，开启该配置即可
# 2、回到钉钉后台回填数据，配置完成后重新发布应用，即可完成集成配置
注： 1、无需在开发管理处配置服务器出口IP 2、8.1SP1版本以下钉钉集成配置应用首页地址为：OAURL/seeyon/wechat/dingding.do?method=newIndex&corpId=CorpID，其中OAURL为OA协同服务器地址，CorpID为刚刚获取的CorpID值。
# 五、OA后台工作台配置
# 1、OA后台钉钉配置——>工作台设置——>输入钉钉企业corpId——>生成url——>将对应地址复制到钉钉自建应用（V8.1SP1之后）
注：此功能的作用是配置快捷应用跳转，直接穿透到应用页面，无需再登录到微协同进行操作。只需要按照上述文档在钉钉后台创建一个H5微应用，然后在开发管理处配置下图中所生成的地址即可
