在你的Node.js项目中轻松集成WhatsApp功能！

WhatsApp Web.js是一个Node.js的WhatsApp客户端库，通过WhatsApp Web浏览器应用程序连接。这款库利用Puppeteer启动WhatsApp Web浏览器，从而访问其内部功能，为用户创建可控的实例，降低被封禁的风险。借助这款API客户端，您几乎可以使用WhatsApp Web的所有功能，为动态使用在Node.js应用中铺平道路。使用该方法并不保证不会被封禁。Wha

weixin_44626085

263人浏览 · 2026-01-31 18:50:19

weixin_44626085 · 2026-01-31 18:50:19 发布

WhatsApp Web.js：轻松构建Node.js WhatsApp客户端的最佳解决方案

WWebJS Website

在现代通信中，WhatsApp已经是一个不可或缺的工具，不论是个人还是企业都在使用WhatsApp与客户沟通。今天，我们向大家介绍一个强大的开源库——WhatsApp Web.js，它为Node.js里的WhatsApp客户端提供了一个极简的解决方案。

什么是WhatsApp Web.js？

注意： 使用该方法并不保证不会被封禁。WhatsApp不允许在其平台上使用机器人或非官方客户端，因此需谨慎使用。

特性与功能概览

WhatsApp Web.js提供的功能非常齐全，能够满足大多数用户的需求。具体特性如下：

功能	状态
多设备支持	✅
发送消息	✅
接收消息	✅
发送媒体文件（图片/音频/文档）	✅
发送媒体文件（视频）	✅ (需使用Google Chrome)
发送贴纸	✅
接收媒体文件（图片/音频/视频/文档）	✅
发送联系人卡片	✅
发送位置	✅
发送按钮	❌ (已废弃)
发送列表	❌ (已废弃)
接收位置	✅
消息回复	✅
通过邀请加入群组	✅
获取群组邀请	✅
修改群组信息（主题、描述）	✅
修改群组设置（发送消息、编辑信息）	✅
添加群组成员	✅
踢出群组成员	✅
提升/降级群组成员	✅
提及用户	✅
提及群组	✅
静音/取消静音聊天	✅
阻止/解锁联系人	✅
获取联系人信息	✅
获取头像	✅
设置用户状态	✅
回复消息	✅
创建投票	✅
频道	✅
投票	🔜
社区	🔜

如果您觉得还有什么功能缺失，欢迎提交问题反馈给我们！

如何安装和使用

使用WhatsApp Web.js非常简单。通过npm安装库，仅需执行以下命令：

npm i whatsapp-web.js

注意： 本库需要Node.js版本为18或更高。

示例代码

以下是一个基础的使用示例：

const { Client } = require('whatsapp-web.js');

const client = new Client();

client.on('qr', (qr) => {
    // 生成并扫描此代码以登录
    console.log('二维码接收成功', qr);
});

client.on('ready', () => {
    console.log('客户端已准备好!');
});

client.on('message', msg => {
    if (msg.body == '!ping') {
        msg.reply('pong');
    }
});

client.initialize();