Salesforce API Integration
调用Salesforce API实现数据查询、同步与错误处理
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Salesforce API Integration。 它的用途是:调用Salesforce API实现数据查询、同步与错误处理 完整的 Skill 内容见:https://321skill.com/skills/salesforce-api-integration-x-6/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'从Salesforce同步最近7天的Opportunity数据,包括金额、阶段和客户名称,并导出为CSV文件。' 它会自动连接Salesforce,执行SOQL查询,处理分页和字段级安全,最后生成CSV。若遇到API限流,则自动等待后重试。
介绍
该Skill解决了与Salesforce系统深度集成时的数据访问与同步难题。无论是日常查询Account、Contact、Opportunity等标准对象,还是操作自定义__c对象,亦或是处理大规模数据导入、跨系统迁移,它都能通过REST、Bulk、Composite、Metadata等多种API提供统一调用入口。内置对INVALID_SESSION_ID、MALFORMED_QUERY等常见错误代码的捕获与处理逻辑,大幅降低排查成本。
使用方式非常直观:对AI说出需求即可。例如“同步Salesforce中最近一周的Lead数据到本地数据库”,Skill会自动选择合适的API(如Bulk API进行批量拉取),处理OAuth/JWT认证,解析SOQL/SOSL查询结果,并返回结构化的数据。也支持Change Data Capture或Platform Events实现实时增量同步,以及调用自定义Apex REST端点或触发Flow。
适合后端开发、数据分析师、运维工程师等需要频繁与Salesforce打交道的角色。后端开发可快速完成数据集成任务;数据分析师能直接拉取业务数据做报表;运维工程师则利用其错误处理与同步机制保障系统稳定性。对于需要从其他CRM迁移至Salesforce的场景,该Skill也能大幅简化流程。
使用前请确保已配置好Connected App并获取必要的OAuth凭据或JWT密钥。注意它不适用于设计个人CRM系统、通用第三方API调用或编写Apex代码。对于超大规模数据(百万级以上),建议先评估Bulk API的批次限制,并合理设置外部ID以实现去重。
核心特点
不仅覆盖REST和Bulk API,还支持Composite、Metadata API以及自定义Apex端点,内置超10种Salesforce常见错误代码的自动处理,适合大规模数据迁移与实时增量同步场景。
注意事项
不适用于设计个人CRM系统、通用第三方API调用或编写Apex代码。
常见问题
如何处理INVALID_SESSION_ID错误?
Skill会自动检测该错误,并尝试使用刷新令牌(Refresh Token)重新获取新的Session ID,无需手动干预。
支持哪些Salesforce API版本?
默认使用最新稳定版API,也支持通过参数指定版本号(如v58.0),兼容沙箱和生产环境。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/salesforce-api-integration-x-6/raw/index.md 读取 Salesforce API Integration 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/salesforce-api-integration-x-6/raw/index.md(查看排版版本)