Salesforce连接器配置指引

一、文档说明

本文档梳理了Salesforce集成/迁移项目从售前到交付过程的方法步骤及素材,旨在为Salesforce集成/迁移项目提供一套系统对接/迁移最佳实践,并帮助实施同事提升交付效率。
本文档适合售前行业专家、客户经理及交付技术顾问、实施顾问阅读。

二、售前阶段

此阶段重点介绍通过集成平台将CRM与Salesforce系统集成给客户带来的价值,以及通过集成平台实现Salesforce系统集成的优势。可以参考培训助手Salesforce连接器配置视频,配置演示环境:https://www.fxiaoke.com/XV/UI/Home?noheader=0&ddtab=true#app/train/detail/=/id-132948/trainType-0 。售前环节展示也可以参考Salesforce迁移方案PPT的演示视频,PPT获取路径见:网盘>公司文件>全部文件>❤️销售必备-销售工具包>04Salesforce替代和迁移

三、实施阶段

进入实施阶段,首先可以通过售前调研工具填写的内容初步了解对接系统的接口情况及对接对象及流向等基本信息。接着,可以使用实施工具做详细的调研,梳理并输出客户业务蓝图、每个需要与CRM对接系统的对接流成图、客户原始数据及关注度排序(即完成实施工具前期调研List、业务蓝图及流程图梳理两页签内容),输出此内容后先在内部进行进行业务方案确认。方案确认后,既可以进入下一步的每个对接对象的字段梳理,以便为接口沟通时提供实际API示例。完成字段梳理后可以联系研发这边和客户方的开发人员做接口标准沟通。注意:
  • 对于Salesforce系统集成,业务方案制定是重中之重,请务必重视并预留对应的时间!
  • 不强制但仍建议先在沙盒环境配置验证客户业务(CRM的沙盒环境必须连接客户SAP的测试账套),与客户联调验证无误后再与客户方确认上线安排细节。特别注意:如果在正式环境直接配置,请和客户协商好以免产生纠纷,最好取得客户方同意的免责说明截图/文件!
  • 本实施工具旨在为项目对接提供准确、详尽的对接资料,所填写资料均为实施实际调研业务需求后整理书写(具体场景请在备注中列明并在评审时说明),若有遗漏而导致工期延误,责任由填写人承担!!

3.1 实施前置条件

实施前置条件:
1、实施工具内容调研完成,方案评审通过;
2、开通CRM及集成平台Salesforce连接器;
3、客户侧SAP系统接口已封装完成,且自测通过;在确认前置条件满足后,即可进入 系统管理>集成平台管理 页面进行配置工作。

3.2 连接器配置

3.2.1 授权配置

进入Salesforce连接器,填写授权信息。授权信息支持两种方式:OAuth 2.0(Authorization Code)和API Key两种方式,配置见如下:
·若选择OAuth 2.0 Web服务器流(OAuth 2.0 Web Server Flow for Web App Integration)- OAuth 2.0 (Authorization Code)方式授权,参数填写对应规则如下:
  • 授权方式:选择 OAuth 2.0 (Authorization Code)
  • 基础路径:salesforce系统域名
  • 版本URL:可以不填,支持50.0以上版本
  • client_id:获取方式参考 附:Salesforce配置授权说明
  • client_secret:获取方式参考 附:Salesforce配置授权说明
  • 重定向地址:OAuth2.0 授权时会显示,且不可修改。此地址需填充到salesforce设置的回调地址中。
·若选择OAuth 2.0 客户端凭据流(OAuth 2.0 Client Credentials Flow for Server-to-Server Integration)- API Key方式授权,参数填写对应规则如下:
  • 授权方式:选择 OAuth 2.0 (Authorization Code)
  • 基础路径:salesforce系统域名
  • 版本URL:可以不填,支持50.0以上版本
  • client_id:获取方式参考 附:Salesforce配置授权说明
  • client_secret:获取方式参考 附:Salesforce配置授权说明
附:Salesforce配置授权说明
  • OAuth 2.0 Web服务器流(OAuth 2.0 Web Server Flow for Web App Integration),默认值。对应平台OAuth2.0类型
  • (👍推荐)OAuth 2.0 客户端凭据流(OAuth 2.0 Client Credentials Flow for Server-to-Server Integration),非默认值。对应平台API Key类型
  • 元数据管理接口:获取对象列表,获取从对象列表(关联对象),获取对象字段信息
  • 根据时间查询修改的数据,根据ID查询数据
  • 单对象数据新增、更新
  • 主从对象数据新增
  • 主从对象数据更新,不支持明细删除
配置要素说明:配置Salesforce External Client App包含以下几个内容:
  • 新建 External Client App
  • 配置 OAuth
  • 配置 Policies
  • 获取密钥
  • * 开启OAuth 2.0 客户端凭据流(OAuth 2.0 Client Credentials Flow for Server-to-Server Integration)【可选,推荐】
· 新建 External Client App
登录 Salesforce - 进入 Setup - Apps - External Client App Manager - New External Client App
登录 Salesforce
新建 New External Client App
· 启用 OAuth 设置
External Client App Manager - 【之前创建的应用】- 启用 OAuth - 配置 OAuth
进入应用设置
启用 OAuth
复制重定向地址
设置重定向地址和api权限范围
取消选中PKCE
· 配置 Policies
配置 Policies
· 查看密钥 
进入应用
填写授权信息
· 开启OAuth 2.0 客户端凭据流
编辑应用配置
启用

3.2.2 获取连接对象

授权成功后,可以通过Salesforce连接器实现的元数据管理接口,使用标准的获取对象类别、获取从对象列表、获取字段等功能。说明:由于salesforce系统新版本基本无主从关系,获取从对象列表将获取到所有关联对象,按业务需求选则即可。
获取主对象后,可按业务需求勾选下方转换后的从对象

3.2.3 配置对象映射关系

获取对象后,可以在对象列表配置对象映射关系,点击编辑映射即可打开新的页面。支持选择CRM已有对象映射或者新建对象做映射;
对象配置之后,匹配对象字段。当选择自定义对象后,支持参照Salesforce对象自动创建自定义对象及对象字段,实现对象及字段的快速迁移;

3.3 创建集成流 

在迁移列表,选择映射好的对象、字段记录,点击更多创建集成流,即可根据配置的映射关系快速创建集成流:
进入集成流,编辑状态检查字段映射关系,检查配置后,启用集成流。做少量数据同步验证配置,无问题即可通过历史数据同步功能批量迁移Salesforce业务数据。

参考文档

salesforce开发者中心:Developer Portal | Salesforce Developers
salesforce OAuth 2.0 授权文档:OAuth Authorization Flows (salesforce.com)
2025-09-19
1 0