用途：为新建 Intercom 集成配置 API 凭据，安装官方 intercom-client TypeScript SDK 并完成认证设置。
前置条件：Node.js 18+；npm、pnpm 或 yarn；拥有 Developer Hub 访问权限的 Intercom 工作区；在应用设置的 Configure > Authentication 中获取访问令牌。
主要能力与用法：
- 安装 SDK：npm install intercom-client。该包导出 IntercomClient 以及 Intercom 命名空间下的全部 TypeScript 类型。
- 访问令牌认证（私有应用，访问自己的 Intercom 工作区）：创建客户端模块和 .env 保存令牌（将 .env 加入 .gitignore）： import { IntercomClient } from "intercom-client"; const client = new IntercomClient({ token: process.env.INTERCOM_ACCESS_TOKEN! });
- 验证连接：列出管理员确认令牌端到端认证：const admins = await client.admins.list(); console.log("Connected! Admins:", admins.admins.length);
- OAuth（公开应用，访问其他工作区）：执行 OAuth 授权→令牌交换流程，再用返回的令牌初始化客户端：const client = new IntercomClient({ token: oauthToken });
输出：intercom-client 安装到 node_modules 并写入 package.json；生成已配置的 IntercomClient 模块；.env 保存 INTERCOM_ACCESS_TOKEN（私有应用）或 INTERCOM_CLIENT_ID / INTERCOM_CLIENT_SECRET（OAuth），且已 gitignore；通过 client.admins.list() 验证连接（SDK 自动应用 API 版本 2.11）。
错误处理：unauthorized（401，令牌无效或过期，在 Developer Hub 重新生成）；forbidden（403，缺少 OAuth 范围，在应用配置中添加）；token_revoked（401，生成新访问令牌）；invalid_grant（400，OAuth 代码过期，重新发起流程）。可捕获 IntercomError 按 statusCode 分支。
限制：需 Node.js 18+ 和 Intercom 工作区；OAuth 涉及范围与版本固定细节；具体收费、价格等信息暂未提供。