wppconnect

用 Node.js 轻松操控 WhatsApp，快速搭建聊天机器人

WPPConnect 是一个由 JavaScript 社区维护的开源项目，旨在将 WhatsApp Web 的功能导出到 Node.js 环境，供开发者构建各类交互应用。它解决了开发者无法直接通过官方 API 操作 WhatsApp 的痛点，通过 Puppeteer 控制 WhatsApp Web 实现消息收发、媒体传输、群组管理等能力。项目核心能力包括：基于 Node.js 的简单 API 调用、支持发送文本/图片/视频/文档、监听消息事件、自动回复、以及结合人工智能进行意图识别。它适合搭建客服机器人、消息通知系统、营销自动化工具等场景。项目使用 TypeScript 编写，模块化设计，社区活跃，持续更新以适配 WhatsApp 的变动。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3458

维护状态活跃

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队wppconnect-team

所属国家

官网地址https://wppconnect.io

GitHubhttps://github.com/wppconnect-team/wppconnect

定价模式free

价格说明开源项目，免费使用，官网提供在线文档和演示，无付费版本。

访问状态

是否开源是

开源协议NOASSERTION

主要语言TypeScript

技术栈/模型ai,api,automate,bot,chat,chatbot,framework,message,nodejs,open-source,puppeteer,sulla,typescript,wa,whatsapp,whatsapp-api,whatsapp-bot,wpp,wppconnect,zap-api

GitHub 星标★ 3458

30天Star增速

HF 下载量

上线时间2021-01-25 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：库/依赖 4 步

环境要求

Node.js 运行环境（WPPConnect 是 Node.js 包，通过 npm 安装）
npm 包管理器
可正常访问 WhatsApp Web 的网络环境
一个可用于扫码登录的 WhatsApp 账号

安装与启动步骤

1准备 Node.js 环境

WPPConnect 是发布到 npm 的 Node.js 包，使用前需先在本机装好 Node.js 与 npm。
2安装 WPPConnect

在项目目录下执行 README 给出的安装命令，包会写入 package.json 依赖项。
```
npm i --save @wppconnect-team/wppconnect
```
3阅读官方入门文档

README 未包含示例代码，需按官方 Getting Started 与 Basic Function 页面了解调用方式。
4运行并扫码登录

编写并运行脚本后，用手机 WhatsApp 扫描终端生成的二维码即可建立会话并收发消息。

如何确认成功

执行安装后，package.json 的 dependencies 中出现 @wppconnect-team/wppconnect，且 node_modules 下存在该目录。

常见问题

Q：安装时提示找不到包怎么办？

A：确认已正确安装 Node.js 与 npm，并在项目目录下执行 npm i --save @wppconnect-team/wppconnect；仍失败可检查 npm 源或网络。

Q：安装完成后怎么开始写代码？

A：README 只给出安装命令，具体用法请查看官方文档 Getting Started 与 Basic Function 页面。

Q：线上文档在哪里？

A：安装说明见 https://wppconnect.io/docs/tutorial/basics/installation ，基础功能见 https://wppconnect.io/docs/tutorial/basics/basic-functions 。

Q：支持哪些功能？

A：README 列出自动刷新二维码、发送文本/图片/视频/音频/文档、获取联系人/群组/黑名单、多会话、转发与接收消息等。

注意事项

README 仅提供 npm 安装命令，使用示例需参考官网文档
该包运行在 Node.js 环境，用 TypeScript 编写
安装命令使用 --save，会将依赖写入 package.json

核心亮点

API 设计简洁，几行代码即可实现消息监听和自动回复
基于 Puppeteer 模拟 Web 端，无需担心官方 API 限制
支持多媒体发送和群组管理，覆盖常见交互需求

不足之处

依赖非官方 Web 接口，存在被 WhatsApp 封禁的风险
文档和示例不够完善，新手上手需自行探索

适用场景

搭建 WhatsApp 客服机器人，自动回复常见问题
实现消息通知系统，将系统事件推送到个人或群组
开发营销自动化工具，批量发送推广消息

替代项目

whatsapp-web.js、Baileys、Venom-bot

项目介绍

wppconnect 是行业应用领域的开源项目，由 wppconnect-team 开发，2021 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（3,458）位列前 30%，在行业应用分类的 544 个项目里位列前 9%。

近 45 天，它的 GitHub 星标从 3,374 增加到 3,458，净增 84。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。免费使用，官网提供在线文档和演示，无付费版本。从国内网络环境看，可直接访问。

它主要面向的使用场景是：搭建WhatsApp客服机器人，自动回复常见问题。同类可对比的替代方案包括 whatsapp-web.js、Baileys、Venom-bot。

上一篇：Streamer-Sales

下一篇：holmesgpt