aldinokemal/go-whatsapp-web-multidevice

API 开发

本页由 AI 翻译，技术细节请以原文为准。查看原文

4971 stars 1204 forks 质量 89 趋势 54MIT

Repository Install

GOWA - 支持 UI、多账户、Webhooks、MCP 和 Chatwoot 的 WhatsApp REST API。采用 Golang 构建，实现高效内存使用。

概览

您的支持有助于确保图书馆保持维护并定期更新！___ - 发布版本 - Docker Hub - GitHub 容器注册表 - n8n 套件 - 前往设置 -> 社区节点 -> 输入 @aldinokemal2104/n8n-nodes-gowa -> 安装 - v6 - 对于 REST 模式，你需要运行 REST 代替 - 例如：./WhatsApp REST 代替 ~~./whatsapp~~ - 对于 MCP 模式，你需要运行 mcp - 例如：./whatsapp mcp - v7 - 从版本 7.x 开始，我们使用 goreleaser 构建二进制文件，因此你可以从 release 下载二进制文件 - v8 - ：你现在可以在单一服务器实例中同时连接和管理多个 WhatsApp 账户 - ：在 /devices 下新增多个端点以管理多个设备 - ：所有设备范围的 REST API 调用现在都需要以下之一： - X-Device-Id 头部，或者 - device_id 查询参数 - 如果只有一个设备注册，它将作为默认参数使用 - ：连接到 /ws？

概述（AI 翻译）

Go WhatsApp — 专为高效内存使用而打造

如果你用这个工具赚钱，考虑通过成为Patreon会员来支持其开发！

您的支持有助于确保项目得以维护并定期更新！

ARM、AMD64 和 MCP 支持

下载：

发布
Docker Hub
GitHub 容器注册表

n8n 社区节点

N8N封装
进入社区节点→设置，输入@aldinokemal2104/n8n-nodes-gowa，然后选择安装。

打破变革

v6
REST 模式需要 rest 代替。
示例：用./whatsapp rest代替./whatsapp。
需要MCP模式 mcp。
示例：./whatsapp mcp。
v7
从7.x版本开始，二进制文件使用GoReleaser构建，并可从以下平台下载最新发布。
v8
多设备支持：你现在可以在一个账户中同时连接和管理多个WhatsApp账户服务器实例。
新的设备管理API：新端点在/devices下管理多个设备。
设备范围要求：所有设备范围的REST API调用现在都要求以下其中之一：
[X-Device-Id 头部，或
device_id 查询参数。

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

If you’re using this tool to generate income, consider supporting its development by becoming a Patreon member!

Your support helps ensure the project stays maintained and receives regular updates!

ARM, AMD64, and MCP Support

Download:

n8n Community Node

n8n package
Go to Settings → Community Nodes, enter @aldinokemal2104/n8n-nodes-gowa, and select Install.

Breaking Changes

v6
- REST mode requires rest instead of ``.
  - Example: ./whatsapp rest instead of ./whatsapp.
- MCP mode required mcp.
  - Example: ./whatsapp mcp.
v7
- Starting with version 7.x, binaries are built with GoReleaser and can be downloaded from the latest release.
v8
- Multi-device support: You can now connect and manage multiple WhatsApp accounts simultaneously in a single server instance.
- New Device Management API: New endpoints under /devices manage multiple devices.
- Device scoping required: All device-scoped REST API calls now require either:
  - X-Device-Id header, or
  - device_id query parameter.
  - If only one device is registered, it is used as the default.
- WebSocket device scoping: Connect to /ws?device_id= to scope the WebSocket connection to a specific device.
- Remote UI support: CORS allows the Authorization and X-Device-Id headers, so a standalone web UI (for example, gowa-ui) hosted on another origin can call the API directly. GET /app/info exposes the version and media size limits. Because browsers cannot set headers on WebSocket connections, pass /ws?device_id=&authorization= when Basic Auth is enabled

在 GitHub 查看完整 README

安装

docker run --detach \

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "whatsapp": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Basic dXNlcjpzZWNyZXQ=",
        "X-Device-Id": "628123456789"
      }
    }
  }
}