名称: salesforce-automation 描述: “通过Rube MCP(Composio)自动化Salesforce任务:线索、联系人、账户、机会、SOQL查询。始终先搜索工具以获取当前架构。” 要求: mcp: [rube] 类别: crm
通过Rube MCP实现Salesforce自动化
通过Composio的Salesforce工具包和Rube MCP自动化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密钥—只需添加端点即可工作。
- 通过确认
RUBE_SEARCH_TOOLS响应来验证Rube MCP可用 - 调用
RUBE_MANAGE_CONNECTIONS并指定工具包salesforce - 如果连接状态不是ACTIVE,请按照返回的认证链接完成Salesforce OAuth
- 在运行任何工作流之前,确认连接状态显示为ACTIVE
核心工作流
1. 管理线索
使用时机: 用户想要创建、搜索、更新或列出线索
工具序列:
SALESFORCE_SEARCH_LEADS- 根据条件搜索线索 [可选]SALESFORCE_LIST_LEADS- 列出所有线索 [可选]SALESFORCE_CREATE_LEAD- 创建新线索 [可选]SALESFORCE_UPDATE_LEAD- 更新线索字段 [可选]SALESFORCE_ADD_LEAD_TO_CAMPAIGN- 将线索添加到营销活动 [可选]SALESFORCE_APPLY_LEAD_ASSIGNMENT_RULES- 应用分配规则 [可选]
关键参数:
LastName: 创建线索时必填Company: 创建线索时必填Email,Phone,Title: 常见线索字段lead_id: 用于更新的线索IDcampaign_id: 用于营销活动操作的营销活动ID
常见陷阱:
- LastName和Company是创建线索时的必填字段
- 线索ID为15或18字符的Salesforce ID
2. 管理联系人和账户
使用时机: 用户想要管理联系人及其关联账户
工具序列:
SALESFORCE_SEARCH_CONTACTS- 搜索联系人 [可选]SALESFORCE_LIST_CONTACTS- 列出联系人 [可选]SALESFORCE_CREATE_CONTACTS- 创建新联系人 [可选]SALESFORCE_SEARCH_ACCOUNTS- 搜索账户 [可选]SALESFORCE_CREATE_ACCOUNT- 创建新账户 [可选]SALESFORCE_ASSOCIATE_CONTACT_TO_ACCOUNT- 将联系人链接到账户 [可选]
关键参数:
LastName: 创建联系人时必填Name: 账户名称用于创建AccountId: 要关联到联系人的账户IDcontact_id,account_id: 用于关联的ID
常见陷阱:
- 联系人至少需要LastName
- 账户关联需要有效的联系人和账户ID
3. 管理机会
使用时机: 用户想要跟踪和管理销售机会
工具序列:
SALESFORCE_SEARCH_OPPORTUNITIES- 搜索机会 [可选]SALESFORCE_LIST_OPPORTUNITIES- 列出所有机会 [可选]SALESFORCE_GET_OPPORTUNITY- 获取机会详情 [可选]SALESFORCE_CREATE_OPPORTUNITY- 创建新机会 [可选]SALESFORCE_RETRIEVE_OPPORTUNITIES_DATA- 检索机会数据 [可选]
关键参数:
Name: 机会名称(必填)StageName: 销售阶段(必填)CloseDate: 预计关闭日期(必填)Amount: 交易价值AccountId: 关联账户
常见陷阱:
- 创建时Name、StageName和CloseDate是必填字段
- 阶段名称必须完全匹配Salesforce中的配置
4. 运行SOQL查询
使用时机: 用户想要使用自定义SOQL查询Salesforce数据
工具序列:
SALESFORCE_RUN_SOQL_QUERY/SALESFORCE_QUERY- 执行SOQL [必需]
关键参数:
query: SOQL查询字符串
常见陷阱:
- SOQL语法不同于SQL;使用Salesforce对象和字段API名称
- 字段API名称可能与显示标签不同(例如,
Account.Name而不是Account Name) - 大型数据集的结果是分页的
5. 管理任务
使用时机: 用户想要创建、搜索、更新或完成任务
工具序列:
SALESFORCE_SEARCH_TASKS- 搜索任务 [可选]SALESFORCE_UPDATE_TASK- 更新任务字段 [可选]SALESFORCE_COMPLETE_TASK- 标记任务为完成 [可选]
关键参数:
task_id: 用于更新的任务IDStatus: 任务状态值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(不区分大小写)字符
- 大多数操作都接受两种格式
快速参考
| 任务 | 工具Slug | 关键参数 |
|---|---|---|
| 创建线索 | 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提供支持