本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 将外部应用程序与 Amazon Connect Customer Profiles 集成
Amazon Connect 提供了一组由亚马逊和 AppFlow 亚马逊提供支持的预建集成。 EventBridge启用 Amazon Connect Customer Profiles 后，您可以使用这些集成将来自外部应用程序（例如 Salesforce 或 Zendesk）的信息与来自 Amazon Connect 的联系人历史记录相结合。这样会创建一份客户资料，该客户资料将座席在客户互动期间所需的全部信息集中在一个位置。
您也可以在 Amazon 中使用客户档案 AppFlow。亚马逊 AppFlow 支持`CustomerProfiles`将其作为目的地。您可以使用 Amazon AppFlow APIs 将数据`CustomerProfiles`作为目标名称发送到客户资料中。
在开始之前，请确保您使用的是客户托管密钥。有关配置 KMS 密钥的更多信息，请参阅[创建 KMS 密钥以供 Customer Profiles 用于加密数据（必需）](enable-customer-profiles.md#enable-customer-profiles-awsmanagedkey)。
## 设置集成
您可以通过在下面选择最适合您的用例的方法，使用 Amazon Connect 中的特色应用程序或使用 Amazon 的外部应用程序 AppFlow 来设置集成。有关与 Slack 集成的更多详细信息，请参阅博客文章[使用 Amazon AppFlow 合并来自多个来源的数据，为联络中心代理建立统一的 Amazon Connect 客户档案](https://aws.amazon.com/blogs/contact-center/unified-customer-data/)。 ServiceNow
**Topics**
+ [设置集成](#setup-integrations-title-menu)
+ [在 Amazon Connect 中为精选应用程序设置集成](integrate-customer-profiles-appflow.md)
+ [使用 Amazon 为外部应用程序设置集成 AppFlow](integrate-external-applications-appflow.md)
+ [删除 Customer Profiles 或停止集成](delete-customer-profile-connection.md)
# 在 Amazon Connect 中为精选应用程序设置集成
这些集成使用 Amazon Connect 精选应用程序为 Amazon Connect Customer Profiles 提供定期更新。
## 开始前的准备工作
### 批量摄取数据
设置集成时，系统会提示您输入要回溯到多远的日期以摄取数据。如果您选择的日期是两个多月前，则 Customer Profiles 会通过创建多个流来自动启用批量摄取。它执行此操作是为了让您不必计算摄取数据所需的流数量。
启用自动批量摄取后，Customer Profiles 会执行以下操作：
+ 将批次大小设置为两个月。
+ 在出现暂时性故障后，在失败之前最多重试三次。
您可以使用 [CreateIntegrationWorkflowRequest](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/CreateIntegrationWorkflowRequest .html)API 来调用自己的批次大小。
### 为什么要求我选择或创建 IAM 角色？
对于 Salesforce、Marketo 和 ServiceNow，Customer Profiles 使用您的 IAM 角色创建多个工作流程来快速高效地摄取数据，从而帮助改善这些来源的历史采集。
对于这些源，如果您在**导入记录的日期**的日期选取器中选择的时间超过 60 天，则系统将提示您创建新的 IAM 角色或选择现有角色。此角色允许 Customer Profiles 管理您的集成。它为 Customer Profiles 提供了必要的权限，以更新和创建用于摄取数据的工作流程。该工作流完成后，Customer Profiles 会创建一个标准的持续集成，当您的新数据在源中更新时，它会摄取这些数据。
在控制台中创建的角色只能由在其中创建该角色的域使用。这是因为 Amazon Connect 会将该角色的访问权限限制为仅允许该域使用的 KMS 密钥。
有关更多信息，请参阅 [授予访问 Customer Profiles 执行角色的最低权限](#grant-least-privilege-cp)。
## 授予访问 Customer Profiles 执行角色的最低权限
如果您想创建自己的 IAM 角色，建议您使用以下代码中显示的权限将该角色限制为所需的最低权限。使用以下代码片段手动创建您的角色。使用您自己的 KMS 密钥并在需要时指定您所在区域。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Condition": {
"ForAnyValue:StringEquals": {
"aws:RequestTag/awsOwningService": "customer-profiles-integration-workflow"
}
},
"Action": [
"appflow:CreateFlow",
"appflow:TagResource",
"profile:TagResource",
"profile:PutIntegration"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "CreateFlowResources"
},
{
"Action": [
"appflow:UseConnectorProfile"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "UseConnectorResources"
},
{
"Condition": {
"ForAnyValue:StringEquals": {
"aws:ResourceTag/awsOwningService": "customer-profiles-integration-workflow"
}
},
"Action": [
"appflow:DescribeFlow",
"appflow:DescribeFlowExecutionRecords",
"appflow:DeleteFlow",
"appflow:StartFlow",
"appflow:StopFlow",
"appflow:UpdateFlow",
"profile:DeleteIntegration"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "AccessFlowResources"
},
{
"Action": [
"kms:CreateGrant",
"kms:ListGrants"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KeyId"
],
"Condition": {
"StringEquals": {
"kms:ViaService": [
"appflow.us-east-1.amazonaws.com"
]
}
},
"Effect": "Allow",
"Sid": "KMSAppflow"
},
{
"Action": [
"kms:CreateGrant"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KeyId"
],
"Condition": {
"StringEquals": {
"kms:ViaService": [
"profile.us-east-1.amazonaws.com"
]
},
"ForAllValues:StringEquals": {
"kms:GrantOperations": [
"Decrypt"
]
}
},
"Effect": "Allow",
"Sid": "KMSCustomerProfiles"
}
]
}
```
------
## 监控您的 Customer Profiles 集成
建立连接后，如果连接停止运行，请删除集成，然后重新建立集成。
## 如果没有发送对象该怎么办
如果对象发送失败，请选择**流详细信息**以详细了解出了什么问题。
您可能需要删除配置并重新连接到外部应用程序。
# 设置 Amazon Connect Cases 的集成
要更新 Amazon Connect 客户档案中的 Amazon Connect 案例数据并使用计算属性等功能，您可以使用亚马逊进行集成 AppIntegrations。首先设置案例事件流以将系统字段发送到 EventBridge 总线，然后使用 Amazon AppIntegrations 将这些事件转发到客户档案。
## 将数据从 Amazon Connect Cases 流式传输到 Event Bridge
1. 打开 Amazon Connect 控制台，网址为[https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)。
1. 在“实例”页面上，选择实例别名。实例别名也是您的**实例名称**，该名称显示在您的 Amazon Connect URL 中。下图显示了 **Amazon Connect 虚拟联系中心实例**页面，其中，实例别名周围有一个方框。
![\[实例别名。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-1.png)
1. 在导航窗格中选择**案例**，并从**域详细信息**部分记下案例域 ID。
![\[“案例”页面，“域详细信息”部分，一个箭头指向域 ID。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-2.png)
1. 使用创建案例事件配置 AWS CLI，将 Amazon Connect 案例事件发送到您的 AWS 账户默认事件桥总线。
```
// set up Case Event Configuration including all system fields
aws connectcases put-case-event-configuration --domain-id --region --event-bridge "{
\"enabled\": true,
\"includedData\": {
\"caseData\": {
\"fields\": [
{
\"id\": \"status\"
},
{
\"id\": \"title\"
},
{
\"id\": \"summary\"
},
{
\"id\": \"reference_number\"
},
{
\"id\": \"created_datetime\"
},
{
\"id\": \"last_updated_datetime\"
},
{
\"id\": \"last_closed_datetime\"
},
{
\"id\": \"customer_id\"
}
]
}
}
}"
```
1. 打开您所在 AWS 地区的事件桥控制台。例如，[https://us-west-2.console.aws.amazon.com/events/家？ region=us-west-2\$1/eventbuses](https://us-west-2.console.aws.amazon.com/events/home?region=us-west-2#/eventbuses)
1. 选择 **Create event bus (创建事件总线)**。
![\[Amazon EventBridge 控制台中的事件总线页面，“创建事件总线” 按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-3.png)
1. 创建名称为 `connect-cases-to-customer-profiles` 的事件总线。
![\[“创建事件总线”页面，“名称”框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-4.png)
1. 返回**默认事件总线**，创建名称为 `connect-cases-to-customer-profiles-rule` 的规则。
![\[默认事件总线，“创建规则”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-5.png)
![\[“构建事件模式”步骤。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-6.png)
+ Event Pattern 片段：
```
{
"source": ["aws.cases"],
"detail": {
"eventType": ["CASE.UPDATED", "CASE.CREATED", "CASE.DELETED"]
}
}
```
![\[“创建方法”部分、“自定义模式（JSON 编辑器）”选项、事件模式代码。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-7.png)
+ 选择**跳过审查和创建**，然后选择**创建规则**。
![\[“跳至审核并创建”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-8.png)
## 使用以下方法将事件桥案例数据提取到客户档案 AppIntegrations
1. 使用创建事件集成 AppIntegrations并记录 ARN 输出。 AWS CLI 这表示 Amazon Connect 实例可以使用的源数据。
```
aws appintegrations create-event-integration --region
--name Connect-Cases-Event-Integration
--event-bridge-bus connect-cases-to-customer-profiles --event-filter
"{\"Source\": \"aws.cases\" }"
--description "Event Integration for Cases Event Bus"
```
1. 使用 AWS CLI，使用 put-integration API 创建与客户档案的集成。这将启动数据流向 Customer Profiles，将占位符值替换为您的 Event Integration ARN 和 Customer Profile 域名。
```
aws customer-profiles put-integration --region
--domain-name
--uri --object-type-name Connect-case
```
## 验证您的 Cases 集成
1. 在 Amazon Connect Cases 中创建案例。
1. 事件传送应该几乎可以在瞬间完成，但要等一分钟才能传送并创建客户配置文件。
1. 使用 AWS CLI，在配置文件下找到 Connect-Case 对象，用正确的值替换占位符。
```
aws customer-profiles list-profile-objects --domain-name
--region
--object-type-name Connect-case --profile-id
```
1. 如果您在上述 API 调用的响应中找不到项目，则说明您的集成存在问题。故障排除：
1. 前往 Amazon EventBridge 控制台。
1. 检查是否 EventSource 处于活动状态，匹配项是否 EventBus 存在且正在运行。
1. 检查您的 Case Event Configuration 是否配置正确。
1. 如果这些方法奏效，请联系 支持 寻求帮助以调查问题。
# 设置 Amazon Connect 与 Salesforce、 ServiceNow、Marketo 或 Zendesk 的集成
要定期更新 Amazon Connect 客户档案，您可以使用亚马逊与 Salesforce ServiceNow、Marketo 或 Zendesk 集成。 AppFlow您首先在 Amazon Connect 和您选择的应用程序中设置连接，然后验证集成。
## 在 Amazon Connect 和 Salesforce、 ServiceNow、Marketo 或 Zendesk 中设置连接
1. 打开 Amazon Connect 控制台，网址为[https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)。
1. 在“实例”页面上，选择实例别名。实例别名也是您的**实例名称**，该名称显示在您的 Amazon Connect URL 中。下图显示了 **Amazon Connect 虚拟联系中心实例**页面，其中，实例别名周围有一个方框。
![\[“Amazon Connect 虚拟联系中心实例”页面, 实例别名。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/instance.png)
1. 在导航窗格中，选择 **Customer Profiles**。
1. 在 **Customer Profiles 配置**页面上，选择**添加集成**，如下图所示。
![\[“Customer Profiles 配置”页面，“添加集成”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. 在**选择数据源**页面上，选择要从哪个外部应用程序中获取客户资料数据。您可以查看[集成要求](https://docs.aws.amazon.com/appflow/latest/userguide/requirements.html)，以更好地了解应用程序所需的连接要求。
![\[“选择数据源”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-cp-salesforce-source.png)
1. 在**建立连接**页面上，选择以下选项之一：
+ **使用现有连接**：这允许您重复使用您可能在 AWS 账户中创建的现有 Amazon AppFlow 资源。
+ **创建新连接**：输入外部应用程序所需的信息。
![\[“建立连接”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-establish-connection.png)
1. 在**集成选项**页面上，选择要摄取的源对象并选择其对象类型。
对象类型可存储您摄取的数据。它们还可定义来自集成的对象在摄取时如何映射到资料。Customer Profiles 提供了默认的对象类型模板，您可以使用这些模板来定义如何将源对象中的属性映射到 Customer Profiles 中的标准对象。您也可以使用从中创建的对象映射。[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)在为用户创建的数据映射添加或创建 Salesforce 集成时，您需要指定特定的数据映射，否则它将为对象类型选择 Salesforce 默认数据映射。您可以创建数据映射并在设置精选数据连接器时使用它。
![\[“集成选项”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-integration-options.png)
1. 对于**摄取开始日期**，Customer Profiles 开始摄取在此日期之后创建的记录。默认情况下，导入记录的日期设置为 30 天前。
1. 在**查看和集成**页面上，检查**连接状态**是否显示为**已连接**，然后选择**创建集成**。
![\[“查看和集成”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-review-and-integrate.png)
1. 设置集成后，返回 **Customer Profiles 配置**页面，选择**查看对象**以查看正在批处理和发送哪些数据。目前，此流程会摄取在过去 30 天内创建或修改的记录。
![\[“Customer Profiles 配置”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-objects.png)
# 为 Segment 设置集成，以便定期更新 Amazon Connect Customer Profiles
要定期更新 Amazon Connect 客户档案，您可以使用亚马逊与 Segment 集成 AppFlow。您首先在 Amazon Connect 和 Segment 中设置连接，然后验证 Segment 集成。
## 在 Amazon Connect 和 Segment 中设置连接
1. 打开 Amazon Connect 控制台，网址为[https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)。
1. 在“实例”页面上，选择实例别名。实例别名也是您的**实例名称**，该名称显示在您的 Amazon Connect URL 中。下图显示了 **Amazon Connect 虚拟联系中心实例**页面，其中，实例别名周围有一个方框。
![\[“Amazon Connect 虚拟联系中心实例”页面, 实例别名。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/instance.png)
1. 在导航窗格中，选择 **Customer Profiles**。
1. 在 **Customer Profiles 配置**页面上，选择**添加集成**。
![\[“Customer Profiles 配置”页面，“添加集成”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. 在**选择数据源**页面上，选择 **Segment**。查看**选择应用程序**页面上列出的应用程序要求。
![\[“选择数据源”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-cp-segment-source.png)
1. 在**建立连接**页面上，选择以下选项之一：
+ **使用现有连接**：这允许您重复使用您可能在中创建的现有 Amazon EventBridge 资源 AWS 账户。
+ **创建新连接**：输入外部应用程序所需的信息。
![\[“建立连接”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-segment-establish-connection.png)
+ **连接名称**：提供您的连接的名称。连接名称由使用此连接的集成引用。
+ **连接 URL**：输入您的应用程序连接 URL。此 URL 用于深度链接到在外部应用程序中创建的对象。连接 URL 是应用程序网站上提供的 Segment 工作区 URL。
查找您的工作区 URL：
1. 登录您的 segment.com 账户。
1. 转至**设置**、**常规设置**。
1. 从浏览器中复制 URL。
1. 客户档案使用亚马逊 EventBridge 与细分市场集成。在**来源设置**页面上，将您的 AWS 账户 身份证复制到剪贴板，然后选择**登录到区段**来配置亚马逊 EventBridge。
1. 按照以下说明设置 Segment：
1. 登录 Segment。
1. 在您的应用程序中，选择一个来源，将目的地设置为 Amazon EventBridge。
1. 粘贴您的 AWS 账户 ID 并选择您所在 AWS 的地区。
1. 切换为**开启**，以激活您的合作伙伴事件源。
1. 转至**事件测试器**，发送测试事件以完成激活您的合作伙伴事件源。
1. **客户端 ID**：这是一个字符串，用于唯一区分外部应用程序中的客户端。此客户端 ID 是应用程序网站上提供的源名称。您可以使用指定的 ID 来标识您希望 Customer Profiles 从中摄取对象的客户端。
查找源 ID：
1. 转至**源**，然后选择源。
1. 转至**设置**、**API 密钥**。
1. 复制您的**源 ID**。
设置事件源目标后，返回 Customer Profiles 控制台并粘贴客户端 ID。
1. 您将会看到一条提示，指示 Amazon Connect 已成功连接到 Segment。
1. 在**集成选项**页面上，选择要摄取的源对象并选择其对象类型。
对象类型可存储您摄取的数据。它们还可定义来自集成的对象在摄取时如何映射到资料。Customer Profiles 提供了默认的对象类型模板，您可以使用这些模板来定义如何将源对象中的属性映射到 Customer Profiles 中的标准对象。您也可以使用从中创建的对象映射。[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
![\[“集成选项”页面，“对象类型”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-integration-options-segment.png)
1. 对于**摄取开始日期**，Customer Profiles 开始摄取在添加集成之后创建的记录。
**注意**
如果您需要历史记录，可以[使用 Amazon S3 作为集成源来导入历史记录](customer-profiles-object-type-mappings.md)。
1. 在**查看和集成**页面上，检查**连接状态**是否显示**已连接**，然后选择**添加集成**。
1. 设置集成后，返回 **Customer Profiles 配置**页面，**集成**页面将显示当前设置的集成。**上次运行**和**集成运行状况**目前不适用于此类集成。
![\[“Customer Profiles 配置”页面，“集成”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
要查看正在发送哪些数据，请选择“集成”和“\$1”，然后选择**查看对象**。
## 验证您的 Segment 集成
要执行此步骤，您需要满足以下先决条件：
+ 访问您的 Segment 工作区。
+ [访问 Amazon Connect 联系人控制面板](amazon-connect-contact-control-panel.md)。
**验证您的 Segment 集成**
1. 转到您的 Segment 工作区控制面板，然后选择**目标**。
![\[Segment 概述页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-segment-1.png)
1. 您将会看到在其中该 Segment 发送数据的目标的列表。选择客户资料的 EventBridge 目的地。
![\[“目标列表”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-segment-2.png)
1. 选择**事件测试器**选项卡。在此页面上，您将向 Customer Profiles 发送测试事件。该事件会被摄取并转换为客户资料，您可以在 Amazon Connect 座席应用程序中查看该资料。
![\[“事件测试器”选项卡。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-segment-3.png)
1. 选择**标识**作为事件类型，然后选择**事件生成器**作为输入方法。
1. 您可以指定**用户 ID** 和一些特性。座席可以在座席应用程序中搜索这些特性。
1. 选择**发送事件**。
1. 事件传送应该几乎可以在瞬间完成，但要等一分钟才能传送并创建客户资料。
1. 打开 Amazon Connect 座席应用程序。搜索您在**事件生成器**中输入的用户 ID。您应该能够看到带有用户 ID 和您输入的特性的客户资料。
1. 如果您看不到客户资料，则说明您的集成存在问题。故障排除：
1. 前往 Amazon EventBridge 控制台。
1. 检查是否 EventSource 处于活动状态，匹配项是否 EventBus 存在且正在运行。
如果这些方法奏效，请联系 支持 寻求帮助以调查问题。
## 监控您的 Customer Profiles 集成
建立连接后，如果连接停止运行，请删除集成，然后重新建立集成。
## 如果没有发送对象该怎么办
如果对象发送失败，请选择**流详细信息**以详细了解出了什么问题。
您可能需要删除配置并重新连接到外部应用程序。
# 为 Shopify 设置集成，以便定期更新 Amazon Connect Customer Profiles
要定期更新 Amazon Connect 客户资料，您可以使用亚马逊与 Shopify 集成 AppIntegrations。您首先在 Amazon Connect 和 Shopify 中设置连接，然后验证 Shopify 集成。
## 在 Amazon Connect 和 Shopify 中设置连接
1. 打开 Amazon Connect 控制台，网址为[https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)。
1. 在“实例”页面上，选择实例别名。实例别名也是您的**实例名称**，该名称显示在您的 Amazon Connect URL 中。下图显示了 **Amazon Connect 虚拟联系中心实例**页面，其中，实例别名周围有一个方框。
![\[“Amazon Connect 虚拟联系中心实例”页面, 实例别名。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/instance.png)
1. 在导航窗格中，选择 **Customer Profiles**。
1. 在 **Customer Profiles 配置**页面上，选择**添加集成**。
![\[“Customer Profiles 配置”页面，“添加集成”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. 在**选择源**页面上，选择 **Shopify**。查看**选择应用程序**页面上列出的应用程序要求。
![\[“选择源”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-cp-shopify-source.png)
1. 在**建立连接**页面上，选择以下选项之一：
+ **使用现有连接**：这允许您重复使用您可能在中创建的现有 Amazon EventBridge 资源 AWS 账户。
+ **创建新连接**：输入外部应用程序所需的信息。
![\[“建立连接”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-shopify-establish-connection.png)
+ **连接名称**：提供您的连接的名称。连接名称由使用此连接的集成引用。
+ **连接 URL**：输入您的应用程序连接 URL。此 URL 用于深度链接到在外部应用程序中创建的对象。连接 URL 是应用程序网站上提供的 Shopify Partner 应用程序 URL。
查找您的 Shopify Partner 应用程序 URL：
+ 登录您的 partners.shopify.com 账户。
+ 转至您的应用程序。
+ 从浏览器中复制 URL。
+ **客户端 ID**：输入您的应用程序客户端 ID。这是一个字符串，用于唯一区分外部应用程序中的客户端。此客户端 ID 是应用程序网站上提供的源名称。您可以使用此处指定的 ID 来标识您希望 Customer Profiles 从中摄取对象的客户端。按照源设置步骤操作后，您的客户端 ID 可能可用。
查找您的源名称：
+ 登录您的 partners.shopify.com 账户。
+ 转至您的应用程序。
+ 从您的 Amazon EventBridge 事件源中复制源名称。
1. 在**来源设置**页面上，将您的 AWS 账户 身份证复制到剪贴板，然后选择**登录 Shopify**。
1. 按照以下说明设置 Shopify：
1. 登录 partners.shopify.com。
1. 在 Amazon 下 EventBridge，选择**创建来源**。
1. 粘贴您的 AWS 账户 ID 并选择您所在 AWS 的地区。
1. 设置事件源目标后，返回 Customer Profiles。您将会看到一条提示，指示 Amazon Connect 已成功连接到 Shopify。
1. 在**集成选项**页面上，选择要摄取的源对象并选择其对象类型。
对象类型可存储您摄取的数据。它们还可定义来自集成的对象在摄取时如何映射到资料。Customer Profiles 提供了默认的对象类型模板，您可以使用这些模板来定义如何将源对象中的属性映射到 Customer Profiles 中的标准对象。您也可以使用从中创建的对象映射。[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
![\[“集成选项”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-integration-options-shopify.png)
1. 对于**摄取开始日期**，Customer Profiles 开始摄取在添加集成之后创建的记录。
**注意**
如果您需要历史记录，可以[使用 Amazon S3 作为集成源来导入历史记录](customer-profiles-object-type-mappings.md)。
1. 在**查看和集成**页面上，检查**连接状态**是否显示**已连接**，然后选择**添加集成**。
**注意**
添加此集成后，您需要[设置 webhook 订阅](#shopify-webhook-subscriptions)以允许事件开始流入此集成。
![\[“查看和集成”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook.png)
1. 设置集成后，返回 **Customer Profiles 配置**页面，**集成**分区将显示当前设置的集成。**上次运行**和**集成运行状况**目前不适用于此类集成。
![\[“集成”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
要查看正在发送哪些数据，请选择“集成”，然后选择**查看对象**。
1. 转到下一步，使用 API 设置 **webhook 订阅**，以便事件可以开始流入此集成。
## 设置 webhook 订阅
1. 使用以下 URL 确保您的应用程序具有所需的权限：
```
https://{shop}.myshopify.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}&state={nonce}
```
其中：
+ `shop` 是您的 Shopify 商店的名称。
+ `api_key` 是您的 Shopify 应用程序的 API 密钥。您可以在 Shopify **应用程序**详细信息页面上找到此信息。
+ `scopes` 的值应为 `read_customers,read_orders,read_draft_orders`。
+ `redirect_uri` 是您在创建应用程序时为其指定的重定向 URI。出于我们的目的，它可以是任何有效的 URL。
+ `nonce` 可以是任何唯一值，用于标识来自其他人的给定授权请求。建议使用时间戳。
构建 URL 后，将其粘贴到浏览器中。将显示一个与下图类似的 installation/authorization 页面，要求商店所有者为定义的范围提供权限。
![\[用于安装和授权应用程序的 shopify 页面示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook-embedded-app.png)
1. 选择**安装未列出的应用程序**，以代表您的商店安装和授权应用程序。
您将进入您输入的重定向 URI，并将授权代码附加到重定向 URI 中作为查询参数。例如：
```
https://example.org/some/redirect/uri?code={authorization_code}&hmac=da9d83c171400a41f8db91a950508985&host={base64_encoded_hostname}×tamp=1409617544&state={nonce}&shop={shop_origin}&host={host}
```
1. 从此 URI 中复制 `authorization_code`。在后续步骤中，您将使用它来获取永久访问令牌。
1. 转到您用于进行 API 调用的任何工具。例如 [CURL](https://curl.se/) 或 [POSTMAN](https://www.postman.com/)。
1. 要获取永久访问令牌，向此端点发出对 Shopify `Admin` API 的 POST 请求：
```
https://{shop}.myshopify.com/admin/oauth/access_token
```
请求正文如下：
```
{
"code": "authorization_code_received_from_redirect_uri",
"client_id": "your_app_api_key",
"client_secret": "your_app_api_secret"
}
```
此请求返回以下响应：
```
{
"access_token": "permanent_access_token",
"scope": "read_customers,read_orders,read_draft_orders"
}
```
1. 记下 `access_token`。这是一个永久令牌，具有上一步中提供的范围。现在，您已准备好创建 webhook 订阅。
1. 对于以下 API 调用，请务必将 HTTP 标头键 `X-Shopify-Access-Token` 设置为从先前调用的响应中收到的 `access_token`。
1. 要设置 webhook 订阅，请对下一步中列出的每个 `topic` 值发出以下 POST 请求：
端点：`https://{shop}.myshopify.com/admin/api/2021-04/webhooks.json`
请求正文：
```
{
"webhook": {
"topic": "replace_this_with_one_of_the_topics_in_the_list_below",
"address": "this_is_the_event_source_arn_generated_when_you_created_the_event_integration",
"format": "json"
}
}
```
1. 对于每个订阅，将 `topic` 的值替换为以下值：
+ `customers/create`
+ `customers/enable`
+ `customers/update`
+ `draft_orders/create`
+ `draft_orders/update`
+ `orders/cancelled`
+ `orders/create`
+ `orders/fulfilled`
+ `orders/paid`
+ `orders/partially_fulfilled`
+ `orders/updated`
现在，您已经准备好接收来自您的 Shopify 商店的事件。接下来，验证您的 Shopify 集成。
## 验证您的 Shopify 集成
1. 以管理员身份登录您的 Shopify 商店。
1. 在左侧导航菜单中，选择**客户**。
1. 选择**添加客户**。
1. 输入您的客户详细信息。请务必输入电话号码和电子邮件。这些信息不一定属于真实的客户。验证集成后，您将删除此客户输入条目。
1. 保存客户对象。
1. 事件传送应该几乎可以在瞬间完成，但要等一分钟才能传送并创建客户资料。
1. 打开 Amazon Connect 座席体验，然后通过您在 Shopify 商店中输入的电子邮件或电话号码查找用户。您应该能够看到具有相同电子邮件或电话号码的客户资料。
1. 如果您看不到客户资料，则说明您的集成存在问题。故障排除：
1. 前往 Amazon EventBridge 控制台。
1. 检查是否 EventSource 处于活动状态，匹配项是否 EventBus 存在且正在运行。
如果这些方法奏效，请联系 支持 寻求帮助以调查问题。
## 监控您的 Customer Profiles 集成
建立连接后，如果连接停止运行，请删除集成，然后重新建立集成。
## 如果没有发送对象该怎么办
如果对象发送失败，请选择**流详细信息**以详细了解出了什么问题。
您可能需要删除配置并重新连接到外部应用程序。
# 使用 Amazon 为外部应用程序设置集成 AppFlow
这些集成使用亚马逊 AppFlow 来定期更新 Amazon Connect 客户资料。以下步骤提供了有关如何使用 Amazon 配置您选择的连接器 AppFlow、配置数据映射以及配置集成以提取客户数据的指导。
有关亚马逊 AppFlow 定价的更多信息，请参阅亚马逊 AppFlow [定价](https://aws.amazon.com/appflow/pricing/)。
有关 Amazon AppFlow 支持的连接器的更多信息，请参阅[支持的源和目标应用程序](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html)。
## 开始前的准备工作
当您启用 Amazon Connect Customer Profiles 时，您将创建一个 Customer Profiles 域，该域是所有数据（如客户资料、对象类型、资料密钥和加密密钥）的容器。以下是创建客户资料域的指南：
+ 每个 Amazon Connect 实例只能与一个域关联。
+ 您可以创建多个域，但它们之间不会共享外部应用程序集成或客户数据。
+ 您创建的所有外部应用程序集成均处于域级别。所有与域关联的 Amazon Connect 实例均会继承该域的集成。
**先决条件：在您的 Amazon Connect 实例中启用客户资料**
1. 打开 Amazon Connect 控制台，网址为[https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)。
1. 在“实例”页面上，选择实例别名。实例别名也是您的**实例名称**，该名称显示在您的 Amazon Connect URL 中。下图显示了 **Amazon Connect 虚拟联系中心实例**页面，其中，实例别名周围有一个方框。
1. 在导航窗格中，选择 **Customer Profiles**。
1. 选择“启用 Customer Profiles”
在表单中，您需要按照以下步骤填写所有必填字段，才能创建 Customer Profiles 域：
1. **域设置**。您可以创建新域并提供名称。
1. **加密**。在“指定 KMS 密钥”下，您可以通过选择现有 AWS KMS 密钥、创建新的 AWS KMS 密钥来启用加密，也可以选择**选择现有域**。
1. **错误报告**。您可以提供死信队列，这是处理客户资料错误的 SQS 队列
1. 选择**提交**，系统将使用您的实例的联系人历史记录信息创建客户资料。
### 使用 Amazon 设置外部应用程序 AppFlow
您可以按照以下步骤使用亚马逊，向 Amazon Connect 客户档案域添加外部应用程序集成。 AppFlow 在继续使用客户资料控制台之前，您必须先在 Amazon AppFlow 控制台中为数据源创建流程，并将 Amazon Connect 客户档案设置为目标。如果您在超过 14 天前创建了流，则该流已过期，您需要为集成创建一个新流。
您可以选择在摄取之前使用 CloudFormation `AWS::AppFlow::Flow Task`资源`Validate`时执行数据转换，例如`Arithmetic``Filter``Map``Map_all``Mask``Merge`、`Truncate`、、、、、、、和。
1. 登录您的 AWS 管理控制台，选择 Amazon AppFlow，然后选择**创建流程**。
![\[亚马逊 AppFlow 页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step1.png)
1. 输入流名称和可选的流描述。
![\[“流详细信息”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step2.png)
1. 您可以按原样保留 “**数据加密**” 部分，因为您的 Amazon Connect 客户档案域已有用于此流程的现有 AWS KMS 密钥。您可以选择创建标签，然后选择**下一步**。
![\[“数据加密”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step3.png)
1. 在**源名称**下拉列表中选择您所选的外部应用程序，然后选择下一个相关字段。例如，如果您想配置 Slack，请从**源名称**下拉列表中选择 Slack。然后，您可以选择现有的 Slack 流或创建新连接。
![\[“配置流”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step4.png)
1. 如果您选择创建新连接，则可以输入外部应用程序的详细信息，例如用户名、密码和子域。您也可以选择用于数据加密的 AWS KMS 密钥并输入连接名称来标识此连接。
![\[“连接到 Slack”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step5.png)
1. 如果您选择使用现有连接，则可以从下拉列表中选择特定的外部应用程序对象。例如，如果选择现有的 Slack 连接，则可以选择**对话**作为对象，然后选择要使用的特定 Slack 频道。
![\[“源详细信息”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step6.png)
1. 在**目标详细信息**部分，在下拉列表中选择 Amazon Connect 作为目标名称，然后选择在前一个先决条件步骤中创建的客户资料域。
![\[“目标详细信息”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step7.png)
1. 通过选择**按需运行**或**按计划时间运行流**来选择流触发器。选择**下一步**。
+ **按需运行**仅在触发流时运行流。
+ **按计划时间运行流**使用计划在特定时间运行流。计划频率限制为 5 分钟、15 分钟或 1 小时。
![\[“流触发器”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step8.png)
1. 在**映射方法**下选择**手动映射字段**。从外部应用程序中选择源字段，然后选择**直接映射字段**。
![\[“映射方法”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step9.png)
1. 查看并选择**创建流**。
有关在 Amazon AppFlow 控制台中创建流程的更多信息，请参阅在 A [mazon 中创建流程 AppFlow](https://docs.aws.amazon.com/appflow/latest/userguide/create-flow.html)。
有关在 Amazon 中设置外部应用程序和许多其他支持的应用程序的更多信息 AppFlow，请参阅[支持的亚马逊 AppFlow 源应用程序和目标应用程序](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html)。
### 设置数据映射以定义如何将外部应用程序数据映射到客户资料
设置Amazon AppFlow 集成后，您需要在客户档案中设置数据映射，以定义如何将来自外部应用程序的数据映射到客户档案。这样，您就可以自定义要用于构建统一客户资料的数据。请谨慎选择您的映射，因为在创建集成后您将无法选择其他映射。
有关数据映射的更多详细信息，请参阅[对象类型映射](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-object-type-mapping.html)。
1. 登录您的 AWS 管理控制台，选择 **Amazon Connect**。然后在您的连接实例别名下选择客户档案。
![\[“Amazon Connect Customer Profiles”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-mapping-step1.png)
1. 选择**数据映射**，然后选择**创建数据映射**。提供数据映射名称和描述。
![\[“数据映射”选项卡，“创建数据映射”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2.png)
![\[“设置数据映射”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2_2.png)
1. 在**映射选项**下，可以选择您的**数据源**作为外部应用程序，选择在上一节中创建的**流名称**以及**数据定义方法**作为*映射目标*。在**映射目标**下，您可以选择要为统一的客户资料定义的客户数据类型。选择**下一步**。
![\[“映射选项”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-mapping-step3.png)
1. 添加客户、产品、案例和订单属性以及源、目标和内容类型，然后选择**下一步**。
![\[“映射订单属性”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-mapping-step4.png)
1. 在**指定标识符**下，您可以从数据源对象中选择各种属性，以帮助将您的数据与其他数据源对象区分开来。您可以从唯一标识符、客户标识符、产品标识符、案例标识符和订单标识符中选择属性。有关标识符的更多信息，请参阅[在 Customer Profiles 中设置密钥属性的标准标识符](standard-identifiers.md)。
![\[“标准标识符”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-mapping-step5.png)
1. 查看并选择**创建数据映射**。数据映射状态将显示为*活动*。
![\[“步骤 6：指定标识符”页面上的标识符。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-mapping-step6.png)
### 设置集成以从外部应用程序摄取您的客户数据
完成外部应用程序的数据映射设置后，您将设置数据源集成以摄取客户数据。
1. 登录您的 AWS 管理控制台，选择 **Amazon Connect**，然后在您的连接实例别名下选择 Customer Profiles。
1. 在**数据源集成**分区下，选择**添加数据源集成**。
![\[“数据源集成”选项卡，“添加数据源集成”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step2.png)
1. 在**数据源**下拉列表下，选择外部应用程序，然后选择**下一步**。您还可以选择**创建新流程，这将在新**选项卡中打开Amaz AppFlow on控制台。
![\[“数据源”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step3.png)
1. 在**流名称**下拉列表中，从数据源中选择要使用的流，然后选择**下一步**。
![\[选择流程名称以建立连接。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step4.png)
1. 在**数据映射**下拉列表中，选择对象的外部应用程序数据映射，以定义数据源如何映射到资料。选择**下一步**。
![\[“选择数据映射”页面，“映射”下拉框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step5.png)
1. 查看并选择**添加数据源集成**。在进入活动状态之前，外部应用程序的数据源集成最初将显示为待处理。
![\[“查看和集成”页面，“添加数据源集成”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step6.png)
### 在 Amazon Connect Customer Profile 座席 CCP 中查看统一的客户资料
现在，您的座席可以通过登录 Amazon Connect 座席 CCP 来查看从外部应用程序导入的客户数据。有关连接到 Amazon Connect 座席 CCP 的更多信息，请参阅[座席应用程序：一应俱全](https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-contact-control-panel.html#use-agent-application)。
您的座席需要拥有相应的安全配置文件权限才能查看 Customer Profiles，并能够使用配置文件搜索栏中的密钥名称和值执行搜索。
有关安全配置文件权限的更多信息，请参阅[安全配置文件](https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html)。
高级用户如果想建立自己的定制座席应用程序和嵌入式客户配置文件，可以使用 [StreamsJS](https://github.com/amazon-connect/amazon-connect-customer-profiles)，它能为座席应用程序提供更多定制功能。
# 删除 Customer Profiles 或停止集成
**注意**
删除映射只会删除与该特定映射相关联的对象和数据。如果有多个对象与一个资料相关联，则删除特定的映射可能无法清除资料数据。如果要删除特定数据，则需要删除相应的映射，但是如果您的资料包含来自其他映射的数据，则这些资料可能仍将存在。这样可能会导致针对现有资料产生额外费用。您可以使用[Amazon Connect 控制台](delete-customer-profiles-domain.md)或 [DeleteDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_DeleteDomain.html)API 删除域名和客户资料中的所有数据，包括所有个人资料。
**控制台方法**
+ **如果您想随时停止提取客户资料数据，请选择， integration/mapping 然后选择删除。**
+ 要删除集成、客户资料和所有客户资料数据，可以在 Amazon Connect 控制台中删除您的客户资料域。有关更多信息，请参阅 [删除 Amazon Connect Customer Profiles 域](delete-customer-profiles-domain.md)。
**API 方法**
+ 要删除特定集成的客户资料数据，请使用 `DeleteProfileObjectType` API。
+ 要删除集成、客户资料和所有客户资料数据，请使用 `DeleteDomain` API。
要重新启用客户资料数据的摄取，请再次执行设置步骤。