🚀 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的最新互动信息。