
whatsapp rest)运行。
快速入门以稳定版本为准。API 参考跟踪 GOWA 的 main 分支,包括发布后合并的变更。使用 GET /app/info 查看运行中的版本,并通过发布说明确认功能是否可用。
一台服务器可以做什么
多个账户
在同一台服务器上运行多个 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-Id4
接收事件
在你的端点
WHATSAPP_WEBHOOK 点。见 Webhooks。未包含
- 官方 SDK。 目前没有。请直接调用 HTTP API(参见客户端示例),或根据 OpenAPI 规范生成客户端。社区提供了一个 n8n 节点:
@aldinokemal2104/n8n-nodes-gowa。 - Rate limiting. GOWA 不会限制流量请求。请参阅发送限制。
