SuperAPI AI 工具集

intercom-automation

智能体与模型

查看项目

更新于 10-15 20:33

技能介绍

用途:借助 Rube MCP 与 Composio 的 Intercom 工具包,自动化 Intercom 的会话、联系人、公司、细分和管理员相关操作。

前提条件:Rube MCP 需已连接(RUBE_SEARCH_TOOLS 可用);通过 RUBE_MANAGE_CONNECTIONS 建立状态为 ACTIVE 的 Intercom 连接(toolkit intercom)。设置方式:将 https://rube.app/mcp 添加为 MCP 服务器,无需 API 密钥;若连接非 ACTIVE,按返回的授权链接完成 Intercom OAuth。务必先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。

主要能力:

  1. 会话管理:列出/搜索/获取/创建会话;创建时 from 必须是联系人(user/lead)而非管理员,正文支持 HTML,纯文本会自动包裹 <p> 标签,搜索使用结构化过滤对象。
  2. 会话状态:回复、分配、关闭、重新打开;管理员回复、分配、关闭、重新打开均需 admin_id,需先用 LIST_ALL_ADMINS 或 IDENTIFY_AN_ADMIN 获取。内部备注用 message_type: 'note'。回复与创建非幂等,重试可能重复发送。
  3. 联系人:搜索、获取、按 external_id 查询、列表、查询标签与细分、从公司移除;搜索需结构化过滤({field, operator, value}),支持 =、!=、>、<、~、!~、IN、NIN;类型分 user 与 lead。
  4. 管理员与团队:LIST_ALL_ADMINS 返回管理员与团队(type: 'team')。
  5. 细分与计数:列出细分、查询联系人或公司所属细分、获取聚合计数(近似值)。
  6. 公司:列出公司、查询公司细分、解除联系人关联。

常用模式:搜索过滤支持单条件与 AND 组合;列表接口多为游标分页,使用 pages.next 与 pagination.starting_after;管理员 ID 需先解析再用于回复、分配和状态变更。

限制与注意事项:速率限制约每分钟 1000 次请求(因套餐而异),429 响应含速率头,应实现指数退避;会话正文为 HTML,需做净化;外部 ID 区分大小写;细分成员为计算值,变更可能不即时反映;计数为近似值;DETACH_A_CONTACT 仅解除关联,不删除联系人。