WhatsApp Bridge MCP-开源WhatsApp集成
免费将您的个人WhatsApp变成人工智能支持的客户支持渠道。
绕过昂贵的WhatsApp Business API（5000美元+年度承诺），使用您的个人WhatsApp帐户和这个轻量级的桥接服务器。
这是什么？
该项目提供：
- WhatsApp桥接服务器 （Go）-连接到WhatsApp Web并公开REST API
- 基本AI机器人示例 （Python）-使用Google Gemini AI的简单聊天机器人
- 完整的文件 -在10分钟内开始
为什么存在
WhatsApp Business API的价格高得令人望而却步：
- 小型企业
- 初创企业
- 个人开发者
- 副项目
官方WhatsApp商务API：5000美元/年最低承诺额\ 此解决方案：0-60美元/年（仅限托管费用）
特性
包含的内容（开源）
- 通过Go桥服务器集成WhatsApp Web
- 用于发送/接收消息的REST API
- 用于消息存储的SQLite数据库
- 使用Google Gemini的基本AI聊天机器人示例
- Docker支持，易于部署
- 全面的文件
不包括什么
这是 基础 只有。对于生产级AI，您需要：
- 高级移情框架 （痕迹）
- 情感状态识别（情绪检测） - 因果分析引擎（了解用户不高兴的原因） - 战略响应规划（选择最佳方法） - 同理心反应合成（类人对话）
- 成本优化 （API成本降低80%）
- 智能缓存系统 - 模式匹配库 - 选择性API触发 - 响应模板管理
- 质量保证
- 基于机器学习的响应评估 - 多维评分 - 自动错误检测 - 持续改进跟踪
- 企业功能
- 多租户支持 - 高级分析仪表板 - Google表格集成 - 团队协作工具 - 人工切换工作流程
想要完整版吗？ 联系人：w3j.btc@gmail.com
建筑
┌─────────────────┐
│ WhatsApp Web │
└────────┬────────┘
│ (WebSocket)
↓
┌─────────────────┐ ┌──────────────────┐
│ Bridge Server │◄────►│ SQLite Database │
│ (Go - 8080) │ │ (messages.db) │
└────────┬────────┘ └──────────────────┘
│ (REST API)
↓
┌─────────────────┐ ┌──────────────────┐
│ Your AI Bot │◄────►│ Gemini API │
│ (Python) │ │ (AI Responses) │
└─────────────────┘ └──────────────────┘快速开始
先决条件
- 转到1.21+（用于网桥服务器）
- Python 3.9+（用于AI机器人）
- Google Gemini API密钥(免费获得一个)
- WhatsApp帐户
安装
1.克隆存储库
git clone https://github.com/W3JDev/whatsapp-bridge-mcp.git
cd whatsapp-bridge-mcp2.启动WhatsApp桥
cd bridge
go mod download
go run main.go使用WhatsApp移动应用程序扫描二维码进行身份验证。
3.配置AI Bot
cd ../examples/basic-bot
cp .env.example .env编辑 .env 并添加您的Gemini API密钥：
GEMINI_API_KEY=your_key_here4.启动Bot
pip install -r requirements.txt
python bot.py5.测试一下！
从另一部手机向您的WhatsApp号码发送消息。机器人会自动响应！
API 参考
发送消息
POST http://localhost:8080/api/send
Content-Type: application/json
{
"recipient": "1234567890@s.whatsapp.net",
"message": "Hello from the bridge!"
}获取消息
消息存储在SQLite数据库中： bridge/store/messages.db
SELECT * FROM messages
WHERE is_from_me = 0
ORDER BY timestamp DESC
LIMIT 10;例子
基本机器人（包括在内）
简单的聊天机器人，用人工智能生成的响应来回应每条消息。
能力:
- 单回合对话
- 双子座的一般反应
- ~3-5秒响应时间
- 每条消息的费用为0.0003美元
局限性:
- 无对话记忆
- 无情绪检测
- 无个性化设置
- 无成本优化
请参阅： examples/basic-bot/
高级机器人（企业版）
使用TRACE同理心框架的生产级AI。
能力:
- 多回合上下文对话
- 情绪检测与移情建模
- 通过缓存降低80%的成本
- \<2秒响应时间
- 类人对话模式
- 质量保证和错误检测
联系获取访问权限: w3j.btc@gmail.com
部署
Docker（推荐）
docker-compose up -d手动部署
看 部署.md 有关部署到以下位置的详细说明：
- AWS EC2
- 谷歌云运行
- 数字海洋
- Heroku
- 铁路
用例
- 客户支持：自动化常见问题解答和常见查询
- 潜在客户开发：在人工交接之前确定潜在客户
- 预约：通过WhatsApp安排会议
- 订单更新：自动发送状态更新
- 社区管理：适度并与团体互动
演出
基本机器人（开源）
- 响应时间：3-5秒
- 每条消息的成本：0.0003美元
- 吞吐量：约30条消息/分钟
- 对话质量：基本
企业机器人（联系访问）
- 响应时间：\<2秒
- 每条消息的成本：0.00006美元（减少80%）
- 吞吐量：无限制
- 对话质量：具有同理心的人性化
限制和免责声明
技术限制
- 使用WhatsApp网络（非官方API）
- 需要手机保持互联网连接
- 根据WhatsApp的服务条款
- 如果WhatsApp更新其协议，可能会中断
法律考虑
- 这是为了 个人/商业用途 使用您自己的WhatsApp帐户
- 请勿用于垃圾邮件或未经请求的消息
- 尊重WhatsApp 服务条款
- 考虑WhatsApp商务API的非常高的量（1000+短信/天）
生产准备就绪
开源版本是 起点，不是一个完整的解决方案：
- 无内置利率限制（账户被禁止的风险）
- 无错误恢复或重试逻辑
- 没有对话背景或记忆
- 无质量控制或响应验证
- 无分析或监控
用于生产用途，考虑内置这些功能的企业版。
贡献
欢迎投稿！拜托：
- 分叉存储库
- 创建要素分支
- 进行更改
- 提交拉取请求
路线图
开源（社区）
- \[\]消息媒体支持（图像、视频、文档）
- \[\]群聊支持
- \[\]Webhook支持实时通知
- \[\]Python SDK更易于集成
- \[\]更多AI机器人示例（OpenAI、Claude等）
企业（商业）
- \[x\] TRACE同理心框架
- \[x\] 成本优化引擎
- \[x\] 基于机器学习的质量保证
- \[x\] Google表格集成
- \[\]多租户架构
- \[\]高级分析仪表板
- \[\]团队协作功能
- \[\]人工切换工作流程
常见问题解答
Q： 这合法吗？\ A： 是的，只要您将其与自己的WhatsApp帐户一起使用并遵守他们的服务条款。不要发垃圾邮件。
Q： 我的账号会被封禁吗？\ A： 如果你遵循最佳实践（合理的音量、没有垃圾邮件、真实的对话），这是不可能的。企业版包括速率限制和安全功能。
Q： 这与WhatsApp Business API有什么不同？\ A： 这使用WhatsApp Web（个人帐户）。商务API是官方的，但每年的费用为5000美元以上。这是免费的。
Q： 我可以用这个做生意吗？\ A： 是的！但考虑生产使用的企业版本（包括质量保证、成本优化等）。
Q： 如何获取TRACE框架？\ A： 联系方式w3j.btc@gmail.com获取许可选项。
Q： 我可以看看企业版的演示吗？\ A： 是的！电子邮件w3j.btc@gmail.com安排演示。
支持
许可证
MIT许可证-个人和商业用途免费。
看 许可证 了解详情。
致谢
联系
作者：W3J开发\ 电子邮件: w3j.btc@gmail.com\ GitHub: @W3JDev
______________________________________________________________________
像这个项目？ 在GitHub上发布并与他人分享！
需要完整版吗？ 联系我获取企业许可、咨询或定制开发。