客服小精灵
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_7f2d3808/cs-elf。
技能介绍
要解决什么问题
外贸和跨境电商在 WhatsApp 上往往一天收到大量询价与跟进消息,人工客服很难做到及时、一致地回复,更难得在对话里系统记下国家、品类、数量、预算等线索。漏回一条高意向客户,或该转人工时还在用模板敷衍,成本都很高。
技能如何工作
客服小精灵是一个基于 Python / FastAPI 的单文件服务(wa_kefu_server.py),把 Webhook 接入、AI 回复、意向抽取、评分与转人工串在同一条链路上。
- 双通道 Webhook:支持 Meta Cloud API 与 Twilio,消息进入后先走 知识库优先 匹配;无命中再调 OpenAI;仍无法回答时用多语言兜底文案。
- 无感意向采集:从对话中抽取 8 类字段(国家/产品/数量/预算/时间/身份/诉求/紧急度),结合 30+ 国家城市关键词、多语言家具产品词与正则规则。
- 客户评分与标签:0–100 分划分高/中/低意向,并自动打询价、高预算、紧急、批发等标签。
- 转人工:满足报价单(如
proforma invoice)、付款物流、投诉、要求人工、大额采购等 6 类条件时自动转接;也提供手动转接 API。 - Web 管理面板:默认
http://localhost:8765,覆盖仪表盘、客户列表与详情、产品库、知识库 CRUD、通道与模型设置;数据落在 SQLite,并带家具行业种子数据便于试跑。
适用边界与注意点
场景上更贴近 外贸家具出口(已预置产品与 FAQ);换品类主要靠改知识库与配置。OpenAI 为可选能力,国内需自行配置 openai_base_url 或依赖知识库兜底。bot_config.json 含 Token 等敏感信息,勿提交版本库;公网 Webhook 需 HTTPS(开发可用 ngrok)。部署细节(BOM、WSL 路径、端口、关键词单复数、正则 patch 等)见技能附带的 deployment-pitfalls.md 与 intent-extraction-technique.md。
使用场景
- 家具外贸团队在 Meta 或 Twilio 接入 WhatsApp 后,用 Webhook 自动回复询价并优先匹配知识库 FAQ。
- 跨境卖家在非工作时间收到西语/阿语客户消息,需要多语言检测后自动接待并记录国家与产品意向。
- 销售在跟进前列表筛选 0–100 分高意向客户,查看八类字段与标签再决定是否人工介入。
- 客户对话中出现 proforma invoice、付款或投诉关键词时,系统自动触发转人工并可在面板里人工发消息。
适合人员
- 负责 WhatsApp 询盘通道的外贸家具销售,希望先自动筛出高预算与批发类线索再跟进。
- 只有小团队的跨境电商运营,需要在无人值班时仍回复常见物流与产品问题并留完整聊天记录。
- 对接 Meta Cloud API 或 Twilio 的技术同事,要交付带仪表盘与客户 API 的可自托管客服服务。
- 需要把 FAQ 与产品库集中维护的客服主管,通过浏览器改知识库而不改代码。