

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Salesforce 集成
<a name="salesforce-integration"></a>

借助 Amazon Quick 中的 Salesforce 操作连接器，您可以在 Salesforce 组织内执行操作，包括管理记录、查询数据以及与 Salesforce 互动。 APIs此操作连接器仅支持任务执行，并且需要 Amazon Quick Pro 或更高级别的级别。

## 您能做什么
<a name="salesforce-integration-capabilities"></a>

借助 Salesforce 集成，您可以通过操作连接器在 Salesforce 组织内执行操作。

**动作连接器**  
创建、更新和查询 Salesforce 对象，例如潜在客户、客户、联系人和机会。

**注意**  
Salesforce 集成不支持数据访问或知识库创建。它专为任务执行和与 Salesforce 对象的 API 交互而设计。

## 开始前的准备工作
<a name="salesforce-integration-prerequisites"></a>

在设置 Salesforce 集成之前，请确保您具备以下条件：
+ 具有适当权限的 Salesforce 组织。
+ 与 Salesforce 关联的应用程序或 API 访问凭证。
+ Amazon 快速作者或更高版本。
+ 配置 OAuth 应用程序的管理权限（如果使用用户身份验证）。

## 第 1 步：设置连接 Salesforce 的应用程序
<a name="salesforce-connected-app-setup"></a>

**注意**  
在 Salesforce 中创建联网应用程序。请勿创建外部客户端应用程序。外部客户端应用程序与此集成不兼容。

在 Salesforce 中创建关联应用程序，以启用使用 Amazon Quick 进行 OAuth 身份验证。

1. 登录您的 Salesforce 帐户，然后使用右上角的设置图标导航到 “设置” 页面。

1. 在 “快速查找” 栏中输入**Apps**，然后按照以下步骤操作：
   + 选择**外部客户端应用程序**
   + 选择**设置**
   + 在 “设置” 下，创建一个新的连接应用程序

1. 选择 “**新建连接的应用程序**”。

1. 选择 “**创建已连接的应用程序**”。

1. 在 “基本信息” 部分，输入以下必填信息：
   + **已连接应用程序名称**-已连接应用程序的描述性名称。
   + **API 名称**-您的应用程序的唯一 API 名称。
   + **联系人电子邮件**-您的联系人电子邮件地址。

1. 在 OAuth “设置” 部分中，选中以下复选框：
   + **启用 OAuth 设置**
   +  **对于支持的授权流程，需要验证密钥才能进行代码交换 (PKCE) 扩展***（推荐*） 

      启用此选项可向授权码流程添加额外的安全层。
   + **Web 服务器流程需要密钥**
   + **刷新令牌流需要密钥**
   + **启用客户端凭证流程**
   + **启用授权码和凭证流程**
   + **启用代币交换流程**
   + **代币兑换流程需要密钥**

1. 添加以下必需的 OAuth 范围：
   + `api`-访问 Salesforce APIs
   + `refresh_token`-在用户离线时保持访问权限
   + `offline_access`-随时执行请求
   + `full`-完全访问所有数据
   + `web`-基于 Web 的访问
   + `visualforce`-访问 Visualforce 页面
   + `custom_permissions`-访问自定义权限
   + `chatter_api`-访问 Chatter API
   + `wave_api`-访问分析 API
   + `eclair_api`-访问爱因斯坦分析 API
   + `pardot_api`-访问 Pardot API
   + `id`-访问身份信息
   + `email`-访问电子邮件地址
   + `profile`-访问基本的个人资料信息
   + `address`-访问地址信息
   + `phone`-访问电话号码
   + `open_id`-访问 OpenID Connect

1. 按以下格式输入回传 URL：`<quicksuite-url>/sn/oauthcallback`

1. 选择**保存**。

## 步骤 2：配置消费者详细信息和执行用户
<a name="salesforce-consumer-details"></a>

配置消费者详细信息并为客户端凭证流设置执行用户。

1. 从 “管理关联的应用程序” 页面中，选择 “**管理消费者详细信息**”。您可能需要验证自己的身份。

1. 复制**消费者密钥（客户端 ID）**和**消费者密钥（客户机密）**。

1. 选择**应用**。

1. 选择 “**初始访问令牌**”，然后选择 “**确定”**。

1. 配置执行用户：

   1. 在关联的应用程序详细信息页面中，选择操作列下的**编辑**。

   1. 在 “ OAuth 策略” > “刷新令牌策略” 下，选择 “**刷新令牌立即过期**”。

   1. 在 “客户端凭证流” 下，对于运行方式，选择要分配客户端凭据流的用户。

   1. 选择**保存**。

## 第 3 步：设置 Salesforce 操作连接器
<a name="salesforce-integration-setup"></a>

准备好与 Salesforce 关联的应用程序凭证后，在 Amazon Quick 中创建 Salesforce 操作连接器。

Salesforce 集成仅支持操作执行——Salesforce 系统不支持数据访问和知识库创建。

1. 在 Amazon Quick 控制台中，选择**集成。**

1. 从集成选项中选择 **Salesforce**，然后单击 “添加”（加上 “\$1”）按钮。

1. 填写集成详情：
   + **名称**-您的 Salesforce 操作连接器的描述性名称。
   + **描述**（可选）-操作连接器的用途。

1. 选择您的连接类型：
   +  OAuth基于@@ **用户身份验证**的个人用户访问权限的身份验证。
   + **服务身份 Service-to-service验证**-应用程序访问的身份验证。

1. 根据您选择的身份验证方法（用户或服务）填写连接设置：

   1. 对于**用户身份验证 (OAuth)**，请配置以下字段：
     + **基本网址**-Salesforce 实例网址（例如， https://your-domain.salesforce.com）。
     + **客户端 ID**-与 Salesforce 关联的应用程序使用者密钥。
     + **客户机密** ——与 Salesforce 关联的应用程序消费者机密。
     + **令牌网址**-Salesforce OAuth 令牌端点。
     + **身份验证网址**-Salesforce OAuth 授权端点。
     + **重定向 URL**-在已连接的应用程序中配置的 OAuth 重定向 URI。

1. 选择**创建并继续**。

1. 选择要与之共享集成的用户。

1. 单击**下一步**。

## 步骤 4：将操作连接器关联到自动化组
<a name="salesforce-automation-group-setup"></a>

要在自动化中使用 Salesforce 操作，必须将操作连接器与自动化组相关联。

1. 导航到您的自动化群组设置。

1. 将 Salesforce 操作连接器与将使用这些操作的自动化组相关联。

1. 为自动化组创建新的自动化，以访问工作流程中的 Salesforce 操作。

## 可用的任务操作
<a name="salesforce-integration-actions"></a>

创建 Salesforce 集成后，您可以查看用于与 Salesforce 对象进行交互的可用操作。常见的 Salesforce 操作包括：
+ 对标准和自定义对象进行创建、读取、更新和删除 (CRUD) 操作。
+ 使用 SOQL（Salesforce 对象查询语言）查询 Salesforce 数据。
+ 管理潜在客户、客户、联系人和机会。
+ 执行 Apex 方法和自定义逻辑。
+ 管理案例、任务和活动。
+ 访问报告和仪表板。

## 共享集成
<a name="salesforce-integration-sharing"></a>

您可以与组织中的其他用户共享 Salesforce 操作连接器。按照以下步骤进行操作：

1. 创建集成后，选择**共享集成**。

1. 选择要与之共享集成的用户或群组。

1. 为共享访问设置适当的权限。

1. 确认共享设置。

共享用户可以使用 Salesforce 集成在连接的 Salesforce 组织内执行操作，但须遵守在原始身份验证设置中配置的权限。

## 管理 Salesforce 操作连接器
<a name="salesforce-integration-management"></a>

创建 Salesforce 操作连接器后，您可以使用以下选项对其进行管理：
+ **编辑操作连接器**-更新身份验证设置或 Salesforce 实例配置。
+ **共享操作连接器**-使组织中的其他用户可以使用操作连接器。
+ **监控使用情况**-查看操作连接器活动和 API 使用情况指标。
+ **查看操作**-查看可用 Salesforce 操作的完整列表。
+ **删除操作连接器**-移除操作连接器并撤消关联的身份验证。