Hainrixz/whatsapp-agentkit

何を解決するか

WhatsApp AgentKit は、AI ベースの WhatsApp カスタマーサービスエージェントの作成とデプロイを簡素化します。Webhook や署名、トークン、デプロイの「配管作業」を排除し、ビジネスオーナーがコードを書くのではなく、ビジネスについての質問に答えるだけで機能するエージェントを作成できるようにします。

動作方法

このプロジェクトは Claude Code を使って開発ライフサイクル全体を自動化します。セットアップスクリプトを実行した後、ユーザーは /build-agent コマンドで Claude Code と対話し、以下の5段階を実行します：

1. 環境設定：Python の確認と依存関係のインストール。
2. インタビュー：Claude がビジネス名、目的、トーン、営業時間、価格/メニューについてユーザーに質問します。
3. 構築：Claude が FastAPI サーバー、Claude API に接続された「脳」、クライアント履歴のメモリ、プロバイダアダプターを含む完全なプロジェクト構造を生成します。
4. テスト：ユーザーはローカル端末のチャットシミュレータを使ってエージェントをテストします。
5. デプロイ：GitHub と Railway でのホスティング手順をガイドします。

2 種類の WhatsApp 接続方法をサポート：Zernio（簡略化されたラッパー）と Meta Cloud API（公式の直接アクセス）。重複メッセージやタイムアウトを防ぐために、即時 Webhook 応答パターンとイベントの重複排除を実装しています。

対象ユーザー

プログラミングの深い知識がなくても、WhatsApp で FAQ 対応、予約、リード資格付けを処理できる AI エージェントを必要とするビジネスオーナーや開発者（特に LATAM 市場をターゲット）。

特徴

• ノーコードセットアップ：Claude Code との自然言語インタビューを通じてエージェントが構築されます。
• プロバイダの柔軟性：パターンアダプターを使って Zernio と Meta Cloud API の間で簡単に切り替え可能。
• 信頼性の高いメッセージング：イベント ID の重複排除と非同期処理により、重複応答を防止。
• セキュアな Webhook：HMAC-SHA256 署名検証を実装し、不正なメッセージの挿入を防止。
• メモリの永続化：各顧客の会話履歴を個別に保持。