基于Dify构建抖店智能客服Agent：从零实现自动化消息回复-平芜编程栈

一、背景痛点：客服“三高一低”让人头大

做电商的朋友都懂，客服部门每天都在上演“三高一低”：

高重复：每天 60% 以上都是“发什么快递？”“什么时候发货？”“有没有优惠券？”
高并发：大促 0 点一过，几十个人同时涌进来，人工根本看不过来
高流失：响应慢 30 秒，买家就去别家下单了
低成本：老板既想要 7×24 小时秒回，又不想加人

夜间更惨，值班客服昏昏欲睡，漏回一条消息，第二天就是差评。于是“搞个机器人顶夜班”成了刚需。

二、技术选型：为什么选了 Dify 而不是 LangChain

我最初在 LangChain 和 Dify 之间摇摆了一周，最后拍板 Dify，原因很简单——老板要“快”，而我要“稳”。

上手速度：Dify 拖拽式工作流，半小时就能跑通一条“意图识别→知识库→回答”链路；LangChain 得自己拼代码，新手容易卡在 chain 嵌套里
可视化调试：Dify 每个节点都能实时看输入输出，出错一眼定位；LangChain 得打日志慢慢追
开箱即用：Dify 自带知识库切片、向量召回、对话管理，还帮你写好 Webhook 模板；LangChain 这些都要自己接
国产友好：抖店 API 返回 GBK 编码，Dify 的 Python 沙箱默认处理好了，省掉一堆转码坑

一句话：Dify 像“乐高”，LangChain 像“原材料”。新手先玩乐高，等拼熟了再考虑自己造轮子。

三、实现步骤：30 分钟搭出可上线的客服 Agent

3.1 Dify 工作流搭建

新建应用 → 选“Agent” → 取名“抖店客服”
拖一个“意图识别”节点，系统提示词里写好分类：商品咨询 / 订单查询 / 退换货 / 闲聊，四类足矣
拖接知识库：把商品详情、售后政策、物流说明三段文档扔进去，Dify 自动切片、向量化
多轮对话：加“变量记忆”节点，把用户第一次提供的订单号存进session.order_sn，后面节点直接引用，避免重复追问
兜底策略：如果置信度 <0.7，走“转人工”节点，直接返回“亲亲，稍等转接人工客服～”

3.2 抖店 API 对接（含完整代码）

官方文档散落在 5 个页面，我帮你拼成一份能跑的。

3.2.1 OAuth2.0 授权

抖店采用“店铺-应用-授权码”模式，先拿auth_code，再换access_token。

# get_token.py import requests, time, json APP_KEY = '你的app_key' APP_SECRET = '你的app_secret' AUTH_CODE = '用户扫码授权后得到的code' # 有效期10分钟 url = f'https://openapi-fxg.jinritemai.com/oauth2/access_token' params = { 'app_key': APP_KEY, 'app_secret': APP_SECRET, 'auth_code': AUTH_CODE, 'grant_type': 'authorization_code' } r = requests.post(url, data=params) token = r.json()['access_token'] # 存数据库，2小时过期 print(token)

3.2.2 消息事件订阅

在抖店后台“服务市场→订阅消息”里勾选：

买家发送消息（msg_from_buyer）
订单状态变更（可选）

把回调地址填成https://你的域名/douyin_webhook，保存后平台会立刻做一次 GET 校验。

3.2.3 Webhook 校验 & 解密

抖店 GET 校验逻辑：把msg_signature + timestamp + nonce做字典序排序后拼字符串，再用SHA256计算签名。

# webhook.py from flask import Flask, request, jsonify import hashlib, hmac, time app = Flask(__name__) TOKEN = '你在后台填的token' def verify(signature, timestamp, nonce): tmp = sorted([TOKEN, timestamp, nonce]) raw = ''.join(tmp).encode('utf-8') return hmac.new(raw, digestmod=hashlib.sha256).hexdigest() == signature @app.route('/douyin_webhook', methods=['GET','POST']) def douyin(): if request.method == 'GET': # 平台首次校验 echostr = request.args.get('echostr') if verify(request.args.get('msg_signature'), request.args.get('timestamp'), request.args.get('nonce')): return echostr return 'fail', 403 # 下面是真正的消息推送 data = request.get_json() buyer_id = data['sender_uid'] text = data['content'] # 调 Dify 接口 answer = call_dify_agent(text buyer_id) # 回写给买家 send_msg(buyer_id, answer) return 'success' def call_dify_agent(query, user): url = 'https://api.dify.ai/v1/chat-messages' headers = {'Authorization': 'Bearer 你的dify_api_key'} payload = { "inputs": {}, "query": query, "user": user, "response_mode": "blocking" } r = requests.post(url, json=payload, timeout=8) return r.json()['answer'] def send_msg(uid, content): url = 'https://openapi-fxg.jinritemai.com/message/send' params = { 'method': 'message.send', 'access_token': get_db_token(), 'param_json': json.dumps({ 'buyer_id': uid, 'content': content }, ensure_ascii=False) } requests.post(url, data=params)

把上面两个文件丢到云函数，10 分钟就能收到第一条机器人回复。

3.3 对话逻辑优化

商品咨询：把商品 ID 做成正则，命中后去知识库召回“材质/尺码/发货地”三段信息，再拼接当前促销价
订单查询：用户第一次提供订单号后写进session，后续节点直接调抖店/order/detail接口，返回物流单号+轨迹
退换货：关键词“退/换/售后”→ 直接给售后卡片模板，并附带“申请入口”超链，减少来回解释
超链转短链：抖店对长域名会截断，用腾讯短链 API 先压缩再发，避免买家点不开

四、避坑指南：踩过的 3 个深坑

消息频率限制
抖店对同一买家 1 分钟内最多回 3 条，超过直接 43012 错误。解决：本地加user_last_send字典，60 秒内超频直接丢弃，前端给提示“客服忙，请稍等”。
敏感词过滤
平台检测出“微信”“QQ”等引流词，店铺会被降权。解决：在 Dify 回答后加一道正则清洗，命中星号替换；同时把常见误杀词（如“加微信”→“加**信”）写白名单。
对话状态持久化
云函数无状态，session只能放 Redis。建议用user_id做 key，JSON 序列化后存 24h TTL，既省内存又避免重启丢失。