Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan API Profil Pelanggan Amazon Connect
Untuk informasi tentang cara mengelola domain dan profil secara terprogram, lihat Referensi API [Amazon Connect Customer Profiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html).
## ListObjectTypeAttributeValues API
ListObjectTypeAttributeValues API menyediakan akses ke nilai berbeda terbaru untuk atribut tertentu, membuatnya berharga untuk validasi data real-time dan pemeriksaan konsistensi dalam tipe objek Anda. API ini bekerja di seluruh domain, mendukung tipe objek kustom dan standar. API menerima nama tipe objek, nama atribut, dan nama domain sebagai parameter input dan mengembalikan nilai hingga batas penyimpanan sekitar 350KB.
**Catatan:**
+ Kami menyimpan hingga 350KB nilai atribut per bidang, memprioritaskan nilai terbaru terlebih dahulu. Setelah batas ini tercapai, nilai yang lebih lama akan dihapus secara otomatis untuk memberi ruang bagi entri baru.
## GetObjectTypeAttributeValues API
GetObjectTypeAttributeValues API memberikan wawasan statistik tentang atribut dalam jenis objek tertentu, tetapi tersedia secara eksklusif untuk domain dengan penyimpanan Data diaktifkan. API ini melakukan perhitungan harian untuk memberikan informasi statistik tentang nilai atribut Anda, membantu Anda memahami pola dan tren dalam data Anda. Perhitungan statistik dilakukan sekali sehari, memberikan snapshot yang konsisten dari karakteristik data atribut Anda.
**Catatan:**
+ Anda akan menerima nilai nol dalam dua skenario:
+ Selama periode pertama setelah mengaktifkan brankas data (kecuali siklus perhitungan terjadi, yang terjadi sekali sehari).
+ Untuk atribut yang tidak mengandung nilai numerik.
Sebaiknya gunakan pustaka open source CustomerProfile JS saat mengintegrasikan Profil Pelanggan ke dalam aplikasi agen Anda sendiri. Untuk informasi lebih lanjut, lihat repo CustomerProfiles JS di [Github](https://github.com/amazon-connect/amazon-connect-customer-profiles).
Untuk informasi selengkapnya tentang cara mengintegrasikan aplikasi yang ada dengan Amazon Connect, gunakan [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams). Anda dapat menyematkan komponen Contact Control Panel (CCP) ke dalam aplikasi Anda.
# Memahami IPv6 dukungan di Profil Pelanggan Amazon Connect
## Konektivitas Publik
Semua Profil Pelanggan Amazon Connect APIs sepenuhnya mendukung IPv4 dan IPv6 menelepon.
```
profile.Region.api.aws
```
**Sebagai contoh:**
```
profile.us-east-1.api.aws
```
Untuk AWS CLI, Anda harus menggunakan titik akhir ini secara eksplisit:
```
aws customer-profiles list-domains \
--endpoint https://profile.us-east-1.api.aws \
--region us-east-1
```
Yang lama APIs masih tersedia sebagai kompatibilitas mundur. Mereka hanya mendukung IPv4 panggilan.
```
profile.Region.amazonaws.com
```
**Sebagai contoh:**
```
profile.us-east-1.amazonaws.com
```
## Konektivitas Pribadi
Anda dapat membuat titik akhir VPC untuk layanan Profil Pelanggan Amazon Connect menggunakan konsol Amazon VPC atau AWS Command Line Interface (AWS CLI). Untuk informasi selengkapnya, lihat [Membuat titik akhir antarmuka](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html) di PrivateLink Panduan AWS.
Buat titik akhir VPC untuk Profil Pelanggan Amazon Connect menggunakan nama layanan berikut:
```
com.amazonaws.Region.profile
```
**Sebagai contoh:**
```
com.amazonaws.us-east-1.profile
```
Jika Anda mengaktifkan DNS pribadi untuk titik akhir, Anda dapat membuat permintaan API ke Profil Pelanggan Amazon Connect menggunakan nama DNS IPv4 dan IPv6 didukung untuk Wilayah, misalnya, profile.us-east-1.api.aws.
Atau, nama DNS lama untuk wilayah ini juga didukung sebagai IPv4 saja.
**Sebagai contoh:**
```
profile.us-east-1.amazonaws.com
```
# Contoh: Mengintegrasikan Amazon S3 secara terprogram dengan Profil Pelanggan Amazon Connect
Dengan menggunakan [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html)API Profil Pelanggan, Anda dapat secara terprogram membuat integrasi untuk S3, Salesforce, Marketo, dan lainnya.
Dalam topik ini kami menunjukkan cara membuat integrasi S3 dengan interval sinkronisasi 15 menit, nilai minimum yang saat ini didukung.
## Langkah 1: Buat file JSON
Buat file JSON dengan konten berikut:
```
{
"DomainName": "your-domain",
"ObjectTypeName": "your-object-name",
"FlowDefinition": {
"FlowName": "your-flow-name",
"KmsArn": "the key ARN is the same as your domain's key",
"Description": "Created by Customer Profiles",
"TriggerConfig": {
"TriggerType": "Scheduled",
"TriggerProperties": {
"Scheduled": {
"ScheduleExpression": "rate(15minutes)",
"DataPullMode": "Incremental",
"ScheduleStartTime": 1634244800.435,
"FirstExecutionFrom": 1594166400
}
}
},
"SourceFlowConfig": {
"ConnectorType":"S3",
"SourceConnectorProperties": {
"S3": {
"BucketName": "your-bucket",
"BucketPrefix": "your-prefix"
}
}
},
"Tasks": [
{"TaskType":"Filter","SourceFields":["colA","colB"],"ConnectorOperator":{"S3":"PROJECTION"}},
{"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colA","TaskProperties":{},"SourceFields":["colA"],"TaskType":"Map"},
{"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colB","TaskProperties":{},"SourceFields":["colB"],"TaskType":"Map"}
]
}
}
```
Untuk menyesuaikan JSON dengan nilai Anda sendiri, ikuti panduan ini:
+ `FlowName`: Bisa STRING [A-za-z0-9] [\$1 w\$1 @\$1.-] \$1
+ `ScheduleStartTime`: Atur ke `DateTime` \$15 menit saat ini dalam waktu epoch.
+ `FirstExecutionFrom`: Buka S3, lihat tanggal file, dan gunakan tanggal yang sebelum tanggal tertua.
+ `Tasks`: Tentukan`TaskType`. Di `Sourcefields` bidang Anda harus menyediakan SEMUA kolom yang Anda miliki di CSV Anda dalam array itu. Kemudian, untuk masing-masing item dalam array itu, Anda perlu menentukan`ConnectorOperator`. Contoh ini untuk dokumen CSV dengan dua kolom: `colA` dan`colB`.
## Langkah 2: Panggil PutIntegration API
Setelah Anda membuat dan menyesuaikan file JSON dengan nilai Anda, panggil [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html)API, seperti yang ditunjukkan pada contoh berikut:
```
aws customer-profiles put-integration --cli-input-json file:///put_integration_s3_cli.json --region us-west-2
```
Respons dari `PutIntegration` mengembalikan URI aliran. Contoh:
```
{
"DomainName": "testDomain",
"Uri": "arn:aws:appflow:us-west-2:9999999999999:flow/Customer_Profiles_testDomain_S3_Salesforce-Account_1634244122247",
"ObjectTypeName": "your objec type",
"CreatedAt": "2021-10-14T13:51:57.748000-07:00",
"LastUpdatedAt": "2021-10-14T13:51:57.748000-07:00",
"Tags": {}
}
```
## Langkah 3: Hubungi Amazon AppFlow StartFlow API
Gunakan URI aliran untuk memanggil Amazon AppFlow [StartFlow](https://docs.aws.amazon.com/appflow/1.0/APIReference/API_StartFlow.html)API. Contoh:
```
aws appflow start-flow —flow-name uri --region us-west-2
```