用途:管理 Intercom 会话的完整生命周期,包括创建、回复(以管理员或联系人身份)、分配给团队、关闭、暂停和打标签。会话包含线程化的“parts”,如消息、备注和分配记录。
主要能力:通过 client.conversations.* 提供七个独立操作——create 创建会话并返回 conversationId;reply 添加 part(type 为 admin 对客户可见、note 仅内部、user 为联系人回复);assign 路由到管理员或团队,也可调用 run_assignment_rules 自动路由;close/snooze/open 控制状态(snooze 使用 Unix 秒);attachTag/detachTag 打标签;find 获取状态、分配人和 conversationParts;list/search 支持 AND/OR 字段过滤、分页和排序。
使用方式:需先完成 intercom-install-auth 配置,提供 INTERCOM_ACCESS_TOKEN,并从环境变量读取,不可硬编码。示例:const client = new IntercomClient({ token: process.env.INTERCOM_ACCESS_TOKEN! }); 创建会话后,用返回的 conversationId 进行后续调用。
适用场景:构建会话管理功能、自动化回复、账单投诉处理、标签与暂停跟进、审计开放队列等。
限制:需有效的管理员 ID 和联系人 ID;对已关闭会话操作会返回 conversation_closed 错误,需先重新打开;常见错误包括 not_found、admin_not_found、parameter_invalid 等。完整代码和示例见 references/implementation.md 与 references/examples.md。