基于 QiweAPI 的实时消息回调机制,构建自定义关键词库,实现对客户咨询的秒级精准响应。
能力介绍
-
全量文本匹配:支持"完全匹配"与"模糊包含"两种模式,灵活覆盖客户的不同提问方式。
-
多媒介内容回复:触发关键词后,不仅能回复纯文本,还支持自动发送图片、名片、视频、文件或小程序卡片。
-
多轮对话路由:通过接口逻辑判断,可实现根据关键词引导用户进入不同的业务分支(如:输入"1"获取报价,输入"2"联系人工)。
-
群聊与私聊通用:支持在个人对话框及外部群聊中同步开启,且能识别 @ 机器人后的关键词指令。
10 分钟接入 Demo
-
建立关键词库:在您的数据库或配置文件中定义"关键词-回复内容"的映射表。
-
配置消息推送:在 QiweAPI 后台设置回调地址,确保每一条客户消息都能实时推送到您的后端。
-
匹配与回传 :后端收到消息后进行字符串检索,命中关键词即调用
send_text或其他发送接口。
API 示例代码
以下展示了如何实现一个简单的关键词匹配逻辑:
python
import requests
from flask import Flask, request
app = Flask(__name__)
# 自定义关键词库
KEYWORD_DB = {
"价格": "您好,我们的产品定价为 99 元起,详情请查看:[链接]",
"合作": "商务合作请添加经理微信:[名片]",
"地址": "公司位于:上海市 XX 区 XX 路 XX 号"
}
@app.route('/keyword_reply', methods=['POST'])
def keyword_reply():
data = request.json
content = data.get('content', '') # 获取客户发送的消息
user_id = data.get('from_user') # 获取客户 ID
# 1. 遍历词库进行模糊匹配
for key, reply in KEYWORD_DB.items():
if key in content:
# 2. 调用 QiweAPI 发送预设回复
requests.post("http://api.qiweapi.com/send_text", json={
"to_user": user_id,
"content": reply,
"api_key": "YOUR_QIWE_KEY"
})
break # 匹配到第一个关键词即跳出
return {"status": "processed"}
使用场景说明
-
高频业务咨询:针对"怎么开通"、"多少钱"、"有优惠吗"等高频问题,实现 0 延迟自动应答,减轻人工负担。
-
活动引流辅助:在朋友圈宣传时告知客户"私信回复【领奖】获取链接",系统自动发放福利,提升转化率。
-
自助服务导航:通过关键词构建"数字菜单",引导客户自助查询物流状态、账号余额或常见故障处理。
-
自动入群引导:识别关键词如"入群"、"加群",机器人自动发送对应群聊的邀请卡片。
FAQ
-
Q:支持正则匹配吗?
- A:支持。因为消息是通过 API 推送到您的后端,您可以利用 Python 或其他语言的
re模块实现极其复杂的正则逻辑。
- A:支持。因为消息是通过 API 推送到您的后端,您可以利用 Python 或其他语言的
-
Q:如果同一个消息命中多个关键词怎么办?
- A:您可以在后端逻辑中设置优先级,或者将匹配到的多个回复合并成一条发送,灵活性完全掌握在开发者手中。
-
Q:如何避免对所有消息都进行匹配?
- A:可以根据
from_user或chat_id进行过滤,仅对特定的客户群或特定的时间段开启关键词自动回复功能。
- A:可以根据