crm/README_FOLLOWUP.md

客户跟进功能说明

功能概述

新增的客户跟进功能允许您:

• 创建客户跟进记录
• 设置跟进时间
• 自动通过飞书机器人发送提醒

功能特性

1. 客户跟进表单

• 客户名称: 从现有客户列表中选择
• 成交状态: 未成交 / 已成交
• 客户级别:
  • A级 (重点客户)
  • B级 (潜在客户)
  • C级 (一般客户)
• 客户行业: 手动输入
• 跟进时间: 选择具体的日期和时间

2. 飞书通知

当到达设定的跟进时间后,系统会自动通过飞书机器人发送提醒消息。

消息格式:

客户跟进提醒
@所有人 请及时跟进"客户名称"

配置飞书 Webhook

步骤 1: 创建飞书机器人

1. 在飞书群聊中,点击右上角设置
2. 选择"群机器人" -> "添加机器人"
3. 选择"自定义机器人"
4. 设置机器人名称和描述
5. 复制生成的 Webhook URL

步骤 2: 配置环境变量

在启动服务器之前,设置环境变量:

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: 启动服务器

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. 飞书机器人需要在对应的群聊中添加才能发送消息