Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Siapkan integrasi untuk aplikasi unggulan di Amazon Connect
Integrasi ini menggunakan aplikasi unggulan Amazon Connect untuk menyediakan pembaruan berkala ke Profil Pelanggan Amazon Connect.
## Sebelum Anda mulai
### Konsumsi data secara massal
Ketika Anda mengatur integrasi Anda, Anda diminta untuk memasukkan tanggal seberapa jauh Anda ingin pergi untuk menelan data. Jika Anda memilih tanggal yang lebih dari dua bulan yang lalu, Profil Pelanggan secara otomatis mengaktifkan konsumsi massal dengan membuat beberapa aliran. Ini dilakukan sehingga Anda tidak perlu menghitung berapa banyak aliran yang Anda butuhkan untuk menelan data.
Ketika konsumsi massal otomatis diaktifkan, Profil Pelanggan melakukan hal berikut:
+ Mengatur ukuran batch menjadi dua bulan.
+ Mencoba lagi kegagalan sementara hingga tiga kali sebelum gagal.
Anda dapat menggunakan [CreateIntegrationWorkflowRequest](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/CreateIntegrationWorkflowRequest .html)API untuk memanggil ukuran batch Anda sendiri.
### Mengapa saya diminta untuk memilih atau membuat peran IAM?
Untuk Salesforce, Marketo, dan ServiceNow, Profil Pelanggan membantu meningkatkan penyerapan historis sumber-sumber ini dengan menggunakan peran IAM Anda untuk membuat beberapa alur kerja untuk menyerap data Anda dengan cepat dan efisien.
Untuk sumber-sumber ini, jika Anda memilih lebih dari 60 hari kembali di **Tanggal untuk mengimpor data** pemilih tanggal, Anda akan diminta untuk membuat peran IAM baru atau memilih yang sudah ada. Peran ini memungkinkan Profil Pelanggan untuk mengelola integrasi Anda. Ini memberikan Profil Pelanggan dengan izin yang diperlukan untuk memperbarui dan membuat alur kerja untuk menyerap data Anda. Setelah alur kerja selesai, Profil Pelanggan membuat integrasi standar dan berkelanjutan yang menyerap data baru Anda saat diperbarui di sumber Anda.
Peran yang dibuat di konsol hanya dapat digunakan oleh domain tempat ia dibuat. Ini karena Amazon Connect membatasi akses peran hanya ke kunci KMS yang digunakan oleh domain.
Untuk informasi selengkapnya, lihat [Berikan akses hak istimewa paling sedikit ke peran eksekusi Profil Pelanggan Anda](#grant-least-privilege-cp).
## Berikan akses hak istimewa paling sedikit ke peran eksekusi Profil Pelanggan Anda
Jika Anda ingin membuat peran IAM Anda sendiri, sebaiknya gunakan izin yang ditampilkan dalam kode berikut untuk membatasi peran ke izin paling sedikit yang diperlukan. Gunakan cuplikan di bawah ini untuk membuat peran Anda secara manual. Gunakan kunci KMS Anda sendiri dan tentukan Wilayah Anda jika diperlukan.
------
#### [ 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"
}
]
}
```
------
## Pantau integrasi Profil Pelanggan Anda
Setelah koneksi Anda dibuat, jika berhenti bekerja, hapus integrasi dan kemudian buat kembali.
## Apa yang harus dilakukan jika objek tidak dikirim
Jika objek gagal dikirim, pilih **Detail aliran** untuk mempelajari lebih lanjut tentang apa yang salah.
Anda mungkin perlu menghapus konfigurasi dan menyambung kembali ke aplikasi eksternal.
# Mengatur integrasi untuk Kasus Amazon Connect
Untuk memperbarui data Amazon Connect Kasus di Profil Pelanggan Amazon Connect dan menggunakan fitur seperti atribut terhitung, Anda dapat mengintegrasikan menggunakan Amazon AppIntegrations. Mulailah dengan menyiapkan aliran peristiwa Kasus untuk mengirim bidang sistem ke EventBridge bus, lalu gunakan Amazon AppIntegrations untuk meneruskan peristiwa ini ke Profil Pelanggan.
## Streaming data dari Amazon Connect Cases ke Event Bridge
1. Buka konsol Amazon Connect di [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Pada halaman instance, pilih alias instance. Alias instance juga merupakan **nama instans** Anda, yang muncul di URL Amazon Connect Anda. Gambar berikut menunjukkan halaman **instance pusat kontak virtual Amazon Connect**, dengan kotak di sekitar alias instance.
![\[Alias contoh.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-1.png)
1. Di panel navigasi, pilih **Kasus** dan catat ID domain Kasus Anda dari bagian **Detail domain**.
![\[Halaman Kasus, bagian detail Domain, panah yang menunjuk ke ID domain.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-2.png)
1. Menggunakan AWS CLI, buat konfigurasi peristiwa Kasus untuk mengirim Amazon Connect Cases Events ke bus Event Bridge default Anda Akun 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. Buka konsol Event Bridge untuk AWS Wilayah Anda. Misalnya, [https://us-west-2.console.aws.amazon.com/events/rumah? wilayah=us-barat-2\$1/eventbus](https://us-west-2.console.aws.amazon.com/events/home?region=us-west-2#/eventbuses)
1. Pilih **Buat bus peristiwa**.
![\[Halaman bus acara di EventBridge konsol Amazon, tombol Buat bus acara.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-3.png)
1. Buat bus acara dengan nama`connect-cases-to-customer-profiles`.
![\[Halaman Buat bus acara, kotak Nama.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-4.png)
1. Kembali ke **bus acara default** Anda dan buat aturan dengan nama`connect-cases-to-customer-profiles-rule`.
![\[Bus acara default, tombol Buat aturan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-5.png)
![\[Langkah pola acara Build.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-6.png)
+ Cuplikan Pola Acara:
```
{
"source": ["aws.cases"],
"detail": {
"eventType": ["CASE.UPDATED", "CASE.CREATED", "CASE.DELETED"]
}
}
```
![\[Bagian Metode pembuatan, pola kustom (editor JSON) pilihan, kode pola Peristiwa.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-7.png)
+ Pilih **Lewati untuk Meninjau dan Membuat** dan kemudian **Buat aturan**.
![\[Tombol Skip to Review and create.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-8.png)
## Menyerap data kasus Event Bridge ke Profil Pelanggan dengan menggunakan AppIntegrations
1. Menggunakan AWS CLI, buat Integrasi Acara dengan AppIntegrations dan catat output ARN. Ini mewakili data sumber yang dapat digunakan instans 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. Menggunakan AWS CLI, buat integrasi dengan Profil Pelanggan menggunakan API put-integration. Ini akan memulai aliran data ke Profil Pelanggan, menggantikan nilai placeholder dengan ARN Integrasi Acara dan nama domain Profil Pelanggan Anda.
```
aws customer-profiles put-integration --region
--domain-name
--uri --object-type-name Connect-case
```
## Verifikasi integrasi Kasus Anda
1. Buat kasing di Amazon Connect Cases.
1. Pengiriman acara harus hampir seketika tetapi biarkan satu menit untuk dikirimkan dan dikaitkan dengan profil pelanggan.
1. Dengan menggunakan AWS CLI, temukan objek Connect-case di bawah profil, ganti placeholder dengan nilai yang benar.
```
aws customer-profiles list-profile-objects --domain-name
--region
--object-type-name Connect-case --profile-id
```
1. Jika Anda tidak menemukan item dalam respons panggilan API di atas, maka ada masalah dengan integrasi Anda. Untuk memecahkan masalah:
1. Pergi ke EventBridge konsol Amazon.
1. Periksa EventSource apakah Aktif dan pencocokan EventBus ada dan sedang berjalan.
1. Periksa apakah Konfigurasi Peristiwa Kasus Anda dikonfigurasi dengan benar.
1. Jika ini berhasil, hubungi bantuan Dukungan untuk menyelidiki masalah ini.
# Siapkan integrasi Amazon Connect dengan Salesforce,, Marketo ServiceNow, atau Zendesk
Untuk memberikan pembaruan berkala ke Profil Pelanggan Amazon Connect, Anda dapat mengintegrasikan dengan Salesforce, Marketo ServiceNow, atau Zendesk menggunakan Amazon. AppFlow Pertama-tama Anda mengatur koneksi di Amazon Connect dan aplikasi pilihan Anda, dan kemudian memverifikasi integrasi.
## Siapkan koneksi di Amazon Connect dan Salesforce,, Marketo ServiceNow, atau Zendesk
1. Buka konsol Amazon Connect di [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Pada halaman instance, pilih alias instance. Alias instance juga merupakan **nama instans** Anda, yang muncul di URL Amazon Connect Anda. Gambar berikut menunjukkan halaman **instance pusat kontak virtual Amazon Connect**, dengan kotak di sekitar alias instance.
![\[Halaman instans pusat kontak virtual Amazon Connect, alias instans.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/instance.png)
1. Di panel navigasi, pilih **Profil pelanggan**.
1. Pada halaman **konfigurasi profil Pelanggan**, pilih **Tambahkan integrasi**, seperti yang ditunjukkan pada gambar berikut.
![\[Halaman konfigurasi profil Pelanggan, tombol Tambahkan integrasi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. Pada halaman **Pilih sumber data**, pilih aplikasi eksternal mana Anda ingin mendapatkan data profil pelanggan. Anda dapat melihat [persyaratan integrasi](https://docs.aws.amazon.com/appflow/latest/userguide/requirements.html) untuk lebih memahami persyaratan koneksi yang diperlukan untuk aplikasi Anda.
![\[Halaman Pilih sumber data.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-cp-salesforce-source.png)
1. Pada halaman **Buat koneksi**, pilih salah satu dari yang berikut ini:
+ **Gunakan koneksi yang ada**: Ini memungkinkan Anda untuk menggunakan kembali AppFlow sumber daya Amazon yang ada yang mungkin telah Anda buat di akun AWS Anda..
+ **Buat koneksi baru**: Masukkan informasi yang diperlukan oleh aplikasi eksternal.
![\[Halaman Buat koneksi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-enable-establish-connection.png)
1. Pada halaman **Opsi integrasi**, pilih objek sumber mana yang ingin Anda konsumsi dan pilih jenis objeknya.
Jenis objek menyimpan data yang Anda konsumsi. Mereka juga menentukan bagaimana objek dari integrasi Anda dipetakan ke profil saat dicerna. Profil Pelanggan menyediakan templat tipe objek default yang dapat Anda gunakan yang menentukan bagaimana atribut dalam objek sumber Anda dipetakan ke objek standar di Profil Pelanggan. Anda juga dapat menggunakan pemetaan objek yang telah Anda buat dari. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) Saat menambahkan atau membuat integrasi Salesforce untuk pemetaan data yang dibuat pengguna, Anda perlu menentukan pemetaan data tertentu, jika tidak maka akan memilih pemetaan data default Salesforce untuk tipe objek. Anda dapat membuat pemetaan data dan menggunakannya saat menyiapkan konektor data unggulan.
![\[Halaman opsi integrasi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-integration-options.png)
1. Untuk **tanggal mulai Ingestion**, Profil Pelanggan mulai menelan catatan yang dibuat setelah tanggal ini. Secara default, tanggal untuk mengimpor catatan ditetapkan pada 30 hari sebelumnya.
1. Pada halaman **Tinjau dan integrasi**, periksa apakah **status Koneksi** mengatakan **Terhubung**, lalu pilih **Buat integrasi**.
![\[Halaman Tinjauan dan integrasi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-enable-review-and-integrate.png)
1. Setelah integrasi diatur, kembali ke halaman **konfigurasi profil Pelanggan**, pilih **Lihat objek** untuk melihat data apa yang sedang dikumpulkan dan dikirim. Saat ini, proses ini menelan catatan yang dibuat atau dimodifikasi dalam 30 hari terakhir.
![\[Halaman konfigurasi profil Pelanggan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-enable-objects.png)
# Menyiapkan integrasi untuk Segmen untuk menyediakan pembaruan berkala ke Profil Pelanggan Amazon Connect
Untuk memberikan pembaruan berkala ke Profil Pelanggan Amazon Connect, Anda dapat mengintegrasikan dengan Segment menggunakan Amazon AppFlow. Pertama-tama Anda mengatur koneksi di Amazon Connect dan Segment, lalu verifikasi integrasi Segmen.
## Siapkan koneksi di Amazon Connect dan Segment
1. Buka konsol Amazon Connect di [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Pada halaman instance, pilih alias instance. Alias instance juga merupakan **nama instans** Anda, yang muncul di URL Amazon Connect Anda. Gambar berikut menunjukkan halaman **instance pusat kontak virtual Amazon Connect**, dengan kotak di sekitar alias instance.
![\[Halaman instans pusat kontak virtual Amazon Connect, alias instans.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/instance.png)
1. Di panel navigasi, pilih **Profil pelanggan**.
1. Pada halaman **konfigurasi profil Pelanggan**, pilih **Tambahkan integrasi**.
![\[Halaman konfigurasi profil Pelanggan, tombol Tambahkan integrasi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. Pada halaman **Pilih sumber data**, pilih **Segmen**. Tinjau persyaratan aplikasi yang tercantum di halaman **Pilih aplikasi**.
![\[Halaman Pilih sumber data.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-cp-segment-source.png)
1. Pada halaman **Buat koneksi**, pilih salah satu dari yang berikut ini:
+ **Gunakan koneksi yang ada**: Ini memungkinkan Anda untuk menggunakan kembali EventBridge sumber daya Amazon yang ada yang mungkin telah Anda buat di Anda Akun AWS.
+ **Buat koneksi baru**: Masukkan informasi yang diperlukan oleh aplikasi eksternal.
![\[Halaman Buat koneksi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-enable-segment-establish-connection.png)
+ **Nama koneksi**: Berikan nama untuk koneksi Anda. Nama koneksi direferensikan oleh integrasi yang menggunakan koneksi ini.
+ **URL koneksi**: Masukkan URL koneksi aplikasi Anda. URL ini digunakan untuk deep-linking ke objek yang dibuat dalam aplikasi eksternal Anda. URL koneksi adalah URL ruang kerja Segmen yang tersedia di situs web aplikasi.
Untuk menemukan URL ruang kerja Anda:
1. Masuk ke akun segment.com Anda.
1. Buka **Pengaturan**, **Pengaturan umum**.
1. Salin URL dari browser Anda.
1. Profil Pelanggan menggunakan Amazon EventBridge untuk integrasi dengan Segmen. Pada halaman **penyiapan Sumber**, salin Akun AWS ID Anda ke clipboard, lalu pilih **Masuk ke Segmen untuk mengonfigurasi** Amazon. EventBridge
1. Gunakan petunjuk berikut untuk mengatur Segmen:
1. Masuk ke Segmen.
1. Dalam aplikasi Anda, pilih sumber untuk mengatur tujuan ke Amazon EventBridge.
1. Tempel di Akun AWS ID Anda dan pilih AWS Wilayah Anda.
1. **Aktifkan**, untuk mengaktifkan sumber acara mitra Anda.
1. Buka **Penguji Acara**, dan kirim acara pengujian untuk menyelesaikan pengaktifan sumber acara mitra Anda.
1. **ID Klien**: Ini adalah string yang secara unik membedakan klien dalam aplikasi eksternal Anda. ID klien ini adalah Nama Sumber yang tersedia di situs web aplikasi. Anda menggunakan ID yang Anda tentukan untuk mengidentifikasi klien yang Anda inginkan Profil Pelanggan untuk menyerap objek Anda.
Untuk menemukan ID sumber Anda:
1. Pergi ke **Sumber**, dan pilih sumber.
1. Buka **Pengaturan**, **Kunci API**.
1. Salin **ID Sumber** Anda.
Setelah Anda mengatur tujuan sumber peristiwa, kembali ke konsol Profil Pelanggan dan tempel ID Klien.
1. Anda akan melihat peringatan yang menunjukkan Amazon Connect telah berhasil terhubung dengan Segment.
1. Pada halaman **Opsi integrasi**, pilih objek sumber mana yang ingin Anda konsumsi dan pilih jenis objeknya.
Jenis objek menyimpan data yang Anda konsumsi. Mereka juga menentukan bagaimana objek dari integrasi Anda dipetakan ke profil saat dicerna. Profil Pelanggan menyediakan templat tipe objek default yang dapat Anda gunakan yang menentukan bagaimana atribut dalam objek sumber Anda dipetakan ke objek standar di Profil Pelanggan. Anda juga dapat menggunakan pemetaan objek yang telah Anda buat dari. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
![\[Halaman opsi Integrasi, bagian Jenis objek.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-integration-options-segment.png)
1. Untuk **tanggal mulai Ingestion**, Profil Pelanggan mulai menelan catatan yang dibuat setelah integrasi ditambahkan.
**catatan**
Jika Anda memerlukan catatan sejarah, Anda dapat [menggunakan Amazon S3 sebagai sumber integrasi untuk mengimpornya](customer-profiles-object-type-mappings.md).
1. Pada halaman **Tinjau dan integrasi**, periksa apakah **status Koneksi** mengatakan **Terhubung**, lalu pilih **Tambahkan integrasi**.
1. Setelah integrasi diatur, kembali ke halaman **konfigurasi profil Pelanggan**, halaman **Integrasi** menampilkan integrasi mana yang sedang disiapkan. **Kesehatan **Last run** dan Integrasi** saat ini tidak tersedia untuk jenis integrasi ini.
![\[Halaman konfigurasi profil Pelanggan, bagian Integrasi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
Untuk melihat data apa yang sedang dikirim, pilih integrasi dan\$1 lalu pilih **Lihat objek**.
## Verifikasi integrasi Segmen
Untuk melakukan langkah ini, Anda memerlukan prasyarat berikut:
+ Akses ke ruang kerja Segmen Anda.
+ [Akses ke Panel Kontrol Kontak Amazon Connect](amazon-connect-contact-control-panel.md).
**Untuk memverifikasi integrasi Segmen Anda**
1. Buka dasbor ruang kerja Segmen Anda dan pilih **Destinasi**.
![\[Halaman ikhtisar segmen.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-enable-segment-1.png)
1. Anda akan melihat daftar tujuan di mana Segmen itu mengirim data. Pilih EventBridge tujuan untuk Profil Pelanggan.
![\[Daftar halaman tujuan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-enable-segment-2.png)
1. Pilih tab **Event Tester**. Dari halaman ini Anda akan mengirimkan acara uji ke Profil Pelanggan. Acara ini dicerna dan diubah menjadi profil pelanggan yang dapat Anda lihat di aplikasi agen Amazon Connect.
![\[Tab penguji acara.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-enable-segment-3.png)
1. Pilih **Identifikasi** sebagai jenis acara, dan pilih **Event Builder** sebagai metode input Anda.
1. Anda dapat menentukan **ID Pengguna** dan beberapa sifat. Agen dapat mencari sifat-sifat ini dalam aplikasi agen.
1. Pilih **Kirim Acara**.
1. Pengiriman acara harus hampir seketika tetapi biarkan sebentar untuk dikirimkan dan buat profil pelanggan.
1. Buka aplikasi agen Amazon Connect. Cari ID pengguna yang Anda masukkan di **Event Builder**. Anda harus dapat melihat profil pelanggan dengan ID pengguna dan ciri-ciri yang Anda masukkan.
1. Jika Anda tidak dapat melihat profil pelanggan, maka ada masalah dengan integrasi Anda. Untuk memecahkan masalah:
1. Pergi ke EventBridge konsol Amazon.
1. Periksa EventSource apakah Aktif dan pencocokan EventBus ada dan sedang berjalan.
Jika ini berhasil, hubungi bantuan Dukungan untuk menyelidiki masalah ini.
## Pantau integrasi Profil Pelanggan Anda
Setelah koneksi Anda dibuat, jika berhenti bekerja, hapus integrasi dan kemudian buat kembali.
## Apa yang harus dilakukan jika objek tidak dikirim
Jika objek gagal dikirim, pilih **Detail aliran** untuk mempelajari lebih lanjut tentang apa yang salah.
Anda mungkin perlu menghapus konfigurasi dan menyambung kembali ke aplikasi eksternal.
# Siapkan integrasi untuk Shopify untuk memberikan pembaruan berkala ke Profil Pelanggan Amazon Connect
Untuk memberikan pembaruan berkala ke Profil Pelanggan Amazon Connect, Anda dapat berintegrasi dengan Shopify menggunakan Amazon. AppIntegrations Pertama-tama Anda mengatur koneksi di Amazon Connect dan Shopify, lalu verifikasi integrasi Shopify.
## Siapkan koneksi di Amazon Connect dan Shopify
1. Buka konsol Amazon Connect di [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Pada halaman instance, pilih alias instance. Alias instance juga merupakan **nama instans** Anda, yang muncul di URL Amazon Connect Anda. Gambar berikut menunjukkan halaman **instance pusat kontak virtual Amazon Connect**, dengan kotak di sekitar alias instance.
![\[Halaman instans pusat kontak virtual Amazon Connect, alias instans.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/instance.png)
1. Di panel navigasi, pilih **Profil pelanggan**.
1. Pada halaman **konfigurasi profil Pelanggan**, pilih **Tambahkan integrasi**.
![\[Halaman konfigurasi profil Pelanggan, tombol Tambahkan integrasi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. Pada halaman **Pilih sumber**, pilih **Shopify**. Tinjau persyaratan aplikasi yang tercantum di halaman **Pilih aplikasi**.
![\[Halaman sumber pilih.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-cp-shopify-source.png)
1. Pada halaman **Buat koneksi**, pilih salah satu dari yang berikut ini:
+ **Gunakan koneksi yang ada**: Ini memungkinkan Anda untuk menggunakan kembali EventBridge sumber daya Amazon yang ada yang mungkin telah Anda buat di Anda Akun AWS.
+ **Buat koneksi baru**: Masukkan informasi yang diperlukan oleh aplikasi eksternal.
![\[Halaman Buat koneksi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-enable-shopify-establish-connection.png)
+ **Nama koneksi**: Berikan nama untuk koneksi Anda. Nama koneksi direferensikan oleh integrasi yang menggunakan koneksi ini.
+ **URL koneksi**: Masukkan URL koneksi aplikasi Anda. URL ini digunakan untuk deep-linking ke objek yang dibuat dalam aplikasi eksternal Anda. URL koneksi adalah URL aplikasi Mitra Shopify yang tersedia di situs web aplikasi.
Untuk menemukan URL aplikasi Mitra Shopify Anda:
+ Masuk ke akun partners.shopify.com Anda.
+ Buka aplikasi Anda.
+ Salin URL dari browser Anda.
+ **ID Klien**: Masukkan ID klien aplikasi Anda. Ini adalah string yang secara unik membedakan klien dalam aplikasi eksternal Anda. ID klien ini adalah Nama Sumber yang tersedia di situs web aplikasi. Anda menggunakan ID yang Anda tentukan di sini untuk mengidentifikasi klien yang Anda inginkan Profil Pelanggan untuk menyerap objek Anda. ID klien Anda mungkin tersedia setelah mengikuti langkah-langkah penyiapan Sumber.
Untuk menemukan nama sumber Anda:
+ Masuk ke akun partners.shopify.com Anda.
+ Buka aplikasi Anda.
+ Salin nama sumber dari sumber EventBridge acara Amazon Anda.
1. Pada halaman **pengaturan Sumber**, salin Akun AWS ID Anda ke clipboard Anda, lalu pilih **Masuk ke** Shopify.
1. Gunakan petunjuk berikut untuk menyiapkan Shopify:
1. Masuk ke partners.shopify.com.
1. Di bawah Amazon EventBridge, pilih **Buat sumber**.
1. Tempel di Akun AWS ID Anda dan pilih AWS Wilayah Anda.
1. Setelah Anda mengatur tujuan sumber acara, kembali ke Profil Pelanggan. Anda akan melihat peringatan yang menunjukkan Amazon Connect telah berhasil terhubung dengan Shopify.
1. Pada halaman **Opsi integrasi**, pilih objek sumber mana yang ingin Anda konsumsi dan pilih jenis objeknya.
Jenis objek menyimpan data yang Anda konsumsi. Mereka juga menentukan bagaimana objek dari integrasi Anda dipetakan ke profil saat dicerna. Profil Pelanggan menyediakan templat tipe objek default yang dapat Anda gunakan yang menentukan bagaimana atribut dalam objek sumber Anda dipetakan ke objek standar di Profil Pelanggan. Anda juga dapat menggunakan pemetaan objek yang telah Anda buat dari. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
![\[Halaman opsi Integrasi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-integration-options-shopify.png)
1. Untuk **tanggal mulai Ingestion**, Profil Pelanggan mulai menelan catatan yang dibuat setelah integrasi ditambahkan.
**catatan**
Jika Anda memerlukan catatan sejarah, Anda dapat [menggunakan Amazon S3 sebagai sumber integrasi untuk mengimpornya](customer-profiles-object-type-mappings.md).
1. Pada halaman **Tinjau dan integrasi**, periksa apakah **status Koneksi** mengatakan **Terhubung**, lalu pilih **Tambahkan integrasi**.
**catatan**
Setelah menambahkan integrasi ini, Anda perlu [mengatur langganan webhook](#shopify-webhook-subscriptions) untuk memungkinkan acara mulai mengalir ke integrasi ini.
![\[Halaman Tinjauan dan integrasi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook.png)
1. Setelah integrasi diatur, kembali ke halaman **konfigurasi profil Pelanggan**, bagian **Integrasi** menampilkan integrasi mana yang sedang disiapkan. **Kesehatan **Last run** dan Integrasi** saat ini tidak tersedia untuk jenis integrasi ini.
![\[Bagian Integrasi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
Untuk melihat data apa yang sedang dikirim, pilih integrasi dan kemudian pilih **Lihat objek**.
1. Pergi ke langkah berikutnya untuk menggunakan API untuk mengatur **langganan webhook** sehingga acara dapat mulai mengalir ke integrasi ini.
## Siapkan langganan webhook
1. Gunakan URL berikut untuk memastikan aplikasi Anda memiliki izin yang diperlukan:
```
https://{shop}.myshopify.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}&state={nonce}
```
Di mana:
+ `shop`adalah nama toko Shopify Anda.
+ `api_key`adalah Kunci API dari aplikasi Shopify Anda. Anda dapat menemukannya di halaman detail **Aplikasi** Shopify.
+ `scopes`harus memiliki nilai`read_customers,read_orders,read_draft_orders`.
+ `redirect_uri`adalah URI pengalihan yang Anda tentukan untuk aplikasi saat Anda membuatnya. Untuk tujuan kami, ini bisa berupa URL yang valid.
+ `nonce`dapat berupa nilai unik apa pun untuk mengidentifikasi permintaan otorisasi yang diberikan dari orang lain. Kami merekomendasikan menggunakan stempel waktu.
Setelah Anda membuat URL, tempelkan ke browser Anda. installation/authorization Halaman yang mirip dengan gambar berikut ditampilkan, meminta pemilik toko untuk memberikan izin untuk cakupan yang ditentukan.
![\[Contoh halaman shopify untuk menginstal dan mengotorisasi aplikasi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook-embedded-app.png)
1. Pilih **Instal aplikasi yang tidak terdaftar** untuk menginstal dan mengotorisasi aplikasi atas nama toko Anda.
Anda akan dibawa ke URI pengalihan yang Anda masukkan dengan kode otorisasi ditambahkan untuk mengarahkan URI sebagai parameter kueri. Contoh:
```
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. Salin `authorization_code` dari URI ini. Anda akan menggunakannya untuk mendapatkan token akses permanen di langkah selanjutnya.
1. Buka alat apa pun yang Anda gunakan untuk melakukan panggilan API. Misalnya, [CURL](https://curl.se/) atau [POSTMAN](https://www.postman.com/).
1. Untuk mendapatkan token akses permanen, buat permintaan POST ke Shopify `Admin` API ke titik akhir ini:
```
https://{shop}.myshopify.com/admin/oauth/access_token
```
dengan badan permintaan berikut:
```
{
"code": "authorization_code_received_from_redirect_uri",
"client_id": "your_app_api_key",
"client_secret": "your_app_api_secret"
}
```
Permintaan ini mengembalikan respons berikut:
```
{
"access_token": "permanent_access_token",
"scope": "read_customers,read_orders,read_draft_orders"
}
```
1. Perhatikan `access_token`. Ini adalah token permanen yang memiliki ruang lingkup yang disediakan dari langkah sebelumnya. Sekarang Anda siap untuk membuat langganan webhook.
1. Untuk panggilan API berikut, pastikan Anda menyetel kunci header HTTP `X-Shopify-Access-Token` ke yang `access_token` Anda terima dari respons panggilan sebelumnya.
1. Untuk mengatur langganan webhook, buat permintaan POST berikut untuk setiap `topic` nilai yang tercantum di langkah berikutnya:
Titik akhir: `https://{shop}.myshopify.com/admin/api/2021-04/webhooks.json`
Badan Permintaan:
```
{
"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. Untuk setiap langganan ganti nilainya `topic` dengan nilai berikut:
+ `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`
Anda sekarang siap untuk menerima acara dari toko Shopify Anda. Selanjutnya, verifikasi integrasi Shopify Anda.
## Verifikasi integrasi Shopify Anda
1. Masuk sebagai Admin ke Toko Shopify Anda.
1. Di menu navigasi kiri, pilih **Pelanggan**.
1. Pilih **Tambahkan Pelanggan**.
1. Masukkan detail pelanggan Anda. Pastikan untuk memasukkan nomor telepon dan email. Ini tidak harus menjadi milik pelanggan sungguhan. Anda akan menghapus entri pelanggan ini setelah memverifikasi integrasi.
1. Simpan objek pelanggan.
1. Pengiriman acara harus hampir seketika tetapi biarkan satu menit untuk dikirimkan dan untuk membuat profil pelanggan.
1. Buka pengalaman agen Amazon Connect dan cari pengguna melalui email atau nomor telepon yang Anda masukkan ke Shopify Store. Anda harus dapat melihat profil pelanggan dengan email atau nomor telepon yang sama.
1. Jika Anda tidak dapat melihat profil pelanggan, maka ada masalah dengan integrasi Anda. Untuk memecahkan masalah:
1. Pergi ke EventBridge konsol Amazon.
1. Periksa EventSource apakah Aktif dan pencocokan EventBus ada dan sedang berjalan.
Jika ini berhasil, hubungi bantuan Dukungan untuk menyelidiki masalah ini.
## Pantau integrasi Profil Pelanggan Anda
Setelah koneksi Anda dibuat, jika berhenti bekerja, hapus integrasi dan kemudian buat kembali.
## Apa yang harus dilakukan jika objek tidak dikirim
Jika objek gagal dikirim, pilih **Detail aliran** untuk mempelajari lebih lanjut tentang apa yang salah.
Anda mungkin perlu menghapus konfigurasi dan menyambung kembali ke aplikasi eksternal.