七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入

钉钉

此文档说明了钉钉接入方式。

接入方式

七鱼提供钉钉自建应用接入方案,只需管理员在七鱼后台按照提示绑定应用相关信息即可。

接入前准备

  1. 请准备钉钉管理员权限账号
  2. 确保钉钉企业状态正常

员工服务

自建应用接入钉钉

步骤一:获取CorpId:登录钉钉开发者后台 ,将企业 CorpId 回填入七鱼,如图1、图2。

图1:获取企业CorpId

图2:将获取到的企业CorpId回填七鱼

步骤二:创建企业内部应用:点击【创建应用】按钮,在创建应用弹框中根据自身需求填写应用信息(例:应用名称为HR服务中心),填写完毕后创建应用,如图3,图4。

图3:创建企业内部应用

图4:填写应用信息

步骤三:回填应用信息:点击创建成功的应用,获取应用信息,将AgentId、AppKey、AppSecret回填进七鱼对应字段内,如图5、图6。

图5:获取应用信息

图6:将应用信息回填七鱼

步骤四:回填七鱼应用链接:将七鱼生成的应用首页地址填入钉钉应用的应用首页地址&PC首页地址,如图7、图8。

图7:复制七鱼首页链接

图8:应用配置信息

步骤五:应用授权:点击权限管理,按需勾选应用权限,建议选择以下4个权限方便进行后续身份认证和业务进行,参考图9(七鱼不会泄漏和主动存储您的员工信息):

​

  • 企业员工手机号信息
  • 邮箱等个人信息
  • 通讯录部门读权限
  • 成员信息读权限

图9:勾选应用权限信息

步骤六:配置字段映射:将钉钉内员工信息字段与七鱼客户信息字段建立映射关系,可自动完成身份识别,方便后续进行会话路由分配、机器人问题回复、工单协同等业务使用。如图10:

图10:配置映射字段

步骤七:发布应用:如图11:

图11:发布应用

跨团队协作

自建应用接入钉钉

步骤一:获取CorpId:登录钉钉开发者后台 ,将企业 CorpId 回填入七鱼,如图1、图2。

图1:获取企业CorpId

图2:将获取到的企业CorpId回填七鱼

步骤二:创建企业内部应用:点击【创建应用】按钮,在创建应用弹框中根据自身需求填写应用信息(例:应用名称为七鱼轻工单),填写完毕后创建应用,如图3。

图3:创建企业内部应用

步骤三:回填应用信息:点击创建成功的应用,获取应用信息,将AgentId、AppKey、AppSecret、RobotCode回填进七鱼对应字段内,如图4、图5。

图4-1:填写应用信息

图4-2:填写应用信息

图5:填写应用信息

步骤四:回填七鱼应用链接:保存第一步内容后,进入第二步。将七鱼生成的应用首页地址填入钉钉应用的应用首页地址&PC首页地址,和回调地址如图6、图7。

图6:复制七鱼首页链接

图7-1:编辑应用信息

图7-2:编辑应用信息

图7-3:编辑应用信息

步骤五:应用授权:点击权限管理,勾选应用权限,开通以下权限方便进行后续身份认证和业务进行,参考图8(七鱼不会泄漏和主动存储您的员工信息),:

​

  • 个人手机号信息
  • 通讯录个人信息读权限
  • 通讯录部门信息读权限
  • 成员信息读权限
  • 通讯录部门成员读权限
  • 企业内机器人发送消息权限

图8:勾选应用权限信息

步骤六:发布应用:完成应用发布,发布后根据需要调整应用可见权限。如图9、图10。

图9:发布应用

图10:发布应用

步骤七:同步员工:在七鱼系统中同步钉钉员工信息到【外部员工管理】,可以使钉钉员工在不登录网易七鱼账号密码的情况下即可直接在钉钉中查看及处理工单。如图11。

图11:同步员工

步骤八:授权im工单权限:在七鱼【员工管理-外部员工管理】中为钉钉员工开启im工单权限,如图12。

图12:授权im工单权限

这篇文档有帮助吗?

目录