Intercom Automation 通过 Rube MCP 接入 Composio 的 Intercom 工具包，用于自动化 Intercom 中的常见操作。
用途 该技能面向需要以程序化方式操作 Intercom 的场景，包括管理支持会话、联系人、公司、细分群组和管理员。它把 Intercom 的各类操作封装为可通过 MCP 调用的工具，适合在智能体或自动化流程中集成 Intercom 的客服与客户数据管理能力。
前置条件
- 必须已连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）。
- 需通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Intercom 连接，工具包为 intercom。
- 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。
设置方式
- 获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥，添加端点即可使用。
- 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
- 调用 RUBE_MANAGE_CONNECTIONS，工具包为 intercom。
- 若连接不是 ACTIVE，按返回的授权链接完成 Intercom OAuth。
- 确认连接状态为 ACTIVE 后再运行任何工作流。
主要能力
- 管理会话：列出、搜索、获取详情、创建会话。创建会话时 from 字段需为联系人（user/lead），而非管理员；会话正文支持 HTML，纯文本会自动包裹在 <p> 标签中；搜索使用结构化过滤对象，而非自由文本；会话 ID 为数字字符串。
- 回复与管理会话状态：回复、分配、关闭、重开会话。管理员回复、关闭、重开和分配操作均需要 admin_id；应先通过 LIST_ALL_ADMINS 或 IDENTIFY_AN_ADMIN 获取管理员 ID；内部备注使用 message_type: 'note'，仅工作区成员可见；重试可能导致重复发送，需实现幂等检查。
- 管理联系人：搜索、查看、按外部 ID 查找、列出联系人、查看联系人标签与细分群组、将联系人从公司中分离。搜索使用结构化查询过滤器，支持 =、!=、>、<、~（包含）、!~（不包含）、IN、NIN 等操作符；联系人类型为 user（已识别）或 lead（匿名）；列表结果分页，使用 starting_after 游标；外部 ID 区分大小写。
- 管理管理员与团队：列出所有管理员和团队，识别特定管理员。LIST_ALL_ADMINS 同时返回管理员和团队，团队以 type: 'team' 出现；管理员 ID 是会话回复、分配、关闭和重开的必需项。
- 查看细分群组与计数：列出细分群组、查看联系人或公司所属细分群组、获取聚合计数。GET_COUNTS 返回近似计数而非精确数字；细分群组成员关系为计算得出，变更可能不会立即反映。
- 管理公司：列出公司、查看公司细分群组、将联系人从公司中分离。公司与联系人的关系通过联系人端点管理；DETACH_A_CONTACT 移除的是联系人与公司的关联，而非联系人本身。
使用方式 通过 MCP 工具调用执行。常见模式包括：使用结构化搜索过滤器（单条件或多条件 AND 组合）；使用游标分页（检查 pages.next 中的 starting_after 游标，直到 pages.next 为 null）；先解析管理员 ID（调用 LIST_ALL_ADMINS，按名称或邮箱查找，再使用 admin.id）。
适用场景 适合需要自动化 Intercom 客服会话处理、联系人查询与管理、公司关系维护、细分群组查看以及管理员信息获取的流程。
限制与注意事项
- 管理员 ID 在回复（以管理员身份）、分配、关闭、重开时必需，需先解析。
- 会话正文为 HTML，纯文本会自动包裹段落标签，需对 HTML 输入做清理以避免渲染问题。
- 回复和会话创建不具备幂等性，重试或超时可能导致重复发送，需跟踪消息 ID。
- 默认速率限制约为每分钟 1000 次请求（因套餐而异），429 响应包含速率限制头，重试应使用指数退避。
- 搜索使用结构化过滤对象，而非自由文本。
- 计数为近似值，细分群组成员关系变更可能延迟反映。
- 外部 ID 区分大小写。
- 具体收费、价格、平台支持范围等资料暂未提供。