跳转至

钉钉应用

你需要先创建 钉钉企业内部应用1。

说明

  • 钉钉登录、消息推送

配置项

企业ID

配置您的企业在钉钉平台上的唯一标识符，用于与您的钉钉企业相关联。

应用ClientID

配置您的钉钉应用的唯一标识符，用于标识和识别您的应用。

应用ClientSecret

配置您的钉钉应用的私钥，用于生成签名并对请求数据进行加密。这个私钥必须与钉钉进行通信的接口进行匹配。

机器人令牌

配置您的钉钉机器人的令牌，用于验证钉钉推送过来的消息的真实性。

钉钉机器人 允许私人对话

配置是否允许钉钉机器人与用户进行私人对话。

请确保配置项的准确性和安全性，避免敏感信息泄露。

截图

创建钉钉应用参考

步骤1：创建企业内部应用

在钉钉开发者后台1，创建一个企业内部应用，获取应用的AppKey和AppSecret。

步骤2：申请权限

申请下面的权限，其中成员信息读权限、个人手机号信息、邮箱等个人信息用于钉钉登录； 企业内机器人发送消息权限、单聊机器人使用管理权限用于钉钉机器人对话

权限信息 权限点code
成员信息读权限 qyapi_get_member
个人手机号信息 Contact.User.mobile
邮箱等个人信息 fieldEmail
企业内机器人发送消息权限 qyapi_robot_sendmsg
单聊机器人使用管理权限 Robot.SingleChat.ReadWrite

步骤3：配置应用地址

配置您的钉钉应用的地址信息，应用首页地址、PC端首页地址、管理后台地址

  • 服务器出口IP：101.133.132.64，如果是私有云，请填写私有云服务器的IP

  • 应用首页网址、PC端首页地址、管理后台地址可以是同一个地址

如果使用钉钉登录、应用首页网址必须与使用钉钉登录的应用域名一致。

步骤3：配置机器人

如果配置了Azure OpenAI2，可以进行如下配置，实现AI对话3。

1
2
# appId 需要替换成你的应用ID
https://www.oauthapp.com/api/DingTalk/{{appId}}/PostMessage

步骤4：发布应用

在完成配置和权限申请后，发布您的钉钉应用，让用户可以使用该应用的功能。

  1. 钉钉开发者后台：https://open-dev.dingtalk.com/ ↩↩

  2. Azure OpenAI：https://docs.oauthapp.com/doc_appsetting_azure.html ↩

  3. 钉钉智能机器人：https://docs.oauthapp.com/code_dingtalk_openai_robot.html ↩

最后更新: August 10, 2023