用途：管理 Intercom 联系人，适合构建联系人管理功能、同步用户数据等场景。
主要能力：围绕 intercom-client SDK 提供六类操作——创建联系人（role 为 user 的已识别用户需 externalId，role 为 lead 的匿名线索）、搜索联系人（支持单条件或 AND/OR 复合查询、分页与排序）、按 contactId 更新姓名或自定义属性、将线索合并进用户（contacts.merge({ from: leadId, into: userId })，线索的会话、事件与标签转移给用户）、列出联系人所属细分、用 startingAfter 游标分页遍历全部联系人。
使用方式：先完成 intercom-install-auth 设置，并具备联系人读写权限的 API 凭证。实例化客户端一次后调用所需操作，例如： import { IntercomClient } from "intercom-client"; const client = new IntercomClient({ token: process.env.INTERCOM_ACCESS_TOKEN! }); const user = await client.contacts.create({ role: "user", externalId: "customer-9001", email: "alice@acme.com", name: "Alice Johnson", customAttributes: { plan: "enterprise" } });
返回结果：create/update 返回单个 contact 对象；search 返回 data、totalCount、pages；merge 返回存活的 user；listSegments 返回 Segment 数组；list 返回单页数据并可按 pages.next.startingAfter 继续翻页。
限制与错误：需先理解 Intercom 的 user 与 lead 模型；合并方向必须 from 为 lead、into 为 user，否则报 merge_not_possible；重复 external_id 或 email 会返回 conflict，建议创建前先搜索；私有应用超过每分钟 10000 次请求会触发 rate_limit_exceeded，需退避与批处理。完整分步代码与端到端示例见技能内 references/implementation.md 与 references/examples.md。会话管理见配套技能 intercom-core-workflow-b。