用途:通过 Intercom REST API 对会话(conversations)和帮助中心(Help Center)执行写入操作,使用 curl 调用。
认证:将 Intercom Personal Access Token 存为环境变量,例如 export INTERCOM_ACCESS_TOKEN="your-token-here";所有请求需带 Intercom-Version: 2.11 请求头。可用 https://api.intercom.io/me 验证令牌。
会话写入能力:回复会话(message_type 为 comment,客户可见);添加内部备注(message_type 为 note,仅管理员可见,支持 HTML);分配会话(message_type 为 assignment,需 assignee_id);关闭(close)、暂停(snoozed,需 snoozed_until Unix 时间戳)、重开(open)。回复与备注走 /conversations/{id}/reply,其余走 /conversations/{id}/parts。
工单:可创建 tracker tickets(POST /tickets)以归组相关问题;但将工单关联到会话仅能在 UI 中完成,REST API 的关联端点会静默失败。
帮助中心:可列出全部文章(GET /articles)、获取文章详情、创建文章(POST /articles,state 为 draft 或 published,parent_type 为 collection 或 section)、更新文章(PUT /articles/{id})、列出集合(GET /help_center/collections)。建议编辑流程为:先列出并读取文章,准备合法 HTML 正文,先以 draft 更新,确认后再发布。
错误处理:401 令牌无效;403 权限不足(需写权限);404 资源不存在;422 请求体无效;429 触发限流(限值 1000/分钟),需等待重试。具体价格、平台支持与更多限制暂未提供。