> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GOWA: WhatsApp REST API

> GOWA 是一个使用 Go 编写、自托管的 WhatsApp Web 多设备 API，将 REST API、Webhook、MCP 服务器和 Chatwoot 集成打包在一个二进制文件中。

![GOWA 多设备与集成架构示意图](https://mintcdn.com/gowa-docs/fmg2izHnKArFAB0e/images/GOWA-WhatsApp-Multi-Device-Integration-Overview.png?fit=max\&auto=format\&n=fmg2izHnKArFAB0e\&q=85\&s=18fadf6c0eeed1a7303404955fc903b4)

GOWA（[go-whatsapp-web-multidevice](https://github.com/aldinokemal/go-whatsapp-web-multidevice)）是一个自托管服务器。它像 WhatsApp Web 一样作为关联设备连接 WhatsApp，并通过 HTTP 提供访问。GOWA 基于 [whatsmeow](https://github.com/tulir/whatsmeow)，以单个 Go 二进制文件（`whatsapp rest`）运行。

快速入门以稳定版本为准。API 参考跟踪 GOWA 的 `main` 分支，包括发布后合并的变更。使用 `GET /app/info` 查看运行中的版本，并通过[发布说明](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases)确认功能是否可用。

> [!WARNING]
>
> GOWA 是非官方客户端，与 WhatsApp 或 Meta 无关。使用 GOWA 可能导致号码被限制或封禁。请勿发送垃圾消息或未经同意的批量消息。

## 一台服务器可以做什么

> [card] [多个账户](https://gowa-docs.mintlify.site/zh/concepts/multidevice.md)
>
> 在同一台服务器上运行多个 WhatsApp 号码。每个号码对应一个设备槽位，请求通过 `X-Device-Id` 选择设备槽位。

> [card] [REST API](https://gowa-docs.mintlify.site/zh/api-reference/introduction.md)
>
> 发送文本、媒体、投票、位置和联系人信息。管理聊天、群组、频道和个人资料。

> [card] [Webhooks](https://gowa-docs.mintlify.site/zh/concepts/webhooks.md)
>
> 通过带签名的 HTTP 回调接收消息、回执、表情回应、群组、通话和频道事件。

> [card] [定时发送](https://gowa-docs.mintlify.site/zh/examples/scheduled-sends.md)
>
> 支持的消息类型可以安排发送一次，也可以按日、周或月重复发送。

> [card] [MCP 服务器](https://gowa-docs.mintlify.site/zh/integrations/mcp.md)
>
> 在 `/mcp` 提供 Streamable HTTP MCP 端点，供 AI 代理发送和读取消息。

> [card] [Chatwoot](https://gowa-docs.mintlify.site/zh/integrations/chatwoot.md)
>
> 将 WhatsApp 对话同步到 Chatwoot 收件箱，并在 Chatwoot 中回复。

通过 `/` 访问 Web 控制台（[gowa-ui](https://github.com/aldinokemal/gowa-ui)），配对设备并手动试用 API。

有关实验性按钮和轮播卡片，请参阅[交互式消息](https://gowa-docs.mintlify.site/zh/examples/interactive-messages.md)。有关频道订阅，请参阅[WhatsApp 频道](https://gowa-docs.mintlify.site/zh/examples/newsletters.md)。有关监控，请参阅[服务器指标](https://gowa-docs.mintlify.site/zh/api-reference/metrics.md)。

## 开始使用

**1. 运行 GOWA**

使用 Docker 或发行版二进制文件启动 GOWA。请参阅[快速入门](https://gowa-docs.mintlify.site/zh/quickstart.md)。

**2. 创建设备并配对**

`POST /devices`, 然后扫描二维码或使用配对码。请参阅 [Authentication](https://gowa-docs.mintlify.site/zh/authentication.md)。

**3. 发送消息**

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

**4. 接收事件**

在你的端点`WHATSAPP_WEBHOOK` 点。见 [Webhooks](https://gowa-docs.mintlify.site/zh/concepts/webhooks.md)。

## 未包含

* **官方 SDK。** 目前没有。请直接调用 HTTP API（参见[客户端示例](https://gowa-docs.mintlify.site/zh/api-reference/sdks/go.md)），或根据 [OpenAPI 规范](https://github.com/aldinokemal/go-whatsapp-web-multidevice/blob/main/docs/openapi.yaml)生成客户端。社区提供了一个 n8n 节点：[`@aldinokemal2104/n8n-nodes-gowa`](https://www.npmjs.com/package/@aldinokemal2104/n8n-nodes-gowa)。
* **Rate limiting.** GOWA 不会限制流量请求。请参阅[发送限制](https://gowa-docs.mintlify.site/zh/advanced/rate-limiting.md)。

## 支持

* [GitHub 问题](https://github.com/aldinokemal/go-whatsapp-web-multidevice/issues)
* [发布和更新日志](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases)


## Related topics

- [快速开始](https://gowa-docs.mintlify.site/zh/quickstart.md)
- [WhatsApp 频道](https://gowa-docs.mintlify.site/zh/examples/newsletters.md)
- [检查用户是否在WhatsApp](https://gowa-docs.mintlify.site/zh/api-reference/user/检查用户是否在whatsapp.md)
- [登录到 whatsapp 服务器](https://gowa-docs.mintlify.site/zh/api-reference/app/登录到-whatsapp-服务器.md)
- [重新连接到 whatsapp 服务器](https://gowa-docs.mintlify.site/zh/api-reference/app/重新连接到-whatsapp-服务器.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.