WhatsApp Python Automation

WhatsApp Python 自动化

这是一个基于 Python 的 WhatsApp 自动化工具，可通过 WhatsApp Web 界面以编程方式发送消息。

功能

• 向个人联系人或群组发送消息
• 易于设置和使用
• 使用 Python 实现自动化
• 适用于 WhatsApp Web

前提条件

• Python 3.6 或更高版本
• Go（版本 1.16 或更高）
• Chrome/Firefox 浏览器
• 已激活的 WhatsApp 帐户
• 互联网连接

Windows 特定要求

Windows 用户需要进行额外设置：

1. 安装 Go：

   • 从官方网站下载 Go
   • 运行安装程序
   • 如果未自动完成，请将 Go 添加到系统 PATH
   • 在命令提示符中运行 go version，验证安装是否成功

2. 启用 CGO：

   • WhatsApp 桥接程序需要 CGO 才能正常工作
   • 打开命令提示符并运行：go env -w CGO_ENABLED=1

3. 安装 C 编译器：

   • 下载并安装 MSYS2
   • 打开 MSYS2 并运行：pacman -S mingw-w64-x86_64-gcc
   • 将 C:\msys64\mingw64\bin 添加到系统 PATH

安装

1. 克隆此仓库：

git clone [your-repository-url]
cd whatsapp-python

2. 安装所需的依赖项：

pip install -r requirements.txt

使用方法

1. 进入项目目录：

cd whatsapp-bridge

2. 运行 WhatsApp 桥接程序：

go run main.go
#this will start whatsapp mcp server

3. 首次运行时，你需要：

   • 使用 WhatsApp 手机应用扫描二维码
   • 等待身份验证流程完成
   • 保持手机连接到互联网

4. 发送消息时，请使用以下格式：

python whatsapp_message.py
#This will run ai with our mcp connection
send message to "recipient_name" "your message"

eg: send message to chau say hi  /#remember to add contact manually to json so it will load it

工作原理

此应用的工作流程如下：

1. 自动化网页浏览器会话
2. 连接到 WhatsApp Web
3. 通过二维码进行身份验证（仅首次需要）
4. 在联系人中查找收件人
5. 使用 ollam 发送指定消息

重要说明

• 保持 WhatsApp 手机应用连接到互联网
• 发送消息时，不要关闭终端中的服务
• 确保收件人已添加到你的 WhatsApp 联系人中
• 会话需要定期重新进行身份验证，例如每 20 天一次
• Windows 用户请确保已启用 CGO 并正确配置 C 编译器

故障排除

如果遇到问题：

1. 确保互联网连接稳定
2. 确认 WhatsApp 帐户处于激活状态
3. 确保收件人姓名与联系人中显示的完全一致
4. 如果身份验证失败，请尝试重新运行脚本

Windows 特定问题

如果遇到以下错误：

• Binary was compiled with 'CGO_ENABLED=0'：确保已启用 CGO
• gcc: command not found：检查 MSYS2 安装情况和 PATH
• missing go.sum entry：在 whatsapp-bridge 目录中运行 go mod tidy

参与贡献

欢迎：

• 报告错误
• 提出功能建议
• 提交拉取请求

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

免责声明

此工具仅供教育用途。请负责任地使用，并遵守 WhatsApp 的服务条款。