Repolode
aldinokemal

aldinokemal/go-whatsapp-web-multidevice

GoWA 是用 Go 编写的自托管 WhatsApp REST API,支持多账号、Webhook、MCP 和 Chatwoot 集成。

可替代:Twilio

Star
4,942
Fork
1,199
未关闭 Issue
47
最近提交
13小时前

这是什么?

GoWA 基于 WhatsApp Web 的多设备协议封装出 HTTP REST API,开发者可以通过普通的 HTTP 请求发送消息、管理群组,并接收 WhatsApp 账号产生的事件。单个服务实例可同时连接和管理多个账号,设备相关接口通过 X-Device-Id 请求头或 device_id 参数指定目标设备。

发送端支持文本、媒体、贴纸、投票、按日/周/月重复的定时发送以及隐式 @ 提及。接收的事件会以 HMAC-SHA-256 签名的方式推送到 Webhook 地址,可按事件类型,或按会话和发送者 JID 进行过滤。服务还在 /mcp 提供 MCP 接口,方便 AI 智能体调用 WhatsApp 操作;同时可选集成 Chatwoot,把会话转入客服收件箱。

项目使用 Go 编写,提供二进制文件、Docker 镜像和 n8n 社区节点。媒体处理依赖 FFmpeg 和 libwebp,支持 Linux、macOS 和 Windows(推荐 WSL),并提供纯 Go 编译选项,便于在树莓派等 ARM 设备上运行。

核心功能

  • 01通过 HTTP API 发送文本、媒体、贴纸、投票等 WhatsApp 消息。
  • 02单个服务实例可管理多个 WhatsApp 账号,并按设备隔离接口调用。
  • 03将接收事件推送到 Webhook,支持 HMAC-SHA-256 签名和事件或 JID 过滤。
  • 04支持一次性或按日、周、月重复的定时发送。
  • 05通过 MCP 接口让 AI 智能体调用 WhatsApp 操作。
  • 06集成 Chatwoot,将会话转入客服收件箱。

适用场景

  • 基于 WhatsApp 账号搭建聊天机器人或客户通知流程。
  • 通过 REST API 或 n8n 社区节点,把 WhatsApp 接入自动化工具。
  • 借助 MCP 让 AI 智能体读取会话并发送消息。
  • 为需要多个账号的小团队自托管 WhatsApp 网关。

快速上手

  1. 1

    从最新发布页面下载二进制文件

  2. 2

    启动 REST API 和 MCP 服务器

    ./whatsapp rest

使用前须知

  • Web 控制面板在启动时从另一个仓库下载,因此离线环境需要额外配置。
  • 多个主要版本改变了程序的启动方式和配置方法,较旧的教程可能无法使用。

标签

常见问题

go-whatsapp-web-multidevice 是什么?
GoWA 是用 Go 编写的自托管 WhatsApp REST API,支持多账号、Webhook、MCP 和 Chatwoot 集成。 GoWA 基于 WhatsApp Web 的多设备协议封装出 HTTP REST API,开发者可以通过普通的 HTTP 请求发送消息、管理群组,并接收 WhatsApp 账号产生的事件。单个服务实例可同时连接和管理多个账号,设备相关接口通过 X-Device-Id 请求头或 device_id 参数指定目标设备。
go-whatsapp-web-multidevice 可以免费使用吗?用的什么许可证?
go-whatsapp-web-multidevice 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
go-whatsapp-web-multidevice 还在维护吗?
活跃维护中。go-whatsapp-web-multidevice 最近一次提交是在 2026年10月21日。
go-whatsapp-web-multidevice 适合用来做什么?
基于 WhatsApp 账号搭建聊天机器人或客户通知流程。 通过 REST API 或 n8n 社区节点,把 WhatsApp 接入自动化工具。 借助 MCP 让 AI 智能体读取会话并发送消息。 为需要多个账号的小团队自托管 WhatsApp 网关。
go-whatsapp-web-multidevice 怎么安装和运行?
从最新发布页面下载二进制文件 启动 REST API 和 MCP 服务器: ./whatsapp rest
在哪里获取 go-whatsapp-web-multidevice?
源代码和安装说明在 GitHub 上:https://github.com/aldinokemal/go-whatsapp-web-multidevice

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目