用途:处理 Intercom API 的速率限制,避免高频集成触发 429 错误。
主要能力:该技能提供五种可组合的防护手段——带响应头感知的重试包装、实时监控、请求队列、请求批处理与指标输出。Intercom 按应用与工作区限制请求:私有应用与公共应用(OAuth)均为每应用每分钟 10,000 次,工作区总量为每分钟 25,000 次;搜索端点每分钟 1,000 次,滚动端点每分钟 100 次。每次响应包含 X-RateLimit-Limit、X-RateLimit-Remaining 与 X-RateLimit-Reset 头部,可用于主动限速。
使用方式:前置条件为在 INTERCOM_ACCESS_TOKEN 中配置访问令牌,请求以 Authorization: Bearer 发送;安装官方 SDK,执行 npm install intercom-client;队列节流需执行 npm install p-queue。按顺序应用防护:将每次调用包裹在带响应头感知的重试中(429 时等待至 X-RateLimit-Reset,5xx 时指数退避加抖动);使用监控在用量超过约 90% 时先暂停;通过上限约 150 req/s 的 p-queue 路由请求;用 OR 批量查询减少请求数;记录 remaining、usage_percent、ms_until_reset 等指标。完整 TypeScript 实现见 references/implementation.md。
适用场景:联系人批量查询、搜索与滚动导出等高频操作,以及多应用共享工作区限额的协调。
限制:具体完整实现需查阅其 references 文件;本文未提供价格、平台支持范围等未列明信息。