====== 钉钉渠道接入 ======

===== 概述 =====

环信客服云支持钉钉渠道接入，绑定后您可以使用环信客服云统一接收与回复钉钉渠道进线的各类消息。钉钉渠道接入后，可以实现让钉钉里的用户可以通过钉钉工作台里的应用，作为咨询客服的入口，可以打开与客服的会话页面，与客服建立起会话链接，同时确保客服可以获取到访客在钉钉里的身份信息，包含用户身份和部门信息等。


===== 钉钉渠道接入过程 =====

1、在钉钉里申请注册创建“H5微应用”（注：需要钉钉管理员给开通开发者权限）

2、注册后可以获取应用信息，将CorpId、AgentId、AppKey、AppSecret回填给客服系统的钉钉渠道

3、将在线客服系统钉钉渠道生成的首页地址维护到新申请的钉钉应用中

4、在钉钉管理后台给新申请的应用勾选可获取的4项用户信息权限

5、在钉钉管理后台发布应用成功后，就可以实时接入访客，并看到访客进线带过来的信息，也可以进行各种统计和筛选查询



===== 钉钉渠道接入详细过程讲解 =====

1、在钉钉开放平台》应用开发》企业内应用》钉钉应用中，点击“创建应用”按钮，按如图填写完成后，点击“确定创建”按钮即可。
注：创建应用地址为 [[https://open-dev.dingtalk.com/fe/app#/corp/app|钉钉开发者管理后台]] ，创建此应用需要有“钉钉开发者”权限，一般是钉钉的应用管理员可以给授权或协助创建

{{:cs:300visitoraccess:钉钉开发者后台.png?nolink|}}

2、H5微应用创建完成后，可以获取到 CorpId、AgentId、AppKey、AppSecret这4项重要参数。（注CorpId参数直接悬浮在右上角的企业图标上即可看到）
{{:cs:300visitoraccess:02-获取钉钉参数.png?nolink|}}

3、进入在线客服系统，切换至管理员模式》接入》在线客服》钉钉渠道中，点击右上角“添加钉钉”，并维护渠道名称和4项重要的钉钉参数，维护后点击确定即可得到钉钉的渠道地址
{{:cs:300visitoraccess:03-维护参数到客服系统.png?nolink|}}

4、将在线客服系统中生成的钉钉渠道的url地址，复制到钉钉开放平台>基础信息>开发管理中的“应用首页地址”以及“PC端首页地址”即可
{{:cs:300visitoraccess:04-回填url地址.png?nolink|}}
{{:cs:300visitoraccess:05-钉钉地址回填完成.png?nolink|}}

5、在钉钉开放平台中维护完地址后，在基础信息>权限管理中，勾选“通讯录管理”下的这4项权限，然后点击“批量申请”即可（开放此权限是为了获取访客端基本身份信息，包含姓名+手机+邮箱+所属部门）
  权限1：企业员工手机号信息
  权限2：邮箱等个人信息
  权限3：通讯录部门信息读权限
  权限4：成员信息读权限
{{:cs:300visitoraccess:06-勾选所需钉钉权限.png?nolink|}}

6、在钉钉开放平台》部署与发布》版本管理与发布中，勾选对应的需要开放给使用的组织或人员，确定并发布应用后，对应组织或人员即可在其 钉钉>工作台中看到此应用
{{:cs:300visitoraccess:07-勾选可以看到应用的组织架构.png?nolink|}}

7、访客在钉钉的工作台里，点开对应的应用发起会话后，坐席端即可在访客资料里看到对应的访客信息，如下图所示
{{:cs:300visitoraccess:08-钉钉渠道进线的访客信息携带.png?nolink|}}


8、在会话记录或统计查询等页面上，可以查看和筛选钉钉渠道进线相关指标数据
{{:cs:300visitoraccess:10-钉钉访客端视角.png?nolink|}}
{{:cs:300visitoraccess:11-钉钉渠道相关统计.png?nolink|}}