

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

# Ekspor data profil pelanggan terpadu Anda
<a name="set-up-real-time-export"></a>

Amazon Connect Profil Pelanggan menyediakan ekspor data real-time dari profil pelanggan terpadu ke Amazon Kinesis Data Stream. Anda dapat mengaktifkan streaming data dan secara otomatis menerima data untuk profil baru dan pembaruan profil yang ada ke Amazon Kinesis Data Stream Anda.

Anda dapat menyimpan data sistem sumber Anda, seperti CRMs dan alat otomatisasi pemasaran, up-to-date dengan informasi terbaru dari Profil Amazon Connect Pelanggan. Misalnya, ketika pelanggan menghubungi pusat kontak Anda untuk memperbarui alamat mereka, agen dapat melakukan perubahan untuk menambahkan alamat pelanggan baru, dan informasi profil yang diperbarui dikirim ke Aliran Data Kinesis secara real-time.

Untuk mengatur ini, Anda perlu mengaktifkan **Ekspor data** di konsol Profil Pelanggan.

## Aktifkan ekspor waktu nyata
<a name="enable-real-time-export"></a>

**Untuk mengaktifkan streaming data untuk domain Anda**

1. Buka konsol Profil Amazon Connect Pelanggan.

1. Pilih tab **Ekspor data** dan pilih **Aktifkan streaming data**  
![\[Ekspor data real-time memungkinkan aliran data Kinesis.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/enable-real-time-export-1.png)

1. Pilih **Aktifkan streaming data** dan pilih aliran data Kinesis yang ada dari menu tarik-turun, atau pilih **buat aliran data Kinesis baru untuk** membuka konsol Kinesis dan membuat aliran. Untuk informasi selengkapnya, lihat [Membuat dan Mengelola Streaming](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html).  
![\[Ekspor data real-time memungkinkan aliran data Kinesis.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/enable-real-time-export-2.png)

1. Pilih tombol **Aktifkan streaming data** untuk menyimpan pengaturan Anda.

## Nonaktifkan ekspor waktu nyata
<a name="disable-real-time-export"></a>

**Untuk menonaktifkan streaming data untuk domain Anda**

1. Buka konsol Profil Amazon Connect Pelanggan.

1. Pilih tab **Ekspor data** dan pilih **Nonaktifkan streaming data**.  
![\[Ekspor data real-time menonaktifkan aliran data Kinesis.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/disable-real-time-export-1.png)

## Muatan Kinesis ekspor waktu nyata
<a name="real-time-export-kinesis-payload"></a>

**Contoh acara keluaran di JSON**

```
{
    "SchemaVersion": 0,
    "EventId": "eventId",
    "EventTimestamp": "2020-01-01T00:00:00Z",
    "EventType": "CREATED",
    "DomainName": "domainName",
    "ObjectTypeName": "objectTypeName",
    "AssociatedProfileId": "associatedProfileId",
    "ProfileObjectUniqueKey": "profileObjectUniqueKey",
    "Object": {
        "map": {
            "k1": [
                "a",
                "b",
                "c"
            ]
        }
    },
    "IsMessageRealTime": true
}
```

**SchemaVersion**  
Versi skema saat ini.

**EventId**  
ID acara unik.

**EventTimestamp**  
Stempel waktu acara menggunakan standar. ISO8601 

**EventType**  
Jenis acara yang diekspor.  
Nilai: DIBUAT, DIPERBARUI, HEALTH\$1CHECK  
+ DIBUAT: Acara ekspor adalah untuk CreateProfile.
+ DIPERBARUI: Acara ekspor adalah untuk a UpdateProfile.
+ HEALTH\$1CHECK: Acara ekspor adalah HealthCheck acara untuk memastikan Profil Pelanggan berhasil di `putEvent` Kinesis Stream.

**DomainName**  
Domain milik acara tersebut. `/Domain`dari acara

**ObjectTypeName**  
Jenis objek acara  
Nilai:`_profile`,`_asset`,`_order`,`_case`. Anda juga dapat menggunakan nama template yang telah ditentukan sebelumnya seperti `Salesforce-Account` atau nama objek yang ditentukan khusus yang dapat Anda buat menggunakan [ PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API.

**AssociatedProfileId**  
ID Profil Standar yang terkait dengan Objek. Itu hanya ada jika tipe objek tidak `_profile`

**ProfileObjectUniqueKey**  
Pengidentifikasi unik yang ProfileObject dihasilkan oleh layanan.  
Tipe: String

**Object**  
Profil Standar atau Objek Profil Standar itu sendiri.

**IsMessageRealTime**  
Tandai untuk menginformasikan apakah pesan tersebut real-time atau didorong ulang.

**Sampel muatan di JSON**

```
{
    "SchemaVersion": 0,
    "EventId": "6049bf39-0000-0000-0000-b75656dd51a8",
    "EventTimestamp": "2023-02-24T07:17:05.356Z",
    "EventType": "UPDATED",
    "DomainName": "SampleDomain",
    "ObjectTypeName": "Salesforce-Account",
    "AssociatedProfileId": "5ffcee99ab0000000000b3ae01225e40",
    "ProfileObjectUniqueKey": "cNo77ZI0000000000pCPB7RQcqfeBaRfBwrzW2MMbws=",
    "Object": {
        "Id": "0012v00002kVKVuAAO",
        "IsDeleted": false,
        "Name": "Company A",
        "Phone": "+12065551234",
        "PhotoUrl": "/services/images/photo/0012v00002kVKVuAAO",
        "OwnerId": "0052v00000fmQ7sAAE",
        "CreatedDate": "2019-12-13T07:56:04.000+0000",
        "CreatedById": "0052v00000fmQ7sAAE",
        "LastModifiedDate": "2023-02-22T20:29:43.000+0000",
        "LastModifiedById": "0052v00000fmQ7sAAE",
        "SystemModstamp": "2023-02-22T20:29:43.000+0000",
        "LastActivityDate": "2020-03-18",
        "LastViewedDate": "2023-02-23T00:09:49.000+0000",
        "LastReferencedDate": "2023-02-23T00:09:49.000+0000",
        "CleanStatus": "Pending"
    },
    "IsMessageRealTime": true
}
```

# Memecahkan masalah saat mengekspor event secara real-time ke Kinesis Data Stream
<a name="real-time-export-troubleshooting"></a>

Mungkin ada penundaan saat pertama kali mengekspor acara ke Aliran Data Kinesis Anda. Ini karena waktu yang diperlukan untuk menyebarkan izin IAM untuk peran terkait layanan. Ketika masalah sebenarnya terjadi, status streaming dapat memasuki status kesalahan.

![\[Peristiwa tidak dapat mencapai tujuan Kinesis Data Stream, memasuki status kesalahan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/real-time-export-troubleshooting.png)


Bagian berikut menampilkan kemungkinan pesan kesalahan yang mungkin Anda temui. Ini juga memberikan penyebab dan resolusi untuk setiap masalah.

## Kesalahan: Aliran Data Kinesis tidak Aktif. Silakan periksa konfigurasi dan buat ulang aliran acara nanti
<a name="real-time-export-kinesis-not-active"></a>

Aliran Data Kinesis tujuan tidak dalam `ACTIVE` keadaan. Hal ini dapat terjadi ketika Kinesis Data Stream Anda sedang dibuat atau dihapus. Untuk mengatasi kesalahan, pastikan Kinesis Data Stream Anda dalam status AKTIF dan aktifkan kembali pengaturan streaming data.

## Kesalahan: Aliran Data Kinesis tidak ada. Harap buat ulang aliran acara dengan tujuan Kinesis Data Stream yang valid
<a name="real-time-export-kinesis-not-found"></a>

Aliran Data Kinesis tujuan dihapus. Untuk mengatasi kesalahan, aktifkan kembali streaming data dengan Kinesis Data Stream yang ada sebagai tujuan.

## Kesalahan: Aliran Data Kinesis sedang dibatasi. Harap pertimbangkan penyediaan throughput Kinesis yang lebih tinggi dengan tepat
<a name="real-time-export-kinesis-throttling"></a>

Aliran Data Kinesis tujuan sedang dibatasi (kurang disediakan). Untuk mengatasi kesalahan tersebut, pastikan Kinesis Data Stream tujuan memiliki jumlah pecahan yang cukup dan kemudian aktifkan kembali streaming data.

## Kesalahan: Kunci KMS yang digunakan untuk mengenkripsi Kinesis Data Stream sedang dibatasi. Harap pertimbangkan untuk meningkatkan kuota permintaan KMS dengan tepat
<a name="real-time-export-kms-throttling"></a>

Kunci KMS yang digunakan oleh Kinesis Data Stream sedang dibatasi. Untuk mengatasi kesalahan, aktifkan kembali streaming data.

## Kesalahan: Periksa konfigurasi Kunci KMS dari Aliran Data Kinesis Anda
<a name="real-time-export-kms-error"></a>

Profil Pelanggan tidak dapat mengakses kunci KMS yang digunakan oleh Kinesis Data Stream. Hal ini dapat terjadi ketika kunci KMS Anda memiliki kebijakan kunci yang menolak akses dari peran terkait layanan Profil Pelanggan, atau kunci tidak dalam status Diaktifkan. Untuk mengatasi kesalahan, pastikan kebijakan kunci KMS tidak menolak akses dari peran terkait layanan Profil Pelanggan, dan kuncinya ada dalam status Diaktifkan. Aktifkan kembali streaming data untuk mengatasi kesalahan.