Whatsapp Agent

🚀 WhatsApp エージェント

このエージェントは、WhatsApp MCPサーバーを通じて、ユーザーの代わりに様々な操作を行うことができる代理プログラムです。

✨ 主な機能

このエージェントは、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との最新のやり取り情報を取得してください。