Helpscout客服对接

技能简介

该技能连接Helpscout客服平台，支持从指定收件箱获取客户对话记录，并可发送客户可见的回复或内部备注，方便在OpenClaw环境中处理客户支持事务。

业务背景

该技能将 Helpscout 客服能力嵌入 OpenClaw 工作流，使业务团队在同一环境内完成客户对话检索与回复，避免多系统切换。支持按状态、负责人、标签等多维度筛选，配合排序功能快速定位高优先级工单，缩短响应周期。

落地案例：客服主管每日晨会前调用技能，按「pending」状态拉取昨夜积压对话，按修改时间排序后分配至对应负责人；一线客服处理投诉时，直接发送客户可见的邮件回复，同时添加内部备注同步协作信息，无需登录 Helpscout 网页端即可完成闭环。

能做什么

• 从多个Helpscout收件箱批量获取对话
• 发送客户可见的邮件回复或仅团队可见的内部备注
• 按状态、文件夹、负责人、客户、标签等条件筛选对话
• 按修改时间、创建时间等字段排序结果
• 在响应中嵌入完整的对话线程数据
• 使用API密钥和App Secret进行安全认证

使用说明

安装与配置

1. 登录Helpscout账户，进入Manage > Apps，获取API Key和App Secret
2. 通过Helpscout API文档查询需要接入的Inbox IDs
3. 执行以下命令保存凭证（替换为实际值）：

   cat ~/.openclaw/openclaw.json | jq '.skills.entries.helpscout = {
     enabled: true,
     env: {
       API_KEY: "your-api-key",
       APP_SECRET: "your-app-secret",
       INBOX_IDS: ["inbox-id-1", "inbox-id-2"]
     }
   }' | openclaw gateway config.apply

4. 验证配置：openclaw gateway config.get

基础调用

const { fetchAllInboxes } = require('./index.js');
const results = await fetchAllInboxes(); // 获取所有活跃对话

高级筛选

const { fetchConversations } = require('./index.js');
// 获取已关闭对话
const closed = await fetchConversations(321755, { status: 'closed', sortField: 'modifiedAt' });
// 按负责人筛选
const assigned = await fetchConversations(321755, { assignedTo: 782728, status: 'active' });
// 嵌入线程数据
const withThreads = await fetchConversations(321755, { embed: 'threads', status: 'active' });

发送回复

const { sendReply, createNote } = require('./index.js');
// 发送客户可见回复（会触发邮件）
await sendReply(3227506031, {
  text: '感谢您的来信，问题已处理。',
  inboxId: 321755
});
// 发送不通知客户的回复
await sendReply(3227506031, { text: '草稿内容', customerId: 856475517, imported: true });
// 回复并关闭对话
await sendReply(3227506031, { text: '已完成', inboxId: 321755, status: 'closed' });
// 添加内部备注
await createNote(3227506031, '内部记录：客户电话确认问题解决');

输入与输出

见下方输入与输出表格。

风险提示

• API密钥和App Secret需妥善保管，避免泄露导致账户风险
• 配置文件中包含敏感信息，请勿提交到代码仓库
• 发送回复前请确认imported参数设置，避免误发邮件给客户
• 网络异常或凭证错误时，技能会返回错误信息，需做好容错处理
• 频繁调用可能触发Helpscout API速率限制

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/fabiensebban/helpscout/SKILL.md
来源类型：GitHub仓库