salesforce-automation

通过 Rube MCP 自动化 Salesforce

通过 Rube MCP 使用 Composio 的 Salesforce 工具包自动执行 Salesforce CRM 操作。

工具包文档：composio.dev/toolkits/salesforce

前提条件

• 必须连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Salesforce 连接，工具包为 salesforce
• 始终先调用 RUBE_SEARCH_TOOLS，以获取当前工具架构

设置

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

1. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用
2. 使用工具包 salesforce 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接状态不是 ACTIVE，请访问返回的授权链接，完成 Salesforce OAuth
4. 运行任何工作流前，确认连接状态显示为 ACTIVE

核心工作流

1. 管理潜在客户

适用场景：用户想要创建、搜索、更新或列出潜在客户

工具调用顺序：

1. SALESFORCE_SEARCH_LEADS - 按条件搜索潜在客户 [可选]
2. SALESFORCE_LIST_LEADS - 列出所有潜在客户 [可选]
3. SALESFORCE_CREATE_LEAD - 创建新的潜在客户 [可选]
4. SALESFORCE_UPDATE_LEAD - 更新潜在客户字段 [可选]
5. SALESFORCE_ADD_LEAD_TO_CAMPAIGN - 将潜在客户添加到营销活动 [可选]
6. SALESFORCE_APPLY_LEAD_ASSIGNMENT_RULES - 应用分配规则 [可选]

关键参数：

• LastName：创建潜在客户时必填
• Company：创建潜在客户时必填
• Email、Phone、Title：常见的潜在客户字段
• lead_id：用于更新的潜在客户 ID
• campaign_id：用于营销活动操作的营销活动 ID

注意事项：

• 创建潜在客户时，LastName 和 Company 为必填字段
• 潜在客户 ID 是 15 或 18 个字符的 Salesforce ID

2. 管理联系人和客户

适用场景：用户想要管理联系人及其关联的客户

工具调用顺序：

1. SALESFORCE_SEARCH_CONTACTS - 搜索联系人 [可选]
2. SALESFORCE_LIST_CONTACTS - 列出联系人 [可选]
3. SALESFORCE_CREATE_CONTACT - 创建新联系人 [可选]
4. SALESFORCE_SEARCH_ACCOUNTS - 搜索客户 [可选]
5. SALESFORCE_CREATE_ACCOUNT - 创建新客户 [可选]
6. SALESFORCE_ASSOCIATE_CONTACT_TO_ACCOUNT - 将联系人关联到客户 [可选]

关键参数：

• LastName：创建联系人时必填
• Name：创建客户时使用的客户名称
• AccountId：要与联系人关联的客户 ID
• contact_id、account_id：用于关联的 ID

注意事项：

• 联系人至少需要 LastName
• 关联客户时，联系人 ID 和客户 ID 都必须有效

3. 管理商机

适用场景：用户想要跟踪和管理销售商机

工具调用顺序：

1. SALESFORCE_SEARCH_OPPORTUNITIES - 搜索商机 [可选]
2. SALESFORCE_LIST_OPPORTUNITIES - 列出所有商机 [可选]
3. SALESFORCE_GET_OPPORTUNITY - 获取商机详情 [可选]
4. SALESFORCE_CREATE_OPPORTUNITY - 创建新商机 [可选]
5. SALESFORCE_RETRIEVE_OPPORTUNITIES_DATA - 获取商机数据 [可选]

关键参数：

• Name：商机名称（必填）
• StageName：销售阶段（必填）
• CloseDate：预计成交日期（必填）
• Amount：交易金额
• AccountId：关联的客户

注意事项：

• 创建商机时，Name、StageName 和 CloseDate 为必填项
• 阶段名称必须与 Salesforce 中配置的内容完全一致

4. 运行 SOQL 查询

适用场景：用户想要使用自定义 SOQL 查询 Salesforce 数据

工具调用顺序：

1. SALESFORCE_RUN_SOQL_QUERY / SALESFORCE_QUERY - 执行 SOQL [必需]

关键参数：

• query：SOQL 查询字符串

注意事项：

• SOQL 语法不同于 SQL；它使用 Salesforce 对象和字段的 API 名称
• 字段 API 名称可能与显示标签不同（例如，使用 Account.Name 而不是 Account Name）
• 大型数据集的结果会分页

5. 管理任务

适用场景：用户想要创建、搜索、更新或完成任务

工具调用顺序：

1. SALESFORCE_SEARCH_TASKS - 搜索任务 [可选]
2. SALESFORCE_UPDATE_TASK - 更新任务字段 [可选]
3. SALESFORCE_COMPLETE_TASK - 将任务标记为已完成 [可选]

关键参数：

• task_id：用于更新的任务 ID
• Status：任务状态值
• Subject：任务主题

注意事项：

• 任务状态值必须与 Salesforce 中的选项列表一致

常见模式

SOQL 语法

基本查询：

SELECT Id, Name, Email FROM Contact WHERE LastName = 'Smith'

包含关系：

SELECT Id, Name, Account.Name FROM Contact WHERE Account.Industry = 'Technology'

日期筛选：

SELECT Id, Name FROM Lead WHERE CreatedDate = TODAY
SELECT Id, Name FROM Opportunity WHERE CloseDate = NEXT_MONTH

分页

• 返回大量结果的 SOQL 查询会提供分页令牌
• 使用 SALESFORCE_QUERY 和 nextRecordsUrl 进行分页
• 检查响应中的 done 字段；如果为 false，则继续分页

已知注意事项

字段 API 名称：

• 始终使用 API 名称，而非显示标签
• 自定义字段以 __c 为后缀
• 使用 SALESFORCE_GET_ALL_CUSTOM_OBJECTS 查找自定义对象

ID 格式：

• Salesforce ID 为 15 位（区分大小写）或 18 位（不区分大小写）
• 大多数操作均接受这两种格式

快速参考

任务	工具标识	关键参数
创建潜在客户	SALESFORCE_CREATE_LEAD	LastName, Company
搜索潜在客户	SALESFORCE_SEARCH_LEADS	query
列出潜在客户	SALESFORCE_LIST_LEADS	(筛选条件)
更新潜在客户	SALESFORCE_UPDATE_LEAD	lead_id, fields
创建联系人	SALESFORCE_CREATE_CONTACT	LastName
搜索联系人	SALESFORCE_SEARCH_CONTACTS	query
创建客户	SALESFORCE_CREATE_ACCOUNT	Name
搜索客户	SALESFORCE_SEARCH_ACCOUNTS	query
关联联系人	SALESFORCE_ASSOCIATE_CONTACT_TO_ACCOUNT	contact_id, account_id
创建商机	SALESFORCE_CREATE_OPPORTUNITY	Name, StageName, CloseDate
获取商机	SALESFORCE_GET_OPPORTUNITY	opportunity_id
搜索商机	SALESFORCE_SEARCH_OPPORTUNITIES	query
运行 SOQL	SALESFORCE_RUN_SOQL_QUERY	query
查询	SALESFORCE_QUERY	query
搜索任务	SALESFORCE_SEARCH_TASKS	query
更新任务	SALESFORCE_UPDATE_TASK	task_id, fields
完成任务	SALESFORCE_COMPLETE_TASK	task_id
获取用户信息	SALESFORCE_GET_USER_INFO	(无)
自定义对象	SALESFORCE_GET_ALL_CUSTOM_OBJECTS	(无)
创建记录	SALESFORCE_CREATE_A_RECORD	object_type, fields
转移所有权	SALESFORCE_MASS_TRANSFER_OWNERSHIP	records, new_owner

---

由 Composio 提供支持