在线激活并对接钉钉

本文描述了在星纵智能智慧办公私有部署过程中的在线激活并对接钉钉的步骤。

重要提示

由于钉钉对接涉及的参数较多，我们建议你将配置过程中出现的参数及时记录下来，以便后续操作。

步骤一、钉钉自建应用及基础配置

星纵智能智慧办公私有部署版本与钉钉的对接是通过钉钉自建应用实现的，在开始对接之前，你需要先创建钉钉自建应用，并完成以下的基础配置。

钉钉自建应用

登录钉钉开放后台。
进入 应用开发 > 企业内部开发 > 钉钉应用。
点击右上角的 创建应用，在弹窗中完成以下配置：
- 应用类型：保持默认选择 H5微应用
- 应用名称：输入一个名称，以帮助你识别此应用。
- 应用描述：输入对该应用的描述，在本例中输入 用于对接星纵智能智慧办公。
- 应用图标：上传应用图标。
- 开发方式：选择 企业自主开发。
点击 确定创建。
应用创建完成后，在 应用信息 页面记录以下内容：
- AgentId
- App Key
- App Secret

配置应用权限

点击左侧导航栏，进入 基础信息 > 权限管理。

在搜索栏中，搜索下列权限信息并点击右侧的 申请权限：

序号	权限信息	序号	权限信息
1	个人手机号信息	6	成员信息读权限
2	日历应用中日程写权限	7	通讯录部门成员读权限
3	通讯录个人信息读权限	8	调用OpenApp专有API时需要具备的权限
4	邮箱等个人信息	9	chat相关接口的管理权限
5	通讯录部门信息读权限	10	企业员工手机号信息

配置应用回调域名

在左侧导航栏中，进入 应用功能 > 登录与分享。
在 接入登录 章节下的 回调域名 栏填写你为星纵智能智慧办公准备的域名，然后点击添加。

配置信息卡片

在左侧导航栏中，进入 应用功能 > 消息推送 页面。
在 消息类型 栏，点击 群互动卡片 右侧的搭建。
在跳转到的 钉钉可交互卡片 页面中，点击右上角 新增模板。
在弹窗中，配置模板信息：
- 请输入模板名称：输入一个名称帮助你识别此模板。
- 卡片类型：保持默认值 IM 卡片。
点击确定，完成模板创建。
在跳转的页面中，点击右上角的导入，将星纵智能智慧办公卡片模板上传至钉钉。

点击此处下载星纵智能智慧办公卡片模板。
在 导入模板 提示框中，点击确认。
当页面显示如下图片时，则表示模板文件导入成功，点击右上角发布。
在 确认发布 提示框中，点击确认。发布成功后记录 卡片 ID。

步骤二、激活星纵智能智慧办公

联系星纵智能销售人员以获取激活码。
打开浏览器，在地址栏输入你为星纵智能智慧办公准备的域名，按下 Enter 键。
在系统激活页面，选择 在线激活 并输入激活码。
点击确认。

步骤三、选择注册方式并绑定钉钉信息

在 注册方式 页面，选择钉钉为注册方式。

完成以下参数的配置

参数	操作
Corp ID	登录钉钉开发者后台，进入首页。在右上角账号信息章节中，复制 CorpId 并粘贴至此栏中。
Agent ID	输入步骤一中记录的 AgentId
App Key	输入步骤一中记录的 App Key
App Secret	输入步骤一中记录的 App Secret
卡片Id	输入步骤一中记录的卡片ID
RobotCode	点击注册页面的消息接收地址旁的复制按钮。登录钉钉开发者后台，进入应用 > 企业内部应用，并点击为星纵智能智慧办公创建的应用。在应用详情页面，点击左侧导航栏，进入应用功能 > 消息推送。点击机器人右侧的配置。在弹窗中，完成以下配置，并点击保存：名称：输入与应用相同的名称。图标：上传一个图标消息接收地址：粘贴消息接收地址点击拷贝RobotCode，返回至智慧办公注册页面，将复制内容粘贴至此栏。
应用首页地址	点击链接右侧的复制按钮。登录钉钉开发者后台，进入应用 > 企业内部应用，并点击为星纵智能智慧办公创建的应用。在应用详情页面，点击左侧导航栏，进入基础信息 > 开发管理。在开发管理页面，点击右上角修改。将应用首页地址链接粘贴至以下栏：应用首页地 PC端首页地址管理后台地址点击右上角保存。
消息接收地址	已在生成 BotAppKey 时完成操作，此时无需其它操作。
请求网址	详细操作参见步骤四。
加密 aes_key
签名 Token

步骤四、配置消息回调

为了保证用户可以在钉钉应用中接收到星纵智能智慧办公相关的通知消息，你需要完成消息回调的配置。

在智慧办公 注册方式 页面，点击 请求网址 右侧的复制按钮。
登录钉钉开发者后台，进入 应用 > 企业内部应用，并点击为星纵智能智慧办公创建的应用。
在应用详情页面，点击左侧导航栏进入 应用功能 > 事件与回调 页面。
在 请求网址 栏，粘贴 请求网址。
点击 加密 aes_key 右侧的按钮，将生成的连接粘贴至智慧办公 注册方式 页面的 加密 aes_key 栏。
点击 签名 token 右侧的按钮，将生成的连接粘贴至智慧办公 注册方式 页面的 签名 token 栏。
在智慧办公 注册方式 页面，点击下方的确认。等待页面跳转至登录页面。
返回至钉钉平台的 事件订阅 页面，点击保存。
保存成功后会展示具体的订阅事件。

在 通讯录事件 章节中，开启以下订阅内容：

序号	权限信息	序号	权限信息
1	通讯录用户增加	6	通讯录企业部门修改
2	通讯录用户更改	7	通讯录企业部门删除
3	通讯录用户离职	8	通讯录用户被设为管理员
4	加入企业后用户激活	9	通讯录用户被取消设置管理员
5	通讯录企业部门创建

步骤五、配置应用可见范围

应用可见范围决定了星纵智能智慧办公对于哪些用户是可见的，只有在应用可见范围内的用户，才可以在钉钉工作台中发现并使用星纵智能智慧办公。

登录钉钉开发者后台，进入 应用 > 企业内部应用，并点击为星纵智能智慧办公创建的应用。
在应用详情页面，点击左侧导航栏进入 部署与发布 > 版本管理与发布 页面。
点击 确认发布，并在提示对话框中点击确定。
应用发布成功后，在 可使用范围设置 栏，根据需求选择可以使用星纵智能智慧办公的人员。
点击保存。

步骤六、登录星纵智能智慧办公

返回星纵智能智慧办公安装向导，在登录页面点击登录。
在授权页面，阅读我们的服务协议和隐私政策并授权。