n8n个节点kapso
这是一个n8n社区节点 AI Capso -WhatsApp云API集成平台。
安装
跟随 安装指南 在n8n社区节点文档中。
npm install n8n-nodes-kapso节点
此包包括两个节点：
Kapiso节点
与Kapso的WhatsApp Cloud API交互的主要节点-发送消息、管理对话、客户等。
免触发。
一个webhook触发节点，用于监听传入的Kapso事件，如新消息、消息状态更新和对话事件。
支持的活动：
whatsapp.message.received-新收到的消息whatsapp.message.sent-消息已发送确认whatsapp.message.delivered-消息已送达whatsapp.message.read-收件人已阅读邮件whatsapp.message.failed-消息发送失败whatsapp.conversation.created-新对话已开始whatsapp.conversation.ended-对话结束whatsapp.conversation.inactive-对话变得不活跃
特征：
- 事件筛选-选择哪些事件触发工作流
- 签名验证-可选HMAC SHA256 webhook签名验证
______________________________________________________________________
运营
此节点提供 23次操作 匹配Kapso MCP服务器功能：
WhatsApp消息（4次操作）
| 操作 | 说明 |
|---|---|
| 发送文本 | 向现有对话发送短信 |
| 发送模板 | 发送带有参数的模板消息（可以开始新的对话） |
| 发送媒体 | 发送图像、视频、音频或文档 |
| 发送互动 | 使用按钮或列表发送交互式消息 |
WhatsApp模板（1个操作）
| 操作 | 说明 |
|---|---|
| 列表模板 | 列出/搜索具有参数详细信息的已批准模板 |
WhatsApp收件箱（2次操作）
| 操作 | 说明 |
|---|---|
| 查看收件箱 | 查看收件箱中的主机号，包括最后一封邮件预览和未读计数 |
| 标记为已读 | 将邮件标记为已读 |
WhatsApp对话（4次操作）
| 操作 | 说明 |
|---|---|
| 获取上下文 | 获取对话元数据和最近的消息 |
| 搜索 | 按电话、姓名、状态或时间搜索对话 |
| 搜索消息 | 搜索邮件文本 |
| 设置状态 | 将对话状态更新为活动或已结束 |
WhatsApp联系人（4次操作）
| 操作 | 说明 |
|---|---|
| 获取上下文 | 包含上次对话和最近消息的联系人摘要 |
| 搜索 | 按姓名或电话搜索联系人 |
| 添加备注 | 在联系人中添加备注，以便进行分诊和随访 |
| 更新 | 更新联系人显示名称或客户链接 |
WhatsApp配置（1次操作）
| 操作 | 说明 |
|---|---|
| 列表概述 | 列出主机号以供选择 |
客户（3次操作）
| 操作 | 说明 |
|---|---|
| 创建 | 创建新客户 |
| 列表 | 通过搜索和分页列出客户 |
| 列出配置 | 列出客户的WhatsApp配置 |
设置链接（3个操作）
| 操作 | 说明 |
|---|---|
| 生成 | 为客户WhatsApp连接生成品牌设置链接 |
| 列表 | 列出客户的设置链接，包括状态和到期时间 |
| 撤销 | 撤销活动设置链接以使入职链接无效 |
项目（1个操作）
| 操作 | 说明 |
|---|---|
| 获取信息 | 获取当前项目ID和名称 |
凭证
要使用此节点，您需要一个Kapso API密钥：
- 首选 Kapso仪表板
- 导航到项目设置→ API密钥
- 创建新的API密钥
- 在n8n Kapso凭据中使用它
响应格式
所有操作都支持两种响应格式：
- 简洁 （默认）：减少令牌使用的最小响应
- 详细的：具有稳定ID的完整响应，用于后续呼叫
使用示例
发送短信
- 将Kapso节点添加到工作流中
- 选择“WhatsApp消息”作为资源
- 选择“发送文本”作为操作
- 输入对话ID或电话号码
- 输入您的消息文本
发送模板消息
- 选择“WhatsApp消息”>“发送模板”
- 输入收件人电话号码
- 输入模板名称
- 以JSON格式提供模板参数
搜索和回复对话
- 使用“WhatsApp对话”>“搜索”查找对话
- 从响应中获取对话ID
- 使用对话ID的“WhatsApp消息”>“发送文本”
为客户提供服务
- 使用“客户”>“创建”创建新客户
- 使用客户ID的“设置链接”>“生成”
- 与您的客户共享生成的URL，以连接他们的WhatsApp业务