teamtock与钉钉集成方案
发布于: 2025-04-07
一、teamtock与钉钉集成准备
配置teamtock和钉钉的集成，需要满足以下条件。
-
拥有钉钉开放平台管理员账号
-
拥有teamtock系统管理员账号
通过钉钉开放平台管理员账号，创建应用，配置所需信息。通过以上两个步骤，完成钉钉集成配置，实现通过钉钉入口访问teamtock应用。
通过teamtock系统管理员账号，进入【后台管理】-【三方集成】页面，选择【钉钉集成】，补充配置对应信息，完成集成配置。
二、在钉钉添加teamtock移动端应用
1、登录钉钉开放平台
2、进入应用开发，创建应用
3、创建应用时，用户可以自定义应用的名称和logo
4、点击“添加应用能力”，添加“网页应用”，进入“网页应用”配置页面
5、补充网页应用配置信息
-
应用首页地址：本地址是钉钉移动端访问teamtock移动端应用的入口。
teamtock移动端应用的入口链接请于“teamtock”系统中【后台管理】-【三方集成】-【钉钉集成】页面【网页应用首页访问地址】字段中获取，并粘贴到【应用首页地址】。
-
【PC端首页地址】：本地址是钉钉PC端访问teamtock的入口。
用户可以根据公司需求配置teamtock移动端访问入口或者PC端访问入口链接。
6、配置应用权限
点击“权限管理”，进去权限设置页面。配置teamtock移动端应用的权限，
-
配置权限范围（权限范围决定那些员工可以在钉钉平台使用teamtock移动端）
-
需开通权限权限
下表所示权限是teamtock移动端应用所需的必要权限，用户可以通过搜索权限名称或者权限点code找到对应的权限，并选中。选中后，点击“批量申请”
通过以下权限的授权，建立teamtock系统和钉钉系统之间的数据关联（包括用户数据的关联），通过授权实现用户在不输入额外登录信息的情况下，直接通过钉钉账号登录teamtock第三方应用。
| 权限名称 | 权限点code |
| 根据手机号获取成员基本信息权限 | qyapi_get_member_by_mobile |
| 通讯录个人信息读权限 | Contact.User.Read |
| 个人手机号信息 | Contact.User.mobile |
| 获取钉钉开放接口用户访问凭证的基础权限 | open_app_api_base |
| 成员信息读权限 | qyapi_get_member |
| 企业员工手机号信息 | fieldMobile |
| 邮箱等个人信息 | fieldEmail |
7、开通事件订阅
实现teamtock系统的消息通知可以发送到钉钉提醒消息中，提升消息传递到及时性。
点击“事件订阅”，选择“HTTP推送”，补充时间订阅信息。
-
请求地址：请于“teamtock”系统中【后台管理】-【三方集成】-【钉钉集成】页面【事件订阅请求地址】字段中获取，并粘贴到对应位置。
-
【加密 aes_key】【签名 token】，点击重置，自动生成
三、建立teamtock和钉钉数据交互机制
建立双系统间的交互机制，需要在teamtock系统中补充部分信息，用于建立系统双方之间的连接。
其中包括
| CorpId | CorpId是企业在钉钉开放平台上的唯一标识符。它用于标识和区分不同的企业，确保数据的归属性和准确性。 |
| App ID | 三方应用的唯一标识，这里用于标识teamtock移动端 |
| Client ID | 企业应用的唯一身份标识。它用于在调用钉钉API接口时验证应用程序的身份和权限 |
| Client Secret | 调用密钥，用于在调用API接口时进行身份验证和权限控制 |
| AgentId | 区分不同企业内部应用的唯一标识。当企业在钉钉上创建了多个应用时，每个应用都会有一个唯一的AgentId |
| 加密 aes_key | AES（高级加密标准）是一种广泛使用的对称加密算法，加密 aes_key是密钥 |
| 签名 token | 签名Token通常用于身份验证和授权，确保消息在传输过程中未被篡改 |
下面介绍上述信息，如何在钉钉开放平台获取，并填入teamtock三方集成配置页。
1、CorpId
点击右上角组织logo，获取“CorpId”
2、App ID/Client ID/Client Secret
点击“凭证与基础信息”，获取“App ID/Client ID/Client Secret”
3、加密 aes_key/签名 token
点击事件订阅，获取“加密 aes_key/签名 token”
4、信息补充完成后保存，即完成配置
四，访问teamtock移动端应用
钉钉集成配置完成后，用户就可以通过钉钉平台访问teamtock应用了。
1，钉钉移动端访问teamtock
用户可以通过钉钉移动端工作台，搜索应用名称，点击访问。
2，钉钉PC端访问teamtock
用户可以通过钉钉PC端工作台，搜索应用名称，点击访问。
作者：teamtock帮助中心