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 簽章驗證，防止未經授權的訊息注入。
• 記憶體持久化：為每位客戶維護獨立的對話歷史。