---

name: intercom-automation description: "通过 Rube MCP (Composio) 自动化 Intercom 任务：对话、联系人、公司、细分群组、管理员。始终先搜索工具以获取当前 schema。" risk: unknown source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Intercom 自动化

通过 Composio 的 Intercom 工具包经由 Rube MCP 自动化 Intercom 操作。

前置条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 建立活跃的 Intercom 连接，工具包为 intercom
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 响应正常以验证 Rube MCP 可用
2. 使用工具包 intercom 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接状态不是 ACTIVE，按照返回的认证链接完成 Intercom OAuth
4. 确认连接状态显示 ACTIVE 后再运行任何工作流

核心工作流

1. 管理对话

使用场景：用户想要创建、列出、搜索或管理客服对话

工具调用顺序：

1. INTERCOM_LIST_ALL_ADMINS - 获取管理员 ID 用于分配 [前置条件]
2. INTERCOM_LIST_CONVERSATIONS - 列出所有对话 [可选]
3. INTERCOM_SEARCH_CONVERSATIONS - 使用过滤器搜索 [可选]
4. INTERCOM_GET_CONVERSATION - 获取对话详情 [可选]
5. INTERCOM_CREATE_CONVERSATION - 创建新对话 [可选]

关键参数：

• from：包含 type（'user'/'lead'）和 id 的对象，用于指定对话创建者
• body：消息正文（支持 HTML）
• id：对话 ID，用于检索
• query：搜索查询对象，包含 field、operator、value

注意事项：

• CREATE_CONVERSATION 的 from 字段需要联系人（user/lead），不能是管理员
• 对话正文支持 HTML；纯文本会自动包裹在 <p> 标签中
• 搜索查询使用结构化过滤对象，不是自由文本搜索
• 对话 ID 是数字字符串

2. 回复和管理对话状态

使用场景：用户想要回复、关闭、重新打开或分配对话

工具调用顺序：

1. INTERCOM_GET_CONVERSATION - 获取当前状态 [前置条件]
2. INTERCOM_REPLY_TO_CONVERSATION - 添加回复 [可选]
3. INTERCOM_ASSIGN_CONVERSATION - 分配给管理员/团队 [可选]
4. INTERCOM_CLOSE_CONVERSATION - 关闭对话 [可选]
5. INTERCOM_REOPEN_CONVERSATION - 重新打开已关闭的对话 [可选]

关键参数：

• conversation_id / id：对话 ID
• body：回复消息正文（支持 HTML）
• type：回复类型（'admin' 或 'user'）
• admin_id：管理员 ID，用于管理员回复、分配和关闭/重新打开
• assignee_id：管理员或团队 ID，用于分配
• message_type：'comment'（默认）或 'note'（内部备注）

注意事项：

• 管理员回复、关闭、重新打开和分配操作都需要 admin_id
• 始终先通过 LIST_ALL_ADMINS 或 IDENTIFY_AN_ADMIN 获取管理员 ID
• 重试时可能出现重复发送；需实现幂等性检查
• 内部备注使用 message_type: 'note'；仅工作区成员可见
• 关闭操作需要 admin_id 和可选的正文消息

3. 管理联系人

使用场景：用户想要搜索、查看或管理联系人（用户和潜在客户）

工具调用顺序：

1. INTERCOM_SEARCH_CONTACTS - 使用过滤器搜索联系人 [必需]
2. INTERCOM_GET_A_CONTACT - 获取特定联系人 [可选]
3. INTERCOM_SHOW_CONTACT_BY_EXTERNAL_ID - 通过外部 ID 查找 [可选]
4. INTERCOM_LIST_CONTACTS - 列出所有联系人 [可选]
5. INTERCOM_LIST_TAGS_ATTACHED_TO_A_CONTACT - 获取联系人标签 [可选]
6. INTERCOM_LIST_ATTACHED_SEGMENTS_FOR_CONTACT - 获取联系人细分群组 [可选]
7. INTERCOM_DETACH_A_CONTACT - 从公司移除联系人 [可选]

关键参数：

• contact_id：联系人 ID，用于检索
• external_id：外部系统 ID，用于查找
• query：搜索过滤对象，包含 field、operator、value
• pagination：包含 per_page 和 starting_after 游标的对象

注意事项：

• SEARCH_CONTACTS 使用结构化查询过滤器，不是自由文本；格式：{field, operator, value}
• 支持的运算符：=、!=、>、<、~（包含）、!~（不包含）、IN、NIN
• 联系人类型为 'user'（已识别）或 'lead'（匿名）
• LIST_CONTACTS 返回分页结果；使用 starting_after 游标进行分页
• 外部 ID 区分大小写

4. 管理管理员和团队

使用场景：用户想要列出工作区管理员或识别特定管理员

工具调用顺序：

1. INTERCOM_LIST_ALL_ADMINS - 列出所有管理员和团队 [必需]
2. INTERCOM_IDENTIFY_AN_ADMIN - 获取特定管理员详情 [可选]

关键参数：

• admin_id：管理员 ID，用于识别

注意事项：

• LIST_ALL_ADMINS 返回管理员和团队
• 对话回复、分配操作需要管理员 ID