项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1550
使用教程
⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。
⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。
环境要求
- Meta(Facebook)开发者账号
- 已创建的业务应用(Business App)
- 具备 Python 基础，能读懂并运行 Flask 项目
- 本地可运行 Python 服务并能通过 ngrok 暴露公网地址
安装与启动步骤
-
1注册开发者账号
前往 Meta 开发者平台注册账号并完成必要的开发者验证，这是使用 WhatsApp Cloud API 的前提。
-
2创建业务应用
在开发者后台新建应用；若列表中没有 Business 选项，选择 Other > Next > Business 创建。
-
3选择电话号码
按 README 的 Step 1，在应用的 WhatsApp 产品下选择/绑定用于收发消息测试的电话号码。
-
4用 API 发消息
按 README 的 Step 2，先用 Cloud API 成功发出一条测试消息，验证凭证与号码配置正确。
-
5启动 Flask 应用
按 README 的 Get Started 章节在本地运行该 Flask 服务，具体启动命令以仓库 README 为准。
-
6启动 ngrok
按 README 的 Launch ngrok 小节，把本地服务暴露为公网 HTTPS 地址，供 Meta 回调访问。
-
7配置 Webhook
按 README 的 Step 3，在 Meta 后台填入回调地址与验证 Token，订阅消息事件以实时收消息。
如何确认成功
Meta 后台 Webhook 验证通过，且给绑定的测试号码发消息能收到 OpenAI 生成的自动回复。
常见问题
Q：没有 Meta 开发者账号能跑起来吗？
A：不能。README 明确要求先注册 Meta 开发者账号并创建业务应用，否则拿不到 WhatsApp Cloud API 的调用权限。
Q：创建应用时找不到 Business 选项怎么办？
A：按 README 说明，选择 Other，点击 Next，再选择 Business 即可创建业务类型应用。
Q：本地服务怎么被 Meta 回调访问？
A：README 要求用 ngrok 把本地 Flask 服务暴露成公网 HTTPS 地址，再把该地址填到 Webhook 回调 URL 中。
Q：这个项目需要 Node.js 吗？
A：不需要。README 标题即为 Pure Python，教程用纯 Python 加 Flask 完成，无需 Node.js。
注意事项
- README 节选未给出具体安装命令，实际安装与启动命令请以仓库 Get Started 章节为准。
- 需要一定的 Python 基础才能跟进本教程。
- 整个过程依赖 Meta 开发者账号、业务应用和 WhatsApp Cloud API 权限。
核心亮点
- 纯 Python 实现，上手快，无需学习 Node.js 或复杂 API
- 内置 OpenAI、Gemini 等 AI 模型集成，几行代码实现智能回复
- 提供清晰的示例和文档，支持 Webhook 与轮询两种消息接收方式
不足之处
- 依赖 WhatsApp 非官方接口，存在账号封禁风险
- 文档/社区待观察
适用场景
- 个人开发者快速搭建 AI 聊天机器人
- 小团队实现客服自动回复或通知推送
- 教育场景演示 AI 对话应用
替代项目
whatsapp-web.js、Baileys、WPPConnect
上一篇：Klee
下一篇：local-cocoa
同类项目推荐
Me_Bot
开源
用你的聊天记录，训练一个说话像你的机器人。
Build a bot that speaks like you!
mychatGPT
开源
跟你的文档聊天，秒速找到答案
GPT chat with your docs!
megahal
开源
让机器人从对话中学习，越聊越像你
MegaHAL is a learning chatterbot.
eMarket
开源
用 PHP 快速搭建带 AI 客服的免费在线商店
eMarket Online Store. It is a free online shop engine. Make the best online shop wit···
OwnGPT
开源
本地跑起专属GPT，文档问答不泄密
Create Own ChatGPT with your documents using streamlit UI on your own device using G···
alts
开源
完全离线的语音助手，保护隐私不联网
100% free, local & offline voice assistant with speech recognition
pyRobBot
开源
让 GPT 开口说话，还能联网查最新消息
Chat with GPT LLMs over voice, UI & terminal, all with access to the internet. Power···
NachoBot
开源
一个能陪你聊天、角色扮演、盯B站的笨蛋机器人
基于Maibot核心修改而成的多功能笨蛋机器人
deprecated-google-gemini-ui
开源
快速搭一个Gemini聊天界面，学API集成
Basic UI to chat with Google Gemini AI