2. 钉钉连接器

菜单位置调整说明:
 原「管理后台 - 系统对接管理 - 钉钉对接」入口,调整为「管理后台 - 集成平台管理 - 连接器 - 钉钉连接器」

配置前说明

特别注意:
由于钉钉重新限制了企业自建应用的IP,对于8月1号之前对接的已经实施好的企业,不要随意修改自建应用的IP地址和应用跳转地址,也不要随意删除自建应用。对于8月1号后需要对接的企业,按此文档进行配置,主要改动在于钉钉侧自建应用IP地址和纷享侧钉钉对接页面client配置。确认企业纷享的环境,如果不在纷享云的企业,请先联系纷享客服联系研发人员处理
在实施对接前,先说明几个关键点:
1、确认crm所在的环境:
对接前先确认客户开通的crm所在的环境,直观的看法是浏览器登陆crm,查看域名,https://www.fxiaoke.com为foneshare环境,https://hwcloud.fxiaoke.com为华为云环境,https://ale.fxiaoke.com为钉钉云环境,https://msv.mengniu.cn为蒙牛云环境。不同的环境,对应得配置地址不同,选择正确的配置。
2、回调地址:
钉钉限制一个企业只能注册一个回调地址,回调地址对于我们对接应用的作用主要是实时监听钉钉企业的组织架构的变化。所以在实现对接之前,实施同学可以咨询下客户钉钉企业是否已经注册过相关的回调事件。
如果在配置过程中出现因为回调地址导致失败的问题不影响初始化通讯录,但是需要在钉钉管理后台配置应用授权,参考目录4的应用授权
3、配置时候需要注意钉钉授权的添加,不要忘记手机号码信息,通讯录等基本权限。
4、目前支持一个钉钉对应多个CRM的场景,需要客户注意的是,一个CRM对应一个钉钉的应用,即需要在钉钉侧创建多个应用对应到CRM,可以通过应用的权限范围决定哪些员工可见,另外需要注意的是多个应用的移动端的首页地址或者PC端的首页地址需要补充上对应appID:即:
foneshare环境:https://www.fxiaoke.com/dingtalk/index.jsp?corpId=钉钉企业corpId&appKey=应用appkey
华为云环境:https://hwcloud.fxiaoke.com/dingtalk/index.jsp?corpId=钉钉企业corpId&appKey=应用appkey
钉钉云环境:https://ale.fxiaoke.com/dingtalkinner/dingtalkinnerindex.jsp?corpId=钉钉企业corpId&appKey=应用appkey
蒙牛云环境:https://msv.mengniu.cn/dingtalk/index.jsp?corpId=钉钉企业corpId&appKey=应用appkey
5、目前CRM的代办与提醒的消息发送到钉钉在灰度中,如需可联系纷享客服联系纷享研发灰度。
6、开通方式:联系纷享客服或对应的客户经理下单购买钉钉连接器。
7、初始化前请确保权限已勾选上、权限范围选择好后,再进行初始化操作。
整个配置对接的流程可以分为两大部分,一是钉钉开发平台的配置。二是:纷享销客侧的对接界面配置。

一、对接后功能展示

1、用户在钉钉工作台可以查看到纷享CRM入口,点击可免登进入CRM首页

1.1 钉钉-PC端-工作台入口
1.2 钉钉-终端入口

2、在钉钉可以收到纷享的待办和CRM提醒,点击待办消息免登跳到CRM处理

待办包含:审批待办、业务流待办
CRM提醒包含:审批消息、业务流消息
注意:纷享侧消息推送到钉钉侧,会消耗一定的钉钉企业的openapi数,请根据企业实际情况选择开不开通。

方式一: 默认将待办和CRM提醒均推送至钉钉-消息-工作通知内。

该方式在企业对接完成后,默认推送至钉钉的工作通知
2.1 钉钉-PC端-消息-工作通知
2.2 钉钉-终端-消息-工作通知

方式二:将待办单独推送至钉钉-待办-工作待办。

仅推送的入口不一样,点击消息卡片后后续的操作均一致。
如有需,可申请灰度(在fs的「产品灰度申请」里提交灰度审批)。
注意:申请该灰度前,请确保钉钉待办的权限已开通,下面两个图片的待办权限都要勾选上。  https://open.dingtalk.com/document/orgapp/apply-for-permissions-task
此待办权限只能在钉钉旧页面勾选
此待办权限只能在钉钉新版页面勾选
钉钉待办的位置
 点击后打开的是CRM详情页

二、钉钉侧配置

1、登录开发者平台https://open-dev.dingtalk.com/,创建应用
1.1 钉钉开发者后台分为旧版和新版,点击右下角进入旧版。
注:钉钉进入旧版有改动,从这个链接进入旧版:
https://open-dev.dingtalk.com/v1/fe/old#/corpeapp 开发者后台统一登录 - 钉钉统一身份认证
1.2 建议新建H5微应用,这样可以在手机终端点击该应用打开纷享销客H5端界面。
1.2 创建完应用点击「开发管理」可以看到下面需要补充的信息:
(1) 服务器出口IP:复制下面的地址粘贴到上图中的服务器出口IP
纷享云环境:103.235.239.62
钉钉云环境:58.250.204.197,119.254.150.2,120.133.55.5,103.235.239.34,103.235.230.65,114.67.19.130,114.67.19.195,43.228.181.1,114.116.205.149,211.103.185.147,120.55.97.181,120.55.99.210,58.250.250.46
蒙牛云环境:152.136.167.83
当配置ip失败的时候,可以空着不填
1、进入旧版,创建好应用,填写ip:127.0.0.1,和应用地址
2、用新的链接进入新版,找到创建好的那个应用,选择继续使用旧版,去掉ip
3、其余步骤不变
(2) 应用首页地址&PC端首页地址统一填写:(注意,如果是一个钉钉企业对应多个CRM,需要再补充对应的appkey.详情参看上面前置说明第4点)
foneshare环境:https://www.sharecrm.com/dingtalk/index.jsp?corpId=填写自己企业的corpid
华为云环境:https://hwcloud.fxiaoke.com/dingtalk/index.jsp?corpId=填写自己企业的corpid&corpSource=hwcloud
钉钉云环境:https://ale.fxiaoke.com/dingtalkinner/dingtalkinnerindex.jsp?corpId=填写自己企业的corpid
蒙牛云环境:https://msv.mengniu.cn/dingtalk/index.jsp?corpId=填写自己企业的corpid
(3) 关于corpid获取:
钉钉管理人员登录后台:https://open-dev.dingtalk.com/#/index,复制下面的corpId
1.3 点击权限管理,可以进行配置授权部门以及人员的配置(建议权限按照下面图示的选择,可以选择全部员工或者部分部门或者员工)
1.4 发布应用
2、创建免登应用,点击登录
回调域名统一填:
foneshare环境:https://www.fxiaoke.com/
华为云环境:https://hwcloud.fxiaoke.com/
钉钉云环境:https://ale.fxiaoke.com/
蒙牛云环境:https://msv.mengniu.cn/
3、应用授权(仅针对回掉地址被注册时,可按此操作处理)
如果上面的回调地址被注册了,可以在钉钉应用页面针对通讯录事件进行订阅,步骤如下:
3.1 登录进入钉钉管理后台,进入事件订阅页面
3.2 配置参数如下:
加密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
事件参考下面的勾选。记得点击开关就行了,不用再点击保存

二、纷享侧配置

1、登陆系统
 登陆纷享销客:https://www.fxiaoke.com/pc-login/build/login.html
登陆钉钉: https://open-dev.dingtalk.com
2、系统初始化配置
2.1 在钉钉开放平台的“首页”频道,找到位于企业名称下的CorpId,将该信息码复制粘贴到纷享销客系统中的“管理-系统对接管理-钉钉对接-对接设置-应用初始化配置”频道中的Corp ID字段。
2.2 在钉钉开放平台的“应用开发-企业内部开发-H5微应用-应用首页”频道中,将AgentId、AppKey、AppSecret的信息码复制粘贴到纷享销客系统中的“管理-系统对接管理-钉钉对接-对接设置-应用初始化配置”频道中的Agent ID、App Key、App Secret字段。
2.3 在钉钉开放平台的“应用开发-移动接入应用-登录-扫码登录”频道中,将appId、appSecret的信息码复制粘贴到纷享销客系统中的“管理-系统对接管理-钉钉对接-对接设置-移动接入应用配置”频道中的App Key、App Secret字段。
2.4 在纷享销客“管理-系统对接管理-钉钉对接-对接设置”频道中,找到Client URL。统一填写:
foneshare环境:‍http://172.17.32.16:8089/
华为云环境:https://hwcloud.fxiaoke.com/dingtalk/
钉钉云环境:http://10.57.5.251:35498/dingtalkinner/
蒙牛云环境:https://msv.mengniu.cn/dingtalk/
3、账户同步与绑定
3.1 模式一:仅同步员工帐号,手动绑定CRM帐号
适用场景:企业希望钉钉组织架构与CRM组织架构相互独立维护,当钉钉新增员工时,需要手动将这些员工同步生成CRM帐号且绑定。
- 在纷享销客“管理-系统对接管理-钉钉对接-账户映射”频道中,点击 同步钉钉职工账户 按钮
- 勾选需要同步的钉钉账户,点击同步
- 在纷享销客“管理-系统对接管理-钉钉对接-同步日记”频道中,可以查看历史同步记录(时间、操作人、状态等信息)
3.2 模式二:同步组织架构,并自动创建CRM帐号
适用场景:企业希望CRM组织架构与钉钉保持一致,仅在钉钉做组织架构的维护,当钉钉新增员工/部门时,同步在CRM生成部门和员工,且自动绑定。
- 点击同步钉钉职工帐号
- 进入部门和员工的选择页面,此处展示的是钉钉授权的部门和员工
初始化对接时,需要手动选择绑定一次。
逻辑说明:如果纷享没有该员工,会自动创建该员工,在钉钉授权的部门或者员工有变动的时候,依靠回调事件完成在纷享同步变化。注意,实施同学需要确定下客户企业是否已经完成回调地址的注册。
到这里纷享销客与钉钉对接配置就完成了。是不是很简单呢。
2023-12-25
14 3