

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Integrasikan aplikasi eksternal dengan Profil Pelanggan Amazon Connect
<a name="integrate-external-apps-customer-profiles"></a>

Amazon Connect menyediakan serangkaian integrasi pra-bangun yang didukung oleh Amazon dan AppFlow Amazon. EventBridge Setelah mengaktifkan Profil Pelanggan Amazon Connect, Anda dapat menggunakan integrasi ini untuk menggabungkan informasi dari aplikasi eksternal seperti Salesforce atau Zendesk, dengan riwayat kontak dari Amazon Connect. Ini menciptakan profil pelanggan yang memiliki semua agen informasi yang dibutuhkan selama interaksi pelanggan di satu tempat.

Anda juga dapat menggunakan Profil Pelanggan di Amazon AppFlow. Amazon AppFlow mendukung `CustomerProfiles` sebagai tujuan. Anda dapat menggunakan Amazon AppFlow APIs untuk mengirim data ke Profil Pelanggan menggunakan `CustomerProfiles` nama tujuan.

Sebelum Anda mulai, pastikan Anda menggunakan kunci yang dikelola pelanggan. Untuk informasi selengkapnya tentang mengonfigurasi kunci KMS, lihat. [Buat kunci KMS untuk digunakan oleh Profil Pelanggan untuk mengenkripsi data (wajib)](enable-customer-profiles.md#enable-customer-profiles-awsmanagedkey) 

## Mengatur integrasi
<a name="setup-integrations-title-menu"></a>

Anda dapat mengatur integrasi menggunakan aplikasi unggulan di Amazon Connect atau aplikasi eksternal menggunakan Amazon AppFlow dengan memilih metode yang paling sesuai dengan kasus penggunaan Anda di bawah ini. Untuk informasi lebih rinci tentang integrasi ServiceNow dan Slack, lihat posting blog [Menggabungkan data dari berbagai sumber menggunakan Amazon AppFlow dan membuat profil Pelanggan Amazon Connect terpadu untuk agen pusat kontak](https://aws.amazon.com/blogs/contact-center/unified-customer-data/).

**Topics**
+ [Mengatur integrasi](#setup-integrations-title-menu)
+ [Siapkan integrasi untuk aplikasi unggulan di Amazon Connect](integrate-customer-profiles-appflow.md)
+ [Mengatur integrasi untuk aplikasi eksternal menggunakan Amazon AppFlow](integrate-external-applications-appflow.md)
+ [Hapus Profil Pelanggan atau hentikan integrasi](delete-customer-profile-connection.md)

# Siapkan integrasi untuk aplikasi unggulan di Amazon Connect
<a name="integrate-customer-profiles-appflow"></a>

Integrasi ini menggunakan aplikasi unggulan Amazon Connect untuk menyediakan pembaruan berkala ke Profil Pelanggan Amazon Connect.

## Sebelum Anda mulai
<a name="before-you-begin-cp-integration"></a>

### Konsumsi data secara massal
<a name="bulk-ingestion"></a>

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?
<a name="why-create-iam-role"></a>

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
<a name="grant-least-privilege-cp"></a>

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
<a name="monitor-customer-profile-connection"></a>

Setelah koneksi Anda dibuat, jika berhenti bekerja, hapus integrasi dan kemudian buat kembali. 

## Apa yang harus dilakukan jika objek tidak dikirim
<a name="fix-customer-profile-connection"></a>

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
<a name="set-up-integration-for-amazon-connect-cases"></a>

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
<a name="stream-data-from-connect-cases-to-event-bridge"></a>

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 <YOUR_CASES_DOMAIN_ID> --region <YOUR_AWS_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
<a name="ingest-event-bridge-case-data-to-customer-profiles-via-appintegrations"></a>

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
    <YOUR_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
    <YOUR_REGION> --domain-name <YOUR_CP_DOMAIN_NAME> 
    --uri <YOUR_EVENT_INTEGRATION_ARN> --object-type-name Connect-case
```

## Verifikasi integrasi Kasus Anda
<a name="verify-your-cases-integration"></a>

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
    <YOUR_CP_DOMAIN_NAME> --region <YOUR_REGION> 
    --object-type-name Connect-case --profile-id <YOUR_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
<a name="steps-integrate-cp-salesforce-servicenow"></a>

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
<a name="setup-connection-segment"></a>

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
<a name="integrate-customer-profiles-segment"></a>

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
<a name="setup-connection-segment"></a>

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
<a name="verify-customer-profile-segment-connection"></a>

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
<a name="monitor-customer-profile-connection-segment"></a>

Setelah koneksi Anda dibuat, jika berhenti bekerja, hapus integrasi dan kemudian buat kembali. 

## Apa yang harus dilakukan jika objek tidak dikirim
<a name="fix-customer-profile-connection-segment"></a>

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
<a name="integrate-customer-profiles-shopify"></a>

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
<a name="setup-connection-shopify"></a>

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
<a name="shopify-webhook-subscriptions"></a>

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}&timestamp=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
<a name="verify-customer-profile-shopify-connection"></a>

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
<a name="monitor-customer-profile-connection-shopify"></a>

Setelah koneksi Anda dibuat, jika berhenti bekerja, hapus integrasi dan kemudian buat kembali. 

## Apa yang harus dilakukan jika objek tidak dikirim
<a name="fix-customer-profile-connection-shopify"></a>

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 aplikasi eksternal menggunakan Amazon AppFlow
<a name="integrate-external-applications-appflow"></a>

Integrasi ini menggunakan Amazon AppFlow untuk memberikan pembaruan berkala ke Profil Pelanggan Amazon Connect. Langkah-langkah di bawah ini memberikan panduan tentang mengonfigurasi konektor pilihan Anda menggunakan Amazon AppFlow, mengonfigurasi pemetaan data, dan mengonfigurasi integrasi untuk mencerna data pelanggan Anda.

Untuk informasi selengkapnya tentang AppFlow harga Amazon, lihat AppFlow [harga](https://aws.amazon.com/appflow/pricing/) Amazon.

Untuk informasi selengkapnya tentang konektor yang AppFlow didukung Amazon, lihat [Aplikasi sumber dan tujuan yang didukung](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html).

## Sebelum Anda mulai
<a name="integrate-ea-appflow-pre-req"></a>

Saat mengaktifkan Profil Pelanggan Amazon Connect, Anda akan membuat domain Profil Pelanggan, yang merupakan wadah untuk semua data, seperti profil pelanggan, jenis objek, kunci profil, dan kunci enkripsi. Berikut ini adalah panduan untuk membuat domain Profil Pelanggan:
+ Setiap instans Amazon Connect hanya dapat dikaitkan dengan satu domain.
+ Anda dapat membuat beberapa domain, tetapi mereka tidak berbagi integrasi aplikasi eksternal atau data pelanggan antara satu sama lain.
+ Semua integrasi aplikasi eksternal yang Anda buat berada pada tingkat domain. Semua instans Amazon Connect yang terkait dengan domain mewarisi integrasi domain.

**Prasyarat: Aktifkan profil Pelanggan di instans Amazon Connect**

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.

1. Di panel navigasi, pilih **Profil pelanggan**.

1. Pilih aktifkan Profil Pelanggan

Dalam formulir, Anda akan diminta untuk melengkapi semua bidang wajib untuk membuat domain Profil Pelanggan dengan mengikuti langkah-langkah di bawah ini:

1. **Pengaturan Domain**. Anda dapat membuat domain baru dan memberikan nama.

1. **Enkripsi**. **Di bawah Tentukan kunci KMS, Anda dapat mengaktifkan enkripsi dengan memilih kunci AWS KMS yang ada, membuat kunci AWS KMS baru, atau Anda dapat memilih Pilih domain yang ada.**

1. **Pelaporan Kesalahan**. Anda dapat memberikan antrian Dead letter, yang merupakan antrian SQS untuk menangani kesalahan profil pelanggan

1. Pilih **Kirim** dan Profil Pelanggan akan dibuat menggunakan informasi Riwayat Kontak instans Anda.

### Siapkan aplikasi eksternal menggunakan Amazon AppFlow
<a name="integrate-ea-appflow-data-source"></a>

Anda dapat menambahkan integrasi aplikasi eksternal ke domain Profil Pelanggan Amazon Connect dengan menggunakan Amazon AppFlow dengan mengikuti langkah-langkah di bawah ini. Anda harus membuat alur untuk sumber data Anda di AppFlow konsol Amazon dan menetapkan Profil Pelanggan Amazon Connect sebagai tujuan sebelum melanjutkan di konsol Profil Pelanggan. Jika Anda membuat alur lebih dari 14 hari yang lalu, aliran tersebut telah kedaluwarsa dan Anda perlu membuat alur baru untuk integrasi Anda.

Anda dapat secara opsional melakukan transformasi data seperti`Arithmetic`,,`Filter`,`Map`,`Map_all`,`Mask`, `Merge``Truncate`, dan `Validate` saat menggunakan CloudFormation `AWS::AppFlow::Flow Task` sumber daya sebelum konsumsi.

1. Masuk ke Konsol AWS Manajemen Anda, pilih Amazon AppFlow, dan pilih **Buat alur**.  
![\[AppFlow Halaman Amazon.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step1.png)

1. Masukkan nama aliran dan deskripsi aliran opsional.  
![\[Halaman detail Flow.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step2.png)

1. Anda dapat meninggalkan bagian **enkripsi Data** sebagaimana adanya karena domain Profil Pelanggan Amazon Connect Anda sudah memiliki AWS KMS kunci yang ada yang akan digunakan untuk Alur ini. Anda dapat secara opsional membuat tag dan kemudian memilih **Berikutnya**.  
![\[Bagian enkripsi data.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step3.png)

1. Pilih aplikasi eksternal pilihan Anda di dropdown **nama Sumber** dan kemudian pilih bidang relevan berikutnya. Misalnya, jika Anda ingin mengkonfigurasi Slack, pilih Slack dari dropdown **nama Sumber**. Anda kemudian dapat memilih aliran Slack yang ada atau membuat koneksi baru.  
![\[Halaman aliran konfigurasikan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step4.png)

1. Jika Anda memilih untuk membuat koneksi baru, Anda kemudian dapat memasukkan detail aplikasi eksternal seperti nama pengguna, kata sandi, dan subdomain. Anda juga dapat memilih AWS KMS kunci untuk enkripsi data dan memasukkan nama koneksi untuk mengidentifikasi koneksi ini.  
![\[Halaman terhubung ke slack.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step5.png)

1. Jika Anda memilih untuk menggunakan koneksi yang ada, Anda dapat memilih objek aplikasi eksternal tertentu dari dropdown. Misalnya, Jika memilih koneksi Slack yang ada, Anda dapat memilih **Percakapan** sebagai objek dan kemudian memilih saluran Slack tertentu yang akan digunakan.  
![\[Halaman detail sumber.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step6.png)

1. Di bagian **Detail tujuan**, pilih Amazon Connect sebagai nama Tujuan di menu tarik-turun dan pilih Domain profil pelanggan yang dibuat pada langkah prasyarat sebelumnya.  
![\[Bagian Detail tujuan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step7.png)

1. Pilih pemicu aliran dengan memilih **Jalankan sesuai permintaan** atau **Jalankan alur sesuai jadwal**. Pilih **Berikutnya**.
   + **Run on demand** menjalankan aliran hanya ketika Anda memicunya.
   + **Run flow sesuai jadwal** menjalankan aliran pada waktu tertentu dengan menggunakan jadwal. Frekuensi jadwal dibatasi hingga 5 menit, 15 menit, atau 1 jam.  
![\[Bagian pemicu aliran.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step8.png)

1. Pilih **Memetakan bidang secara manual** di bawah **Metode pemetaan**. Pilih bidang sumber dari aplikasi eksternal dan kemudian pilih **bidang Peta secara langsung**.   
![\[Bagian metode pemetaan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step9.png)

1. Tinjau dan pilih **Buat alur**.

Untuk informasi selengkapnya tentang membuat alur di AppFlow konsol Amazon, lihat [Membuat alur di Amazon AppFlow](https://docs.aws.amazon.com/appflow/latest/userguide/create-flow.html).

Untuk informasi selengkapnya tentang penyiapan aplikasi eksternal dan banyak aplikasi lain yang didukung di Amazon AppFlow, lihat [Aplikasi AppFlow sumber dan tujuan Amazon yang didukung](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html).

### Mengatur pemetaan data untuk menentukan bagaimana data aplikasi eksternal dipetakan ke Profil Pelanggan
<a name="integrate-ea-appflow-mappings"></a>

Setelah AppFlow integrasi Amazon disiapkan, Anda perlu menyiapkan pemetaan data di Profil Pelanggan untuk menentukan bagaimana data dari aplikasi eksternal akan dipetakan ke Profil Pelanggan. Ini akan memungkinkan Anda untuk menyesuaikan data yang ingin Anda gunakan untuk membangun profil pelanggan terpadu Anda. Pilih pemetaan Anda dengan hati-hati, karena Anda tidak akan dapat memilih pemetaan yang berbeda setelah membuat integrasi.

Untuk informasi lebih rinci tentang pemetaan data, lihat Pemetaan [tipe objek](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-object-type-mapping.html).

1. Masuk ke AWS Management Console, pilih **Amazon Connect**. Dan pilih Profil Pelanggan di bawah alias instance connect Anda.  
![\[Halaman Profil Pelanggan Amazon Connect.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-mapping-step1.png)

1. Pilih **Pemetaan data** dan kemudian pilih **Buat pemetaan data**. Berikan nama Pemetaan Data dan deskripsi.  
![\[Tab pemetaan data, tombol buat pemetaan data.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2.png)  
![\[Halaman pemetaan data yang ditetapkan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2_2.png)

1. Di bawah **Opsi pemetaan**, Anda dapat memilih **sumber Data** sebagai aplikasi eksternal, **nama Aliran** yang Anda buat di bagian sebelumnya, dan **metode definisi data** sebagai tujuan *Pemetaan*. Di bawah **Tujuan pemetaan**, Anda dapat memilih jenis data pelanggan yang ingin ditentukan untuk profil pelanggan terpadu Anda. Pilih **Berikutnya**.  
![\[Bagian opsi pemetaan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-mapping-step3.png)

1. Tambahkan atribut pelanggan, produk, kasus, dan pesanan dengan jenis sumber, tujuan, dan konten, lalu pilih **Berikutnya**.  
![\[Halaman atribut urutan peta.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-mapping-step4.png)

1. Di bawah **Tentukan pengidentifikasi**, Anda dapat memilih berbagai atribut dari objek sumber data yang membantu membedakan data Anda dari objek sumber data lainnya. Anda dapat memilih atribut dari pengidentifikasi unik, pelanggan, produk, kasus, dan pesanan. Untuk informasi selengkapnya tentang pengidentifikasi, lihat[Pengidentifikasi standar untuk menyetel atribut pada kunci di Profil Pelanggan](standard-identifiers.md).   
![\[Halaman pengenal Standar.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-mapping-step5.png)

1. Tinjau dan pilih **Buat Pemetaan Data**. Status Pemetaan Data akan ditampilkan sebagai *Aktif*.  
![\[Pengidentifikasi pada Langkah 6: Tentukan halaman pengidentifikasi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-mapping-step6.png)

### Siapkan integrasi untuk menyerap data pelanggan Anda dari aplikasi eksternal
<a name="integrate-ea-appflow-integ"></a>

Setelah penyiapan pemetaan data dilakukan untuk aplikasi eksternal, Anda akan mengatur integrasi sumber data untuk menyerap data pelanggan Anda. 

1. Masuk ke AWS Management Console, pilih **Amazon Connect**. Dan pilih Profil Pelanggan di bawah alias instans connect Anda.

1. Di bawah bagian **Integrasi sumber data** pilih **Tambahkan integrasi sumber data**.  
![\[Tab integrasi sumber data, tambahkan tombol integrasi sumber data.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step2.png)

1. **Di bawah dropdown **Sumber data**, pilih aplikasi eksternal dan pilih Berikutnya.** Anda juga memiliki opsi untuk memilih **Buat aliran baru** yang akan membuka AppFlow konsol Amazon di tab baru.  
![\[Bagian sumber data.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step3.png)

1. **Di bawah dropdown **nama Flow**, pilih alur yang ingin Anda gunakan dari sumber data Anda dan pilih Berikutnya.**  
![\[Memilih nama aliran untuk membuat koneksi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step4.png)

1. Di bawah tarik-turun **Pemetaan Data**, pilih pemetaan data aplikasi eksternal untuk objek untuk menentukan bagaimana sumber data Anda dipetakan ke profil. Pilih **Berikutnya**.  
![\[Pilih halaman pemetaan data, kotak dropdown pemetaan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step5.png)

1. Tinjau dan pilih **Tambahkan Integrasi Sumber Data**. Integrasi sumber data dari aplikasi eksternal awalnya akan ditampilkan sebagai tertunda sebelum pindah ke status aktif.  
![\[Tinjau dan integrasikan halaman, tambahkan tombol integrasi sumber data.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step6.png)

### Lihat profil pelanggan terpadu di Amazon Connect Customer Profile Agent CCP
<a name="integrate-ea-appflow-view"></a>

Agen Anda sekarang dapat melihat data pelanggan yang telah diimpor dari aplikasi eksternal dengan masuk ke Amazon Connect Agent CCP. Untuk informasi selengkapnya tentang menghubungkan ke Amazon Connect Agent CCP, lihat [Aplikasi Agen: Semuanya di satu tempat](https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-contact-control-panel.html#use-agent-application).

Agen Anda harus memiliki izin profil keamanan yang sesuai untuk melihat Profil Pelanggan dan akan dapat melakukan pencarian menggunakan nama kunci dan nilai di bilah pencarian profil.

Untuk informasi selengkapnya tentang izin profil keamanan, lihat [Profil keamanan](https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html).

Pengguna tingkat lanjut yang ingin membangun aplikasi agen kustom mereka sendiri dan profil pelanggan yang disematkan dapat menggunakan [StreamsJS](https://github.com/amazon-connect/amazon-connect-customer-profiles) yang menyediakan lebih banyak penyesuaian melalui aplikasi agen.

# Hapus Profil Pelanggan atau hentikan integrasi
<a name="delete-customer-profile-connection"></a>

**catatan**  
Menghapus pemetaan hanya akan menghapus objek dan data yang terkait dengan pemetaan tertentu. Jika ada beberapa objek yang terkait dengan profil, maka menghapus pemetaan tertentu mungkin tidak menghapus data profil. Jika Anda ingin menghapus data tertentu, maka Anda akan menghapus pemetaan, tetapi profil Anda mungkin masih ada jika berisi data dari pemetaan lain. Hal ini dapat mengakibatkan biaya tambahan untuk profil yang ada. Anda dapat menghapus domain dan semua data dari Profil Pelanggan, termasuk semua profil, dengan menggunakan [Amazon Connect konsol](delete-customer-profiles-domain.md) atau [DeleteDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_DeleteDomain.html)API.

**Metode konsol**
+ **Jika sewaktu-waktu Anda ingin menghentikan konsumsi data profil pelanggan, pilih integration/mapping dan kemudian pilih Hapus.**
+ Untuk menghapus integrasi, profil pelanggan, dan semua data profil pelanggan, Anda dapat menghapus domain profil pelanggan Anda di Amazon Connect konsol. Untuk informasi selengkapnya, lihat [Menghapus domain Profil Pelanggan Amazon Connect](delete-customer-profiles-domain.md).

**Metode API**
+ Untuk menghapus data profil pelanggan untuk integrasi tertentu, gunakan `DeleteProfileObjectType` API.
+ Untuk menghapus integrasi, profil pelanggan, dan semua data profil pelanggan, gunakan `DeleteDomain` API.

Untuk mengaktifkan kembali konsumsi data profil pelanggan, lakukan langkah-langkah pengaturan lagi. 