1 文档使用说明
纷享销客CRM与订单OA的集成，可以实现CRM待办消息、消息提醒同步到钉钉OA的 纷享销客CRM 企业号。用户可以在钉钉的 纷享销客CRM 企业号收到CRM待办消息，并且在 纷享销客CRM 企业号点击消息后无需输入账号信息即可免登到纷享CRM处理待办消息。
CRM待办消息包括审批流程、业务流程、待处理的工单、待审批的工单，CRM消息提醒包括CRM通知、审批流消息、工作流消息、导入导出消息。
本文档包含售前材料、实施配置以及常见问题三部分，适用对象：实施顾问、技术顾问、销售经理、CSM等；
2 钉钉连接器售前阶段
2.1售前素材
纷享销客CRM与钉钉OA集成，用户可以在钉钉工作台中直接通过CRM入口，点击即可进入纷享销客CRM；还可以直接在钉钉APP中处理CRM待办审批，以及进行CRM数据新建、查看、处理等业务操作，如新增销售记录、商机推进等。目前，支持钉钉三方应用对接和钉钉自建应用对接。
● 钉钉三方应用：指客户从钉钉应用市场上安装的应用。
● 钉钉自建应用：指客户在钉钉开发者后台自己建立的应用。
钉钉OA免登录入口效果
用户无需来回切换APP，可以在钉钉工作台中直接找到CRM入口，一键免登进入CRM应用处理CRM业务
钉钉PC端工作台-纷享销客CRM应用
钉钉移动端工作台-纷享销客CRM应用
CRM待办推送至钉钉OA效果
在钉钉IM窗口中查看纷享CRM的待办消息，用户点击消息即可免登跳转到纷享销客的待办详情页进行处理CRM待办推送至钉钉OA效果
钉钉PC端待办查看效果
钉钉移动端待办查看效果
2.2环境准备
售前演示环境可以通过申请添加为现有demo环境账号来使用：
2.2.1Demo账号申请
请用钉钉扫码加入易动纷享组织，加入后，钉钉工作台即可看到 纷享销售crm，用于账号演示。为方便搭建环境，可添加CRM管理员权限，请按如下模板提交普通审批：
【审批模板】
#订单Demo环境管理员权限申请#
● 钉钉账号名称：
● 申请管理员原因：
审批流程：提交人→直属leader→李曼Theodore
注意：此环境为测试环境，无正式数据，如有演示需要可自行创建数据。
3 钉钉连接器实施阶段
3.1 学习材料
视频培训课程学习材料，地址见下：
培训课程：https://www.fxiaoke.com/XV/UI/Home?noheader=0&ddtab=true#app/train/detail/=/id-155820/trainType-0（课时1）
3.2实施前置条件
实施前，请确认客户使用的是独立版的纷享销客CRM还是钉钉版CRM（H5）。如果是独立版纷享销客CRM，则需要开通纷享销客CRM、钉钉OA、钉钉连接器；如果是钉钉版CRM（H5），则需要开通钉钉OA即可，纷享销客CRM可以从钉钉OA应用市场开通。独立版纷享销客CRM和钉钉版CRM（H5）区别见5.附：钉钉版CRM（H5）与独立版CRM对接钉钉能力对比。
3.4实施配置
3.4.1人员绑定
3.4.1.1钉钉版CRM（H5)人员绑定
从钉钉应用市场或者钉钉客户端->工作台->应用中心，安装纷享销客CRM：
钉钉工作台
钉钉应用中心
进入工作台，在应用管理>应用设置，点击 纷享销客CRM 应用进入纷享销客CRM应用，配置可见范围：
钉钉应用设置
配置完成后，钉钉的人员会自动同步到纷享销客CRM（H5）版本并建立映射关系。从钉钉工作台->纷享销客CRM应用，进入纷享销客，或者从 纷享销客 WEB登录页面，更多入口，钉钉扫码登录，即可使用纷享销客CRM的服务。
3.4.1.2独立版CRM人员绑定
1）代理服务安装
由于钉钉自建应用访问钉钉OPEN API接口须使用客户的出口IP。独立版纷享销客CRM部署在纷享云，在对接钉钉时就要部署纷享的钉钉代理服务程序。
注意：钉钉代理服务器基本要求：
1. CPU双核或更多
2. 内存4GB或更大
3. 带宽4MB或更大
4. JDK版本至少是 java 1.8
5.
代理服务要有独立IP或域名，能够访问外网并且能够被外网访问
准备好代理服务安装服务器后，下载代理服务jar包（钉钉代理服务下载：fs-dingtalk-client-V1.1.1.jar
），把代理服务jar放到安装目录文件，通过Windows命令指定文件目录并执行 java -jar fs-dingtalk-client-V1.1.jar ，如下图所示（在文件夹空白处按住shift+右键，选择“在此处打开命令窗”，输入java命令安装）：
代理服务运行成功后，显示红框里面的信息
可以尝试在浏览器里面输入如下URL：http://客户的IP和端口（或者域名和端口）/hello.html ，如果显示下图的dingtalk proxy service start success字样，代表代理服务运行成功
示例如下图：
2）创建钉钉自建应用
进入钉钉管理后台应用列表，在 钉钉应用 页签点击 创建应用 按钮，按提示填写应用名称和描述：
钉钉管理后台
钉钉管理后台创建应用
3）创建钉钉工作台网页应用
创建完应用后，保存并退出，在应用列表进入应用详情页面，在 添加应用能力 标签页面，添加 网页应用，在左侧的菜单里面就会多一个 网页应用 菜单。钉钉工作台或者移动APP点击 纷享销客CRM 打开的页面即通过此处配置。
添加应用能力效果
进入 网页应用 配置应用首页地址和PC端首页地址，appKey字段，可不填，如果客户新建了2个或以上自建应用和纷享连接器，这个字段必填。注意：应用首页地址和PC端首页地址，要填一样的URL。
网页应用配置
附：应用首页地址和PC端首页地址格式：http://{客户的代理服务器域名或IP}/index.jsp?corpId=客户的钉钉企业ID&corpSource=客户的CRM系统所在的云服务标识&appKey=自建应用的appKey
● corpId获取：登录钉钉开发者后台，https://open-dev.dingtalk.com/
● corpSource目前支持如下几种：
纷享云：corpSource=foneshare
华为云：corpSource=hwcloud
阿里云：corpSource=ale
备注：
1.
如果客户的CRM系统域名是https://www.fxiaoke.com，则客户是纷享云客户。
2.
如果客户的CRM系统域名是https://hwcloud.fxiaoke.com，则客户是华为云客户。
3.
如果客户的CRM系统域名是https://ale.fxiaoke.com，则客户是阿里云客户。
● appKey字段获取：进入应用，在基础信息>凭证与基础信息 菜单，右侧的应用凭证即可找到
配置 安全设置 参数，服务器出口IP：指代理服务器的出口IP，需要客户的运维提供。重定向URL（回调域名）：需要和配置的应用首页地址一样。（服务器出口IP：建议不填，首次可以随便填一个IP，之后，再编辑，清空这个字段。）
点击权限管理，进行配置授权部门以及人员的配置(建议权限按照下面图示的选择，可以选择全部员工或者部分部门或者员工)
需要开通的权限列表（下表中的权限必须全部配置）：
| 权限信息 | 权限点code |
| 调用SNS API时需要具备的基本权限 | snsapi_base |
| 以用户的个人身份创建或更新个人待办数据 | Todo.PersonalTodo.Write |
| 企业员工手机号信息 | fieldMobile |
| 邮箱等个人信息 | fieldEmail |
| 通讯录部门信息读权限 | qyapi_get_department_list |
| 成员信息读权限 | qyapi_get_member |
| 根据手机号获取成员基本信息权限 | qyapi_get_member_by_mobile |
| 通讯录部门成员读权限 | qyapi_get_department_member |
| 调用企业API基础权限 | qyapi_base |
| 智能人事个人信息读权限 | qyapi_hrm_read_user |
| 获取钉钉开放接口用户访问凭证的基础权限 | open_app_api_base |
| 待办应用中待办写权限 | Todo.Todo.Write |
| 待办应用中待办读权限 | Todo.Todo.Read |
配置完成后，在 版本管理与发布 点击 创建新版本 ，在新的页面中，按提示填写应用版本号和描述，工作台显示的应用能力固定值为 网页应用 ，配置发布范围，保存，发布应用即可。
版本管理与发布
版本发布备注
4）创建钉钉免登应用
点击 登录 进入新版页面，点击 修改 按钮配置：
名称及描述可按提示填写，授权logo地址暂时用不到，可以先填写一个通用的域名，回调域名统一填：
foneshare环境：https://www.fxiaoke.com/
华为云环境：https://hwcloud.fxiaoke.com/
钉钉云环境：https://ale.fxiaoke.com/
蒙牛云环境：https://msv.mengniu.cn/
5）钉钉连接器配置
登陆纷享销客，在管理后台，系统管理>集成平台管理>连接器 右侧 OA连接器 分类下找到钉钉连接器，进入设置：
连接器页面及字段填写说明：
钉钉连接器 移动接入应用配置：
钉钉连接器 Client配置：根据客户代理服务配置IP和端口填写即可。
6）钉钉自建应用事件订阅
钉钉连接信息填写完成后，保存，钉钉连接器默认后台会生成该自建应用 事件订阅 信息（切勿忘记去页面做个检查）。若回调地址被注册时，可以在钉钉应用页面针对通讯录事件进行订阅，步骤如下：登录进入钉钉管理后台，进入事件订阅页面
配置参数如下：
加密aes_key: twki1srsvwm2vaxecwyy2xxllc4r5t0zivt1qropp9s
签名token: iMY3uFx9DPCc5S17i7Y
请求网址：
foneshare环境：https://www.fxiaoke.com/dingtalk/business/appCallBack?appKey=上面自建应用的appkey
华为云环境：https://hwcloud.fxiaoke.com/dingtalk/business/appCallBack?appKey=上面自建应用的appkey
钉钉云环境：https://ale.fxiaoke.com/dingtalkinner/business/appCallBack?appKey=上面自建应用的appkey
蒙牛云环境：https://msv.mengniu.cn/dingtalk/business/appCallBack?appKey=上面自建应用的appkey
事件参考下面的勾选。记得点击开关就行了，不用再点击保存
7）账户同步与绑定
账号绑定支持两种模式：“仅同步员工，手动绑定”和“同步组织架构，并自动创建CRM帐号”。此模式在连接器信息设置页面，集成方式控制，如下图：
模式一：仅同步员工帐号，手动绑定CRM帐号
适用场景：企业希望钉钉组织架构与CRM组织架构相互独立维护，当钉钉新增员工时，需要手动将这些员工同步生成CRM帐号且绑定。在纷享销客“管理-系统对接管理-钉钉对接-账户映射”频道中，点击 同步钉钉职工账户 按钮
勾选需要同步的钉钉账户，点击同步
在纷享销客“管理-系统对接管理-钉钉对接-同步日记”频道中，可以查看历史同步记录（时间、操作人、状态等信息）
模式二：同步组织架构，并自动创建CRM帐号
适用场景：企业希望CRM组织架构与钉钉保持一致，仅在钉钉做组织架构的维护，当钉钉新增员工/部门时，同步在CRM生成部门和员工，且自动绑定。点击同步钉钉职工帐号
进入部门和员工的选择页面，此处展示的是钉钉授权的部门和员工初始化对接时，需要手动选择绑定一次。
逻辑说明：如果纷享销客没有该员工，会自动创建该员工，在钉钉授权的部门或者员工有变动的时候，依靠回调事件完成在纷享同步变化。
注意：此功能依赖 6）钉钉自建应用事件订阅，实施时，请勿忘检查该配置；
4 FAQ
1. 老版（钉钉版本CRM）H5如何切换新版（钉钉版本CRM）H5 ？
23 年 4 月前老客户都是旧版H5，之后在钉钉添加应用的客户都是新版，如果客户是用的老版H5，销售可在CRM中提交灰度申请切换为新版，灰度项选择[钉钉版H5（新基座）]
2.钉钉移动端CRM布局如何自定义？
首页布局自定义
入口：纷享销客CRM->管理页面->应用中心管理->应用列表->钉钉-纷享销客CRM->编辑->移动应用视图->编辑（如果没有钉钉-纷享销客CRM应用入口，请检查客户是否是新版H5，如果不是需要申请灰度后入口可见，可参考FAQ 1 申请灰度）
对象详情页自定义
入口：纷享销客CRM->管理页面->预设对象管理->某一对象的详情页布局->移动端->沿用PC端 OR 独立配置布局:
移动端底导航自定义
底导航自定义，要用到APP自定义能力，APP自定义在CRM中未付费产品，所以此入口需下销售订单（产品名称：APP自定义）后露出。也是需要在新版H5中自定义设置才能生效。入口：纷享销客CRM->管理页面->界面定制管理->APP主导航->新建模板，选择适用平台（钉钉/企微/飞书）及适用范围
支持删除默认的底导航图标、支持替换成CRM对象，暂不支持替换成其他应用
3.客户侧自主下的订单如何关闭？
客户钉钉管理员可参考下方视频，操作关闭订单。操作路径：钉钉APP移动端->我的->钱包->订单，找到纷享销客待支付订单，点击”关闭订单即可“
4. 钉钉客户代理服务常见问题
案例1：代理服务启动失败，报端口被占用
解决方案：更换代理服务的端口，重新执行如下命名：
java -jar fs-dingtalk-client.jar --server.port=xxxx（把xxxx换成新的端口）
案例2：代理服务本地可以正常访问，外网无法正常访问
解决方案：
1.
检查代理服务的IP是否是外网IP，如果不是，请使用外网IP
2.
如果是外网IP，找客户运维看一下，可能是纷享的IP不在客户的白名单里面，让客户把纷享服务的出口IP（找纷享的运维 程波 提供纷享的所有出口IP）加入到客户的白名单。
3.
如果代理服务使用域名，内网可以访问，外网无法访问，找客户运维检查域名指向的IP是否正常。
4.
如果代理服务的域名是https://开头的，客户没有给代理服务的这个域名配置SSL证书，浏览器会拦截这个URL，这种情况，请找客户运维给代理服务的域名配置SSL证书。
5 附：钉钉版CRM（H5）与独立版CRM对接钉钉能力对比
5.1 绑定后增加：
● 钉钉侧免登入口：钉钉工作台应用列表内嵌了CRM登录入口，免登进纷享
● 钉钉侧待办推送：CRM待办消息推送至钉钉，点击可直接进入CRM业务表单界面进行处理
5.2 钉钉侧使用说明（与独立版区别）
能力区别：主要为钉钉移动端和独立APP的使用区别，PC端功能一致。
独立APP页面
钉钉手机端页面
