sulla

用 JavaScript 快速开发 WhatsApp 机器人，几行代码即可收发消息

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署对话助手 🍴 复刻 269 🐛 待处理 96 👀 关注 71

GitHub ↗

GitHub 星标 ★ 1305

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源库，MIT 许可证，完全免费，需自行部署使用。

项目预览

项目数据

分类对话助手

开发团队danielcardeenas

GitHubhttps://github.com/danielcardeenas/sulla

定价模式🏷️完全免费

价格说明开源库，MIT 许可证，完全免费，需自行部署使用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型bot,chatbot,framework,whatsapp,whatsapp-api,whatsapp-bot

GitHub 星标★ 1305

上线时间2019-06-10 00:00:00

代码更新2023-05-24

仓库体积3.2 MB

本站数据更新2026-11-10

维护状态低维护

收录时间2026-08-09

浏览次数7

项目介绍

sulla 是一个基于 JavaScript 的 WhatsApp 聊天机器人 API 库，旨在让开发者通过简洁的接口快速构建 WhatsApp 机器人。它封装了 WhatsApp Web 的底层交互，提供消息收发、群组管理、媒体处理等核心能力，解决了非官方 API 接入复杂、维护成本高的问题。项目采用事件驱动模型，支持监听消息、成员变动等事件，并内置了会话管理和多设备支持，适合个人开发者和小团队快速搭建自动化客服、通知机器人等应用。其 API 设计直观，文档示例丰富，降低了 WhatsApp 机器人开发的门槛。

Star 增长趋势

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

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

技术标签

bot chatbot framework whatsapp whatsapp-api

使用教程

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

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

环境要求

已安装 Node.js 与 npm（README 未指定具体版本）
项目基于 puppeteer，环境中需能下载并运行 Chromium
一个可扫码登录的 WhatsApp 手机账号

安装与启动步骤

1安装 sulla 依赖

在 Node.js 项目目录中执行，README 给出的唯一安装命令，会作为依赖写入 package.json。
```
npm i sulla --save
```
2编写机器人脚本

新建一个 js 文件，粘贴 README 的 Getting started 示例：create() 启动实例，onMessage 监听消息并对 Hi 回复。
3运行脚本生成二维码

用 Node 运行你保存的脚本文件（文件名以你实际创建的为准），sulla 会创建 WhatsApp Web 实例。
```
node index.js
```
4扫码登录账号

未登录时终端会打印二维码，用手机 WhatsApp 扫描即可，sulla 会记住会话，之后无需重复认证。
5按需创建多会话

若要同时运行多个机器人，向 create() 传入不同会话名，例如 create('sales') 与 create('support')。