用途：按 HTTP 状态码和错误类型快速诊断并修复 Intercom REST API 错误。所有 Intercom 错误返回统一信封（type、request_id、errors[].code），先读取 errors[].code，再对照错误表定位原因并应用修复。
主要能力：提供错误码与 HTTP 状态、是否可重试、处理动作的对照，包括 unauthorized(401)、forbidden(403)、not_found(404)、conflict(409)、parameter_invalid(422)、rate_limit_exceeded(429)、server_error(500+)。区分可重试错误（429、5xx 用退避重试）与不可重试的 4xx 客户端错误（应修正请求）。
使用方式：需要 INTERCOM_ACCESS_TOKEN 环境变量（Developer Hub > Your App > Authentication），以及 curl 和 jq；TypeScript 修复示例使用 intercom-client SDK（npm install intercom-client）。快速鉴权检查： curl -s https://api.intercom.io/me -H "Authorization: Bearer $INTERCOM_ACCESS_TOKEN" -H "Accept: application/json" | jq '.type' 令牌有效时返回 "admin"。诊断流程为：捕获错误（HTTP 状态与 JSON 体）、匹配 errors[].code、先确认令牌与限流、再应用修复、仅对可重试错误重试。
适用场景：调试失败的 Intercom API 请求、处理鉴权失败、重复联系人冲突、参数校验错误、限流与服务器错误。
限制：限流为每应用 10,000 请求/分钟、每工作区 25,000 请求/分钟；遇 429 需读取 X-RateLimit-Reset 并等待到该时间点再重试。持续 5xx 需携带 request_id 联系 Intercom 支持并查看状态页。完整逐码原因与修复见 references/error-reference.md，一次性健康检查脚本见 references/diagnostics.md。更深入的端到端调试可参考同包中的 intercom-debug-bundle 技能。