Hainrixz/whatsapp-agentkit

解决的问题

WhatsApp AgentKit 简化了 AI 驱动的 WhatsApp 客户服务代理的创建和部署。它消除了处理 Webhook、签名、令牌和部署等“管道工作”，让业务所有者只需回答关于其业务的问题，而无需编写代码，即可创建一个功能完整的代理。

工作原理

该项目使用 Claude Code 自动化整个开发生命周期。运行设置脚本后，用户通过 /build-agent 命令与 Claude Code 交互，执行五个阶段：

1. 环境设置：验证 Python 并安装依赖项。
2. 访谈：Claude 向用户询问其业务名称、目的、语气、营业时间以及价格/菜单信息。
3. 构建：Claude 生成完整的项目结构，包括 FastAPI 服务器、连接到 Claude API 的“大脑”、客户历史记录的内存，以及提供者适配器。
4. 测试：用户通过本地终端聊天模拟器测试代理。
5. 部署：引导用户通过 GitHub 和 Railway 进行托管。

支持两种 WhatsApp 连接方式：Zernio（简化封装）和 Meta Cloud API（官方直接访问）。为防止重复消息和超时，实现了即时 Webhook 响应模式和事件去重。

适用人群

希望在 WhatsApp 上处理常见问题、预约或潜在客户资格审核，但无需深入编程知识的业务所有者和开发者（特别针对拉丁美洲市场）。

主要亮点

• 无代码设置：通过与 Claude Code 的自然语言访谈构建代理。
• 提供者灵活性：使用模式适配器可轻松在 Zernio 和 Meta Cloud API 之间切换。
• 可靠的消息传递：通过事件 ID 去重和异步处理防止重复响应。
• 安全的 Webhook：实现 HMAC-SHA256 签名验证，防止未经授权的消息注入。
• 记忆持久化：为每位客户维护独立的对话历史。