# @aldinokemal2104/n8n-nodes-gowa 中文文档

规范地址：https://npmcn.com/package/%40aldinokemal2104/n8n-nodes-gowa/

版本：3\.2\.0
npm 元数据更新时间：2026-04-02T15:53:25.570Z
中文译文更新时间：2026-11-05T21:31:43.155Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aldinokemal2104/n8n-nodes-gowa
原文对照：https://npmcn.com/package/%40aldinokemal2104/n8n-nodes-gowa/?lang=original
项目主页：https://github.com/aldinokemal/n8n-node-gowa
源码仓库：https://github.com/aldinokemal/n8n-node-gowa

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1 MB，30 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.15
- 运行依赖：0 个
- peer 依赖：n8n-workflow \*
- 首次发布：2025-07-02T06:34:21.866Z
- 最新版本发布：2026-04-02T15:53:25.335Z
- 近 30 天下载量：17499（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 8 个）

## 中文简介

go WhatsApp网络多Device API v8 的 n8n 社区节点

## 安装

```sh
npm install @aldinokemal2104/n8n-nodes-gowa
```

也可以使用：`pnpm add @aldinokemal2104/n8n-nodes-gowa`、`yarn add @aldinokemal2104/n8n-nodes-gowa`、`bun add @aldinokemal2104/n8n-nodes-gowa`

## README

# n8n-节点-高瓦

[![npm version](https://badge.fury.io/js/%40aldinokemal2104%2Fn8n-nodes-gowa.svg)](https://www.npmjs.com/package/@aldinokemal2104/n8n-nodes-gowa)

![Banner image](https://user-images.githubusercontent.com/10284570/173569848-c624317f-42b1-45a6-ab09-f0ea3c247648.png)

这是一个 N8n 社区节点 [GOWA (Go WhatsApp 网络多功能设备)](https://github.com/aldinokemal/go-whatsapp-web-multidevice) API整合.

GOWA提供由Go所写的WhatsApp Web API综合执行,支持多设备功能和广泛的WhatsApp功能.

**这个版本(3.0.0)与GOWA API v8.**

[无 8n](https://n8n.io/) 是一个 [获得公平代码许可](https://docs.n8n.io/reference/license/) 工作流程自动化平台.

[安装](https://npmcn.com/package/%40aldinokemal2104/n8n-nodes-gowa/#readme-installation)  
[业务](https://npmcn.com/package/%40aldinokemal2104/n8n-nodes-gowa/#readme-operations)  
[全权证书](https://npmcn.com/package/%40aldinokemal2104/n8n-nodes-gowa/#readme-credentials)  
[使用量](https://npmcn.com/package/%40aldinokemal2104/n8n-nodes-gowa/#readme-usage)

## 安装

### 备选案文1:从npm安装(建议)

```bash
npm install @aldinokemal2104/n8n-nodes-gowa
```

### 备选案文2:手工安装

跟着 [安装指南](https://docs.n8n.io/integrations/community-nodes/installation/) 在n8n社区节点文档中.

-   打开设置 > 社区节点 > 安装
-   输入 `@aldinokemal2104/n8n-nodes-gowa`
-   单击安装

## 业务

此节点支持以下操作:

### App 管理

-   **获取连接状态** - 检查WhatsApp客户端是否连接并登录
-   **获取设备信息** - 获取设备信息
-   **登录** - 登录带有QR代码的WhatsApp服务器
-   **登录代码** - 登录时加配对码
-   **注销** - 删除数据库并登录
-   **重新连接** - 重新连接WhatsApp Web

### 设备管理(v8)

-   **列出设备** - 列出所有具有连接状态的已注册设备
-   **添加设备** - 为多设备管理创建一个新设备槽
-   **获取设备** - 获得关于特定设备的详细资料
-   **删除设备** - 从服务器上取出设备
-   **登录设备** - 启动特定设备的 QR 码登录
-   **以代码登录设备** - 启动特定设备的配对编码登录
-   **注销设备** - 从WhatsApp登录特定设备
-   **重新连接设备** - 将特定设备重新连接到WhatsApp
-   **获取设备状态** - 获取特定设备的连接状态

### 发送信件

-   **发送文本** - 发送短信(带有可选的消失消息持续时间)
-   **发送链接** - 以可选标题发送链接
-   **发送媒体** - 发送带有可选标题的媒体文件(图像、音频、视频或任何文件)
-   **发送标签** - 发送贴纸,自动转换为WebP格式
-   **发送联系人** - 发送联系信息
-   **发送位置** - 发送位置坐标
-   **发送波尔** - 提供多种选择的民意测验
-   **发送聊天存在** - 发送打字指标(开始/停止)
-   **发送存在** - 发送存在状态(可用/无可用)

### 信件管理

-   **删除信件** - 删除信件
-   **下载媒体** - 从消息中下载媒体内容
-   **撤消信件** - 给大家留言
-   **对信件的反应** - 对信息增加情感反应
-   **更新信件** - 更新信件内容
-   **读取信件** - 将消息标为已读
-   **星报消息** - 留个口信
-   **脱星消息** - 解开一条消息

### 集团管理

-   **创建组** - 创建新的WhatsApp组
-   **添加参与者** - 增加参加团体的人数
-   **删除参与者** - 从团体中清除参与者
-   **促进参与** - 促进参与者管理
-   **取消参加人数** - 开除行政主管的参加者
-   **离开组** - 离开一组
-   **用链接加入组** - 使用邀请链接加入组
-   **获取参与者请求** - 获得参加团体申请名单
-   **核准与会请求** - 核准与会者参加小组的请求
-   **拒绝参与者请求** - 拒绝参与者加入团体的请求
-   **设定组名称** - 设定组名
-   **设定组相片** - 设定或删除组合相片
-   **设定组主题** - 设置或删除组主题/描述
-   **设定组锁定状态** - 锁定/解锁组,只有管理员才能修改组信息
-   **设置组宣告模式** - 启用/ 无法宣布模式, 只有管理员才能发送消息
-   **获取组信息** - 获取一个团体的信息
-   **获得团体参与者** - 获得团体参与者名单
-   **获取组邀请链接** - 获取或重置组邀请链接
-   **出口集团参与者** - 作为CSV的出口集团参与者
-   **从链接获取组信息** - 从邀请链接获取组信息

### 聊天管理

-   **列表聊天** - 获取所有聊天对话的列表
-   **获取聊天消息** - 从特定聊天中获取信息
-   **标签聊天** - 应用或删除聊天对话中的标签
-   **平分聊天** - 在对话列表中取消或取消聊天
-   **设置消失的计时器** - 设置或禁用正在消失的消息进行聊天

### 用户操作

-   **更改按键名称** - 更新在WhatsApp中向其他人显示的显示名称
-   **获取用户信息** - 获取用户配置信息
-   **获取神通** - 获取用户外观图像
-   **设定神通** - 设置用户外观图像
-   **获取商务简介** - 获得商业概况信息
-   **获取隐私设置** - 获取隐私设置
-   **获取我的组合** - 获取用户所在分组列表
-   **获取我的通讯** - 获得用户所遵循的通讯清单
-   **获取我的联系人** - 获取用户联系人列表
-   **检查联系人** - 检查联系人是否在WhatsApp上

### 通讯管理

-   **不跟随通讯** - 不跟随通讯

## 全权证书

这个节点需要GOWA API的证书:

1.  **主机 URL** - 您的 GOWA API 服务器的 URL( 默认 ): [http://localhost:3:00 (英语)](http://localhost:3000/)(中文(简体) )
2.  **用户名** - 基本认证用户名
3.  **密码** - 基本授权密码
4.  **设备标识** - (可选)多设备支持的默认设备标识符。 当节点级设备ID参数为空时使用.

证书使用 HTTP Basic 认证连接到您的 GOWA API 实例 .

## 使用量

1.  设置您的 GOWA API 服务器 [正式文件](https://github.com/aldinokemal/go-whatsapp-web-multidevice)
2.  在 n8n 中配置 GOWA API 证书
3.  在工作流程中添加 GOWA 节点
4.  选择想要的资源和操作
5.  配置您操作所需的参数

### 示例:发送文本信件

1.  选择 **发送** 作为资源
2.  选择 **发送文本** 作为操作
3.  输入电话号码( 有国家代码, 无 +)
4.  输入您的消息文本
5.  执行节点

### 示例: 发送媒体

1.  选择 **发送** 作为资源
2.  选择 **发送媒体** 作为操作
3.  输入电话号码( 有国家代码, 无 +)
4.  选择媒体类型(图像、音频、视频或文件)
5.  选择媒体源( 文件上传或 URL - 注意: 文件只能上传)
6.  对于文件上传:指定包含文件的二进制属性名称
7.  对于 URL: 输入媒体 URL
8.  可选添加标题
9.  执行节点

### 示例:多设备管理

1.  选择 **设备** 作为资源
2.  选择 **添加设备** 创建新设备槽
3.  使用 **登录设备** 或者说 **以代码登录设备** 要认证
4.  使用 **获取设备状态** 以检查连接状态
5.  对于app/chat/group/message/newsletter/send/user操作,您可以设定 **设备标识** 直接在节点中以动态方式覆盖每个项目的认证设备ID

### 示例:获取商务简介

1.  选择 **用户** 作为资源
2.  选择 **获取商务简介** 作为操作
3.  输入商业电话号码( 有国家代码)
4.  执行节点

### 示例: 发送聊天存在

1.  选择 **发送** 作为资源
2.  选择 **发送聊天存在** 作为操作
3.  输入电话号码
4.  选择“ 开始打字” 或“ 停止打字” 动作
5.  执行节点

## 资源

-   [n8n 社区节点文档](https://docs.n8n.io/integrations/community-nodes/)
-   [GOWA GitHub 仓库](https://github.com/aldinokemal/go-whatsapp-web-multidevice)
-   [GOWA API 文档](https://github.com/aldinokemal/go-whatsapp-web-multidevice/blob/main/docs/openapi.yaml)
-   [npm 软件包](https://www.npmjs.com/package/@aldinokemal2104/n8n-nodes-gowa)

## 许可证

[麻省理工学院](https://npmcn.com/package/%40aldinokemal2104/n8n-nodes-gowa/LICENSE.md)

## 常见问题

### @aldinokemal2104/n8n-nodes-gowa 是什么？

go WhatsApp网络多Device API v8 的 n8n 社区节点

### 如何安装 @aldinokemal2104/n8n-nodes-gowa？

在项目目录运行 npm install @aldinokemal2104/n8n-nodes-gowa，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：n8n-workflow（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @aldinokemal2104/n8n-nodes-gowa 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/aldinokemal2104\_\_n8n-nodes-gowa 是否存在。

### @aldinokemal2104/n8n-nodes-gowa 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @aldinokemal2104/n8n-nodes-gowa 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.15。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @aldinokemal2104/n8n-nodes-gowa 可以商用吗？

@aldinokemal2104/n8n-nodes-gowa 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @aldinokemal2104/n8n-nodes-gowa 的下载量有多少？

根据 npm 官方下载统计，@aldinokemal2104/n8n-nodes-gowa 在 2026/10/06 – 2026/11/04 这 30 天内被下载 17,499 次，日均约 583 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aldinokemal2104/n8n-nodes-gowa 还在维护吗？

最新版本 3\.2\.0 发布于 2026/04/02（7 个月前）；至今共发布 15 个版本，其中过去 12 个月发布了 8 个；首次发布于 2025/07/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。