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 のボイスメッセージとして音声ファイルを送信します（ファイルが .ogg opus ファイルであるか、ffmpeg がインストールされている必要があります）
• download_media: WhatsApp メッセージのメディアをダウンロードし、ローカルファイルのパスを取得します

⚡クイックスタート

前提条件

• Python 3.10+
• WhatsApp MCP サーバー
• OpenAI API キー（または DeepSeek などの互換サービス）
• uv

メモ

WhatsApp MCP サーバーをセットアップするには、READMEの手順に従ってください。

インストール

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

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

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

2. 仮想環境を作成して有効化する

   uv venv
   # On macOS/Linux
   source .venv/bin/activate
   # On 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 エージェントに尋ねられる質問の例を以下に示します。

• 最近のチャットを表示してください。
• John Doe に「Meeting at 5pm.」とメッセージを送信してください。
• 過去 1 週間に John から届いたメッセージをすべて一覧表示してください。
• SF News グループで最後に送信された写真をダウンロードしてください。
• Alex という名前の連絡先を検索してください。
• +1234567890 との最後のやり取りを取得してください。