使用官方的 QQ 商务插件(推荐)
这是最标准、最官方、也是对用户体验最好的方法,腾讯官方提供了一个 JS 插件,可以智能地检测用户设备,并弹出相应的 QQ 客户端(PC端或手机端)或在线交谈窗口。

(图片来源网络,侵删)
优点:
- 官方支持:稳定可靠,不会被腾讯封禁。
- 设备适配:自动判断用户是电脑还是手机,打开最合适的聊天窗口。
- 功能强大:可以设置默认消息、显示客服名片等。
- 无需 jQuery:虽然你提到了 jQuery,但这个官方插件是原生 JS 实现的,不依赖 jQuery。
实现步骤:
-
获取 QQ 号码的专属代码
- 访问腾讯官方的 QQ 商务组件生成页面。
- 输入你的 QQ 号码。
- 选择你想要的样式和功能(比如是否显示头像、默认消息等)。
- 点击“获取代码”,页面会生成一段 JS 代码。
-
将代码嵌入你的网页
(图片来源网络,侵删)- 将生成的
<script>代码复制粘贴到你网页的<body>标签内的最末尾(</body>之前),这样可以确保页面主要内容先加载,避免影响页面加载速度。
- 将生成的
示例代码:
假设你在官方工具生成的代码如下(请务必替换成你自己生成的代码):
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">我的网站</title>
<style>
body { font-family: sans-serif; text-align: center; padding-top: 50px; }
</style>
</head>
<body>
<h1>欢迎来到我的网站!</h1>
<p>页面加载后,QQ 对话框会自动弹出。</p>
<!-- ====================================================== -->
<!-- 以下是腾讯官方生成的 QQ 商务组件代码,请放在 body 末尾 -->
<!-- ====================================================== -->
<script charset="utf-8" type="text/javascript" src="https://wpa.b.qq.com/cgi-bin/rpc?func=GPB&from=local&r=0.7438084282292936&t=1678886400000&ak=2a9b3f3e4d5c6b7f8a9b0c1d2e3f4a5b6" id="BP_1678886400000"></script>
<script charset="utf-8" type="text/javascript" src="https://wpa.b.qq.com/cgi-bin/rpc?func=GPB&from=local&r=0.7438084282292936&t=1678886400000&ak=2a9b3f3e4d5c6b7f8a9b0c1d2e3f4a5b6" id="BP_1678886400000"></script>
<script type="text/javascript">
(function() {
var bp = document.createElement('script');
var curProtocol = window.location.protocol.split(':')[0];
if (curProtocol === 'https') {
bp.src = 'https://zz.bdstatic.com/linksubmit/push.js';
} else {
bp.src = 'http://push.zhanzhang.baidu.com/push.js';
}
var s = document.getElementsByTagName("script")[0];
s.parentNode.insertBefore(bp, s);
})();
</script>
<!-- ====================================================== -->
<!-- 官方代码结束 -->
<!-- ====================================================== -->
</body>
</html>
注意: 上面的 ak 参数和 src 链接都是示例,你需要去官方工具获取你自己的专属代码。
使用 jQuery 强制打开 QQ 协议链接(不推荐)
这种方法是通过构造一个 tencent://message/ 开头的链接,然后用 jQuery 在页面加载时触发点击事件来打开它。

(图片来源网络,侵删)
缺点:
- 非官方:使用的是协议漏洞,可能随时被腾讯禁用。
- 体验差:会强制打开本地的 QQ 客户端,如果用户没有安装 QQ 或网络环境不允许,会没有任何反应,造成困惑。
- 不智能:无法区分手机和 PC,在手机上可能无效或打开不正确。
- 依赖 jQuery:需要额外引入 jQuery 库。
实现步骤:
-
在网页中引入 jQuery 库
你可以使用 CDN(内容分发网络)来快速引入。
-
编写 jQuery 代码
- 使用 jQuery 的
ready()方法,确保页面 DOM 加载完成后再执行。 - 创建一个
<a>链接,其href属性是 QQ 协议格式。 - 使用
trigger('click')或click()方法来模拟点击这个链接。
- 使用 jQuery 的
QQ 协议链接格式:
<a href="tencent://message/?uin=你的QQ号码">QQ客服</a>
示例代码:
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">使用jQuery弹出QQ</title>
<!-- 1. 引入 jQuery 库 -->
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
<h1>欢迎来到我的网站!</h1>
<p>页面加载后,将尝试使用 jQuery 打开 QQ。</p>
<!-- 2. 创建一个隐藏的 QQ 协议链接 -->
<a id="qq-link" href="tencent://message/?uin=123456789" style="display:none;">联系QQ</a>
<!-- 3. 编写 jQuery 脚本 -->
<script>
$(document).ready(function(){
// 页面加载完成后,立即触发隐藏链接的点击事件
$("#qq-link").trigger("click");
});
</script>
</body>
</html>
请将 123456789 替换成你自己的 QQ 号码。
总结与建议
| 特性 | 官方插件 | jQuery 协议 |
|---|---|---|
| 推荐度 | ⭐⭐⭐⭐⭐ (强烈推荐) | ⭐ (不推荐) |
| 稳定性 | 非常高,官方维护 | 低,可能随时失效 |
| 用户体验 | 优秀,智能适配 | 一般,强制打开,可能失败 |
| 实现复杂度 | 简单,复制粘贴即可 | 简单,但需引入 jQuery |
| 设备兼容 | PC、手机全支持 | 主要支持 PC 端 QQ 客户端 |
为了你的网站和用户体验,强烈建议使用方法一(腾讯官方的 QQ 商务插件),这是目前最安全、最有效、最专业的做法,方法二虽然也能实现,但属于“野路子”,存在很高的不确定性和风险。
