Intercom

核心用法

Intercom Support Skill 通过 ClawLink 代理层与 Intercom API v2.17 对接，提供完整的客服运营管理能力。用户无需自行配置 API 密钥，通过 OAuth 授权即可完成三方连接。主要功能覆盖四大领域：

1. 对话与客户管理

• 支持对话的创建、搜索、回复、关闭/重开、分配等全生命周期操作
• 客户（Contact）与公司（Company）的 CRUD 管理，支持标签、订阅、备注等扩展属性
• 访客（Visitor）的识别与清理

2. 工单系统（Tickets）

• 工单创建、更新、搜索及异步队列处理
• 自定义工单类型（Ticket Types）与状态流（Ticket States）管理
• 支持工单标签与回复

3. 知识库与内容管理

• Help Center 文章、合集（Collections）、版块（Sections）的完整管理
• 内部文章（Internal Articles）与外部页面（External Pages）的维护
• 内容导入源（Content Import Sources）配置

4. 数据与自动化

• 数据属性（Data Attributes）与事件（Events）追踪
• 宏（Macros）、细分（Segments）、订阅类型管理
• 数据导出（Data Exports）与通话记录（Calls/Transcripts）

显著优点

• 零配置接入：ClawLink 托管 OAuth 流程，无需处理令牌存储与刷新
• 权限最小化：访问范围严格限定于已连接的 Intercom 工作区
• 操作安全：所有写入操作强制要求用户显式确认，高风险操作（删除、归档）额外标记
• 功能全面：覆盖 Intercom 官方 API 的绝大多数功能点，超过 100 个工具方法
• 实时发现：支持通过 clawlink_list_tools 动态获取当前可用的工具目录

潜在局限

• 依赖 ClawLink 生态：必须通过 ClawLink 插件才能使用，无法直接配置 Intercom API 密钥
• 网络耦合：所有请求经 ClawLink 代理，存在额外的网络跳数与潜在单点依赖
• API 限制继承：受 Intercom 原生限制（如事件查询 90 天、公司滚动 API 10,000 条上限）
• 权限继承：管理员操作需源 Intercom 账户具备对应权限，权限不足时无法降级执行

适合人群

• 已使用 OpenClaw + ClawLink 技术栈的客服团队
• 希望通过自然语言指令批量操作 Intercom 数据的管理员
• 需要跨系统（如结合 Jotform、Monday、Slack）构建自动化工作流的用户
• 缺乏开发资源、不愿维护 API 集成的中小型 SaaS 企业

常规风险

| 风险类别 | 说明 | 缓解措施 |

|---------|------|---------|

| 误操作风险 | 对话关闭/分配、客户删除等操作直接影响线上客户 | 强制确认流程 + 预览机制 |

| 数据泄露 | ClawLink 托管 OAuth 令牌，存在第三方托管风险 | 验证 ClawLink 安全认证状态 |

| 服务可用性 | ClawLink 或 Intercom 服务中断影响功能 | 内置重试与错误状态反馈 |

| 权限失控 | 高权限账户被滥用执行批量操作 | 按角色限制操作范围，审计日志记录 |

| 状态不同步 | Intercom 状态字段（state/open）可能不一致 | 执行前重新获取（re-fetch）验证 |

核心用法

Intercom Support Skill 是一套完整的客户支持工作流自动化解决方案，通过 ClawLink 代理与 Intercom API v2.17 深度集成。用户无需自行配置 API 密钥，仅需三步即可完成部署：安装 ClawLink 插件、配对设备、连接 Intercom 工作空间。

该技能覆盖客户支持的核心场景：对话管理（创建、回复、分配、关闭/重启对话）、联系人全生命周期管理（创建、更新、归档、合并、标签订阅管理）、企业客户管理（公司信息维护、关联联系人）、工单系统（创建、搜索、状态流转、自定义字段）、知识库运营（文章/集合/版块创建与维护、内部文档管理）以及团队管理（管理员状态、团队分配、活动日志）。所有操作通过统一的 clawlink_call_tool 命令调用，支持参数化查询和批量处理。

显著优点

零凭证架构：采用 OAuth 2.0 授权流程，API 令牌由 ClawLink 安全托管并自动注入，彻底消除密钥泄露风险。操作安全隔离：明确区分读写权限，所有写操作（回复、关闭、删除、分配）强制要求用户显式确认，破坏性操作标记为高影响级别。功能覆盖全面：100+ 个工具函数覆盖 Intercom 全 API 能力，从基础对话到高级数据分析（事件追踪、自定义属性、数据导出）一应俱全。工作流自动化：支持宏命令、批量标签管理、异步工单创建、Fin AI 通话分析等高级功能，可构建复杂支持流程。

潜在缺点与局限性

外部依赖锁定：功能完全依赖 ClawLink 服务可用性，若 ClawLink 出现故障或停止运营，技能将失效。网络延迟风险：所有 API 调用经 ClawLink 代理转发，相比直连增加一层网络跳数，高并发场景下延迟累积明显。数据主权顾虑：OAuth 令牌和用户数据流经第三方平台，对数据合规要求严格的行业（金融、医疗）需额外评估。来源可信度限制：作者为个人开发者（T3 级别），缺乏组织背书，企业级部署需自行安全审计。版本维护不确定性：开源许可证为 MIT-0，无商业支持承诺，长期维护依赖社区活跃度。

适合的目标群体

中小型企业客服团队：希望快速部署专业客户支持系统，但无力承担自研成本的团队。SaaS 产品运营者：需将客户支持、产品反馈、用户教育整合到统一平台的产品驱动型公司。远程客服管理者：依赖对话分配、团队绩效追踪、SLA 监控的分布式客服管理者。内容运营团队：需要频繁更新帮助中心、维护知识库、管理内部文档的运营人员。技术型支持工程师：熟悉命令行操作，希望通过脚本自动化批量处理工单、导出数据的工程师。

使用风险与注意事项

性能风险：Intercom API 存在速率限制（429 错误），批量操作需设计退避重试机制；对话历史分页查询需遍历游标，大数据量下耗时较长。数据一致性风险：对话状态字段（state 与 open）可能不同步，关键操作前需重新获取；附件 URL 短期失效，需及时下载。权限配置风险：alsoAllow 配置项开放 ClawLink 插件权限，需定期检查授权插件列表，防止权限扩散。供应链风险：ClawLink 作为第三方代理，理论上具备访问用户数据的权限，建议审查其隐私政策并最小化 Intercom 工作空间权限配置。业务连续性风险：建议定期导出关键数据（对话记录、联系人信息），建立技能不可用时的应急流程。