🚀 WhatsApp 多通道平台服务器

WhatsApp 多通道平台服务器用于集成 WhatsApp，借助 REST API 实现消息的收发功能，为开发者提供便捷的消息交互解决方案。

🚀 快速开始

WhatsApp 多通道平台服务器允许你通过 REST API 实现消息的发送和接收。使用前请确保满足先决条件，并按照安装步骤完成部署，即可开启消息交互之旅。

✨ 主要特性

• 🔗 WhatsApp 连接管理及二维码认证
• 💬 发送和接收文本消息
• 🖼️ 发送媒体消息（图片、文档等）
• 📇 联系人管理
• 💬 聊天记录
• 📊 会话 persistence
• 🌐 与其他应用程序集成的 REST API

📦 安装指南

先决条件

• Node.js (v14 或更高版本)
• MongoDB（可选但推荐用于消息存储）
• WhatsApp 账户

安装步骤

1. 克隆仓库：

git clone https://github.com/krusleung/whatsapp-mcp-server.git
cd whatsapp-mcp-server

2. 安装依赖项：

npm install

3. 从示例创建 .env 文件：

cp .env.example .env

4. 使用配置编辑 .env 文件

运行服务器

启动开发服务器：

npm run dev

生产环境：

npm start

📚 详细文档

API 文档

认证

服务器使用 WhatsApp Web 的 QR 码进行认证。首次启动服务器时，控制台会显示一个 QR 码。使用您的 WhatsApp 手机应用程序扫描：

1. 在手机上打开 WhatsApp
2. 点击菜单或设置并选择 WhatsApp Web
3. 扫描控制台中显示的 QR 码

API 端点

💻 使用示例

发送消息

curl -X POST http://localhost:3000/api/messages/send \
  -H "Content-Type: application/json" \
  -d '{"to": "1234567890", "message": "Hello from WhatsApp MCP Server!"}'

获取联系人

curl -X GET http://localhost:3000/api/contacts

📄 许可证

此项目根据 MIT License 许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• whatsapp-web.js - WhatsApp Web API
• Express - 网络框架
• Mongoose - MongoDB ODM