跳转到主要内容
GOWA 多设备与集成架构示意图 GOWA(go-whatsapp-web-multidevice)是一个自托管服务器。它像 WhatsApp Web 一样作为关联设备连接 WhatsApp,并通过 HTTP 提供访问。GOWA 基于 whatsmeow,以单个 Go 二进制文件(whatsapp rest)运行。 快速入门以稳定版本为准。API 参考跟踪 GOWA 的 main 分支,包括发布后合并的变更。使用 GET /app/info 查看运行中的版本,并通过发布说明确认功能是否可用。
GOWA 是非官方客户端,与 WhatsApp 或 Meta 无关。使用 GOWA 可能导致号码被限制或封禁。请勿发送垃圾消息或未经同意的批量消息。

一台服务器可以做什么

多个账户

在同一台服务器上运行多个 WhatsApp 号码。每个号码对应一个设备槽位,请求通过 X-Device-Id 选择设备槽位。

REST API

发送文本、媒体、投票、位置和联系人信息。管理聊天、群组、频道和个人资料。

Webhooks

通过带签名的 HTTP 回调接收消息、回执、表情回应、群组、通话和频道事件。

定时发送

支持的消息类型可以安排发送一次,也可以按日、周或月重复发送。

MCP 服务器

在 /mcp 提供 Streamable HTTP MCP 端点,供 AI 代理发送和读取消息。

Chatwoot

将 WhatsApp 对话同步到 Chatwoot 收件箱,并在 Chatwoot 中回复。
通过 / 访问 Web 控制台(gowa-ui),配对设备并手动试用 API。 有关实验性按钮和轮播卡片,请参阅交互式消息。有关频道订阅,请参阅WhatsApp 频道。有关监控,请参阅服务器指标。

开始使用

1

运行 GOWA

使用 Docker 或发行版二进制文件启动 GOWA。请参阅快速入门。
2

创建设备并配对

POST /devices, 然后扫描二维码或使用配对码。请参阅 Authentication。
3

发送消息

POST /send/message with Basic Auth and X-Device-Id
4

接收事件

在你的端点WHATSAPP_WEBHOOK 点。见 Webhooks。

未包含

支持