wppconnect

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

开源 🏷️完全免费 ✅ 目前可打开对话助手 🍴 复刻 587 🐛 待处理 34 👀 关注 73

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 3523

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，免费使用，官网提供在线文档和演示，无付费版本。

项目预览

项目数据

分类对话助手

开发团队wppconnect-team

官网地址https://wppconnect.io/wppconnect

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

定价模式🏷️完全免费

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

访问状态✅ 目前可打开

是否开源是

开源协议NOASSERTION

主要语言TypeScript

技术栈/模型automation,chatbot,messaging,nodejs,open-source,puppeteer,typescript,whatsapp,whatsapp-api,whatsapp-bot,whatsapp-web,wppconnect

GitHub 星标★ 3523

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

代码更新2026-11-09

仓库体积91.8 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数7

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3523

技术标签

automation chatbot messaging nodejs open-source

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 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 扫描终端生成的二维码即可建立会话并收发消息。