跳到主要内容

让你的 AI Agent 连接 Salesforce

为 Agent 和产品后端提供结构化 Salesforce 动作,遵守授权用户的访问权限。

每月 20,000 次免费应用调用(付费服务另计)

试试这些 Salesforce 任务

将提示词复制到已安装 oo Skill 的 Agent,补充页面链接和原始笔记后执行。

oo SkillSalesforce

检查 CRM 数据

先了解对象字段,再查询标准或自定义记录。

/oo Salesforce: 检查 Salesforce Account 字段,然后返回最多 20 条客户的名称和 ID。仅在需要时继续分页,不修改记录。

按外部 ID 维护记录

将来源字段映射到自定义对象,创建或更新一条记录。

/oo Salesforce: 查询 [对象 API 名称] 的字段,确认哪些字段可写。按 [外部 ID 字段] 和 [外部 ID 值] 创建或更新一条记录,只写入 [指定字段],并返回本次是创建还是更新。

整理销售报表解读

按指定日期条件运行已有报表并解释结果。

/oo Salesforce: 查找 Salesforce 报表 [名称],检查其定义,在不修改已保存报表的前提下按 [日期范围] 运行,并汇总结果及报表完整性标记。

发送与记录关联的文档

上传文档、关联记录,并发送已确认的模板邮件。

/oo Salesforce: 将 [文件 URL] 作为新 Salesforce 文件按 [文件名] 上传,把 metadata.FirstPublishLocationId 设为 Salesforce 记录 [ID],在上传时完成关联。然后向联系人 [ID] 发送模板 [模板 ID] 的邮件,将上传响应中的 id(ContentVersion ID)放入 email.attachmentIdCollection 作为附件。返回上传和邮件结果,包括失败项。

处理 CRM CSV 导入

提交 CSV,处理完成后检查逐条记录结果。

/oo Salesforce: 将 [CSV URL] 按外部 ID 字段 [字段] 写入 Salesforce 对象 [API 名称]。等待处理完成,返回任务计数及可下载的失败记录结果,不自动重新提交失败记录。

调用已有 Salesforce 工作流

发现已配置动作并按其参数定义调用。

/oo Salesforce: 查找 Salesforce Flow [API 名称],检查输入定义,然后使用 [参数] 调用。报告各项动作结果,不把部分失败的响应视为全部成功。

开始使用 Salesforce

  1. 安装 OOMOL

    在 Agent 中配置 oo CLI 和 oo Skill。

    安装 OOMOL →
  2. 连接 Salesforce

    授权 OOMOL Salesforce Connected App,授予 API 和离线访问权限。

    连接 Salesforce→
  3. 向 Agent 交代任务

    使用 /oo,说明要读取的页面、修改的内容和保存位置。

    连接指南 →
  • Salesforce 组织须启用 API,授权用户须具有相应对象和字段的访问权限。
  • Salesforce 组织须允许访问 OOMOL Connected App;如需批准或安装,请联系 Salesforce 管理员。
  • 可使用生产登录入口、Sandbox 登录入口或组织的 My Domain 地址。
  • 在 OOMOL 中断开连接会移除本地访问;如需使远端授权失效,请在 Salesforce 中撤销授权。
  • 连接可使用的动作取决于 Salesforce 用户权限和组织已启用的功能。
  • 报表、邮件、文件和自动化需要相应的 Salesforce 用户权限与组织功能。
  • Bulk CSV 和文件下载使用 OOMOL 文件中转。大任务异步执行;请求成功时仍可能存在失败记录。

Salesforce 工具

发现标准和自定义对象、跨对象搜索及同步记录、处理集合与 Bulk 任务、运行报表和仪表盘、管理记录文件、发送模板邮件并调用现有 Salesforce 自动化。OOMOL 为这些流程管理 OAuth 与文件中转。

发现、搜索与同步

检查对象结构、跨对象搜索,并跟踪变更或删除的记录。

维护单条和关联记录

操作单条记录,或处理集合、记录树及有依赖关系的请求。

报表与仪表盘

用临时筛选条件运行已有报表,查看或刷新仪表盘。

文件与附件

上传文件、读取文件版本,并管理与 CRM 记录的关联。

邮件与现有自动化

发送邮件,调用已配置的标准、Flow、Apex 和快捷动作。

批量数据任务

提交 CSV 导入或查询任务、查看结果并中止任务。

84 个工具

Get Record Create Defaults

在创建记录前获取当前用户的默认值、创建布局和对象元数据;不能保证后续写入一定通过验证规则。

salesforce.get_record_create_defaults

Get Record Layout

读取指定对象和记录类型在创建、编辑或查看模式下的页面布局。

salesforce.get_record_layout

Get Lookup Suggestions

根据当前用户上下文及依赖字段值查找允许关联的候选记录。使用 UI API POST,但只读取候选数据。

salesforce.get_lookup_suggestions

Create Report

根据明确提供的报表定义创建并保存 Salesforce 报表。

salesforce.create_report

Clone Report

复制可访问的报表,可覆盖名称、文件夹等元数据。

salesforce.clone_report

Save Report

保存报表元数据修改。Salesforce 保存时会使该报表正在运行的异步任务失效并删除它们。

salesforce.save_report

Tooling Query

使用 SOQL SELECT 查询 Salesforce Tooling 元数据,例如验证规则、Apex 类和日志;需要相应管理员权限。

salesforce.tooling_query

Tooling Query More

使用返回的 nextRecordsUrl 继续获取 Tooling SOQL 查询结果。

salesforce.tooling_query_more

Get Tooling Record

读取一条 Tooling API 元数据记录,不修改配置。

salesforce.get_tooling_record

Get Apex Log

读取 Apex 调试日志正文;日志可能包含敏感业务数据。

salesforce.get_apex_log

Convert Leads

使用 Salesforce 原生接口批量转换最多 100 条线索。请查询 LeadStatus 选择有效的 convertedStatus,并逐项检查失败;队列拥有的线索必须指定用户 ownerId。

salesforce.convert_leads

List Approval Processes

列出经典审批流程定义,可按对象 API 名称筛选。

salesforce.list_approval_processes

Submit For Approval

将记录提交到经典审批流程,逐项检查部分失败;Flow 审批请使用 invoke_action。

salesforce.submit_for_approval

Review Approval Requests

批准或拒绝分配给当前用户的经典审批工作项;各项可独立成功或失败。

salesforce.review_approval_requests

List Pending Approvals

查询自己、自己及所在组、或指定处理人的经典审批待办。后续页将 nextRecordsUrl 传给 query_more;组范围不保证覆盖所有委托审批。

salesforce.list_pending_approvals

List Chatter Feed Elements

读取 Chatter 动态,支持原生分页、搜索和筛选。不同动态类型支持的选项不同,不支持的组合会被拒绝;内嵌评论仅为预览。

salesforce.list_chatter_feed_elements

Get Chatter Feed Element

读取完整 Chatter 动态条目,保留 capabilities 和结构化消息内容。

salesforce.get_chatter_feed_element

List Chatter Comments

读取动态条目的完整评论页;后续页使用 nextPageUrl 中的分页 token。

salesforce.list_chatter_comments

Create Chatter Comment

使用结构化消息段回复 Chatter 动态,可附加文件、知识文章或分享的动态实体。

salesforce.create_chatter_comment

Create Chatter Feed Element

向明确选择的用户、群组或记录发布结构化 Chatter 动态,支持原生 capabilities 和已上传文件。

salesforce.create_chatter_feed_element

List Knowledge Articles

按语言、渠道及分类搜索或浏览可见的在线知识文章。列表仅含摘要,正文用 get_knowledge_article 获取;后续页递增 pageNumber。

salesforce.list_knowledge_articles

Get Knowledge Article

按文章 ID 或 URL 名称读取可见的在线知识文章,包含自定义布局内容;不读取草稿版本或自定义二进制文件字段。

salesforce.get_knowledge_article

List Objects

列出当前 Salesforce 用户可访问的 sObject。

salesforce.list_objects

Describe Object

查询 sObject 的字段、关系、权限和记录类型等元数据。

salesforce.describe_object

Query

执行只读 SOQL 并返回一页结果;将 nextRecordsUrl 传入 query_more 获取后续页。

salesforce.query

Query More

使用 Salesforce 返回的相对 nextRecordsUrl 获取下一页 SOQL 结果。

salesforce.query_more

Get Record

按对象 API 名称和记录 ID 获取 Salesforce 记录。

salesforce.get_record

Create Record

创建一条标准或自定义 Salesforce 记录。

salesforce.create_record

Update Record

更新 Salesforce 记录中指定的字段,未提供的字段保持不变。

salesforce.update_record

Delete Record

按对象 API 名称和记录 ID 删除一条 Salesforce 记录。

salesforce.delete_record

Upsert Record

根据外部 ID 字段创建或更新一条 Salesforce 记录;使用 updateOnly 禁止创建新记录。

salesforce.upsert_record

Search Records

使用 SOSL 跨 Salesforce 对象搜索。

salesforce.search_records

Parameterized Search

无需编写 SOSL 即可搜索 Salesforce,支持官方参数化搜索选项。

salesforce.parameterized_search

Get Record By External Id

根据外部 ID 字段和值读取记录。

salesforce.get_record_by_external_id

Get Related Records

从记录出发,按一个或多个 Salesforce 关系 API 名称读取关联数据。

salesforce.get_related_records

List Updated Records

列出最近 30 天内指定同步时间窗中发生变更的记录 ID。

salesforce.list_updated_records

List Deleted Records

列出保留的删除日志中的记录,最多覆盖最近 15 天;请保留返回的时间标记。

salesforce.list_deleted_records

Get Record Counts

获取指定对象或所有可访问对象的近似记录数。

salesforce.get_record_counts

Get Records

一次读取同一对象的最多 2000 条记录;不存在或无权访问的记录在对应位置返回 null。

salesforce.get_records

Create Records

一次创建最多 200 条记录,保留逐条成功状态和错误。

salesforce.create_records

Update Records

一次更新最多 200 条记录,保留逐条成功状态和错误。

salesforce.update_records

Upsert Records

使用外部 ID 字段批量创建或更新同一对象的最多 200 条记录。

salesforce.upsert_records

Delete Records

删除最多 200 条 Salesforce 记录,可选在任意记录失败时全部回滚。

salesforce.delete_records

Create Record Tree

原子创建父子记录树,最多 200 条记录、五种对象和五层嵌套。

salesforce.create_record_tree

Execute Composite

执行最多 25 个有依赖关系的 Salesforce REST 子请求,其中最多五个为查询或集合操作;可删除资源。

salesforce.execute_composite

Execute Composite Graph

执行事务性 Salesforce sObject Graph,总计最多 500 个子请求和 75 个 Graph;可删除资源。

salesforce.execute_composite_graph

List List Views

列出 sObject 可访问的列表视图。

salesforce.list_list_views

Describe List View

描述列表视图,包括列定义和 SOQL 查询。

salesforce.describe_list_view

Get List View Records

执行列表视图并返回记录行及展示元数据。

salesforce.get_list_view_records

Get Picklist Values

通过 UI API 获取指定记录类型的选项值及依赖关系。

salesforce.get_picklist_values

Get Current User

获取当前授权 Salesforce 用户的身份信息。

salesforce.get_current_user

Get Org Limits

获取组织额度及剩余额度,需要 View Setup and Configuration 权限。

salesforce.get_org_limits

List Reports

列出最多 200 个最近访问的报表;如需发现全部可访问报表,请用 SOQL 查询 Report 对象。

salesforce.list_reports

Describe Report

获取报表、报表类型及扩展元数据,包括可用筛选字段。

salesforce.describe_report

Run Report

同步运行报表,可临时覆盖元数据,不保存更改。

salesforce.run_report

Submit Report

启动异步报表运行并返回供 get_report_result 使用的句柄。

salesforce.submit_report

Get Report Result

获取异步报表的状态和结果;空 factMap 也是有效的成功结果。

salesforce.get_report_result

List Dashboards

列出最近访问的仪表盘;如需更广泛发现,请用 SOQL 查询 Dashboard 对象。

salesforce.list_dashboards

Get Dashboard

获取仪表盘元数据、组件数据和状态,可选筛选条件。

salesforce.get_dashboard

Refresh Dashboard

请求刷新仪表盘;读取刷新后的数据前,请查询 get_dashboard_status。

salesforce.refresh_dashboard

Get Dashboard Status

获取仪表盘各组件的刷新状态。

salesforce.get_dashboard_status

List Email Templates

使用 SOQL 列出可访问的启用中邮件模板;后续页使用 query_more。

salesforce.list_email_templates

Get Email Template

获取邮件模板元数据、文本正文和 HTML 内容。

salesforce.get_email_template

Send Email

通过 Salesforce emailSimple 发送邮件并返回各项动作结果,请检查 isSuccess 和 errors。

salesforce.send_email

Send Email From Template

发送带合并字段的 Salesforce 模板邮件,需要收件人的 Contact 或 Lead ID。

salesforce.send_email_from_template

List Invocable Actions

发现标准动作、自定义动作类别或某个自定义类别内的动作。

salesforce.list_invocable_actions

Describe Invocable Action

调用前查询 Invocable Action 的输入和输出定义。

salesforce.describe_invocable_action

Invoke Action

调用标准动作或自定义 Flow/Apex 动作;动态动作可能删除数据或执行其他破坏性操作。

salesforce.invoke_action

List Quick Actions

列出全局快捷动作或指定对象的快捷动作。

salesforce.list_quick_actions

Get Quick Action Defaults

获取对象特定快捷动作的默认字段值,可使用记录上下文求值。

salesforce.get_quick_action_defaults

Execute Quick Action

使用字段值和可选记录上下文执行全局或对象特定的快捷动作。

salesforce.execute_quick_action

Upload File

从文件 URL 通过流式 multipart 上传新的 Salesforce ContentVersion,最大 2 GB;也可为已有文件添加版本。

salesforce.upload_file

Get File

获取 Salesforce ContentDocument 及最新版本引用。

salesforce.get_file

Download File

将 Salesforce 文件版本下载到 OOMOL 文件中转,默认使用最新已发布版本。

salesforce.download_file

List Record Files

列出与 Salesforce 记录关联的文件,包含解除关联所需的链接 ID;后续页使用 query_more。

salesforce.list_record_files

List File Shares

列出文件的 ContentDocumentLink 共享记录;后续页使用 query_more。

salesforce.list_file_shares

Link File

以指定共享级别将已有文件关联到 Salesforce 记录。

salesforce.link_file

Unlink File

删除一个 ContentDocumentLink,不删除底层文件。

salesforce.unlink_file

Delete File

删除 ContentDocument 及其关联版本和链接。

salesforce.delete_file

Submit Bulk Query

提交异步 Bulk API 2.0 SOQL 查询并返回带版本的句柄。

salesforce.submit_bulk_query

Get Bulk Query Result

轮询 Bulk 查询,完成后下载一页 CSV 到文件中转;使用 nextLocator 继续分页。

salesforce.get_bulk_query_result

Submit Bulk Ingest

从公网 CSV URL 创建、上传并提交 Bulk API 2.0 任务,支持 delete 和不可恢复的 hardDelete;请检查逐条结果。

salesforce.submit_bulk_ingest

Get Bulk Ingest Result

轮询 Bulk 导入任务,在终态下载成功、失败或未处理记录;JobComplete 仍可能包含失败记录。

salesforce.get_bulk_ingest_result

Cancel Bulk Job

中止当前授权用户创建的 Bulk 查询或导入任务。

salesforce.cancel_bulk_job

常见问题

连接后能访问所有记录吗?

不能。Salesforce 仍会执行授权用户的 API、对象、字段和记录访问权限。

包含文件、批量任务和触发器吗?

已支持文件和异步 Bulk API 2.0 任务。事件触发器及 Data Cloud、Marketing Cloud 等独立产品不在当前结构化能力范围内。

为什么报表和仪表盘列表没有显示全部项目?

这些 Salesforce 接口返回最近访问的项目。如需更广泛发现,请使用记录查询动作查询 Report 或 Dashboard 对象,结果仍受访问权限限制。

请求成功是否表示每条记录都成功?

不是。集合、Composite、邮件动作和 Bulk 任务会提供逐项结果或失败计数。重试或继续工作流前应先检查这些信息。