📦 Salesforce Fast integrations — Salesforce 快速集成

Salesforce CRM - SDR 操作专家 该技能为 SDR 团队提供 Salesforce 技能。它处理实时数据获取、重复检测、记录创建/更新、SOQL 查询生成和筛选工作流同步。它支持 Claude Code、OpenClaw、Cursor 和任何兼容 Agent Skills 的平台。

安全模型 该技能采用深度防御安全模型。每个写操作在触及 Salesforce 之前都会经过四个层次：

• 对象白名单检查（仅允许 5 个对象）
• 字段白名单检查（仅允许每个对象声明的字段）
• 干运行预览（显示将要更改的内容）
• 确认门槛（需要明确的“是”）
• Salesforce API
• 审计日志写入（~/.salesforce_skill_audit.log）

所有读操作（SOQL 查询）始终是安全的 - 它们永远不会修改数据。写操作（创建/更新）需要每次明确确认，除非传递 --yes 参数。

最小权限设置（首次使用前必需） 永远不要使用个人管理员帐户。创建一个专用的集成用户： 步骤 1：在 Salesforce 中创建集成用户 前往设置 > 用户 > 新用户 设置个人资料：“最小访问 - Salesforce”（或自定义） 设置用户名：sdr-skill-integration@yourcompany.com 启用 API 仅限用户类型

步骤 2：创建权限集（仅限 SDR 字段） 创建一个名为 SDR_Skill_Integration 的权限集，包含： 对象权限（仅读取 + 编辑， 无删除， 无查看所有）： 账户：读取、创建、编辑 联系人：读取、创建、编辑 潜在客户：读取、创建、编辑 机会：仅读取 任务：读取、创建、编辑 字段权限（仅技能实际使用的字段）： 账户：名称、网站、行业、员工数量、电话、账单地址、类型、所有权、描述、年收入、父 ID、所有者 ID + 所有 R_D_*__c 自定义字段 联系人：名字、姓氏、电子邮件、电话、职称、部门、账户 ID 潜在客户：名字、姓氏、公司、职称、电子邮件、电话、网站、行业、员工数量、州、国家、潜在客户来源、状态

步骤 3：创建连接应用 前往设置 > 应用程序管理器 > 新连接应用 启用 OAuth 设置 范围：api、refresh_token（不要添加 full 或 web） 记下客户 ID 和客户密钥

步骤 4：设置环境变量 # 使用 .env 文件或密钥管理器 - 永远不要硬编码这些 export SF_ACCESS_TOKEN="your_oauth_access_token" export SF_INSTANCE_URL="https://yourorg.my.salesforce.com" 不要导出 SF_USERNAME、SF_PASSWORD 或 SF_SECURITY_TOKEN - 脚本使用基于令牌的身份验证，这更安全，不需要密码凭据。

步骤 5：从只读测试开始 # 首先测试查询 - 零风险， 无写操作 python3 scripts/salesforce_query.py "SELECT Id, Name FROM Account LIMIT 5" # 然后测试干运行写操作， 在进行任何实际写操作之前 python3 scripts/salesforce_upsert.py create Account '{"Name":"Test"}' --dry-run

如何触发此技能 可以说： “检查 [公司] 是否已经存在于 Salesforce 中” “获取账户 [ID] 的全部详细信息” “使用筛选结果更新账户 [ID]” “找到 [州] 中未筛选的公司” “为 [人] 在 [公司] 创建一个新的潜在客户” “找到 [公司] 的 CEO” “批量检查这些 10 家公司是否有重复项” “在我确认之前，先进行账户 [ID] 的干运行更新”

核心操作

• 重复检测（始终首先运行 - 仅读取）

在创建任何记录之前，检查重复项。这些是纯读操作 - 零风险。 按公司名称： SELECT Id, Name, Website, Industry, NumberOfEmployees, BillingState, Owner.Name, LastModifiedDate FROM Account WHERE Name LIKE '%{company_name}%' AND BillingCountry = 'United States' ORDER BY LastModifiedDate DESC LIMIT 10 按网站域名： SELECT Id, Name, Website, Owner.Name, LastModifiedDate FROM Account WHERE Website LIKE '%{domain}%' LIMIT 5 批量检查（多个公司 - 仍然仅读取）： SELECT Id, Name, Website, Owner.Name FROM Account WHERE Name IN ('Company A', 'Company B', 'Company C') OR Website IN ('companya.com', 'companyb.com') LIMIT 200 决策规则：找到匹配项 -> 显示现有记录（ID、名称、所有者、最后修改日期）-> 询问：更新现有记录或创建新记录？未找到匹配项 -> 确认安全创建 -> 继续

• 获取完整账户详细信息（仅读取）

SELECT Id, Name, Website, Industry, NumberOfEmployees, BillingStreet, BillingCity, BillingState, BillingPostalCode, Phone, Type, Ownership, Parent.Name, Parent.Id, Parent.Ownership, Parent.Type, Description, AnnualRevenue, R_D_Screening_Status__c, R_D_Qualification__c, NAICS_Code__c, Technical_Employees__c, Disqualifier_Reason__c, Screening_Notes__c, Last_Screening_Date__c, Owner.Name, Owner.Email, CreatedDate, LastModifiedDate FROM Account WHERE Id = '{account_id}' 在获取后，自动： 检查父公司是否有排除项 列出决策者联系人（CEO、CFO、所有者、总裁） 显示最近活动（最近 90 天） 显示开放机会