Whatsapp Agent

🚀 WhatsApp 代理

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 點開會。"
• 列出過去一週內約翰的所有消息。
• 下載“SF 新聞”群組中最後發送的照片。
• 搜索名為亞歷克斯的聯繫人。
• 獲取與 +1234567890 的最新互動信息。