读取 Intercom 对话:提取支持数据 - Openclaw Skills

作者:互联网

2026-03-30

AI教程

什么是 读取 Intercom 对话?

读取 Intercom 对话技能是一个强大的数据检索模块,专为在 Openclaw Skills 生态系统中运行的开发人员和 AI 代理而设计。它提供了一种与 Intercom API 交互的标准方式,允许用户提取对话历史记录、搜索支持工单并获取特定消息详情。

通过使用此技能,团队可以弥合客户支持平台与自动化工作流程之间的差距。无论您是在构建分析仪表板还是为 AI 代理提供上下文,此技能都能确保 Intercom 数据易于访问且结构良好,可供立即使用。

下载入口:https://github.com/openclaw/skills/tree/main/skills/duyeng/intercom-conversations

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install intercom-conversations

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 intercom-conversations。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

Install

读取 Intercom 对话 应用场景

  • 自动化收集支持对话日志以进行每周情感分析。
  • 使用复杂的查询操作符在数千个工单中搜索特定的客户问题。
  • 通过 ID 获取完整的对话记录,为 AI 驱动的回复草拟提供背景信息。
  • 使用 Openclaw Skills 将支持交互数据与外部报告工具同步。
读取 Intercom 对话 工作原理
  1. 用户使用有效的 Intercom 访问令牌配置环境。
  2. 该技能接受指定所需操作的 JSON 输入:列出、查找或搜索。
  3. 它通过 Intercom API 进行身份验证,并使用提供的参数(如分页游标或过滤器)执行请求的查询。
  4. 原始 API 响应被解析为简洁的 JSON 格式,包括成功标志和请求的对话数据。
  5. 数据返回给代理或应用程序,即可进行处理或显示。

读取 Intercom 对话 配置指南

要开始使用此技能,您必须提供 Intercom 凭据并安装必要的依赖项。

设置环境变量:

export INTERCOM_ACCESS_TOKEN='your_token_here'

安装软件包:

npm install

读取 Intercom 对话 数据架构与分类体系

该技能根据请求的操作返回结构化 JSON 对象。关键数据结构包括:

操作 主要输出 元数据
conversations.list conversations (数组) next_starting_after (游标)
conversations.find conversation (对象) ok: true, action
conversations.search conversations (数组) ok: true, action

所有响应都包含一个 ok 布尔值以指示成功,并返回原始 action 以进行跟踪。

Clawhub Skill: Intercom Conversations (Read)

Clawhub loads this Node module and calls default(input).

Required env

  • INTERCOM_ACCESS_TOKEN (required)

Install

npm install

Inputs

List

{ "action": "conversations.list", "per_page": 50, "starting_after": "cursor" }

Find

{ "action": "conversations.find", "conversation_id": "123", "display_as": "plaintext" }
{ "action": "conversations.search", "query": { "operator": "AND", "value": [] }, "pagination": { "per_page": 50 } }

Outputs

All successful responses include ok: true and echo the action.

  • list/search: { ok, action, conversations, next_starting_after }
  • find: { ok, action, conversation }

Errors: { ok: false, error, supported_actions? }

Contracts / metadata

  • OpenAPI spec: openapi.yaml
  • Skill registry metadata: clawhub.skill.json