钉钉应用配置

# 钉钉应用配置

## 钉钉后台设置

1\.登录[钉钉开发者后台](https://developers.dingtalk.com/)

![](/media/202507//1751968565.5525937.png)

2\.登录成功后，**切换到旧版（右上角返回旧版）**，可看见所属组织，CorpId，API Token等信息。

![](/media/202507//1751968565.5565243.png)

3\.在**应用开发**页面，选择**企业内部开发 \- H5微应用**，然后单击**创建应用**。

![](/media/202507//1751968565.5604446.png)

4\.在弹出的创建应用页面中填写基本信息，然后单击**确定创建**。

* **应用类型**：选择**H5微应用**。

* **开发方式**：选择**企业自助开发**。

![](/media/202507//1751968565.5636654.png)

5\.应用创建完成后，在**凭证与基础信息**页面，复制应用的**AgentId**、**AppKey**和**AppSecret**备用。

![](/media/202507//1751968565.5668206.png)

6\.在**应用开发**页面，选择**移动接入应用 \- 登录**，然后单击**创建扫码登录授权**。

![](/media/202507//1751968565.5699027.png)

7\.在弹出的创建扫码登录应用授权页面中填写基本信息，然后单击**确定**。

* **授权LOGO地址**：选择**应用的logo图片地址。**

**授权logo**用于钉钉扫码以后，手机中间出现的一个图片logo。**授权LOGO地址**只要是一个可以访问到的图片地址就可以。一般会用平台logo，平台logo地址获取方式：

![](/media/202507//1751968565.5732472.png)

右键点击平台logo，点击复制图片地址即可获得平台logo图片地址。

* **回调域名**：填写**系统域名\+固定页面名称，比如** （http://xxxxxxxxxxx:xxxxxx/oauth\-callback） 其中http://xxxxxxxxxxx:xxxxxx 为系统域名，oauth\-callback为前端vue中转页面，

**注意**：域名必须与前端配置的域名保持一致，否则首页二维码无法显示。**系统域名**可使用登录平台后的首页地址

![](/media/202507//1751968565.576554.png)

上图中的回调域名可以写成：[http://test.zhoujusoft.com](http://test.zhoujusoft.com/)/oauth\-callback

* 创建完成后，复制**appId**、**appSecret**备用。

![](/media/202507//1751968565.5793674.png)

8\.单击**开发管理**进入开发管理页面，然后单击**修改，**并根据以下内容配置开发信息。（配置从工作台进入）

* **开发模式**：选择**开发应用**。

* **服务器出口IP**：输入调用钉钉服务端API时使用的IP即企业服务器的公网IP，多个IP请以英文逗号","隔开，支持带一个\*号通配符的IP格式。

* **应用首页地址**：输入应用首页URL，在移动端工作台点击应用图标会跳转到此页面。可输入后端服务部署的服务器的IP或域名。

![](/media/202507//1751968565.5838275.png)

9\.单击**权限管理**进入权限管理页面，然后根据以下配置添加接口调用权限。

a.权限范围选择**全部员工**，然后选择**通讯录管理**下。

b.单击**添加接口权限，**在弹出的**添加接口权限**窗口中添加**通讯录编辑、只读、手机号码权限**。

![](/media/202507//1751968565.5879803.png)

![](/media/202507//1751968565.591218.png)

## 瞬翕云后台配置

1\.使用管理员登录S2系统后台，进入系统管理\>系统参数\>第三方集成

![](/media/202507//1751968565.5947871.png)

这里填写的**应用AppKey、应用AgentID、应用凭证**可取上面“第五点”中的信息；

**移动接入AppID、移动接入应用凭证**可取上面“第七点”中的信息；

**App地址**是自行开发的H5应用站点地址。

注意：上述后台配置结束后，不要忘记还有两个小设置

1、钉钉管理员在移动端将配置好的h5应用设置为全员应用

![](/media/202507//1751968565.5983639.png)

点击“添加”，搜索已经在后台配置好的应用，添加上来

2、瞬翕云管理员在登录配置上，将钉钉登录选项勾选上

![](/media/202507//1751968565.6013913.png)

![](/media/202507//1751968565.6040978.png)