下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-r4wuabfo--crm-service-mgmt.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-r4wuabfo/crm-service-mgmt。35CRM 客服管理模块,涵盖客户服务、客户投诉、客户回访、服务反馈四大功能。
阅读全文 (展开查看完整说明)
概述
CRM 客服管理
参考文档索引
| 分类 | 文件 | 说明 |
|---|---|---|
| 认证 | [authentication.md](references/authentication.md) | Token 认证流程、请求规范 |
| 基础 | [base.md](references/base.md) | 工具函数、编码规范 |
| 枚举 | [enums.md](references/enums.md) | 时间常量、dbType、searchCondition 通用结构 |
| 客户服务 | [customer_serve.md](references/customer_serve.md) | 查询客户服务列表、新增客户服务 |
| 客户投诉 | [customer_complaints.md](references/customer_complaints.md) | 查询客户投诉列表、新增客户投诉 |
| 客户回访 | [customer_revisit.md](references/customer_revisit.md) | 查询客户回访列表、新增客户回访 |
| 服务反馈 | [customer_serve_feed_back.md](references/customer_serve_feed_back.md) | 查询服务反馈列表、新增服务反馈 |
第一步:收集凭据(每次对话开始时)
尚未获取凭据时,使用 AskUserQuestion 工具一次性收集 2 个参数:
AskUserQuestion({
questions: [
{ header: "平台地址", question: "CRM 平台的 base_url 是什么?",
options: [{ label: "在下方输入平台地址", description: "例如 https://crm.example.com" }] },
{ header: "Token", question: "API Token (PAT) 是什么?",
options: [{ label: "在下方输入 Token", description: "在下方粘贴 Token 字符串" }] },
]
})收集到凭据后,调用 scripts/crm_login.py 验证 Token 有效性:
python scripts/crm_login.py n --base-url <base_url> n --token <token>验证成功输出 JSON:{"success": true, "token": "...", "base_url": "..."}
凭据在当前会话中复用,不要重复询问。
常见操作速查
| 操作 | 接口 | 参考文档 |
|---|---|---|
| 查询客户服务列表 | POST /customerServe/list | customer_serve.md |
| 新增客户服务 | viewId=CustomerServeAdd → POST /customerServe/insert | customer_serve.md |
| 查询客户投诉列表 | POST /customerComplaints/list | customer_complaints.md |
| 新增客户投诉 | viewId=CustomerComplaintsAdd → POST /customerComplaints/insert | customer_complaints.md |
| 查询客户回访列表 | POST /customerRevisit/list | customer_revisit.md |
| 新增客户回访 | viewId=CustomerRevisitAdd → POST /customerRevisit/insert | customer_revisit.md |
| 查询服务反馈列表 | POST /customerServeFeedBack/list | customer_serve_feed_back.md |
| 新增服务反馈 | viewId=CustomerServeFeedBackAdd → POST /customerServeFeedBack/insert | customer_serve_feed_back.md |
脚本工具
crm_login.py — 验证 Token
python scripts/crm_login.py n --base-url https://xxx n --token xxx输出:{"success": true, "token": "...", "base_url": "..."}
crm_query.py — 通用查询(使用 Token)
python scripts/crm_query.py
--base-url https://xxx
--token xxx
--module-id customer_serve
--limit 25crm_form_submit.py — 通用表单提交(使用 Token)
# 仅查看模板
python scripts/crm_form_submit.py
--base-url https://xxx
--token xxx
--view-id CustomerServeAdd
--template-only
# 提交新增
python scripts/crm_form_submit.py
--base-url https://xxx
--token xxx
--view-id CustomerServeAdd
--data '{"name":"测试客户服务"}'关键注意事项
- 中文编码:所有含中文的请求必须通过 Python 脚本执行,不能用 Bash 直接 curl(详见 base.md)
- multipart 请求:使用
curl --data-binary @-通过 subprocess 发送 - 日期格式:提交格式必须为
Y-m-d H:i:s(含时间部分),如2026-06-05 00:00:00 - 响应数据位置:解析时用
resp.get('rows') or resp.get('data') or [] - 新增操作:使用通用表单流程(
scripts/crm_form_submit.py):view/form → 解析字段 → insert