钉钉 Python 脚本配置全攻略：AppKey/AppSecret/ChatID/UserID 获取指南

要获取钉钉 API 所需的配置信息（如 APPKEY、APPSECRET 等），需要在钉钉开放平台进行相应操作。以下是详细获取步骤：

一、获取 DINGTALK_APPKEY 和 DINGTALK_APPSECRET

1. 注册并登录钉钉开放平台

• 访问 钉钉开放平台
• 使用企业管理员账号登录，或注册新账号

2. 创建企业内部应用

1. 进入 应用开发 > 企业内部应用，点击 创建应用
2. 填写应用基本信息：
   • 应用名称：自定义（如 "文件下载助手"）
   • 应用简介：简要描述用途
   • 接入方式：选择 "企业内部应用"
   • 应用类型：选择 "小程序" 或 "H5 应用"

3. 获取 AppKey 和 AppSecret

• 创建成功后，在应用详情页的 基本信息 中找到：
  • AppKey：对应 DINGTALK_APPKEY
  • AppSecret：对应 DINGTALK_APPSECRET
  • 注意：AppSecret 仅首次创建时显示，请妥善保存！

二、获取 DINGTALK_CHATID（群聊 ID）

方法一：通过开放平台 API 获取

1. 获取 access_token：

   bash

   curl -X GET "https://oapi.dingtalk.com/gettoken?appkey=YOUR_APPKEY&appsecret=YOUR_APPSECRET"
   

    
   • 替换 YOUR_APPKEY 和 YOUR_APPSECRET
   • 响应中的 access_token 字段即为所需

2. 获取群聊列表：

   bash

   curl -X POST "https://oapi.dingtalk.com/chat/list?access_token=ACCESS_TOKEN" -d '{"offset":0,"size":100}'
   

    
   • 替换 ACCESS_TOKEN
   • 响应中的 chatid 字段即为群聊 ID

方法二：通过钉钉客户端获取

1. 在电脑端钉钉打开目标群聊
2. 点击群名称进入群设置
3. 群 ID 显示在页面底部（需管理员权限）

三、获取 DINGTALK_USERID（用户 ID）

方法一：通过开放平台 API 获取

1. 获取用户手机号对应的 UserID：

   bash

   curl -X POST "https://oapi.dingtalk.com/user/get_by_mobile?access_token=ACCESS_TOKEN" -d '{"mobile":"13800138000"}'
   

    
   • 替换 ACCESS_TOKEN 和手机号
   • 响应中的 userid 字段即为所需

方法二：通过钉钉管理后台获取

1. 登录 钉钉管理后台
2. 进入 通讯录 > 员工管理
3. 点击目标用户，在详情页的 个人信息 中查看 UserID

四、配置 DINGTALK_DOWNLOAD_DIR

这是本地文件下载目录，无需从钉钉获取。确保：

1. 目录路径存在且可写
2. 格式为相对路径（如 ./downloads）或绝对路径（如 /data/files）

权限申请注意事项

1. API 权限申请：

   • 在开放平台的应用详情页，进入 权限管理
   • 申请以下权限：
     • 企业内部群文件读权限
     • 企业内部群会话读权限
     • 成员信息读权限

2. 管理员授权：

   • 部分敏感 API 需要企业管理员授权
   • 在应用详情页点击 申请发布，提交管理员审批

配置完成后，将这些信息填入你的 Python 脚本：

python

DINGTALK_APPKEY="实际的AppKey"
DINGTALK_APPSECRET="实际的AppSecret"
DINGTALK_CHATID="实际的ChatID"
DINGTALK_USERID="实际的UserID"
DINGTALK_DOWNLOAD_DIR="./downloads"

这样你的脚本就能正常访问钉钉 API 并下载文件了。