86 lines
2.1 KiB
Markdown
86 lines
2.1 KiB
Markdown
# 客户跟进功能说明
|
|
|
|
## 功能概述
|
|
|
|
新增的客户跟进功能允许您:
|
|
- 创建客户跟进记录
|
|
- 设置跟进时间
|
|
- 自动通过飞书机器人发送提醒
|
|
|
|
## 功能特性
|
|
|
|
### 1. 客户跟进表单
|
|
- **客户名称**: 从现有客户列表中选择
|
|
- **成交状态**: 未成交 / 已成交
|
|
- **客户级别**:
|
|
- A级 (重点客户)
|
|
- B级 (潜在客户)
|
|
- C级 (一般客户)
|
|
- **客户行业**: 手动输入
|
|
- **跟进时间**: 选择具体的日期和时间
|
|
|
|
### 2. 飞书通知
|
|
当到达设定的跟进时间后,系统会自动通过飞书机器人发送提醒消息。
|
|
|
|
消息格式:
|
|
```
|
|
客户跟进提醒
|
|
@所有人 请及时跟进"客户名称"
|
|
```
|
|
|
|
## 配置飞书 Webhook
|
|
|
|
### 步骤 1: 创建飞书机器人
|
|
|
|
1. 在飞书群聊中,点击右上角设置
|
|
2. 选择"群机器人" -> "添加机器人"
|
|
3. 选择"自定义机器人"
|
|
4. 设置机器人名称和描述
|
|
5. 复制生成的 Webhook URL
|
|
|
|
### 步骤 2: 配置环境变量
|
|
|
|
在启动服务器之前,设置环境变量:
|
|
|
|
```bash
|
|
export FEISHU_WEBHOOK_URL="https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx"
|
|
```
|
|
|
|
或者在 `.env` 文件中添加:
|
|
|
|
```
|
|
FEISHU_WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx
|
|
```
|
|
|
|
### 步骤 3: 启动服务器
|
|
|
|
```bash
|
|
go run ./cmd/server/main.go
|
|
```
|
|
|
|
## 通知机制
|
|
|
|
- 系统每分钟检查一次是否有需要发送的跟进提醒
|
|
- 当跟进时间到达后,自动发送飞书通知
|
|
- 通知发送后,记录状态会更新为"已通知"
|
|
- 每条跟进记录只会发送一次通知
|
|
|
|
## 数据存储
|
|
|
|
跟进记录存储在 `./data/followups.json` 文件中。
|
|
|
|
## API 端点
|
|
|
|
- `GET /api/followups` - 获取跟进列表
|
|
- `POST /api/followups` - 创建跟进记录
|
|
- `GET /api/followups/:id` - 获取单个跟进记录
|
|
- `PUT /api/followups/:id` - 更新跟进记录
|
|
- `DELETE /api/followups/:id` - 删除跟进记录
|
|
- `GET /api/customers/list` - 获取客户名称列表
|
|
|
|
## 注意事项
|
|
|
|
1. 如果未配置 `FEISHU_WEBHOOK_URL`,通知功能将不可用,但其他功能正常工作
|
|
2. 确保服务器时区设置正确,以保证通知时间准确
|
|
3. 飞书机器人需要在对应的群聊中添加才能发送消息
|