用途：这是一个最小的 Intercom 集成入门示例，用于在新接入 Intercom 时验证凭据是否可用，并在编写正式业务代码前先跑通一次端到端往返流程，理解联系人、会话、消息与标签之间的关系。
主要能力：覆盖 Intercom 核心数据模型（用户与潜在客户形式的联系人、会话、消息、标签），演示五个步骤——创建联系人、搜索联系人、发送消息（管理员到联系人）、创建会话、为联系人打标签。除第一步给完整代码外，其余步骤形态一致，均为 client.<resource>.<verb>(...)。参考文档另含完整数据模型对照表（Contact、Conversation、Message、Tag、Company、Admin 及关键字段）。
使用方式：前置条件为已完成 intercom-install-auth 设置、在项目中安装 intercom-client（npm install intercom-client），并在环境变量中导出有效的 INTERCOM_ACCESS_TOKEN，即 export INTERCOM_ACCESS_TOKEN。SDK 从该令牌读取身份，无需单独登录调用。示例中通过 new IntercomClient({ token: process.env.INTERCOM_ACCESS_TOKEN! }) 初始化客户端，然后调用 client.contacts.create({ role: "user", externalId: "user-12345", email: "jane@example.com", name: "Jane Smith" }) 创建联系人。运行脚本会输出已创建联系人对象（id、role、email、external_id、custom_attributes 和时间戳）以及各操作的确认日志，并给出已认证管理员名称与工作区联系人和会话数量；结果仅存在于内存与日志，不写入磁盘。
适用场景：新接入 Intercom 集成时验证环境、测试安装配置、在构建实际功能前熟悉 API 实体关系。
限制与错误处理：常见错误包括 not_found (404) 无效 ID、parameter_invalid 缺少必填字段、conflict (409) external_id 重复、unauthorized (401) 令牌无效；对应处理为核对 ID、查阅文档确认必填参数、使用唯一标识符、重新生成访问令牌（重跑 intercom-install-auth）。后续可参考 intercom-local-dev-loop 搭建本地开发流程。具体收费、价格与平台细节暂未提供。