Whatsapp Agent

🚀 WhatsApp エージェント

このエージェントは、WhatsApp MCPサーバーを介してWhatsAppとやり取りするプログラムです。ユーザーを代表して様々な操作を実行することができます。

✨ 主な機能

このエージェントは、WhatsApp MCPサーバーに接続します。このサーバーは以下のツールを提供します。

• 検索連絡先（search_contacts）：名前または電話番号で連絡先を検索します。
• メッセージ一覧（list_messages）：メッセージを取得し、必要に応じてフィルターとコンテキストを指定できます。
• チャット一覧（list_chats）：利用可能なチャットとそのメタデータを一覧表示します。
• チャット情報取得（get_chat）：特定のチャットの情報を取得します。
• 連絡先から直接チャット取得（get_direct_chat_by_contact）：特定の連絡先との直接のチャットを見つけます。
• 連絡先のチャット一覧（get_contact_chats）：特定の連絡先が関係するすべてのチャットを一覧表示します。
• 最新のやり取り取得（get_last_interaction）：特定の連絡先との最新のメッセージを取得します。
• メッセージコンテキスト取得（get_message_context）：特定のメッセージのコンテキスト情報を取得します。
• メッセージ送信（send_message）：指定された電話番号またはグループJIDにWhatsAppメッセージを送信します。
• ファイル送信（send_file）：指定された受信者にファイル（画像、動画、オーディオ、ドキュメント）を送信します。
• 音声メッセージ送信（send_audio_message）：オーディオファイルをWhatsAppの音声メッセージとして送信します（ファイルは.opus形式またはffmpegのインストールが必要）。
• メディアダウンロード（download_media）：WhatsAppメッセージからメディアをダウンロードし、ローカルのファイルパスを取得します。

🚀 クイックスタート

前提条件

• Python 3.10以上
• WhatsApp MCPサーバー
• OpenAI APIキー（または深度求索などの互換性のあるサービス）
• uv

⚠️ 重要提示

WhatsApp MCPサーバーを設定するには、READMEの説明に従ってください。

📦 インストール

以下の手順に従って、ローカルマシンにプロジェクトを設定します。

1. リポジトリをクローンする

   git clone https://github.com/aasherkamal216/whatsapp_agent.git
   cd whatsapp_agent
   

2. 仮想環境を作成してアクティブ化する

   uv venv
   # macOS/Linuxの場合
   source .venv/bin/activate
   # Windowsの場合
   .venv\Scripts\activate
   

3. 依存関係をインストールする

   uv sync
   

4. 環境変数を設定する

   サンプル環境ファイルをコピーし、資格情報を更新します。

   cp .env.example .env
   

   .envファイルに環境変数を追加します。

💻 使用例

基本的な使用法

Chainlitアプリケーションを実行します。

uv run chainlit run chainlit_app.py -w

このアプリケーションはhttp://localhost:8000で実行されます。

質問例

以下は、WhatsAppエージェントに問い合わせることができる質問の例です。

• 最近のチャット履歴を表示してください。
• ジョン・ドウに「午後5時に会議を開きます。」というメッセージを送信してください。
• 過去1週間のジョンのすべてのメッセージを一覧表示してください。
• 「SFニュース」グループで最後に送信された写真をダウンロードしてください。
• アレックスという名前の連絡先を検索してください。
• +1234567890との最新のやり取り情報を取得してください。