翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Connect のおすすめアプリケーションの統合をセットアップする
これらの統合は、Amazon Connect のおすすめアプリケーションを使用して、Amazon Connect Customer Profiles を定期的に更新します。
## [開始する前に]
### データの一括取り込み
統合を設定すると、データの取り込みを開始する日付を入力するように求められます。2 か月以上前の日付を選択した場合、複数のフローを作成することで、Customer Profiles の一括取り込みが自動的に有効になります。これにより、データを取り込むのに必要なフロー数を計算する必要がなくなります。
自動一括取り込みが有効になっている場合、Customer Profiles では次の処理を実行します。
+ バッチサイズを 2 か月に設定します。
+ 一時的な障害に対しては、最大 3 回再試行してから失敗とします。
[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 Customer Profiles で Amazon Connect Cases データを更新し、計算属性などの機能を使用するには、Amazon AppIntegrations を使用して統合できます。まず、EventBridge バスにシステムフィールドを送信するように Cases イベントストリームを設定してから、Amazon AppIntegrations を使用してこれらのイベントを Customer Profiles に転送します。
## 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/ja_jp/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-1.png)
1. ナビゲーションペインで **[ケース]** を選択し、**[ドメインの詳細]** セクションにある Cases ドメイン ID をメモします。
![\[Cases ページ、ドメインの詳細セクション、ドメイン ID を指す矢印。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-2.png)
1. を使用して AWS CLI、Amazon Connect Cases Events を AWS アカウントデフォルトの Event Bridge バスに送信する Case イベント設定を作成します。
```
// 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 リージョンの Event Bridge コンソールを開きます。例: [https://us-west-2.console.aws.amazon.com/events/home?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/ja_jp/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/ja_jp/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/ja_jp/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-5.png)
![\[イベントパターンの構築手順。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-6.png)
+ イベントパターンのスニペット:
```
{
"source": ["aws.cases"],
"detail": {
"eventType": ["CASE.UPDATED", "CASE.CREATED", "CASE.DELETED"]
}
}
```
![\[作成方法セクション、カスタムパターン (JSON エディタ) オプション、イベントパターンコード。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-7.png)
+ **[スキップして確認および作成]**、**[ルールを作成]** の順に選択します。
![\[スキップして確認および作成ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-8.png)
## AppIntegrations を使用して Event Bridge ケースデータを Customer Profiles に取り込む
1. を使用して AWS CLI、AppIntegrations とのイベント統合を作成し、ARN 出力を記録します。 これは、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 との統合を作成します。これにより、Customer Profiles へのデータフローが開始され、プレースホルダーの値がイベント統合 ARN と Customer Profile のドメイン名に置き換えられます。
```
aws customer-profiles put-integration --region
--domain-name
--uri --object-type-name Connect-case
```
## Cases 統合を検証する
1. Amazon Connect Cases でケースを作成します。
1. イベントの配信はほぼ瞬時に行われるはずですが、配信されて顧客プロファイルに関連付けられるまで 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 イベント設定が正しく設定されているかどうかを確認します。
1. これらが機能している場合は、問題の調査 サポート について にお問い合わせください。
# Salesforce、ServiceNow、Marketo、または Zendesk と Amazon Connect の統合を設定する
Amazon Connect Customer Profiles を定期的に更新するには、Amazon AppFlow を使用して Salesforce、ServiceNow、Marketo、または Zendesk と統合できます。最初に 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/ja_jp/connect/latest/adminguide/images/instance.png)
1. ナビゲーションペインで、**[Customer profiles]** (お客様プロファイル) を選択します。
1. 次の図に示すように、**[顧客プロファイルの設定]** ページで **[統合を追加]** を選択します。
![\[[顧客プロフィール設定] ページ、[統合を追加] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. **[データソースの選択]** ページで、顧客プロファイルデータを取得する外部アプリケーションを選択します。[[integration requirements]](https://docs.aws.amazon.com/appflow/latest/userguide/requirements.html) (統合要件) を参照すると、アプリケーションの接続要件を詳しく確認できます。
![\[[データソースの選択] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-cp-salesforce-source.png)
1. **[接続の確立]** ページで、以下のいずれかを選択します。
+ **既存の接続を使用**: これにより、AWS アカウントなどで作成した既存の Amazon AppFlow リソースを再利用できます。
+ **新しい接続を作成**: 外部アプリケーションで必要な情報を入力します。
![\[[接続の確立] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-establish-connection.png)
1. **[Integration options]** (統合オプション) ページで、取り込むソースオブジェクトを選択し、そのオブジェクトタイプを選択します。
オブジェクトタイプには、取り込まれたデータが保存されます。また、統合からオブジェクトが取り込まれたときにプロファイルにマッピングされる方法も定義します。Customer Profiles には、ソースオブジェクトの属性が Customer Profiles の標準オブジェクトにどのようにマッピングされるかを定義できる、デフォルトのオブジェクトタイプテンプレートが用意されています。また、[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) から作成したオブジェクトマッピングを使用することもできます。ユーザーが作成したデータマッピングの Salesforce 統合を追加または作成する場合、特定のデータマッピングを指定する必要があります。指定しないと、Salesforce のデフォルトのデータマッピングがオブジェクトタイプとして選択されます。データマッピングを作成し、これを使用しておすすめのデータコネクタを設定できます。
![\[[統合オプション] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-integration-options.png)
1. **[Ingestion start date]** (取り込み開始日) の場合、Customer Profiles はこの日付以降に作成されたレコードの取り込みを開始します。デフォルトでは、レコードのインポート日は 30 日前に設定されます。
1. [**確認と統合**] ページで、[**接続ステータス**] が [**接続済み**] であることを確認してから、[**統合の作成**] を選択します。
![\[[確認と統合] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-review-and-integrate.png)
1. 統合の設定後、**[Customer profiles configuration]** (お客様プロファイルの設定) ページに戻って **[View objects]** (オブジェクトの表示) を選択して、どのデータがバッチ処理され、送信されているかを確認します。現在、このプロセスは、直近 30 日間に作成または変更されたレコードを取り込みます。
![\[[顧客プロファイル設定] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-objects.png)
# Amazon Connect Customer Profiles に定期的な更新を提供するためにセグメントの統合を設定する
Amazon Connect Customer Profiles を定期的に更新するために、Amazon AppFlow を使用してセグメントと統合できます。最初に 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 仮想コンタクトセンターのインスタンス]** ページを示しています。インスタンスエイリアスがボックスで囲まれています。
![\[[Amazon Connect 仮想コンタクトセンターのインスタンス] ページ、インスタンスのエイリアス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/instance.png)
1. ナビゲーションペインで、[**お客様プロファイル**] を選択します。
1. **[お客様プロファイルの設定]** ページで **[統合の追加]** を選択します。
![\[[顧客プロファイル設定] ページ、[統合を追加] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. **[データソースの選択]** ページで、**[セグメント]** を選択します。**[アプリケーションの選択]** ページに記載されているアプリケーションの要件を確認します。
![\[[データソースの選択] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-cp-segment-source.png)
1. **[接続の確立]** ページで、以下のいずれかを選択します。
+ **既存の接続**を使用する: これにより、 で作成した既存の Amazon EventBridge リソースを再利用できます AWS アカウント。
+ **新しい接続を作成**: 外部アプリケーションで必要な情報を入力します。
![\[[接続の確立] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-segment-establish-connection.png)
+ **接続名**: 接続の名前を指定します。接続名は、この接続を使用する統合によって参照されます。
+ **接続 URL**: アプリケーション接続 URL を入力します。この URL は、外部アプリケーションで作成されたタスクへのディープリンクに使用されます。接続 URL は、アプリケーションウェブサイトで使用できるセグメントワークスペースの URL です。
ワークスペース URL を検索するには:
1. segment.com アカウントにログインします。
1. **[Settings]** (設定) 、**[General settings]** (全般設定) と移動します。
1. ブラウザから URL をコピーします。
1. Customer Profiles は、セグメントとの統合に Amazon EventBridge を使用します。**ソース設定**ページで、 AWS アカウント ID をクリップボードにコピーし、**セグメントにログイン**して Amazon EventBridge を設定します。
1. 次のステップに従って、セグメントを設定します。
1. セグメントにログインします。
1. アプリケーションで、Amazon EventBridge への送信先を設定するソースを選択します。
1. AWS アカウント ID を貼り付け、 AWS リージョンを選択します。
1. **[ON]** (オン) に切り替え、パートナーイベントソースをアクティブ化します。
1. **[Event Tester]** (イベントテスター) へ移動し、テストイベントを送信して、パートナーイベントソースのアクティブ化を完了します。
1. **クライアント ID**: これは、外部アプリケーションでクライアントを一意に区別する文字列です。このクライアント ID は、アプリケーションウェブサイトで使用できるソース名です。指定した ID を使用して、Customer Profiles でオブジェクトを取り込むクライアントを特定します。
ソース ID を検索するには、次の操作を行います。
1. **[Sources]** (ソース) へ移動し、ソースを選択します。
1. **[Settings]** (設定) 、**[API Keys]** (API キー) と移動します。
1. **[Source ID]** (ソース ID) をコピーします。
イベントソースの送信先を設定したら、Customer Profiles コンソールに戻り、クライアント ID をペーストします。
1. Amazon Connect がセグメントに正常に接続されたことを示すアラートが表示されます。
1. **[Integration options]** (統合オプション) ページで、取り込むソースオブジェクトを選択し、そのオブジェクトタイプを選択します。
オブジェクトタイプには、取り込まれたデータが保存されます。また、統合からオブジェクトが取り込まれたときにプロファイルにマッピングされる方法も定義します。Customer Profiles には、ソースオブジェクトの属性が Customer Profiles の標準オブジェクトにどのようにマッピングされるかを定義できる、デフォルトのオブジェクトタイプテンプレートが用意されています。また、[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) から作成したオブジェクトマッピングを使用することもできます。
![\[[統合オプション] ページ、[オブジェクトタイプ] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-integration-options-segment.png)
1. [**Ingestion start date**] (取り込み開始日) の場合、Customer Profiles は統合が追加された日付以降に作成されたレコードの取り込みを開始します。
**注記**
履歴レコードが必要な場合は、[インポートする統合ソースとして Amazon S3 を使用](customer-profiles-object-type-mappings.md)することができます。
1. **[Review and integrate]** (確認と統合) ページで、**[Connection status]** (接続ステータス) が **[Connected]** (接続済み) であることを確認してから、**[Add integration]** (統合の追加) を選択します。
1. 統合が設定されたら、**[Customer profiles configuration]** (Customer Profiles の設定) ページに戻ります。**[Integrations]** (統合) ページには、現在設定されている統合が表示されます。**[Last run]** (最後の実行) および **[Integration health]** (統合ヘルス) は、このタイプの統合では現在使用できません。
![\[[顧客プロフィール設定] ページ、[統合] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
送信されているデータを確認するには、統合を選択してから、**[View objects]** (オブジェクトの表示) を選択します。
## セグメントの統合を確認する
このステップを実行するには、次の前提条件を満たしている必要があります。
+ セグメントワークスペースにアクセスします。
+ [Amazon Connect お問い合わせコントロールパネルへのアクセス](amazon-connect-contact-control-panel.md)。
**セグメントの統合を確認するには**
1. セグメントワークスペースダッシュボードに移動し、**[Destinations]** (送信先) を選択します。
![\[[セグメント概要] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-segment-1.png)
1. セグメントがデータを送信する送信先のリストが表示されます。Customer Profiles の EventBridge 送信先 を選択します。
![\[[送信先一覧] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-segment-2.png)
1. **[Event Tester]** (イベントテスター) タブを選択します。このページから、Customer Profiles にテストイベントを送信します。イベントが取り込まれ、Amazon Connect エージェントアプリケーションで表示できる Customer Profiles に変換されます。
![\[[イベントテスター] タブ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-segment-3.png)
1. イベントタイプとして **[Identify]** (識別) を選択し、入力方法として **[Event Builder]** を選択します。
1. **ユーザー ID** といくつかの特性を指定できます。エージェントは、エージェントアプリケーションでこれらの特性を検索できます。
1. **[Send Event]** (イベントの送信) を選択します。
1. イベントの配信はほぼ瞬時に行う必要がありますが、配信して顧客プロファイルを作成するには 1 分ほどかかります。
1. Amazon Connect エージェントアプリケーションを開きます。[**Event Builder**] で入力したユーザ ID を検索します。ユーザー ID と入力した特性を持つ顧客プロファイルが表示されます。
1. 顧客プロファイルが表示されない場合は、統合に問題があります。トラブルシューティング：
1. Amazon EventBridge コンソールに移動します。
1. EventSource がアクティブで、一致する EventBus が存在し、実行されているかどうかを確認します。
これらが機能している場合は、問題の調査 サポート について にお問い合わせください。
## Customer Profiles 統合をモニタリングする
接続が確立されてから動作しなくなったら、統合を削除してから再確立します。
## オブジェクトが送信されていない場合の対処方法
オブジェクトの送信に失敗した場合には、[**フローの詳細**] をクリックして不具合の詳細を表示します。
設定を削除して、外部アプリケーションに再接続する必要がある場合があります。
# Amazon Connect Customer Profiles に定期的な更新を提供するために Shopify の統合を設定する
Amazon Connect Customer Profiles を定期的に更新するために、Amazon AppIntegrations を使用して Shopify と統合できます。最初に 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/ja_jp/connect/latest/adminguide/images/instance.png)
1. ナビゲーションペインで、[**お客様プロファイル**] を選択します。
1. **[お客様プロファイルの設定]** ページで **[統合の追加]** を選択します。
![\[[顧客プロフィール設定] ページ、[統合を追加] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. **[Select source]** (ソースの選択) ページで、**[Shopify]** を選択します。**[アプリケーションの選択]** ページに記載されているアプリケーションの要件を確認します。
![\[[ソースの選択] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-cp-shopify-source.png)
1. **[接続の確立]** ページで、以下のいずれかを選択します。
+ **既存の接続**を使用する: これにより、 で作成した既存の Amazon EventBridge リソースを再利用できます AWS アカウント。
+ **新しい接続を作成**: 外部アプリケーションで必要な情報を入力します。
![\[[接続の確立] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-shopify-establish-connection.png)
+ **接続名**: 接続の名前を指定します。接続名は、この接続を使用する統合によって参照されます。
+ **接続 URL**: アプリケーション接続 URL を入力します。この URL は、外部アプリケーションで作成されたタスクへのディープリンクに使用されます。接続 URL は、アプリケーションウェブサイトで使用できる Shopify パートナーアプリの URL です。
Shopify パートナーアプリの URL を見つけるには:
+ partners.shopify.com アカウントにログインします。
+ アプリに移動します。
+ ブラウザから URL をコピーします。
+ **クライアント ID**: アプリケーションクライアント ID を入力します。これは、外部アプリケーションでクライアントを一意に区別する文字列です。このクライアント ID は、アプリケーションウェブサイトで使用できるソース名です。ここで指定した ID を使用して、Customer Profiles でオブジェクトを取り込むクライアントを特定します。クライアント ID は、ソースの設定ステップを実行した後に利用可能になる場合があります。
ソース名を見つけるには:
+ partners.shopify.com アカウントにログインします。
+ アプリに移動します。
+ Amazon EventBridge イベントソースからソース名をコピーします。
1. **ソース設定**ページで、 AWS アカウント ID をクリップボードにコピーし、「Log **in to Shopify**」を選択します。
1. 次のステップに従って、Shopify を設定します。
1. partners.shopify.com にログインします。
1. Amazon EventBridge で、**[Create source]** (ソースの作成) を選択します。
1. AWS アカウント ID を貼り付け、 AWS リージョンを選択します。
1. イベントソースの送信先を設定したら、Customer Profiles に戻ります。Amazon Connect が Shopify に正常に接続されたことを示すアラートが表示されます。
1. [**Integration options**] (統合オプション) ページで、取り込むソースオブジェクトを選択し、そのオブジェクトタイプを選択します。
オブジェクトタイプには、取り込まれたデータが保存されます。また、統合からオブジェクトが取り込まれたときにプロファイルにマッピングされる方法も定義します。Customer Profiles には、ソースオブジェクトの属性が Customer Profiles の標準オブジェクトにどのようにマッピングされるかを定義できる、デフォルトのオブジェクトタイプテンプレートが用意されています。また、[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) から作成したオブジェクトマッピングを使用することもできます。
![\[[統合オプション] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-integration-options-shopify.png)
1. [**Ingestion start date**] (取り込み開始日) の場合、Customer Profiles は統合が追加された日付以降に作成されたレコードの取り込みを開始します。
**注記**
履歴レコードが必要な場合は、[インポートする統合ソースとして Amazon S3 を使用](customer-profiles-object-type-mappings.md)することができます。
1. **[Review and integrate]** (確認と統合) ページで、**[Connection status]** (接続ステータス) が **[Connected]** (接続済み) であることを確認してから、**[Add integration]** (統合の追加) を選択します。
**注記**
この統合を追加したら、次の作業を行う必要があります。[Webhook サブスクリプションを設定](#shopify-webhook-subscriptions)して、イベントがこの統合に流入し始めることを許可します。
![\[[確認と統合] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook.png)
1. 統合が設定されたら、**[顧客プロファイル設定]** ページに戻ります。**[統合]** セクションに、現在設定されている統合が表示されます。**[Last run]** (最後の実行) および **[Integration health]** (統合ヘルス) は、このタイプの統合では現在使用できません。
![\[[統合] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
送信されているデータを確認するには、統合を選択してから、**[View objects]** (オブジェクトの表示) を選択します。
1. 次のステップに進み、API を使用して、**[webhook subscriptions]** (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 **[App]** 詳細ページ にあります。
+ `scopes` は、値 `read_customers,read_orders,read_draft_orders` が必要です。
+ `redirect_uri` は、アプリの作成時に指定したリダイレクト URI です。私たちの目的では、任意の有効な URL にすることができます。
+ `nonce` は、他の要求からの特定の承認要求を識別するために、任意の一意の値を指定できます。タイムスタンプを使用することをお勧めします。
URL を作成したら、ブラウザに貼り付けます。次のイメージのようなインストール/承認ページが表示され、ストア所有者に定義済みのスコープに対する許可を付与するよう求められます。
![\[アプリをインストールして承認するための Shopify ページの例。\]](http://docs.aws.amazon.com/ja_jp/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 リクエストを作成します。
```
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. 左のナビゲーションメニューの **[Customers]** (顧客) を選択します。
1. **[Add Customer]** (顧客の追加) を選択します。
1. 顧客の詳細を入力します。電話番号と E メールアドレスを必ず入力してください。これらは実際の顧客に属している必要はありません。このカスタマーエントリは、統合の検証後に削除されます。
1. 顧客オブジェクトを保存します。
1. イベントの配信はほぼ瞬時に行う必要がありますが、配信して顧客プロファイルを作成するには 1 分ほどかかります。
1. Amazon Connect エージェントエクスペリエンスを開き、Shopify ストアに入力した E メールまたは電話番号でユーザーを検索します。同じ E メールまたは電話番号で顧客プロフィールを表示できます。
1. 顧客プロファイルが表示されない場合は、統合に問題があります。トラブルシューティング：
1. Amazon EventBridge コンソールに移動します。
1. EventSource がアクティブで、一致する EventBus が存在し、実行されているかどうかを確認します。
これらが機能している場合は、問題の調査 サポート について にお問い合わせください。
## Customer Profiles 統合をモニタリングする
接続が確立されてから動作しなくなったら、統合を削除してから再確立します。
## オブジェクトが送信されていない場合の対処方法
オブジェクトの送信に失敗した場合には、[**フローの詳細**] をクリックして不具合の詳細を表示します。
設定を削除して、外部アプリケーションに再接続する必要がある場合があります。