一、为什么用 IM「回调」而不是自己写 WebSocket

做客服机器人，最容易踩的坑是一上来就想去维护长连接、心跳、登录态。其实腾讯云即时通信 IM（以下简称 IM）已经把这些底层全托管了，我们要做的只是"接住它抛出来的消息事件，再回一条消息"。

举个真实场景：我司「岭森咖啡」小红书账号每天有用户问"怎么买豆子""云南豆什么风味"，这类高频重复问题特别适合机器人先接住。如果自己写后台，光登录态、断线重连、多端同步就够喝一壶；而 IM 把这些做成开箱即用的能力，开发侧只关心"收到问题 → 给出答案"这一小段逻辑，心智负担直接降一个量级。

IM 提供了一个非常好用的能力——

发单聊消息之前回调（CallbackBeforeSendMsg）

。用户在 App / Demo 里给机器人账号发消息时，IM 会先 POST 一份 JSON 到我们配置的公网地址，我们在这里生成答案，再通过 REST API 把回复推回去。整个过程不需要管长连接，调试期用一台笔记本 + 公网隧道就能跑通。本文就是这条链路的完整落地。

三、用 WorkBuddy 生成 UserSig 签发脚本

机器人用管理员身份发消息，需要先签一个 UserSig。WorkBuddy 帮我补好了 v2（HMAC-SHA256）标准实现，零三方依赖：

import base64, hashlib, hmac, time

def gen_user_sig(sdkappid: int, key: str, userid: str, expire: int = 86400) -> str:
    uid = base64.b64encode(userid.encode()).decode()
    content = (
        f"TLS.identifier:{uid}\n"
        f"TLS.sdkappid:{sdkappid}\n"
        f"TLS.time:{base64.b64encode(str(int(time.time())).encode()).decode()}\n"
        f"TLS.expire:{base64.b64encode(str(expire).encode()).decode()}\n"
    )
    sha = hmac.new(key.encode(), content.encode(), hashlib.sha256).digest()
    content += "TLS.sig:" + base64.b64encode(sha).decode() + "\n"
    return base64.b64encode(content.encode()).decode()

if __name__ == "__main__":
    sig = gen_user_sig(1400000000, "你的SecretKey", "admin")
    print(sig)

注：新应用默认密钥是 ECDSA（v3），若上面跑出来 IM 报 

，改用控制台「开发辅助工具」或官方 

四、用 WorkBuddy 生成回调机器人服务

核心是一个 Flask 服务：接住回调 → 抽文本 → 匹配知识库 → 调 REST API 回消息。

from flask import Flask, request, jsonify
import time, random, urllib.request, json
from usersig import gen_user_sig  # 引用第三节的脚本

APPID, KEY, ADMIN = 1400000000, "你的SecretKey", "admin"
BOT = "kefu_bot"  # 机器人账号，用户给它发消息

FAQ = {  # 原型知识库：关键词 → 答案
    "价格": "我们基础版 99 元/月，含 1w 日活，详见官网定价页。",
    "退款": "7 天内未激活可原路退款，联系人工客服处理。",
    "默认": "已收到您的问题，客服小森稍后跟进～（这是机器人原型自动回复）",
}

def reply(text: str) -> str:
    for k, v in FAQ.items():
        if k in text:
            return v
    return FAQ["默认"]

def send_msg(to_user: str, text: str):
    sig = gen_user_sig(APPID, KEY, ADMIN)
    url = (f"https://console.tim.qq.com/v4/openim/sendmsg?sdkappid={APPID}"
           f"&identifier={ADMIN}&usersig={sig}"
           f"&random={random.randint(0, 2**31)}&contenttype=json")
    body = {
        "From_Account": BOT, "To_Account": to_user,
        "MsgLifeTime": 604800, "MsgRandom": random.randint(0, 2**31),
        "MsgTimeStamp": int(time.time()),
        "MsgBody": [{"MsgType": "TIMTextElem", "MsgContent": {"Text": text}}],
    }
    req = urllib.request.Request(url, data=json.dumps(body).encode(),
                                 headers={"Content-Type": "application/json"})
    return json.loads(urllib.request.urlopen(req, timeout=5).read())

app = Flask(__name__)

@app.route("/im/callback", methods=["POST"])
def callback():
    data = request.get_json(force=True)
    if data.get("CallbackCommand") != "C2C.CallbackBeforeSendMsg":
        return jsonify({"ActionStatus": "OK", "ErrorInfo": "", "ErrorCode": 0})
    if data.get("To_Account") != BOT:   # 只接发给机器人的消息
        return jsonify({"ActionStatus": "OK", "ErrorInfo": "", "ErrorCode": 0})
    text = data["MsgBody"][0]["MsgContent"]["Text"]
    send_msg(data["From_Account"], reply(text))  # REST 回消息，不触发回调环
    return jsonify({"ActionStatus": "OK", "ErrorInfo": "", "ErrorCode": 0})

app.run(port=9000)

IM 抛给我们的回调，实际长这样（已精简）：

 取正文。注意一条消息可能带多个 

，原型里要判一下类型，避免取文本越界报错。

）拿到公网地址，填回「回调配置」。用 IM 提供的「体验 Demo」以普通用户身份给 

，否则 IM 会按"发送失败"拦截这条用户消息——这是原型最容易翻车的地方。

这套组合把"消息接入、长连接、登录态"全交给腾讯云 IM，我们只写了一个几十行的回调服务，就拥有了一个可演示的客服机器人原型。后续接上 LLM 与知识库，就是生产级智能客服的雏形。

用 WorkBuddy + 腾讯云 IM，1 小时搭一个会"答产品问题"的客服机器人原型

编程语言

后端

人工智能

基于腾讯云IM回调实现客服机器人，无需自建WebSocket，通过C2C.CallbackBeforeSendMsg事件接收用户消息，结合REST API自动回复。使用Flask搭建回调服务，实现FAQ关键词匹配与消息发送，支持UserSig签名认证，完成低成本客服机器人快速部署。

服务器

WorkBuddy 

WebSocket

JSON

WorkBuddy企业版限时双倍 Credits 活动

workbuddy

2026上云采购 | AI焕新·智启新局

lexiang

cscbot

腾讯云 IM，全球通信，1折起


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

用 WorkBuddy + 腾讯云 IM，1 小时搭一个会"答产品问题"的客服机器人原型

用 WorkBuddy + 腾讯云 IM，1 小时搭一个会"答产品问题"的客服机器人原型

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐