用途：指导从 Zendesk、Freshdesk、HelpScout 等平台迁移到 Intercom，或向 Intercom 批量导入联系人、公司、标签与帮助中心文章，并提供迁移后校验与回滚思路。
主要能力：按依赖顺序分六个阶段执行——联系人导入（用 external_id/email 先搜索再更新或创建，保证幂等，并打上 migrated_from、migration_date 自定义属性便于回滚）、公司导入（先于联系人，供联系人引用）、标签创建与应用、帮助中心文章按分类归入集合、编排执行、校验（对比实际数量与源数量，联系人与文章阈值为 95%）。联系人导入返回 { created, updated, failed, errors[] }，错误项含 contact_id、email、error；编排输出各阶段进度日志与最终耗时；校验返回 { passed, checks[] }。
使用方式：需准备带访问令牌的 Intercom 工作区、源系统导出数据（CSV 或 API）、已安装 intercom-client（npm install intercom-client）、灰度切换的功能开关及已测试的回滚方案。令牌从环境变量读取，先 export INTERCOM_ACCESS_TOKEN="your-workspace-access-token"，再 new IntercomClient({ token: process.env.INTERCOM_ACCESS_TOKEN! })。完整可运行代码在 references/implementation.md。
常见问题与限制：409 冲突（重复 external_id/email）需创建前先搜索；429 限流需批次间加延时；422 校验失败需提前校验数据格式；部分迁移可借幂等操作重跑。会话历史不支持 API 批量导入，需联系 Intercom 支持。回滚需迁移期间保持源系统在线，校验通过并并行运行两周后再下线；反查可用 custom_attributes.migration_date 分批删除。资料未说明收费、价格或平台配额等细节。