salesforce-automation

通过 Rube MCP 实现 Salesforce 自动化

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

前提条件

• 必须已连接 Rube MCP（可使用 RUBE_SEARCH_TOOLS）
• 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Salesforce 连接，并使用工具包 salesforce
• 始终先调用 RUBE_SEARCH_TOOLS 获取最新的工具架构

设置

获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务。请确认实际的 MCP 身份验证、Salesforce 组织和权限范围；仅添加端点并不会建立访问权限。

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

记录变更边界

确认准确的组织、对象和记录 ID；预览批量所有权、营销活动或分配变更，并且只应用用户授权的字段。自动化规则可能会通知其他用户或对其造成影响；读取记录并不代表获准进行通信。创建结果不确定时，重试前先核实是否已创建记录，以免重复创建潜在客户。

核心工作流

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 为必填字段
• Salesforce 潜在客户 ID 长度为 15 或 18 个字符

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 查询会提供分页令牌
• 使用带有 nextRecordsUrl 的 SALESFORCE_QUERY 进行分页
• 检查响应中的 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	(filters)
更新潜在客户	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	(none)
自定义对象	SALESFORCE_GET_ALL_CUSTOM_OBJECTS	(none)
创建记录	SALESFORCE_CREATE_A_RECORD	object_type, fields
转移所有权	SALESFORCE_MASS_TRANSFER_OWNERSHIP	records, new_owner

适用场景

当需要执行概述中描述的工作流或操作时，可使用此技能。

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少必需输入、权限、安全边界或成功标准，请暂停并请求澄清。