# @fazer-ai/n8n-nodes-chatwoot 中文文档

规范地址：https://npmcn.com/package/%40fazer-ai/n8n-nodes-chatwoot/

版本：2\.3\.2
npm 元数据更新时间：2026-06-09T16:26:16.002Z
中文译文更新时间：2026-11-14T12:17:14.453Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：915 kB，161 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.10
- 运行依赖：0 个
- peer 依赖：n8n-workflow \*
- 首次发布：2026-01-29T02:23:24.854Z
- 最新版本发布：2026-06-09T16:26:15.678Z
- 近 30 天下载量：5089（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 24 个）

## 中文简介

由 Fazer.ai 与 n8n 合并

## 安装

```sh
npm install @fazer-ai/n8n-nodes-chatwoot
```

也可以使用：`pnpm add @fazer-ai/n8n-nodes-chatwoot`、`yarn add @fazer-ai/n8n-nodes-chatwoot`、`bun add @fazer-ai/n8n-nodes-chatwoot`

## README

# @fazer-ai/n8n-nodes-chatwoot (英语)

[![npm version](https://img.shields.io/npm/v/@fazer-ai/n8n-nodes-chatwoot.svg)](https://www.npmjs.com/package/@fazer-ai/n8n-nodes-chatwoot) [![npm downloads](https://img.shields.io/npm/dm/@fazer-ai/n8n-nodes-chatwoot.svg)](https://www.npmjs.com/package/@fazer-ai/n8n-nodes-chatwoot)

这是一个 N8n 社区节点,让你使用 [欢呼](https://www.chatwoot.com/) 在您的 n8n 工作流程中.

Chatwoot是一个开源客户接触平台,帮助企业管理多个频道的客户对话. 这个节点提供了与Chatwoot API的全面整合,允许您实现客户支持工作流程自动化,管理联系人,处理对话,等等.

> \[TIP\] 为了改进特点和最佳业绩,我们建议使用 [fazer.ai的"欢呼"](https://github.com/fazer-ai/chatwoot)包括诸如Kanban板、WhatsApp与Bailes/Z-API供应商的整合,以及更多的webhook活动.

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

[安装](https://npmcn.com/package/%40fazer-ai/n8n-nodes-chatwoot/#readme-installation)  
[节点](https://npmcn.com/package/%40fazer-ai/n8n-nodes-chatwoot/#readme-nodes)  
[业务](https://npmcn.com/package/%40fazer-ai/n8n-nodes-chatwoot/#readme-operations)  
[全权证书](https://npmcn.com/package/%40fazer-ai/n8n-nodes-chatwoot/#readme-credentials)  
[兼容性](https://npmcn.com/package/%40fazer-ai/n8n-nodes-chatwoot/#readme-compatibility)  
[使用量](https://npmcn.com/package/%40fazer-ai/n8n-nodes-chatwoot/#readme-usage)  
[资源](https://npmcn.com/package/%40fazer-ai/n8n-nodes-chatwoot/#readme-resources)  
[发展](https://npmcn.com/package/%40fazer-ai/n8n-nodes-chatwoot/#readme-development)

## 安装

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

使用此软件包名称安装 :

```
@fazer-ai/n8n-nodes-chatwoot
```

## 节点

此软件包包括两个节点:

### {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我们来试试看

与 Chatwoot API 互动的主节点. 支持 CRUD 操作管理您的 Chatwoot 实例 .

### {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我们来试试看 触发

一个Webhook触发节点,可以监听Chatwoot事件. 在您的 Chatwoot 实例中自动注册并管理 Webhooks .

## 业务

### 账户

| 运行 | 说明 |
| --- | --- |
| 获取 | 获取关于 Chatwoot 具体账户的详细信息 |

### 联系人

| 运行 | 说明 |
| --- | --- |
| 创建 | 创建名称、电话(E.164格式)、电子邮件和自定义属性的新联系人 |
| 获取 | 获取联系信息 |
| 更新 | 更新联系方式 |
| 删除 | 删除联系人 |
| 列表 | 列出与 Pagination 的联系人 |
| 搜索 | 通过查询查找联系人 |
| 设置自定义属性 | 在联系人上设定自定义属性 |
| 销毁自定义属性 | 从联系人中删除所有自定义属性 |

### 对话

| 运行 | 说明 |
| --- | --- |
| 创建 | 为联系人创建新对话 |
| 获取 | 找个人谈谈 |
| 列表 | 列出与过滤器的对话 |
| 发送信件 | 在谈话中发送短信 |
| 发送文件 | 在对话中发送文件/附件 |
| 列出信件 | 在与 pagination 的对话中列出信件 |
| 列表附件 | 在对话框中列出附件 |
| 指定代理 | 指派一名代理来谈话 |
| 指派小组 | 派一个团队来谈话 |
| 添加标签 | 在对话中添加标签( 保留已有的) |
| 删除标签 | 从对话中删除特定标签 |
| 更新标签 | 替换对话中的所有标签 |
| 切换状态 | 变化状况(开放、待决、解决、静音) |
| 设定优先级 | 设定对话优先级 |
| 添加自定义属性 | 添加自定义属性( 保留已有) |
| 删除自定义属性 | 删除特定自定义属性 |
| 设置自定义属性 | 替换所有自定义属性 |
| 更新最后查看 | 更新上次看到的时间戳 |
| 更新存在 | 设置存在状态(关闭、打字、记录) |
| 标记未读 | 将对话标为未读 |
| 更新附件元数据 | 更新附件上的元数据(例如:转录) |

### 自定义属性

| 运行 | 说明 |
| --- | --- |
| 创建 | 为联系人、 对话或任务( QQ) 模式创建自定义属性定义 |
| 列表 | 列出所有自定义属性定义 |
| 删除 | 删除自定义属性定义 |

支持的类型:文本、数字、货币、百分比、链接、日期、列表、复选框.

### 收件箱

| 运行 | 说明 |
| --- | --- |
| 获取 | 获取关于特定收件箱的信息 |
| 列表 | 在账户中列出所有收件箱 |
| 在WhatsApp上 \\\\ \\ \\ \\ \\ \\ \\ \\ | 检查WhatsApp上是否有电话号码注册 |
| WhatsApp 断开 QQ | 断开WhatsApp收件箱 |
| WhatsApp 获取 QR 代码 QQ | 获取WhatsApp 收件箱连接的 QR 代码 |

> \* 这些行动需要 [fazer.ai的"欢呼"](https://github.com/fazer-ai/chatwoot)

### 坎班董事会

| 运行 | 说明 |
| --- | --- |
| 创建 | 创建新的 Kanban 棋盘 |
| 获取 | 找张牌来 |
| 列表 | 列表 Kanban 板块 |
| 更新 | 更新 Kanban 棋盘 |
| 删除 | 删除 Kanban 板 |
| 更新代理 | 更新指派给棋盘的代理 |
| 更新收件箱 | 更新连接到棋盘的收件箱 |

### Kanban 步骤 QQ

| 运行 | 说明 |
| --- | --- |
| 创建 | 在棋盘中创建新步( 列) |
| 列表 | 从棋盘中列出步骤 |
| 更新 | 更新一步 |
| 删除 | 删除一个步骤 |

### Kanban 任务QQ

| 运行 | 说明 |
| --- | --- |
| 创建 | 创建新任务( 有值、 自定义属性和行项) |
| 获取 | 得到一个具体的任务 |
| 列表 | 列出棋盘中的任务 |
| 更新 | 更新任务 |
| 移动 | 将任务移至另一步骤 |
| 删除 | 删除任务 |

### 坎班产品

管理用作任务行项目来源的被划板扫描的产品目录.

| 运行 | 说明 |
| --- | --- |
| 创建 | 创建产品( 名称、 描述、 单价、 存档旗) |
| 列表 | 从一个板上列出产品 |
| 更新 | 更新产品 |
| 删除 | 删除一个产品 |

### Kanban 任务产品QQ

管理一个kanban任务所附带的细列项目(数量,单价,折扣).

| 运行 | 说明 |
| --- | --- |
| 创建 | 在任务中附加产品(数量、单价、折扣百分比) |
| 列表 | 列出任务行项目 |
| 更新 | 更新任务行项目 |
| 删除 | 从任务中删除行项 |

### 标签

| 运行 | 说明 |
| --- | --- |
| 创建 | 创建新标签 |
| 列表 | 列出所有标签 |
| 更新 | 更新标签 |
| 删除 | 删除标签 |

### 简介

| 运行 | 说明 |
| --- | --- |
| 获取 | 获取当前用户配置信息 |

### 已排定的消息

| 运行 | 说明 |
| --- | --- |
| 创建 | 在对话中创建新预定的消息 |
| 获得多个 | 列出对话中所有已排定的消息 |
| 更新 | 更新已有的预定信件 |
| 删除 | 删除已排定的消息 |

### 团队

| 运行 | 说明 |
| --- | --- |
| 创建 | 创建新团队 |
| 删除 | 删除一个团队 |
| 列表 | 列出所有团队 |
| 获取团队成员 | 召集全体队员 |
| 指定代理 | 给一个团队指派一名特工 |
| 未指定代理 | 从团队中删除代理 |

## 触发事件

这个 **{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我们来试试看 触发** 节点支持以下webhook事件:

| 活动 | 说明 |
| --- | --- |
| 联系人已创建 | 创建新联系人时触发 |
| 联系人更新 | 更新联系人时触发 |
| 对话已创建 | 创建新对话时触发 |
| 状态已改变 | 当对话状态发生变化时触发 |
| 对话已更新 | 当对话更新时触发 |
| 打开对话打字 | 当有人开始打字时触发 |
| 对话打字关闭 | 当有人停止打字时触发 |
| 信件创建 | 创建信件时触发 |
| 信件已更新 | 消息更新时触发 |
| 消息来袭 QQ | 只触发来信 |
| 消息正在发送 {} | 只触发发送信件 |
| Kanban 任务创建QQ | 创建 Kanban 任务时触发 |
| Kanban 任务更新QQ | 当 Kanban 任务更新时触发 |
| Kanban 任务已删除 {} | 删除 Kanban 任务时触发 |
| 提供方事件收到QQ | 收到提供者事件时触发 |
| 已打开 Live Chat 部件 | 当用户打开直播聊天部件时触发 |

> 这些事件要求 [fazer.ai的"欢呼"](https://github.com/fazer-ai/chatwoot)

## 全权证书

要认证查特伍特,你需要:

### 1\. 查特伍特API URL

您的 Chatwoot 实例的基础 URL( 例如 ), `https://app.chatwoot.com` 或您自行托管的 URL .

### 2\. 访问托肯

来自您的 Chatwoot 配置文件的个人访问文件夹 :

1.  登录到您的 Chatwoot 仪表板
2.  转到 **配置文件设置** (单击您的外观 ~ 配置设置)
3.  导航一直到 **访问托肯**
4.  复制您的签名

代号是 `Api-Access-Token` 每个请求的标题.

### Webhook 签名验证

这个 **{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我们来试试看 触发** 节点使用HMAC-SHA256对接 `X-Chatwoot-Signature` 财务报告和审定财务报表 `X-Chatwoot-Timestamp` 用查特伍特提供的每个网页的秘密 当 Chatwoot 实例不提供秘密( 旧版本) 或测试模式时, 校验会自动跳过, 使其向后兼容 .

## 兼容性

-   **最小 n8n 版本 :** 1.0.0 (单位:千美元)
-   **试验过:** n8n 1.x 和 2.x 键
-   **Chatwoot 版本 :** 与 Chatwoot v4.x 兼容, 并随后兼容
-   **(法语) 欢呼:** Kanban、WhatsApp 供应商操作和额外的网络hook活动需要

## 使用量

### Basic Workflow: 自动响应新对话

1.  添加一个 **{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我们来试试看 触发** 节点
2.  选择您的账户并选择“ Conversation Created” 事件
3.  连接到 a **{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我们来试试看** 节点
4.  将资源设置为“ 集合” , 将操作设置为“ 发送信件 ”
5.  使用触发输出中的对话 ID

### 与联系人合作

联系人资源支持E.164电话号码格式验证(例如, `+5511999999999`) (中文(简体) ). 在创建或更新联系人时,也可以设置社会概况和自定义属性.

### 使用资源定位器

所有资源都支持两种选择模式:

-   **从列表**: 浏览和搜索现有项目(账户、收件箱、对话等)
-   **通过身份证明**: 直接输入动态工作流程的ID

### 自定义属性

自定义属性可以三种方式指定:

1.  **定义模式**: 从现有的属性定义中选择
2.  **键派模式**: 手动输入密钥值对
3.  **JSON 模式**: 为复杂结构提供 JSON 对象

### AI 工具使用

此节点被启用为 n8n AI 工具(`usableAsTool: true`),允许与AI代理一起用于智能自动化工作流程.

## 资源

-   [n8n 社区节点文档](https://docs.n8n.io/integrations/community-nodes/)
-   [Chatwoot API 文档](https://developers.chatwoot.com/api-reference/introduction)
-   [(法语) Chatwoot 仓库](https://github.com/fazer-ai/chatwoot)
-   [(法语) 网站](https://fazer.ai/)

## 发展

### 先决条件

-   节点.js v22或以上
-   pnpm 软件包管理器

### 设置

```bash
# Clone the repository
git clone https://github.com/fazer-ai/n8n-nodes-chatwoot.git
cd n8n-nodes-chatwoot

# Install dependencies
pnpm install
```

### 脚本

| 命令 | 说明 |
| --- | --- |
| `pnpm build` | 编译类型脚本源到 `dist/` |
| `pnpm lint` | 运行 ESLint |
| `pnpm lint:fix` | 使用自动修正运行 ESLint |
| `pnpm dev` | 开始开发模式 |
| `pnpm start` | 启动 Docker 开发环境 |
| `pnpm start:log` | 用日志启动 Docker 开发 |

### 项目结构

```
├── credentials/          # Credential definitions
├── nodes/Chatwoot/       # Node implementations
│   ├── actions/          # Resource operations
│   ├── methods/          # List search & load options
│   └── shared/           # Shared utilities
├── icons/                # Node icons
└── dist/                 # Build output (published)
```

## 许可证

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

## 作者数

**卡约·奥利维拉** - 说吧 [(法语)](https://fazer.ai/)

**加布里埃尔·贾布隆斯基** - 说吧 [(法语)](https://fazer.ai/)

* * *

由 Q 制作 [(法语)](https://fazer.ai/)

## 常见问题

### @fazer-ai/n8n-nodes-chatwoot 是什么？

由 Fazer\.ai 与 n8n 合并

### 如何安装 @fazer-ai/n8n-nodes-chatwoot？

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

### @fazer-ai/n8n-nodes-chatwoot 支持 TypeScript 吗？

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

### @fazer-ai/n8n-nodes-chatwoot 需要什么版本的 Node\.js？

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

### @fazer-ai/n8n-nodes-chatwoot 可以商用吗？

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

### @fazer-ai/n8n-nodes-chatwoot 的下载量有多少？

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

### @fazer-ai/n8n-nodes-chatwoot 还在维护吗？

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