企业官网建设流程全解析

从零搭建你的第一个钉钉智能机器人

前言

最近在做一个数据分析项目，需要通过钉钉机器人来和用户交互。今天我就来分享一下如何从零搭建一个功能完善的钉钉智能机器人。

项目简介

这个项目叫分析助手，它可以：

• 🤖 通过钉钉聊天与用户交互
• 📊 调用 Agent API 进行智能分析
• 🎨 使用钉钉卡片展示结果，支持表格、图表等
• 📁 可以发送文件卡片
• 📝 记录所有消息和 API 请求

技术栈

• Python 3.7+
• dingtalk-stream- 钉钉官方 SDK
• aiohttp- 异步 HTTP 请求
• PyYAML- 配置文件管理
• requests- 同步 HTTP 请求

项目结构

dingtalk_prod/ ├── main.py # 主入口 ├── dingtalk_config.yaml # 配置文件（新增） ├── dingtalk_config.json # 配置文件（旧版） ├── requirements.txt # 依赖包 ├── README.md # 项目说明 └── app/ ├── __init__.py ├── config.py # 配置加载 ├── logger.py # 日志配置 ├── api_client.py # API 客户端（钉钉 + Agent） ├── card_utils.py # 卡片工具函数 ├── file_handler.py # 文件处理 └── bot_handler.py # 机器人核心逻辑

第一步：钉钉开发平台配置

1.1 注册钉钉开发者账号

访问 钉钉开放平台 并注册开发者账号。

1.2 创建企业内部机器人应用

1. 登录钉钉开放平台，进入应用开发→企业内部开发
2. 点击创建应用，填写应用信息：
   • 应用名称：分析助手（或你喜欢的名字）
   • 应用描述：数据分析智能助手
   • 应用图标：上传一个头像
3. 创建成功后，进入凭证与基础信息，记录下：
   • AppKey(Client ID)
   • AppSecret(Client Secret)

1.3 配置权限

在权限管理中添加以下权限：

• 机器人调用企业会话
• 机器人调用单聊
• 机器人发送消息到企业群
• 读取群会话基本信息
• 读取用户基本信息

1.4 发布应用

1. 进入版本管理与发布
2. 点击创建新版本，填写版本号和更新内容
3. 点击发布，选择全部用户或指定用户/部门
4. 等待审核通过（通常几分钟内完成）

第二步：下载代码并配置

2.1 下载代码

gitclone<你的仓库地址>