@fazer-ai/n8n-nodes-chatwoot (英语)
这是一个 N8n 社区节点,让你使用 欢呼 在您的 n8n 工作流程中.
Chatwoot是一个开源客户接触平台,帮助企业管理多个频道的客户对话. 这个节点提供了与Chatwoot API的全面整合,允许您实现客户支持工作流程自动化,管理联系人,处理对话,等等.
[TIP] 为了改进特点和最佳业绩,我们建议使用 fazer.ai的"欢呼"包括诸如Kanban板、WhatsApp与Bailes/Z-API供应商的整合,以及更多的webhook活动.
安装
跟着 安装指南 在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的"欢呼"
坎班董事会
| 运行 | 说明 |
|---|---|
| 创建 | 创建新的 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的"欢呼"
全权证书
要认证查特伍特,你需要:
1. 查特伍特API URL
您的 Chatwoot 实例的基础 URL( 例如 ), https://app.chatwoot.com 或您自行托管的 URL .
2. 访问托肯
来自您的 Chatwoot 配置文件的个人访问文件夹 :
- 登录到您的 Chatwoot 仪表板
- 转到 配置文件设置 (单击您的外观 ~ 配置设置)
- 导航一直到 访问托肯
- 复制您的签名
代号是 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: 自动响应新对话
- 添加一个 {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}我们来试试看 触发 节点
- 选择您的账户并选择“ Conversation Created” 事件
- 连接到 a {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}我们来试试看 节点
- 将资源设置为“ 集合” , 将操作设置为“ 发送信件 ”
- 使用触发输出中的对话 ID
与联系人合作
联系人资源支持E.164电话号码格式验证(例如, +5511999999999) (中文(简体) ). 在创建或更新联系人时,也可以设置社会概况和自定义属性.
使用资源定位器
所有资源都支持两种选择模式:
- 从列表: 浏览和搜索现有项目(账户、收件箱、对话等)
- 通过身份证明: 直接输入动态工作流程的ID
自定义属性
自定义属性可以三种方式指定:
- 定义模式: 从现有的属性定义中选择
- 键派模式: 手动输入密钥值对
- JSON 模式: 为复杂结构提供 JSON 对象
AI 工具使用
此节点被启用为 n8n AI 工具(usableAsTool: true),允许与AI代理一起用于智能自动化工作流程.
资源
发展
先决条件
- 节点.js v22或以上
- pnpm 软件包管理器
设置
# 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)
许可证
作者数
卡约·奥利维拉 - 说吧 (法语)
加布里埃尔·贾布隆斯基 - 说吧 (法语)
由 Q 制作 (法语)