用途:通过 Intercom REST API 进行客户消息与联系人管理,适用于需要脚本化处理 Intercom 会话、联系人、公司、标签、帮助中心文章和事件的场景。资料给出的是 curl 调用示例集合。
主要能力:列出管理员;创建、获取、更新、删除、搜索联系人(支持自定义属性与多条件搜索);列出、获取、搜索会话,并回复、指派、关闭会话;创建内部备注;列出、创建标签,为联系人打标签或取消标签;列出与获取文章;创建公司、把联系人关联到公司;记录自定义事件。
使用方式:所有示例假设已设置环境变量 INTERCOM_TOKEN。基础地址为 https://api.intercom.io/,必需请求头为 Authorization: Bearer ${INTERCOM_TOKEN}、Accept: application/json、Intercom-Version: 2.14。GET 用于读取,POST 用于创建与搜索,PATCH 用于更新(非 PUT),DELETE 用于删除。部分示例先把请求体写入 /tmp/intercom_request.json,再用 curl -d @/tmp/intercom_request.json 发送。
搜索:字段操作符含 =、!=、<、>、<=、>=、IN、NIN、~、!~;查询操作符为 AND、OR;支持 pagination.per_page 等分页参数。
排错:请求失败可运行 zero doctor check-connector --env-name INTERCOM_TOKEN,或 zero doctor check-connector --url https://api.intercom.io/admins --method GET。
限制:新创建的联系人可能需数秒后才能更新或搜索;429 表示超出速率限制,私有应用与公共应用均为每分钟 10,000 次调用,工作区合计每分钟 25,000 次,可通过 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset 头观察;会话状态为 open、closed、snoozed;自定义属性需先在 Intercom 界面定义;不应在公开仓库或日志中暴露令牌。价格、套餐与平台支持等资料未提供。