Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan atribut kontak Amazon Connect
Salah satu cara untuk membuat pelanggan Anda merasa diperhatikan adalah dengan menciptakan pengalaman yang dipersonalisasi untuk mereka di pusat kontak Anda. Misalnya, Anda dapat mengirimkan satu pesan selamat datang untuk pelanggan yang menggunakan telepon dan satu lagi untuk pelanggan yang menggunakan obrolan. Untuk melakukan ini, Anda memerlukan cara untuk menyimpan informasi tentang kontak dan kemudian membuat keputusan berdasarkan nilainya.
**Topics**
+ [Cara kerja atribut kontak di Amazon Connect](what-is-a-contact-attribute.md)
+ [Daftar atribut kontak yang tersedia di Amazon Connect dan JSONPath referensinya](connect-attrib-list.md)
+ [Cara mereferensikan atribut kontak di Amazon Connect](how-to-reference-attributes.md)
+ [Menampilkan informasi kontak ke agen di Contact Control Panel (CCP)](use-attribs-ccp.md)
+ [Menggunakan atribut di Amazon Connect untuk merutekan berdasarkan jumlah kontak dalam antrian](attrib-system-metrics.md)
+ [Personalisasi pengalaman kontak berdasarkan cara mereka menghubungi pusat kontak Anda](use-channel-contact-attribute.md)
+ [Gunakan Amazon Lex dan nilai atribut](attribs-cust-input-lex-bot.md)
+ [Menyimpan nilai dari fungsi Lambda sebagai atribut kontak di Amazon Connect](attribs-with-lambda.md)
# Cara kerja atribut kontak di Amazon Connect
Amazon Connect memperlakukan setiap interaksi dengan pelanggan sebagai **kontak**. Interaksi dapat berupa panggilan telepon (suara), obrolan, atau interaksi otomatis dengan bot Amazon Lex.
Setiap kontak dapat memiliki beberapa data yang spesifik untuk interaksi tertentu. Data ini dapat diakses sebagai atribut kontak. Contoh:
+ Nama pelanggan
+ Nama agen
+ Saluran yang digunakan untuk kontak, seperti telepon atau obrolan
Atribut kontak mewakili data ini sebagai pasangan kunci-nilai. Anda mungkin menganggapnya sebagai nama bidang bersama dengan data yang dimasukkan ke dalam bidang itu.
Sebagai contoh, berikut adalah beberapa pasangan kunci-nilai untuk nama pelanggan:
| Key | Nilai |
| --- | --- |
| nama depan | Jane |
| nama belakang | Doe |
Keuntungan dari atribut kontak adalah bahwa mereka memungkinkan Anda untuk menyimpan informasi sementara tentang kontak sehingga Anda dapat menggunakannya dalam alur.
Misalnya, dalam pesan selamat datang Anda, Anda dapat mengucapkan nama mereka atau berterima kasih kepada mereka karena telah menjadi anggota. Untuk melakukan ini, Anda memerlukan cara untuk mengambil data tentang pelanggan tertentu dan menggunakannya dalam aliran.
## Kasus penggunaan umum
Berikut adalah beberapa kasus penggunaan umum di mana atribut kontak digunakan:
+ Gunakan nomor telepon pelanggan untuk menjadwalkan panggilan balik antrian.
+ Identifikasi agen mana yang berinteraksi dengan pelanggan sehingga survei pos panggilan dapat dikaitkan dengan kontak.
+ Identifikasi jumlah kontak dalam antrian untuk memutuskan apakah kontak harus diarahkan ke antrian yang berbeda.
+ Dapatkan ARN streaming media yang sesuai untuk disimpan dalam database.
+ Gunakan nomor telepon pelanggan untuk mengidentifikasi status pelanggan (misalnya, apakah mereka anggota), atau status pesanan mereka (dikirim, ditunda, dll.) Untuk mengarahkan mereka ke antrian yang sesuai.
+ Berdasarkan interaksi pelanggan dengan bot, identifikasi slot (misalnya, jenis bunga yang akan dipesan) yang akan digunakan dalam aliran.
## Jenis atribut kontak
Untuk membuatnya lebih cepat bagi Anda untuk menemukan dan memilih atribut yang ingin Anda gunakan, atribut dikelompokkan ke dalam **tipe**. Untuk setiap blok aliran, kami hanya memunculkan jenis atribut yang bekerja dengannya.
Cara lain untuk memikirkan jenis atribut kontak adalah dengan mengkategorikannya berdasarkan dari mana nilainya berasal. Nilai untuk atribut kontak memiliki sumber berikut:
+ Amazon Connect memberikan nilai, seperti nama agen, selama interaksi kontak. Ini dikenal sebagai memberikan nilai saat runtime.
+ Proses eksternal, seperti Amazon Lex atau AWS Lambda, memberikan nilai.
+ [Ditentukan pengguna](connect-attrib-list.md#user-defined-attributes).
+ Atribut kontak: Dalam alur, Anda dapat menentukan nilai untuk atribut di bawah Namespace yang ditentukan pengguna.
+ Atribut segmen kontak: Dalam alur, Anda dapat menentukan nilai untuk atribut di bawah Namespace atribut Segmen. Anda juga harus menentukan atribut terlebih dahulu sebelum menetapkannya sebagai atribut segmen kontak. Untuk petunjuk, lihat [Gunakan atribut segmen kontak](use-contact-segment-attributes.md).
[Atribut aliran](connect-attrib-list.md#flow-attributes) mirip dengan atribut yang ditentukan pengguna. Namun, tidak seperti atribut yang ditentukan pengguna, atribut flow dibatasi pada alur di mana atribut tersebut dikonfigurasi.
Ilustrasi berikut mencantumkan jenis atribut kontak yang tersedia, dan memetakannya ke tiga sumber untuk nilai: Amazon Connect, proses eksternal seperti Amazon Lex, dan yang ditentukan pengguna.
![\[Jenis atribut kontak yang tersedia, sumber untuk nilainya.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/contact-attributes-types.png)
## Atribut kontak dalam catatan kontak
Dalam catatan kontak, atribut kontak dibagikan di semua kontak dengan yang sama InitialContactId.
Misalnya, saat melakukan transfer, atribut kontak yang diperbarui dalam aliran transfer memperbarui nilai atribut dalam atribut kontak dari kedua catatan kontak (yaitu, atribut kontak Masuk dan Transfer).
## Atribut segmen kontak dalam catatan kontak
Dalam catatan kontak, nilai atribut segmen kontak khusus untuk Contactid individu. Nilai tidak dibagikan di semua kontak dengan yang sama InitialContactId.
Misalnya, saat melakukan transfer, atribut segmen kontak yang diperbarui dalam aliran transfer memperbarui nilai atribut pada catatan kontak baru (yaitu, memperbarui atribut segmen kontak Transfer).
## “\$1” adalah karakter khusus
Amazon Connect memperlakukan karakter “\$1” sebagai karakter khusus. Anda tidak dapat menggunakannya dalam kunci saat menyetel atribut.
Misalnya, katakanlah Anda membuat blok interaksi dengan text-to-speech. Anda menetapkan atribut seperti ini:
` {"$one":"please read this text"} `
Ketika Amazon Connect membaca teks ini, ia berbunyi “tanda dolar satu” ke kontak alih-alih “harap baca teks ini.” Juga, jika Anda memasukkan \$1 dalam kunci dan mencoba mereferensikan nilainya nanti menggunakan Amazon Connect, itu tidak akan mengambil nilainya.
Amazon Connect mencatat dan meneruskan pasangan kunci:value penuh `({"_$one":"please read this text"})` ke integrasi seperti Lambda.
## Apa yang terjadi jika atribut tidak ada
Pastikan untuk menerapkan logika untuk menangani jika atribut tidak ada dan kontak dialihkan ke cabang kesalahan.
Katakanlah Anda menambahkan atribut ke blok input pelanggan Store. **Namespace** adalah **Agen** dan **Kunci** adalah **nama Pengguna**, seperti yang ditunjukkan pada contoh berikut.
![\[Simpan blok input pelanggan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/contact-attributes-errorbranch.png)
Jika aliran berjalan dan nama pengguna agen tidak tersedia, maka kontak dialihkan ke cabang kesalahan.
# Daftar atribut kontak yang tersedia di Amazon Connect dan JSONPath referensinya
Tabel berikut menjelaskan atribut kontak yang tersedia di Amazon Connect.
JSONPath Referensi untuk setiap atribut disediakan sehingga Anda dapat [membuat string teks dinamis](create-dynamic-text-strings.md).
**Topics**
+ [Atribut sistem](#attribs-system-table)
+ [Atribut segmen](#attribs-segment-attributes)
+ [Atribut tampilan](#attribs-views)
+ [Atribut kemampuan](#attribs-capabilities)
+ [Atribut agen](#attribs-agent)
+ [Atribut antrian](#attribs-system-metrics-table)
+ [Kontak atribut Metrik](#attribs-contact-metrics-table)
+ [Atribut metadata panggilan telepon (atribut panggilan)](#telephony-call-metadata-attributes)
+ [Atribut pesan awal obrolan](#chat-initial-message-attributes)
+ [Atribut email](#email-attribs)
+ [Atribut aliran media](#media-stream-attribs)
+ [Atribut kontak Amazon Lex](#attribs-lex-table)
+ [Atribut kontak kasus](#attribs-case-table)
+ [Atribut kontak Lambda](#attribs-lambda-table)
+ [Atribut yang ditentukan pengguna](#user-defined-attributes)
+ [Atribut aliran](#flow-attributes)
+ [Atribut Loop](#w2aac18c52b9c41)
+ [Atribut modul aliran](#flow-modules-attributes)
+ [Atribut Tabel Data](#data-table-attributes)
+ [Atribut Pesan Apple untuk Bisnis](#apple-messages-for-business-attributes)
+ [Atribut Profil Pelanggan](#customer-profiles-attributes)
+ [Atribut kampanye keluar](#campaign-attributes)
+ [Atribut Connect AI agents](#qic-attributes)
## Atribut sistem
Ini adalah atribut yang telah ditentukan sebelumnya di Amazon Connect. Anda dapat mereferensikan atribut sistem, tetapi Anda tidak dapat membuatnya.
Tidak semua blok dalam aliran mendukung menggunakan atribut Sistem. Misalnya, Anda tidak dapat menggunakan atribut Sistem untuk menyimpan masukan pelanggan. Sebagai gantinya, gunakan [atribut yang ditentukan pengguna](#user-defined-attributes) untuk menyimpan input data oleh pelanggan.
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| Wilayah AWS | Saat digunakan, ini mengembalikan Wilayah AWS tempat kontak ditangani. Misalnya, us-west-2, us-east-1, dan seterusnya. | Sistem | \$1. AwsRegion atau \$1 ['AwsRegion'] |
| Alamat atau nomor pelanggan | Nomor telepon pelanggan, atau alamat email jika menggunakan saluran EMAIL. Didukung dalam panggilan suara, SMS, pesan WhatsApp bisnis, dan email. Ketika digunakan dalam aliran bisikan keluar, ini adalah nomor yang dihubungi agen untuk menjangkau pelanggan. Ketika digunakan dalam arus masuk, ini adalah nomor dari mana pelanggan melakukan panggilan. Atribut ini termasuk dalam catatan kontak. Ketika digunakan dalam fungsi Lambda, itu termasuk dalam objek input di bawah. CustomerEndpoint | Sistem | \$1. CustomerEndpoint.Alamat |
| ID Pelanggan | Nomor identifikasi pelanggan. Misalnya, CustomerId mungkin nomor pelanggan dari CRM Anda. Anda dapat membuat fungsi Lambda untuk menarik ID pelanggan unik pemanggil dari sistem CRM Anda. ID Suara menggunakan atribut ini sebagai `CustomerSpeakerId` pemanggil. | Sistem | \$1.CustomerId |
| Alamat atau nomor sistem | Didukung dalam panggilan suara, SMS, email, dan pesan WhatsApp bisnis. Nomor yang dihubungi pelanggan untuk menghubungi pusat kontak Anda atau alamat email tempat kontak mengirim email jika menggunakan saluran EMAIL. Atribut ini termasuk dalam catatan kontak. Ketika digunakan dalam fungsi Lambda, itu termasuk dalam objek input di bawah. SystemEndpoint | Sistem | \$1. SystemEndpoint.Alamat |
| Nama tampilan pelanggan | Nama pelanggan di email yang mereka kirim ke pusat kontak Anda. | Sistem | \$1.CustomerEndpoint.DisplayName |
| Nama tampilan sistem | Nama tampilan alamat email yang dikirim pelanggan. | Sistem | \$1.SystemEndpoint.DisplayName |
| Daftar Alamat Email CC | Daftar lengkap alamat email cc pada email masuk yang dikirim ke pusat kontak Anda. | Sistem | \$1.AdditionalEmailRecipients.CcList |
| Ke Daftar Alamat Email | Daftar lengkap Alamat email ke email masuk yang dikirim ke pusat kontak Anda. | Sistem | \$1.AdditionalEmailRecipients.ToList |
| Nomor callback pelanggan | Nomor yang digunakan Amazon Connect untuk menelepon kembali pelanggan. Nomor ini bisa menjadi nomor yang digunakan untuk panggilan balik antrian, atau saat agen melakukan panggilan dari PKC. Transfer ke fungsionalitas antrian callback, atau untuk panggilan agen dari CCP. Nilai default adalah nomor yang digunakan pelanggan untuk menghubungi pusat kontak Anda. Namun, itu bisa ditimpa dengan [Tetapkan nomor panggilan balik](set-callback-number.md) blok. Atribut ini tidak termasuk dalam catatan kontak, dan tidak dapat diakses di input Lambda. Namun, Anda dapat menyalin atribut ke atribut yang ditentukan pengguna dengan [Tetapkan atribut kontak](set-contact-attributes.md) blok, yang disertakan dalam catatan kontak. Anda juga dapat meneruskan atribut ini sebagai parameter input Lambda di [Fungsi AWS Lambda ](invoke-lambda-function-block.md) blok, yang tidak termasuk dalam catatan kontak. | Sistem | tidak berlaku |
| Masukan pelanggan yang tersimpan | Atribut yang dibuat dari pemanggilan blok terbaru. [Menyimpan masukan pelanggan](store-customer-input.md) Nilai atribut yang dibuat dari pemanggilan [Menyimpan masukan pelanggan](store-customer-input.md) blok terbaru. Atribut ini tidak termasuk dalam catatan kontak, dan tidak dapat diakses dalam input Lambda. Anda dapat menyalin atribut ke atribut yang ditentukan pengguna dengan [Tetapkan atribut kontak](set-contact-attributes.md) blok, yang disertakan dalam catatan kontak. Anda juga dapat meneruskan atribut ini sebagai parameter input Lambda di blok. [Fungsi AWS Lambda ](invoke-lambda-function-block.md) | Sistem | \$1.StoredCustomerInput |
| Nama antrian | Nama antrean. | Sistem | \$1. Antrian.Nama |
| Antrian ARN | ARN untuk antrian. | Sistem | \$1.antrean.arn |
| Nomor antrian keluar | Nomor ID pemanggil Outbound untuk antrian yang dipilih. Atribut ini hanya tersedia dalam aliran bisikan keluar. | Sistem | |
| Suara teks ke ucapan | Nama suara Amazon Polly untuk digunakan text-to-speech dalam alur kontak. | Sistem | \$1.TextToSpeechVoiceId |
| Id kontak | Pengidentifikasi unik kontak. | Sistem | \$1.ContactId |
| Id Kontak Awal | Pengidentifikasi unik untuk kontak yang terkait dengan interaksi pertama antara pelanggan dan pusat kontak Anda. Gunakan ID kontak awal untuk melacak kontak antar alur. | Sistem | \$1.InitialContactId |
| Id Kontak Tugas | Pengidentifikasi unik untuk kontak tugas. Gunakan ID kontak tugas untuk melacak tugas di antara alur. | Sistem | \$1. Tugas. ContactId |
| ID Kontak Sebelumnya | Pengidentifikasi unik untuk kontak sebelum ditransfer. Gunakan ID kontak sebelumnya untuk melacak kontak antar aliran. | Sistem | \$1.PreviousContactId |
| Channel | Metode yang digunakan untuk menghubungi pusat kontak Anda: SUARA, OBROLAN, TUGAS, EMAIL. | Sistem | \$1. Saluran |
| Contoh ARN | ARN untuk instans Amazon Connect Anda. | Sistem | \$1.InstancEarn |
| Metode inisiasi | Bagaimana kontak dimulai. Nilai yang valid meliputi: INBOUND, OUTBOUND, TRANSFER, CALLBACK, QUEUE\$1TRANSFER, EXTERNAL\$1OUTBOUND, MONITOR, DISCONNECT, WEBRTC\$1API, dan API. | Sistem | \$1.InitiationMethod |
| Nama | Nama tugas. | Sistem | \$1. Nama |
| Deskripsi | Deskripsi tugas. | Sistem | \$1. Deskripsi |
| Referensi | Tautan ke dokumen lain yang terkait dengan kontak. | Sistem | \$1. Referensi. *ReferenceKey*.Value dan \$1. Referensi. *ReferenceKey*.Type dimana nama *ReferenceKey* Referensi yang ditentukan pengguna. |
| Bahasa | Bahasa konten. Gunakan java.util.Locale standar. Misalnya, en-US untuk Amerika Serikat Inggris, Ja-jp untuk Jepang, dll. | Sistem | \$1.LanguageCode |
| Tipe Endpoint Sistem | Jenis titik akhir sistem. Nilai yang valid adalah TELEPHONE\$1NUMBER. | Sistem | \$1. SystemEndpoint.Tipe |
| Tipe Endpoint Pelanggan | Jenis titik akhir pelanggan. Nilai yang valid adalah TELEPHONE\$1NUMBER. | Sistem | \$1. CustomerEndpoint.Tipe |
| Nomor ID Penelepon Keluar Antrian | Nomor ID pemanggil keluar ditentukan untuk antrian. Ini dapat berguna untuk mengembalikan ID pemanggil setelah menyetel ID pemanggil khusus. | Sistem | \$1. Antrian. OutboundCallerId.Alamat |
| Jenis nomor ID Penelepon Keluar Antrian | Jenis nomor ID penelepon keluar. Nilai yang valid adalah TELEPHONE\$1NUMBER. | Sistem | \$1. Antrian. OutboundCallerId.Tipe |
| Tag | Tanda yang digunakan untuk mengorganisasi, melacak, atau mengendalikan akses untuk sumber daya Anda. Untuk informasi selengkapnya tentang tag, lihat [Tambahkan tag ke sumber daya di Amazon Connect](tagging.md) dan[Siapkan penagihan granular untuk tampilan mendetail penggunaan Amazon Connect](granular-billing.md). | Sistem | \$1. Tag |
## Atribut segmen
Atribut segmen adalah sekumpulan pasangan nilai kunci yang ditentukan sistem yang disimpan pada segmen kontak individu menggunakan peta atribut. Namun, dimungkinkan untuk membuat atribut segmen yang ditentukan pengguna, seperti yang dijelaskan dalam tabel berikut..
| Atribut | Deskripsi | Nilai yang diizinkan | Tipe | JSONPath Referensi |
| --- | --- | --- | --- | --- |
| Hubungkan: subtipe | Merupakan subtipe saluran yang digunakan untuk kontak. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/connect-attrib-list.html) | ValueString | \$1. SegmentAttributes['Hubungkan: subtipe'] |
| Hubungkan: arah | Merupakan arah kontak. Misalnya, inbound atau outbound. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/connect-attrib-list.html) | ValueString | \$1. SegmentAttributes['Hubungkan: Arah'] |
| menghubungkan: CreatedByUser | Merupakan ARN pengguna yang membuat tugas. | | ValueString | \$1. SegmentAttributes['sambungkan: CreatedByUser '] |
| menghubungkan: AssignmentType | Merupakan bagaimana tugas ditugaskan. | “DIRI” | ValueString | \$1. SegmentAttributes['sambungkan: AssignmentType '] |
| menghubungkan: EmailSubject | Merupakan subjek kontak email. | | ValueString | \$1. SegmentAttributes['sambungkan: EmailSubject '] |
| menghubungkan: ScreenSharingDetails | `ScreenSharingDetails`Bagian ini menyimpan informasi tentang aktivitas berbagi layar yang dilakukan pada kontak. `ScreenSharingActivated`Kuncinya menunjukkan apakah sesi berbagi layar diaktifkan untuk kontak atau tidak. | `"connect:ScreenSharingDetails": { "ScreensharingActivated" : "TRUE" // Allowed Values "TRUE" and "FALSE" }` | ValueString | \$1. SegmentAttributes['sambungkan: ScreenSharingDetails '] |
| menghubungkan: ContactExpiry | Berisi rincian kedaluwarsa kontak seperti `ExpiryDuration` dan `ExpiryTimeStamp` untuk kontak Tugas dan Email. | | ValueMap | \$1. SegmentAttributes['sambungkan: ContactExpiry '] |
| menghubungkan: CustomerAuthentication | Detail otentikasi kontak obrolan. | `"connect:CustomerAuthentication": { "valueMap": { "IdentityProvider": { "ValueString": ""}, "ClientId": { "ValueString": ""}, "Status": { "ValueString": *AUTHENTICATED \| FAILED \| TIMEOUT*}, "AssociatedCustomerId": { "ValueString": ""} "AuthenticationMethod": { "ValueString": "*CONNECT" \| "CUSTOM*" } } }` | ValueMap | \$1. SegmentAttributes['sambungkan: CustomerAuthentication '] |
| menghubungkan: ValidationTestType | Merupakan jenis pengujian dan simulasi. Bidang ini tetap kosong untuk kontak yang tidak disimulasikan. Anda dapat menggunakan atribut ini di dasbor analitik untuk menyaring kontak pelanggan yang sebenarnya atau untuk mengidentifikasi apakah kontak disimulasikan dalam objek catatan kontak Anda. | “PENGALAMAN\$1VALIDASI” | ValueString | \$1.Segment.Attributes ['connect: '] ValidationTestType |
| Id Klien | Pengidentifikasi klien aplikasi Amazon Cognito. | | ValueString | \$1. SegmentAttributes['sambungkan: CustomerAuthentication '] [' ClientId '] |
| Identifikasi Penyedia | Penyedia identitas digunakan untuk mengautentikasi pelanggan. | | ValueString | \$1. SegmentAttributes['sambungkan: CustomerAuthentication '] [' IdentityProvider '] |
| Status | Status proses otentikasi. | `AUTHENTICATED` \$1 `FAILED` \$1 `TIMEOUT` | ValueString | \$1. SegmentAttributes['sambungkan: CustomerAuthentication '] [' Status '] |
| ID Pelanggan Terkait | Nomor pengenal pelanggan. Ini adalah pengenal kustom atau pengenal Profil Pelanggan. | | ValueString | \$1. SegmentAttributes['sambungkan: CustomerAuthentication '] [' AssociatedCustomerId '] |
| Metode Otentikasi | Alur kerja autentikasi yang dikelola Amazon Connect atau alur kerja autentikasi yang dikelola pelanggan. | `CONNECT` \$1 `CUSTOM` | ValueString | \$1. SegmentAttributes['sambungkan: CustomerAuthentication '] [' AuthenticationMethod '] |
| Subjek Email | Subjek email dalam email yang dikirim pelanggan ke pusat kontak Anda. Ini berguna jika Anda ingin melihat subjek email untuk kata kunci tertentu. | | Atribut segmen | \$1. SegmentAttributes['sambungkan: EmailSubject '] |
| Putusan Spam Amazon SES | Saat email masuk ke pusat kontak Anda, Amazon SES memindainya untuk mencari spam. Anda dapat memeriksa kondisi GAGAL dan kemudian menjatuhkan email atau memasukkannya ke dalam antrian khusus bagi pengawas untuk memeriksanya. | | Atribut segmen | \$1. SegmentAttributes['Hubungkan:x-ses-spam-vonis'] |
| Putusan Virus Amazon SES | Ketika email masuk ke pusat kontak Anda, Amazon SES memindainya dari virus. Anda dapat memeriksa kondisi GAGAL dan kemudian menjatuhkan email atau memasukkannya ke dalam antrian khusus bagi pengawas untuk memeriksanya. | | Atribut segmen | \$1. SegmentAttributes['Hubungkan: X-SES-virus-putusan'] |
| Atribut yang ditentukan pengguna | Anda dapat memilih atribut yang ditentukan pengguna dan menyimpannya di kontak di bawah atribut segmen. Atribut harus ditentukan sebelumnya sebelum dapat digunakan untuk menyimpan nilai pada kontak. Lihat [Gunakan atribut segmen kontak](use-contact-segment-attributes.md). | Jika tidak ada nilai yang telah ditentukan sebelumnya, Amazon Connect mengizinkan semua nilai string. Ini juga terjadi ketika opsi [Menerapkan nilai yang valid](use-contact-segment-attributes.md) pada halaman **Tambahkan atribut yang telah ditentukan** tidak dipilih. Ketika opsi **Menegakkan nilai valid** dipilih dan nilai telah ditentukan sebelumnya, kontak hanya menyimpan nilai yang valid dan telah ditentukan untuk kunci atribut yang telah ditentukan. (Jika menggunakan API, lihat [EnableValueValidationOnAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_InputPredefinedAttributeConfiguration.html)parameternya.) | String | \$1. SegmentAttributes['Atribute\$1key\$1name'] |
## Atribut tampilan
Tabel berikut mencantumkan atribut Tampilan yang tersedia di Amazon Connect.
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| Tindakan | Tindakan yang diambil oleh pengguna berinteraksi dengan tampilan. Tindakan muncul sebagai cabang aliran dari [Tampilkan tampilan](show-view-block.md) blok | Tampilan | \$1. Views.Aksi |
| Lihat data hasil | Data keluaran dari interaksi pengguna dengan tampilan berdasarkan komponen tempat mereka mengambil tindakan. | Tampilan | \$1. Tampilan. ViewResultData |
## Atribut kemampuan
Tabel berikut mencantumkan atribut Capabilities yang tersedia di Amazon Connect. Atribut ini mendukung kemampuan berbagi layar dan video. Untuk informasi selengkapnya, lihat [Siapkan kemampuan dalam aplikasi, web, panggilan video, dan berbagi layar](inapp-calling.md).
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| Kemampuan berbagi layar agen | Kemampuan berbagi layar yang diaktifkan untuk peserta. | Kemampuan | \$1. Kemampuan. Agen. ScreenShare |
| Kemampuan video agen | Kemampuan berbagi video yang diaktifkan untuk peserta melalui panggilan. | Kemampuan | \$1. Kemampuan.Agen.Video |
| Kemampuan berbagi layar pelanggan | Kemampuan berbagi layar yang diaktifkan untuk peserta. | Kemampuan | \$1. Kemampuan. Pelanggan. ScreenShare |
| Kemampuan video pelanggan | Kemampuan berbagi video yang diaktifkan untuk peserta melalui panggilan. | Kemampuan | \$1. Kemampuan.Customer.Video |
## Atribut agen
Tabel berikut mencantumkan atribut agen yang tersedia di Amazon Connect.
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| Nama Pengguna Agen | Nama pengguna yang digunakan agen untuk masuk ke Amazon Connect. | Sistem | \$1. Agen. UserName |
| Agen Nama depan | Nama depan agen seperti yang dimasukkan di akun pengguna Amazon Connect mereka. | Sistem | \$1. Agen. FirstName |
| Nama belakang Agen | Nama belakang agen seperti yang dimasukkan di akun pengguna Amazon Connect mereka. | Sistem | \$1. Agen. LastName |
| Agen ARN | ARN dari agen. | Sistem | \$1.agent.arn |
**catatan**
Bila Anda menggunakan atribut kontak agen dalam aliran **Transfer ke agen**, atribut agen mencerminkan agen target, bukan orang yang memulai transfer.
Atribut agen hanya tersedia dalam jenis aliran berikut:
+ Agen berbisik
+ Bisikan pelanggan
+ Agen memegang
+ Penahanan pelanggan
+ Bisikan keluar
+ Transfer ke agen. Dalam hal ini, atribut agen mencerminkan agen target, bukan orang yang memulai transfer.
Atribut agen tidak tersedia dalam jenis aliran berikut:
+ Antrian pelanggan
+ Transfer ke antrian
+ Aliran masuk
## Atribut antrian
Atribut sistem ini dikembalikan saat Anda menggunakan [Dapatkan metrik](get-queue-metrics.md) blok dalam alur Anda.
Jika tidak ada aktivitas saat ini di pusat kontak Anda, nilai null dikembalikan untuk atribut ini.
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| Nama antrian | Nama antrian yang metriknya diambil. | Sistem | \$1. Metrics.Antrian.Nama |
| Antrian ARN | ARN dari antrian yang metriknya diambil. | Sistem | \$1.metrics.queue.arn |
| Kontak dalam antrian | Jumlah kontak saat ini dalam antrian. | Sistem | \$1. Metrics.Queue.Size |
| Kontak tertua dalam antrian | Untuk kontak yang paling lama berada dalam antrian, lamanya waktu kontak berada dalam antrian, dalam hitungan detik. | Sistem | \$1.Metrics.Antrian. OldestContactAge |
| Antrian Perkiraan Waktu Tunggu | Perkiraan, dalam hitungan detik, berapa lama kontak akan menunggu dalam antrian sebelum terhubung ke agen. | Sistem | \$1.Metrics.Antrian. EstimatedWaitTime |
| Agen online | Jumlah agen yang saat ini online, yang berarti masuk dan di negara bagian mana pun selain offline. | Sistem | \$1. Metrics.Agents.Online.Count |
| Agen tersedia | Jumlah agen yang statusnya diatur ke Tersedia. | Sistem | \$1.Metrics.Agents.Tersedia. Hitungan |
| Agen yang dikelola | Jumlah agen yang saat ini dikelola, yaitu agen yang masuk dan di negara Tersedia, ACW, atau Sibuk. | Sistem | \$1. Metrics.Agens.Staffed.Count |
| Agen di Setelah kontak bekerja | Jumlah agen saat ini di negara bagian ACW. | Sistem | \$1.Metrics.Agents. AfterContactWork.Hitung |
| Agen sibuk | Jumlah agen yang saat ini aktif dalam kontak. | Sistem | \$1. Metrics.Agens.Busy.Count |
| Agen melewatkan hitungan | Jumlah agen di negara bagian Missed, yang merupakan negara bagian yang dimasuki agen setelah kontak yang terlewat. | Sistem | \$1.Metrics.Agents.Missed.Count |
| Agen dalam keadaan tidak produktif | Jumlah agen dalam keadaan non-produktif (NPT). | Sistem | \$1.Metrics.Agents. NonProductive.Hitung |
## Kontak atribut Metrik
Atribut sistem ini dikembalikan saat Anda menggunakan [Dapatkan metrik](get-queue-metrics.md) blok dalam alur Anda.
Jika tidak ada aktivitas saat ini di pusat kontak Anda, nilai null dikembalikan untuk atribut ini.
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| Perkiraan Waktu Tunggu | Perkiraan, dalam hitungan detik, berapa lama kontak saat ini akan menunggu dalam antrian sebelum terhubung ke agen. | Sistem | \$1.Metrics.Kontak. EstimatedWaitTime |
| Posisi dalam Antrian | Posisi kontak dalam antrian saat menghitung saluran (suara, obrolan, tugas, atau email) dan apakah langkah perutean digunakan. | Sistem | \$1.Metrics.Kontak. PositionInQueue |
## Atribut metadata panggilan telepon (atribut panggilan)
Metadata telepon memberikan informasi tambahan terkait dengan asal panggilan dari operator telepon.
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| P-Charge-Info | Pihak yang bertanggung jawab atas tuduhan yang terkait dengan panggilan tersebut. | Sistem | \$1.Media.Sip.Headers.P-Charge-Info |
| Dari | Identitas pengguna akhir yang terkait dengan permintaan. | Sistem | \$1.Media.Sip.Headers.Dari |
| Untuk | Informasi tentang pihak yang dipanggil atau penerima permintaan. | Sistem | \$1.Media.Sip.Headers.To |
| ISUP-OLI | Indikator Garis Asal (OLI). Menunjukkan jenis panggilan penempatan baris (misalnya, PSTN, panggilan layanan 800, wireless/cellular PCS, telepon umum). | Sistem | \$1.media.sip.headers.isup-oli |
| JIP | Parameter Indikasi Yurisdiksi (JIP). Menunjukkan lokasi geografis pemanggil/sakelar. Nilai contoh: 212555 | Sistem | \$1.media.sip.headers.jip |
| Penghitung Hop- | Penghitung Hop. Nilai contoh: 0 | Sistem | \$1.Media.Sip.Headers.Hop-Counter |
| Sakelar Asal-Asal | Sakelar Asal. Nilai contoh: 710 | Sistem | \$1.Media.Sip.Headers.Originating-Switch |
| Batang Asal- | Batang Asal. Nilai contoh: 0235 | Sistem | \$1.Media.Sip.Headers.Originating-Trunk |
| Indikator Penerusan Panggilan | Indikator Penerusan Panggilan (misalnya, header Pengalihan). Menunjukkan asal panggilan domestik atau internasional. Nilai contoh: sip: \$1 15555555555@public-vip.us2.telphony-provider.com; alasan = tanpa syarat | Sistem | \$1.Media.Sip.Headers.Call-Forwarding-Indicator |
| Panggilan-Pesta-Alamat | Alamat Pesta Panggilan (nomor). NPAC dip menunjukkan tipe garis yang sebenarnya dan sakelar geografis asli. Nilai contoh: 15555555555; noa = 4 | Sistem | \$1.Media.Sip.Headers.Calling-Party-Address |
| Disebut-Pesta-Alamat | Disebut Alamat Partai (nomor). Nilai contoh: 15555555555; noa = 4 | Sistem | \$1.Media.Sip.Headers.Called-Party-Address |
| Metadata SIPREC | XMLmetadata SIPREC diterima oleh konektor Lensa Kontak Amazon | Sistem | \$1. Media.Sip. SiprecMetadata |
**catatan**
Ketersediaan metadata telepon tidak konsisten di semua penyedia telepon dan mungkin tidak tersedia dalam semua kasus. Ini dapat menghasilkan nilai kosong.
## Atribut pesan awal obrolan
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| InitialMessage | Pesan awal yang diberikan oleh pelanggan pada obrolan web atau SMS. | Sistem | \$1. Media. InitialMessage |
## Atribut email
Tabel berikut mencantumkan atribut email yang tersedia di Amazon Connect.
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| Pesan email (Teks biasa) | Saat menggunakan blok aliran [konten tersimpan](get-stored-content.md), ini akan menyimpan versi teks biasa dari pesan email dari kontak email. | Sistem | \$1. Email. EmailMessage.Teks biasa |
## Atribut aliran media
Tabel berikut mencantumkan atribut yang dapat Anda gunakan untuk mengidentifikasi lokasi dalam aliran media langsung tempat audio pelanggan dimulai dan berhenti.
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| Arn streaming audio pelanggan | ARN dari Kinesis Video stream digunakan untuk streaming media langsung yang mencakup data pelanggan untuk referensi. | Aliran media | \$1. MediaStreams.customer.audio.streamarn |
| Stempel waktu mulai audio pelanggan di aliran video Kinesis yang digunakan untuk streaming media langsung. | Saat streaming audio pelanggan dimulai. | Aliran media | \$1. MediaStreams.Customer.Audio. StartTimestamp |
| Stempel waktu berhenti audio pelanggan | Ketika streaming audio pelanggan menghentikan aliran video Kinesis yang digunakan untuk streaming media langsung. | Aliran media | \$1. MediaStreams.Customer.Audio. StopTimestamp |
| Nomor fragmen mulai audio pelanggan | Nomor yang mengidentifikasi fragmen Kinesis Video Streams, dalam aliran yang digunakan untuk streaming media langsung, di mana streaming audio pelanggan dimulai. | Aliran media | \$1. MediaStreams.Customer.Audio. StartFragmentNumber |
## Atribut kontak Amazon Lex
Tabel berikut mencantumkan atribut yang dikembalikan dari bot Amazon Lex. Ini juga dikenal sebagai *atribut sesi*.
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| Maksud Alternatif | Daftar maksud alternatif yang tersedia dari Amazon Lex. Setiap niat memiliki skor kepercayaan dan slot yang sesuai untuk diisi. | Lex | \$1. Lex. AlternativeIntents. *x*. IntentName \$1. Lex. AlternativeIntents. *x*. IntentConfidence.Skor \$1. Lex. AlternativeIntents. *x*.Slot \$1. Lex. AlternativeIntents. *y.*IntentName \$1. Lex. AlternativeIntents. *y*. IntentConfidence.Skor \$1. Lex. AlternativeIntents. *y*.Slot \$1. Lex. AlternativeIntents. *z*. IntentName \$1. Lex. AlternativeIntents. *z*. IntentConfidence.Skor \$1. Lex. AlternativeIntents. *z*.Slot Di mana*x*, *y,* dan *z* apakah nama-nama maksud dalam tanggapan Lex |
| Skor Keyakinan Niat | Skor kepercayaan niat dikembalikan oleh Amazon Lex. | Lex | \$1. Lex. IntentConfidence.Skor |
| Nama maksud | Maksud pengguna dikembalikan oleh Amazon Lex. | Lex | \$1. Lex. IntentName |
| Label Sentimen | Sentimen yang disimpulkan bahwa Amazon Comprehend memiliki kepercayaan tertinggi. | Lex | \$1. Lex. SentimentResponse.Label |
| Skor sentimen | Kemungkinan sentimen itu disimpulkan dengan benar. | Lex | \$1. Lex. SentimentResponse.Scores.Positif \$1. Lex. SentimentResponse.Scores.Negatif \$1. Lex. SentimentResponse.Scores.Mixed \$1. Lex. SentimentResponse.Scores.Neutral |
| Atribut sesi | Peta pasangan nilai kunci yang mewakili informasi konteks khusus sesi. | Lex | \$1. Lex. SessionAttributes.AttributeKey |
| Slot | Peta slot maksud (pasangan kunci/nilai) Amazon Lex terdeteksi dari input pengguna selama interaksi. | Lex | \$1.lex.slots.slotname |
| Status dialog | Status dialog terakhir kembali dari bot Amazon Lex. Nilainya adalah 'Terpenuhi' jika maksud dikembalikan ke aliran. | N/A (tidak ada tipe yang muncul di UI) | \$1. Lex. DialogState |
## Atribut kontak kasus
Tabel berikut mencantumkan atribut yang digunakan dengan Kasus Amazon Connect.
| Atribut | Deskripsi | Tipe | JSONPath Referensi | Dari mana datanya berasal |
| --- | --- | --- | --- | --- |
| ID Kasus | Pengidentifikasi unik kasus dalam format UUID (misalnya, 689b0bea-aa29-4340-896d-4ca3ce9b6226) | text | \$1.case.case\$1id | Amazon Connect |
| Alasan Kasus | Alasan untuk membuka kasus | pilih tunggal | \$1.case.case\$1alasan | Agen |
| Dibuat Oleh | Identitas pengguna yang membuat kasus. | user | \$1.case.created\$1by | Amazon Connect |
| Pelanggan | API adalah ID profil pelanggan. Pada halaman Cases: Fields, nama pelanggan ditampilkan. | text | \$1.case.customer\$1id | Amazon Connect |
| Tanggal/Waktu Ditutup | Tanggal dan waktu kasus terakhir ditutup. Itu tidak menjamin bahwa kasing ditutup. Jika kasus dibuka kembali, bidang ini berisi date/time stempel terakhir kali status diubah menjadi ditutup. | tanggal-waktu | \$1.case.last\$1closed\$1datetime | Amazon Connect |
| Tanggal/Waktu Dibuka | Tanggal dan waktu kasus dibuka. | tanggal-waktu | \$1.case.created\$1datetime | Amazon Connect |
| Tanggal/Waktu Diperbarui | Tanggal dan waktu kasus terakhir diperbarui. | tanggal-waktu | \$1.case.last\$1updated\$1datetime | Amazon Connect |
| Nomor referensi | Nomor ramah untuk kasing dalam format numerik 8 digit. Nomor referensi (tidak seperti ID Kasus) tidak dijamin unik. Kami menyarankan Anda mengidentifikasi pelanggan dan kemudian mengumpulkan nomor referensi untuk menemukan kasus yang tepat dengan benar. | text | \$1.case.reference\$1number | Agen |
| Status | Status kasus saat ini | text | \$1.case.status | Agen |
| Ringkasan | Ringkasan kasus | text | \$1.kasus.Ringkasan | Agen |
| judul | Judul kasus | text | \$1.case.title | Agen |
## Atribut kontak Lambda
Atribut Lambda dikembalikan sebagai pasangan kunci-nilai dari pemanggilan blok terbaru. [Fungsi AWS Lambda ](invoke-lambda-function-block.md) Atribut pemanggilan Lambda ditimpa dengan setiap pemanggilan fungsi Lambda.
Untuk mereferensikan atribut di JSONPath, gunakan:
+ `$.LambdaInvocation.ResultData.attributeName`
di mana `AttributeName` adalah nama atribut, atau kunci dari pasangan kunci-nilai dikembalikan dari fungsi.
Misalnya, jika fungsi mengembalikan ID kontak, referensi atribut dengan`$.LambdaInvocation.ResultData.ContactId`. Saat mereferensikan ID kontak yang dikembalikan dari Amazon Connect, JSONPath adalah`$.ContactId`.
Untuk informasi selengkapnya tentang penggunaan atribut dalam fungsi Lambda, lihat. [Berikan Amazon Connect akses ke AWS Lambda fungsi Anda](connect-lambda-functions.md)
Atribut ini tidak termasuk dalam catatan kontak, tidak diteruskan ke pemanggilan Lambda berikutnya, dan tidak diteruskan ke PKC untuk informasi screenpop. Namun, mereka dapat diteruskan sebagai input fungsi Lambda pada [Fungsi AWS Lambda ](invoke-lambda-function-block.md) blok, atau disalin ke atribut yang ditentukan pengguna menggunakan blok. [Tetapkan atribut kontak](set-contact-attributes.md) Saat digunakan dalam [Tetapkan atribut kontak](set-contact-attributes.md) blok, atribut yang disalin disertakan dalam catatan kontak, dan dapat digunakan dalam PKC.
## Atribut yang ditentukan pengguna
Untuk semua atribut lainnya Amazon Connect mendefinisikan kunci dan nilai. Namun, untuk atribut yang ditentukan pengguna, Anda memberikan nama untuk kunci dan nilainya.
Gunakan atribut yang ditentukan pengguna dalam situasi di mana Anda ingin menyimpan nilai dalam alur kontak, lalu lihat nilai tersebut nanti. Misalnya, jika Anda mengintegrasikan Amazon Connect dan CRM atau sistem lain, Anda mungkin ingin mendapatkan masukan dari pelanggan seperti nomor anggota mereka. Kemudian Anda dapat menggunakan nomor anggota tersebut untuk mengambil informasi tentang anggota dari CRM, and/or menggunakan nomor anggota di seluruh alur, dll.
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| Nama apa pun yang Anda pilih | Atribut yang ditentukan pengguna memiliki dua bagian: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/connect-attrib-list.html) | Ditentukan pengguna | \$1. Atribut. *name\$1of\$1your\$1destination\$1key* |
Untuk membuat atribut yang ditentukan pengguna, gunakan blok. [Tetapkan atribut kontak](set-contact-attributes.md)
## Atribut aliran
Atribut aliran seperti atribut tipe yang ditentukan pengguna, namun, atribut tersebut dibatasi pada alur di mana atribut tersebut disetel.
Atribut aliran berguna dalam situasi di mana Anda tidak ingin menyimpan data di seluruh kontak, seperti ketika Anda perlu menggunakan informasi sensitif seperti nomor kartu kredit pelanggan untuk melakukan penurunan data Lambda.
+ Atribut aliran adalah variabel sementara yang disimpan secara lokal dan hanya digunakan dalam aliran. Mereka tidak terlihat di mana pun di luar aliran, bahkan ketika kontak ditransfer ke aliran lain.
+ Mereka dapat mencapai 32 KB (ukuran maksimum bagian atribut catatan kontak).
+ **Mereka tidak diteruskan ke Lambda kecuali mereka secara eksplisit dikonfigurasi sebagai parameter: di blok **fungsi Invoke AWS Lambda**, pilih Tambahkan parameter.**
+ Mereka tidak diteruskan ke modul. Anda dapat menyetel atribut flow dalam modul, tetapi tidak akan dilewatkan dari modul.
+ Mereka tidak muncul di catatan kontak.
+ Mereka tidak tampak kepada agen di PKT.
+ `GetContactAttributes`API tidak dapat mengeksposnya.
+ Jika Anda mengaktifkan logging pada alur, kunci dan nilai akan muncul di log Cloudwatch.
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| Nama apa pun yang Anda pilih | Atribut flow memiliki dua bagian: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/connect-attrib-list.html) | Aliran | \$1. FlowAttributes. *name\$1of\$1your\$1destination\$1key* |
## Atribut Loop
Tabel berikut mencantumkan atribut yang tersedia dengan blok Loop jika a LoopName ditentukan dalam blok Loop.
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| Indeks | Indeks Loop saat ini. Nilai dimulai dari 0. Ini tersedia dengan loop berbasis Count dan Array | Loop | \$1. Loop. *name\$1of\$1your\$1loop .Index* |
| Elemen | Elemen Loop saat ini. Ini hanya tersedia dengan loop berbasis Array | Loop | \$1. Loop. *name\$1of\$1your\$1loop .Elemen* |
| Elemen | Elemen yang disediakan sebagai masukan ke Loop. Ini hanya tersedia dengan loop berbasis Array | Loop | \$1. Loop. *name\$1of\$1your\$1loop .Elemen* |
## Atribut modul aliran
Modul aliran Atribut input adalah atribut yang diteruskan ke modul yang telah menentukan skema input dari aliran atau modul lain menggunakan blok Modul [Invoke](contact-flow-modules.md#add-modules). Modul aliran Output dan atribut Result dikembalikan dari pemanggilan terbaru dari blok Modul [Invoke](contact-flow-modules.md#add-modules). Atribut Output dan Result Modul ditimpa dengan setiap pemanggilan fungsi Modul.
Atribut ini tidak termasuk dalam catatan kontak, tidak diteruskan ke pemanggilan modul berikutnya, dan tidak diteruskan ke PKC untuk informasi screenpop. Namun, mereka dapat disalin ke atribut yang ditentukan pengguna menggunakan blok Atribut [kontak Set](set-contact-attributes.md). Ketika digunakan dalam blok [Atribut kontak Set](set-contact-attributes.md), atribut yang disalin disertakan dalam catatan kontak, dan dapat digunakan dalam CCP.
Tabel berikut mencantumkan atribut modul aliran yang tersedia di Amazon Connect.
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| Input | Data input menyediakan akses ke input yang diteruskan ke modul. Ini dikembalikan sebagai objek JSON dan format tertentu ditentukan oleh skema input modul. | Modul | \$1. Modul.Masukan |
| Hasil | Data hasil menangkap nama cabang yang dikembalikan dari modul tidak termasuk cabang kesalahan. Ini dikembalikan sebagai string. | Modul | \$1.Modul.Hasil |
| Output (Atribut referensi dari UI) | Data output menangkap data-hasil yang dihasilkan dari eksekusi modul. Ini dikembalikan sebagai objek JSON dan format tertentu ditentukan oleh skema output modul. | Modul | \$1. Modul. ResultData |
## Atribut Tabel Data
Atribut yang dikembalikan oleh operasi blok Tabel Data. Gunakan ini untuk mengakses data yang diambil dari tabel data dalam alur kontak Anda.
### Mengevaluasi atribut Nilai Tabel Data
Atribut dikembalikan saat menggunakan tindakan Evaluasi di blok Tabel Data untuk menanyakan nilai atribut tertentu.
+ Jika query tidak mengembalikan hasil atau atribut tidak ditemukan, referensi akan kosong atau null.
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| Tabel Data hasil kueri yang dievaluasi | Nilai atribut tertentu diambil oleh query bernama. Ganti `` dengan nama unik yang ditetapkan untuk kueri Anda, dan `` dengan nama atribut yang Anda pilih untuk diambil. | Tabel Data | \$1.DataTables.. |
### Daftar Data Tabel Nilai atribut
Atribut dikembalikan saat menggunakan tindakan Daftar di blok Tabel Data untuk mengambil catatan lengkap.
+ Daftar mengembalikan catatan lengkap (semua atribut), bukan hanya yang dipilih.
+ Jika tidak ada catatan yang cocok ditemukan, primaryKeyGroups array akan kosong.
+ Bila tidak ada grup kunci primer yang dikonfigurasi, seluruh tabel dimuat dan hasilnya dapat diakses dengan nama grup “default”:`$.DataTableList.ResultData.primaryKeyGroups.default[index]`.
+ Namespace Daftar memiliki batas data maksimum 32 KB.
+ Saat mengakses elemen array di blok aliran, gunakan backticks untuk membungkus referensi: JSONPath ``$.DataTableList.ResultData.primaryKeyGroups.[index]``
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| ID tabel data | Pengidentifikasi unik dari tabel data dari mana catatan diambil. | Daftar Tabel Data | \$1.DataTableList.ResultData.dataTableId |
| Versi kunci | Informasi versi kunci untuk tabel data. | Daftar Tabel Data | \$1. DataTableList. ResultData.lockVersion.DataTable |
| Nama grup default | Ketika tidak ada grup kunci utama yang dikonfigurasi, seluruh tabel dimuat dan hasilnya dapat diakses di bawah nama grup “default”. | Daftar Tabel Data | \$1. DataTableList. ResultData. primaryKeyGroups.default [indeks] |
| Kelompok-kelompok kunci utama | Kumpulan catatan yang diambil diatur oleh nama grup nilai primer. Ganti `` dengan nama yang ditetapkan ke grup nilai utama Anda. | Daftar Tabel Data | \$1.DataTableList.ResultData.primaryKeyGroups. |
| Baris tertentu | Akses baris tertentu dalam grup kunci utama. Ganti `` dengan nama grup Anda dan `[index]` dengan indeks baris berbasis nol. | Daftar Tabel Data | \$1. DataTableList. ResultData. primaryKeyGroups. < GroupName > [indeks] |
| Nilai kunci primer | Akses nilai atribut kunci utama di baris tertentu. | Daftar Tabel Data | \$1. DataTableList. ResultData. primaryKeyGroups. < GroupName > [index] .primaryKeys [index] .attributeValue |
| Nilai atribut | Akses nilai atribut non-primer di baris tertentu. | Daftar Tabel Data | \$1. DataTableList. ResultData. primaryKeyGroups. < GroupName > [index] .attributes [index] .attributeValue |
## Atribut Pesan Apple untuk Bisnis
Gunakan atribut kontak berikut untuk merutekan Pesan Apple untuk pelanggan Bisnis. Misalnya, jika Anda memiliki lini bisnis yang berbeda menggunakan Apple Messages for Business, Anda dapat melakukan cabang ke alur yang berbeda berdasarkan atribut AppleBusinessChatGroup kontak. Atau, jika Anda ingin merutekan pesan Apple Messages for Business secara berbeda dari pesan obrolan lainnya, Anda dapat melakukan cabang berdasarkan pesan MessagingPlatform.
| Atribut | Deskripsi | Tipe | JSON |
| --- | --- | --- | --- |
| MessagingPlatform | Platform perpesanan dari mana permintaan pelanggan berasal. Nilai yang tepat: **AppleBusinessChat** | Ditentukan pengguna | \$1. Atribut. MessagingPlatform |
| AppleBusinessChatCustomerId | ID buram pelanggan yang disediakan oleh Apple. Ini tetap konstan untuk AppleID dan bisnis. Anda dapat menggunakan ini untuk mengidentifikasi apakah pesan tersebut berasal dari pelanggan baru atau pelanggan yang kembali. | Ditentukan pengguna | \$1. Atribut. AppleBusinessChatCustomerId |
| AppleBusinessChatIntent | Anda dapat menentukan maksud atau tujuan obrolan. Parameter ini disertakan dalam URL yang memulai sesi obrolan di Pesan saat pelanggan memilih tombol **Obrolan Bisnis**. | Ditentukan pengguna | \$1. Atribut. AppleBusinessChatIntent |
| AppleBusinessChatGroup | Anda mendefinisikan kelompok yang menunjuk departemen atau individu yang paling memenuhi syarat untuk menangani pertanyaan atau masalah khusus pelanggan. Parameter ini disertakan dalam URL yang memulai sesi obrolan di Pesan saat pelanggan memilih tombol **Obrolan Bisnis**. | Ditentukan pengguna | \$1. Atribut. AppleBusinessChatGroup |
| AppleBusinessChatLocale | Mendefinisikan preferensi bahasa dan AWS Wilayah yang ingin dilihat pengguna di antarmuka pengguna mereka. Ini terdiri dari pengenal bahasa (ISO 639-1) dan pengenal Wilayah (ISO 3166). Misalnya, **en\$1US**. | Ditentukan pengguna | \$1. Atribut. AppleBusinessChatLocale |
| AppleFormCapability | Apakah perangkat pelanggan mendukung formulir. Jika benar, perangkat pelanggan didukung. Jika salah, perangkat tidak didukung. | Ditentukan pengguna | \$1. Atribut. AppleFormCapability |
| AppleAuthenticationCapability | Apakah perangkat pelanggan mendukung Authentication (OAuth2). Jika benar, perangkat pelanggan didukung. Jika salah, perangkat mereka tidak didukung. | Ditentukan pengguna | \$1. Atribut. AppleAuthenticationCapability |
| AppleTimePickerCapability | Apakah perangkat pelanggan mendukung pemilih waktu. Jika benar, perangkat pelanggan didukung. Jika salah, perangkat tidak didukung. | Ditentukan pengguna | \$1. Atribut. AppleTimePickerCapability |
| AppleListPickerCapability | Apakah perangkat pelanggan mendukung pemilih daftar. Jika benar, perangkat pelanggan didukung. Jika salah, perangkat tidak didukung. | Ditentukan pengguna | \$1. Atribut. AppleListPickerCapability |
| AppleQuickReplyCapability | Apakah perangkat pelanggan mendukung balasan cepat. Jika benar, perangkat pelanggan didukung. Jika salah, perangkat tidak didukung. | Ditentukan pengguna | \$1. Atribut. AppleQuickReplyCapability |
## Atribut Profil Pelanggan
Tabel berikut mencantumkan atribut yang digunakan dengan Profil Amazon Connect Pelanggan.
Ukuran total atribut kontak Profil Pelanggan dibatasi hingga 14.000 (56 atribut dengan asumsi ukuran maksimal 255 masing-masing) karakter untuk seluruh alur. Ini mencakup semua nilai yang dipertahankan sebagai bidang **Respons** di blok Profil Pelanggan selama alur.
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| profileSearchKey | Nama atribut yang ingin Anda gunakan untuk mencari profil. | Ditentukan pengguna | Tidak berlaku |
| profileSearchValue | Nilai kunci yang ingin Anda cari, seperti nama pelanggan atau nomor akun. | Ditentukan pengguna | Tidak berlaku |
| ID Profil | Pengidentifikasi unik dari profil pelanggan. | text | \$1. Pelanggan. ProfileId |
| Profil ARN | ARN dari profil pelanggan. | text | \$1.customer.profilearn |
| Nama Depan | Nama depan pelanggan. | text | \$1. Pelanggan. FirstName |
| Nama Tengah | Nama tengah pelanggan. | text | \$1. Pelanggan. MiddleName |
| Nama Belakang | Nama belakang pelanggan. | text | \$1. Pelanggan. LastName |
| Nomor Rekening | Nomor rekening unik yang telah Anda berikan kepada pelanggan. | text | \$1. Pelanggan. AccountNumber |
| Alamat Email | Alamat email pelanggan, yang belum ditentukan sebagai alamat pribadi atau bisnis. | text | \$1. Pelanggan. EmailAddress |
| Nomor Telepon | Nomor telepon pelanggan, yang belum ditentukan sebagai nomor ponsel, rumah, atau bisnis. | text | \$1. Pelanggan. PhoneNumber |
| Informasi tambahan | Setiap informasi tambahan yang relevan dengan profil pelanggan. | text | \$1. Pelanggan. AdditionalInformation |
| Tipe Pesta | Jenis pesta pelanggan. | text | \$1. Pelanggan. PartyType |
| Nama Bisnis | Nama bisnis pelanggan. | text | \$1. Pelanggan. BusinessName |
| Tanggal Lahir | Tanggal lahir pelanggan. | text | \$1. Pelanggan. BirthDate |
| Gender | Jenis kelamin pelanggan. | text | \$1. Customer.Gender |
| Nomor Ponsel | Nomor ponsel pelanggan. | text | \$1. Pelanggan. MobilePhoneNumber |
| Nomor Telepon Rumah | Nomor telepon rumah pelanggan. | text | \$1. Pelanggan. HomePhoneNumber |
| Nomor Telepon Bisnis | Nomor telepon bisnis pelanggan. | text | \$1. Pelanggan. BusinessPhoneNumber |
| Alamat Email Bisnis | Alamat email bisnis pelanggan. | text | \$1. Pelanggan. BusinessEmailAddress |
| Alamat | Alamat umum yang terkait dengan pelanggan yang tidak mengirim surat, pengiriman, atau penagihan. | text | \$1.Customer.Alamat1 \$1.Customer.Alamat2 \$1.Customer.Alamat3 \$1.Customer.Alamat4 \$1. Customer.City \$1. Pelanggan. Kabupaten \$1.Customer.Country \$1. Pelanggan. PostalCode \$1. Customer.Province \$1. Customer.State |
| Alamat Pengiriman | Alamat pengiriman pelanggan. | text | \$1. Pelanggan. ShippingAddress1 \$1. Pelanggan. ShippingAddress2 \$1. Pelanggan. ShippingAddress3 \$1. Pelanggan. ShippingAddress4 \$1. Pelanggan. ShippingCity \$1. Pelanggan. ShippingCounty \$1. Pelanggan. ShippingCountry \$1. Pelanggan. ShippingPostalCode \$1. Pelanggan. ShippingProvince \$1. Pelanggan. ShippingState |
| Alamat Surat | Alamat surat pelanggan. | text | \$1. Pelanggan. MailingAddress1 \$1. Pelanggan. MailingAddress2 \$1. Pelanggan. MailingAddress3 \$1. Pelanggan. MailingAddress4 \$1. Pelanggan. MailingCity \$1. Pelanggan. MailingCounty \$1. Pelanggan. MailingCountry \$1. Pelanggan. MailingPostalCode \$1. Pelanggan. MailingProvince \$1. Pelanggan. MailingState |
| Alamat Penagihan | Alamat penagihan pelanggan | text | \$1. Pelanggan. BillingAddress1 \$1. Pelanggan. BillingAddress2 \$1. Pelanggan. BillingAddress3 \$1. Pelanggan. BillingAddress4 \$1. Pelanggan. BillingCity \$1. Pelanggan. BillingCounty \$1. Pelanggan. BillingCountry \$1. Pelanggan. BillingPostalCode \$1. Pelanggan. BillingProvince \$1. Pelanggan. BillingState |
| Atribut | Pasangan nilai kunci dari atribut profil pelanggan. | text | \$1.customer.Attributes.x |
| Atribut Objek | Sebuah pasangan nilai kunci dari atribut objek kustom dari profil pelanggan. | text | \$1. Pelanggan. ObjectAttributes.y |
| Atribut yang Dihitung | Pasangan nilai kunci dari atribut yang dihitung dari profil pelanggan. | text | \$1. Pelanggan. CalculatedAttributes.z |
| Aset | Aset standar pelanggan. | text | \$1.Customer.Asset. AssetId \$1.Customer.Asset. ProfileId \$1.Customer.Asset. AssetName \$1.Customer.Asset. SerialNumber \$1.Customer.Asset. ModelNumber \$1.Customer.Asset. ModelName \$1.customer.asset.productsku \$1.Customer.Asset. PurchaseDate \$1.Customer.Asset. UsageEndDate \$1.Customer.Asset.Status \$1.Customer.Asset.Price \$1. Customer.Asset.Quantity \$1.Customer.Asset.Description \$1.Customer.Asset. AdditionalInformation \$1.Customer.Asset. DataSource \$1.customer.asset.attributes.x |
| Order | Pesanan standar pelanggan. | text | \$1.Customer.Order. OrderId \$1.Customer.Order. ProfileId \$1.Customer.Order. CustomerEmail \$1.Customer.Order. CustomerPhone \$1.Customer.Order. CreatedDate \$1.Customer.Order. UpdatedDate \$1.Customer.Order. ProcessedDate \$1.Customer.Order. ClosedDate \$1.Customer.Order. CancelledDate \$1.Customer.Order. CancelReason \$1.Customer.Order.Name \$1.Customer.Order. AdditionalInformation \$1. Customer.Order.Gateway \$1.Customer.Order.Status \$1.Customer.Order. StatusCode \$1.Customer.Order. StatusUrl \$1.Customer.Order. CreditCardNumber \$1.Customer.Order. CreditCardCompany \$1.Customer.Order. FulfillmentStatus \$1.Customer.Order. TotalPrice \$1.Customer.Order. TotalTax \$1.Customer.Order. TotalDiscounts \$1.Customer.Order. TotalItemsPrice \$1.Customer.Order. TotalShippingPrice \$1.Customer.Order. TotalTipReceived \$1.Customer.Order.Currency \$1.Customer.Order. TotalWeight \$1.Customer.Order. BillingName \$1.Customer.Order. BillingAddress1 \$1.Customer.Order. BillingAddress2 \$1.Customer.Order. BillingAddress3 \$1.Customer.Order. BillingAddress4 \$1.Customer.Order. BillingCity \$1.Customer.Order. BillingCounty \$1.Customer.Order. BillingCountry \$1.Customer.Order. BillingPostalCode \$1.Customer.Order. BillingProvince \$1.Customer.Order. BillingState \$1.Customer.Order. ShippingName \$1.Customer.Order. ShippingAddress1 \$1.Customer.Order. ShippingAddress2 \$1.Customer.Order. ShippingAddress3 \$1.Customer.Order. ShippingAddress4 \$1.Customer.Order. ShippingCity \$1.Customer.Order. ShippingCounty \$1.Customer.Order. ShippingCountry \$1.Customer.Order. ShippingPostalCode \$1.Customer.Order. ShippingProvince \$1.Customer.Order. ShippingState \$1.customer.order.attributes.y |
| Kasus | Kasus standar pelanggan. | text | \$1. Customer.Case. CaseId \$1. Customer.Case. ProfileId \$1. Customer.Case.Title \$1.Customer.Case.Summary \$1.Customer.Case.Status \$1. Customer.Case.Reason \$1. Customer.Case. CreatedBy \$1. Customer.Case. CreatedDate \$1. Customer.Case. UpdatedDate \$1. Customer.Case. ClosedDate \$1. Customer.Case. AdditionalInformation \$1. Customer.Case. DataSource \$1.customer.case.attributes.z |
## Atribut kampanye keluar
Anda dapat menggunakan data dalam daftar Amazon Pinpoint [segmen](https://docs.aws.amazon.com/pinpoint/latest/userguide/segments-building.html) untuk menyesuaikan pengalaman dalam Amazon Connect alur. Untuk mereferensikan data dalam daftar segmen, gunakan **\$1.Attributes. *attribute coming in the segment***. Misalnya, jika Anda memiliki segmen dengan dua kolom “Atribut. FirstName” dan “Atribut. ItemDescription, Anda akan menyebutnya sebagai:
+ \$1. Atribut. FirstName
+ \$1. Atribut. ItemDescription
Untuk informasi selengkapnya, lihat [Menambahkan konten yang dipersonalisasi ke templat pesan](https://docs.aws.amazon.com/pinpoint/latest/userguide/message-templates-personalizing.html) di *Panduan Pengguna Amazon Pinpoint*.
## Atribut Connect AI agents
Atribut berikut menyimpan ARN sesi Connect AI agent. Kasus penggunaan untuk atribut ini adalah ketika Anda ingin melakukan tindakan API apa pun, seperti [UpdateSession[UpdateSessionData](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_UpdateSessionData.html)](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_UpdateSession.html). Anda dapat meneruskan atribut sebagai input untuk [Fungsi AWS Lambda ](invoke-lambda-function-block.md) memblokir. Dan Lambda dapat memanggil mereka APIs terhadap sesi input ARN.
| Atribut | Deskripsi | Tipe | JSONPath Referensi |
| --- | --- | --- | --- |
| SessionArn | Nama Sumber Daya Amazon (ARN) dari sesi agen Connect AI. | Aliran | \$1. Kebijaksanaan. SessionArn |
# Cara mereferensikan atribut kontak di Amazon Connect
Cara Anda mereferensikan atribut kontak tergantung pada bagaimana mereka dibuat dan bagaimana Anda mengaksesnya.
+ Untuk sintaks JSON untuk setiap atribut, lihat. [Daftar atribut kontak yang tersedia di Amazon Connect dan JSONPath referensinya](connect-attrib-list.md)
+ Untuk referensi atribut yang berisi karakter khusus dalam namanya, seperti spasi, tempatkan tanda kurung dan tanda kutip tunggal di sekitar nama atribut. Sebagai contoh: ` $.Attributes.['user attribute name']`.
+ Untuk mereferensikan atribut di namespace yang sama, seperti atribut sistem, Anda menggunakan nama atribut, atau nama yang Anda tentukan sebagai kunci **Tujuan**.
+ Untuk mereferensikan nilai dalam namespace yang berbeda, seperti mereferensikan atribut eksternal, Anda menentukan JSONPath sintaks ke atribut.
+ Untuk menggunakan atribut kontak untuk mengakses sumber daya lain, tetapkan atribut yang ditentukan pengguna di alur Anda dan gunakan Nama Sumber Daya Amazon (ARN) sumber daya yang ingin Anda akses sebagai nilai untuk atribut.
## Contoh Lambda
+ Untuk mereferensikan nama pelanggan dari pencarian fungsi Lambda, gunakan \$1.External. AttributeKey, mengganti AttributeKey dengan kunci (atau nama) atribut yang dikembalikan dari fungsi Lambda.
+ Untuk menggunakan prompt Amazon Connect dalam fungsi Lambda, setel atribut yang ditentukan pengguna ke ARN untuk prompt, lalu akses atribut tersebut dari fungsi Lambda.
## Contoh Amazon Lex
+ Untuk mereferensikan atribut dari bot Amazon Lex, Anda menggunakan format \$1.Lex. dan kemudian sertakan bagian bot Amazon Lex untuk referensi, seperti \$1. Lex. IntentName.
+ Untuk mereferensikan input pelanggan ke slot bot Amazon Lex, gunakan \$1.Lex.Slots. *SlotName*, mengganti *SlotName* dengan nama slot di bot.
## Tetapkan contoh atribut kontak
Gunakan [Tetapkan atribut kontak](set-contact-attributes.md) blok untuk menetapkan nilai yang kemudian direferensikan dalam aliran. Misalnya, buat salam yang dipersonalisasi untuk pelanggan yang diarahkan ke antrian berdasarkan jenis akun pelanggan. Anda juga dapat menentukan atribut untuk nama perusahaan atau lini bisnis untuk dimasukkan dalam teks ke string ucapan yang dikatakan kepada pelanggan. [Tetapkan atribut kontak](set-contact-attributes.md)Blok ini berguna untuk menyalin atribut yang diambil dari sumber eksternal ke atribut yang ditentukan pengguna.
**Untuk mengatur atribut kontak dengan [Tetapkan atribut kontak](set-contact-attributes.md) blok**
1. Di Amazon Connect, pilih **Routing**, **alur Kontak**.
1. Pilih alur yang ada, atau buat yang baru.
1. Tambahkan [Tetapkan atribut kontak](set-contact-attributes.md) blok.
1. Edit [Tetapkan atribut kontak](set-contact-attributes.md) blok, dan pilih **Gunakan teks**.
1. Untuk **kunci Tujuan**, berikan nama untuk atribut, seperti *Perusahaan*. Ini adalah nilai yang Anda gunakan untuk bidang **Atribut** saat menggunakan atau mereferensikan atribut di blok lain. Untuk **Nilai**, gunakan nama perusahaan Anda.
Anda juga dapat memilih untuk menggunakan atribut yang ada sebagai dasar untuk membuat atribut baru.
# Menampilkan informasi kontak ke agen di Contact Control Panel (CCP)
Anda dapat menggunakan atribut kontak untuk menangkap informasi tentang kontak dan kemudian menyajikannya kepada agen melalui Contact Control Panel (CCP). Misalnya, Anda mungkin ingin melakukan ini untuk menyesuaikan pengalaman agen saat menggunakan CCP yang terintegrasi dengan aplikasi manajemen hubungan pelanggan (CRM).
Gunakan juga saat mengintegrasikan Amazon Connect dengan aplikasi khusus menggunakan Amazon Connect Streams API atau Amazon Connect API. Anda dapat menggunakan semua atribut yang ditentukan pengguna, selain nomor pelanggan dan nomor panggilan, di CCP menggunakan library Amazon Connect Streams. JavaScript Untuk informasi selengkapnya, lihat [Amazon Connect Streams API](https://github.com/aws/amazon-connect-streams) atau Amazon Connect API.
Saat menggunakan Amazon Connect Streams API, Anda dapat mengakses atribut yang ditentukan pengguna dengan memanggil Contact.getAttributes (). Anda dapat mengakses titik akhir menggunakan Contact.getConnections (), di mana koneksi memiliki pemanggilan GetEndPoint () di dalamnya.
Untuk mengakses atribut langsung dari fungsi Lambda, gunakan \$1.External. AttributeName. Jika atribut disimpan ke atribut yang ditentukan pengguna dari [Tetapkan atribut kontak](set-contact-attributes.md) blok, gunakan \$1.Attributes. AttributeName.
Misalnya, disertakan dengan instans Amazon Connect Anda, ada alur bernama “Catatan sampel untuk screenpop.” Dalam alur ini, [Tetapkan atribut kontak](set-contact-attributes.md) blok digunakan untuk membuat atribut dari string teks. Teks, sebagai atribut, dapat diteruskan ke PKC untuk menampilkan catatan ke agen.
# Menggunakan atribut di Amazon Connect untuk merutekan berdasarkan jumlah kontak dalam antrian
Amazon Connect menyertakan atribut antrian yang dapat membantu Anda menentukan kondisi perutean dalam alur berdasarkan metrik real-time tentang antrian dan agen di pusat kontak Anda. Misalnya, berikut adalah beberapa skenario penggunaan umum:
+ Periksa jumlah kontak atau agen yang tersedia dalam antrian, dan berapa lama kontak tertua berada dalam antrian, lalu rute yang sesuai.
+ Untuk merutekan ke antrian dengan kontak paling sedikit di dalamnya:
1. Dapatkan metrik untuk beberapa antrian.
1. Gunakan [Tetapkan atribut kontak](set-contact-attributes.md) blok untuk menyimpan atribut metrik untuk setiap antrian.
1. bandingkan atribut metrik antrian menggunakan [Periksa atribut kontak](check-contact-attributes.md) blok, dan rute kontak ke antrian dengan panggilan paling sedikit di dalamnya, atau ke panggilan balik jika semua antrian sibuk.
# Menggunakan blok Periksa atribut kontak untuk merutekan kontak ke antrian
1. Di Amazon Connect, pilih **Routing**, **alur Kontak**.
1. Buka alur yang ada atau buat yang baru.
1. Secara opsional, di bawah **Interact**, tambahkan blok **prompt Play** ke desainer untuk memainkan salam kepada pelanggan Anda. Tambahkan konektor antara blok **Entry point** dan blok **prompt Play**.
1. Di bawah **Set**, seret blok **metrik antrian Dapatkan** ke desainer, dan hubungkan cabang **Oke** dari blok **prompt Play** ke sana.
1. Pilih judul blok **Get queue metrics** untuk membuka properti blok. Secara default, blok mengambil metrik untuk antrian kerja saat ini. **Untuk mengambil metrik untuk antrian yang berbeda, pilih Setel antrian.**
1. **Pilih **Pilih antrian**, lalu pilih antrian untuk mengambil metrik dari drop-down, lalu pilih Simpan.**
Anda juga dapat menentukan antrian untuk mengambil metrik untuk menggunakan atribut kontak.
1. Di bawah **Periksa**, seret blok **atribut kontak Periksa** ke desainer.
1. Pilih judul blok untuk menampilkan pengaturan blok. Kemudian, di bawah **Atribut untuk memeriksa**, pilih **Metrik antrian** di menu tarik-turun **Jenis**.
1. Di bawah **Atribut**, pilih **Kontak dalam antrian**.
1. Untuk menggunakan kondisi untuk merutekan kontak, pilih **Tambahkan kondisi lain**.
Secara default, blok **Periksa atribut kontak** mencakup satu kondisi, **Tidak cocok**. Cabang **No match** diikuti ketika tidak ada kecocokan untuk salah satu kondisi yang Anda tentukan di blok.
1. Di bawah **Kondisi untuk memeriksa**, pilih **Kurang dari** sebagai operator untuk kondisi di menu tarik-turun, lalu di bidang nilai masukkan 5.
1. Pilih **Tambahkan kondisi lain**, lalu pilih **Lebih besar atau sama** dari menu tarik-turun, dan masukkan 5 di bidang nilai.
1. Pilih **Simpan**.
Anda sekarang melihat dua cabang keluaran baru untuk blok **Periksa atribut kontak**.
Anda sekarang dapat menambahkan blok tambahan ke aliran untuk merutekan kontak sesuai keinginan. Misalnya, sambungkan cabang < 5 ke blok **Transfer ke antrian** untuk mentransfer panggilan ke antrian ketika ada kurang dari lima panggilan saat ini dalam antrian. Hubungkan cabang> 5 ke blok nomor panggilan balik Set pelanggan dan kemudian transfer panggilan ke antrian panggilan balik menggunakan blok **Transfer ke antrian** sehingga pelanggan tidak harus menunda.
## Rutekan kontak berdasarkan metrik antrian
Banyak pusat kontak merutekan pelanggan berdasarkan jumlah kontak yang menunggu dalam antrian. Topik ini menjelaskan cara mengonfigurasi aliran yang terlihat mirip dengan gambar berikut. Ini menunjukkan tiga blok aliran berikut yang dihubungkan oleh cabang Sukses: **Tetapkan atribut kontak**, **Dapatkan metrik antrian**, dan **Periksa atribut kontak**.
![\[Perancang aliran dengan tiga blok aliran di atasnya.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/get-metrics-specify-set-contact-attributes.png)
1. Tambahkan [Tetapkan atribut kontak](set-contact-attributes.md) blok ke alur Anda.
1. Di[Tetapkan atribut kontak](set-contact-attributes.md), tentukan salurannya. Jika Anda menyetel saluran secara dinamis menggunakan teks, untuk nilai atribut masukkan **Suara** atau **Obrolan**, seperti yang ditunjukkan pada gambar berikut. Nilai ini tidak peka huruf besar/kecil.
![\[Halaman properti dari blok Atribut kontak Set. Namespace diatur ke ditentukan Pengguna, Nilai diatur ke obrolan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/get-metrics-properties2.png)
1. Tambahkan [Dapatkan metrik](get-queue-metrics.md) blok ke alur Anda.
Di blok metrik Get queue, atribut dinamis hanya dapat menampilkan metrik untuk satu saluran
## Tambahkan blok Periksa atribut kontak setelah blok metrik Get queue
Setelah blok **metrik antrian Dapatkan**, tambahkan [Periksa atribut kontak](check-contact-attributes.md) blok ke cabang berdasarkan metrik yang dikembalikan. Gunakan langkah-langkah berikut:
1. Setelah **Dapatkan metrik antrian**, tambahkan blok **Periksa atribut kontak**.
1. Di blok **Periksa atribut kontak**, setel **Atribut untuk memeriksa** **metrik Antrian**.
1. Di kotak tarik-turun **Atribut untuk** dicentang, Anda akan melihat bahwa metrik antrian berikut dikembalikan oleh blok metrik antrian **Dapatkan**. Pilih metrik yang ingin Anda gunakan untuk keputusan perutean.
![\[Halaman properti blok Periksa atribut kontak, Namespace diatur ke metrik Antrian.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/get-metrics-block-returned-metrics.png)
1. Pilih **Tambahkan kondisi** untuk memasukkan perbandingan untuk keputusan perutean Anda. Gambar berikut menunjukkan blok yang dikonfigurasi untuk memeriksa apakah kontak dalam antrian lebih besar dari 5.
![\[Bagian Atribut untuk memeriksa, bagian Kondisi untuk memeriksa.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/get-metrics-check-attributes-block.png)
# Personalisasi pengalaman kontak berdasarkan cara mereka menghubungi pusat kontak Anda
Anda dapat mempersonalisasi pengalaman pelanggan berdasarkan saluran yang mereka gunakan untuk menghubungi Anda. Inilah yang Anda lakukan:
1. Tambahkan blok **Periksa atribut kontak** ke awal alur Anda.
1. Konfigurasikan blok seperti yang ditunjukkan pada gambar berikut. Di bagian **Atribut untuk diperiksa**, atur **Type** to **System**, atur **Atribut** ke **Channel**. Di bagian **Conditions to check**, atur ke **Equals CHAT.**
![\[Bagian Atribut untuk dicentang diatur ke Saluran, bagian Ketentuan untuk memeriksa diatur ke obrolan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/channel-attribute.png)
1. Gambar berikut dari blok atribut Periksa kontak yang dikonfigurasi menunjukkan dua cabang: **CHAT** dan **No Match**. Jika pelanggan menghubungi Anda melalui obrolan, tentukan apa yang harus terjadi selanjutnya. Jika pelanggan menghubungi Anda melalui panggilan (No Match), tentukan langkah selanjutnya dalam alur.
![\[Blok atribut kontak Periksa yang dikonfigurasi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/channel-attribute-flow.png)
# Gunakan Amazon Lex dan nilai atribut
Saat Anda mereferensikan atribut di blok **input Dapatkan pelanggan**, dan memilih Amazon Lex sebagai metode pengumpulan input, nilai atribut diambil dan disimpan dari output dari interaksi pelanggan dengan bot Amazon Lex. Anda dapat menggunakan atribut untuk setiap maksud atau slot yang digunakan di bot Amazon Lex, serta atribut sesi yang terkait dengan bot. Cabang keluaran ditambahkan ke blok untuk setiap maksud yang Anda sertakan. Ketika pelanggan memilih intent saat berinteraksi dengan bot, cabang yang terkait dengan intent tersebut diikuti dalam alur.
Untuk daftar atribut Amazon Lex yang dapat Anda gunakan dan terima kembali dari bot Lex, lihat[Atribut kontak Amazon Lex](connect-attrib-list.md#attribs-lex-table).
# Menggunakan bot Amazon Lex untuk mendapatkan masukan pelanggan
1. Buka yang sudah ada atau buat alur baru.
1. Di bawah **Interact**, seret blok **input Dapatkan pelanggan** ke desainer.
1. Pilih judul blok untuk menampilkan pengaturan blok, lalu pilih **Teks ke ucapan (Ad hoc)**.
1. Pilih **Masukkan teks**, lalu masukkan teks di bidang **Enter text to be spoken** yang digunakan sebagai pesan atau salam kepada pelanggan Anda. Misalnya, “Terima kasih telah menelepon” diikuti dengan permintaan untuk memasukkan informasi untuk memenuhi maksud yang Anda tetapkan di bot Amazon Lex Anda.
1. Pilih tab **Amazon Lex**, lalu dari menu tarik-turun, pilih bot Amazon Lex yang akan digunakan untuk mendapatkan masukan pelanggan.
1. Secara default, bidang **Alias** diisi dengan \$1LATEST. Untuk menggunakan alias bot yang berbeda, masukkan nilai alias yang akan digunakan.
**penting**
Dalam lingkungan produksi, selalu gunakan alias yang berbeda dari **TestBotAlias**untuk Amazon Lex dan **\$1LATEST** untuk Amazon Lex classic. **TestBotAlias**dan **\$1LATEST** mendukung sejumlah panggilan bersamaan ke bot Amazon Lex. Untuk informasi selengkapnya, lihat [Kuota runtime atau Service Quotas](https://docs.aws.amazon.com/lexv2/latest/dg/quotas.html#quotas-service) [Runtime (Amazon Lex](https://docs.aws.amazon.com/lex/latest/dg/gl-limits.html#gl-limits-runtime) Classic).
1. Secara opsional, untuk meneruskan atribut ke Amazon Lex untuk digunakan sebagai atribut sesi, pilih **Tambahkan atribut**. Tentukan nilai yang akan diteruskan menggunakan teks atau atribut.
1. Untuk membuat cabang dari blok berdasarkan maksud pelanggan, pilih **Tambahkan maksud**, lalu masukkan nama intent persis sama dengan nama maksud di bot Anda.
1. Pilih **Simpan**.
# Gunakan atribut intent alternatif di Amazon Lex
Biasanya Anda mengonfigurasi alur ke cabang pada maksud Lex yang menang. Namun, dalam beberapa situasi, Anda mungkin ingin bercabang pada maksud alternatif. Artinya, apa yang mungkin dimaksud pelanggan.
Gambar berikut menunjukkan halaman **Properti** dari blok **Periksa atribut kontak**. Hal ini dikonfigurasi untuk memeriksa atribut Lex.
![\[Halaman properti blok Periksa atribut kontak.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/check-contact-attributes-alternate-intents.png)
1. **Nama maksud adalah nama** dari maksud alternatif dalam Lex. Ini peka huruf besar/kecil dan harus sama persis dengan apa yang ada di Lex.
1. **Atribut Intent** adalah apa yang akan diperiksa Amazon Connect. Dalam contoh ini, itu akan memeriksa **Skor Keyakinan Maksud**.
1. **Ketentuan untuk memeriksa**: Jika Lex yakin 70%, pelanggan berarti maksud alternatif alih-alih niat menang, cabang.
# Bagaimana blok aliran menggunakan atribut sesi Amazon Lex
Ketika pelanggan memulai percakapan dengan bot Anda, Amazon Lex membuat *sesi*. Dengan *atribut sesi*, juga dikenal sebagai *atribut Lex*, Anda dapat meneruskan informasi antara bot dan Amazon Connect selama sesi berlangsung. Untuk daftar atribut Amazon Lex yang dapat Anda gunakan, lihat[Atribut kontak Amazon Lex](connect-attrib-list.md#attribs-lex-table).
## Siklus hidup atribut sesi
Setiap percakapan berisi satu set atribut sesi. Dalam kasus di mana AWS Lambda fungsi dipanggil untuk melakukan beberapa pemrosesan, Amazon Lex menjalankan atribut dalam urutan berikut:
+ Default layanan: Atribut ini hanya digunakan jika tidak ada atribut yang ditentukan.
+ Atribut sesi yang disediakan oleh Amazon Connect: Atribut ini ditentukan dalam [Dapatkan masukan pelanggan](get-customer-input.md) blok.
+ Atribut sesi yang disediakan oleh Lambda menimpa semua yang sebelumnya: Ketika suatu AWS Lambda fungsi dipanggil dan melakukan beberapa pemrosesan, ia akan mengganti atribut sesi apa pun yang disetel di blok. [Dapatkan masukan pelanggan](get-customer-input.md)
Katakanlah seorang pelanggan mengatakan bahwa mereka menginginkan **mobil**. Itu adalah atribut sesi pertama yang melalui pemrosesan. Ketika ditanya jenis mobil apa, mereka mengatakan **mobil mewah**. Ucapan kedua ini mengesampingkan pemrosesan Lambda apa pun yang terjadi pada ucapan pertama.
Untuk contoh cara membuat fungsi Lambda yang memproses atribut sesi, lihat [Langkah 1: Membuat Fungsi Lambda](https://docs.aws.amazon.com/lex/latest/dg/gs2-prepare.html) di Panduan Pengembang *Amazon* Lex. Untuk informasi tentang Amazon Lex V2, lihat [Menyetel atribut sesi](https://docs.aws.amazon.com/lexv2/latest/dg/context-mgmt-session-attribs.html).
Untuk struktur data peristiwa yang disediakan Amazon Lex ke fungsi Lambda, lihat [Peristiwa Input Fungsi Lambda dan Format Respons](https://docs.aws.amazon.com/lex/latest/dg/lambda-input-response-format.html) di Panduan Pengembang *Amazon* Lex. Untuk informasi tentang Amazon Lex V2, lihat [Menafsirkan format peristiwa input](https://docs.aws.amazon.com/lexv2/latest/dg/lambda-input-format.html).
## Blok aliran yang mendukung atribut sesi Lex
Anda dapat menggunakan atribut sesi Lex di blok aliran berikut ketika bot Lex dipanggil:
+ [Ubah prioritas/usia perutean](change-routing-priority.md)
+ [Periksa atribut kontak](check-contact-attributes.md)
+ [Dapatkan masukan pelanggan](get-customer-input.md)
+ [Fungsi AWS Lambda ](invoke-lambda-function-block.md)
+ [Loop](loop.md)
+ [Tetapkan nomor panggilan balik](set-callback-number.md)
+ [Tetapkan atribut kontak](set-contact-attributes.md)
+ [Mengatur aliran antrian pelanggan](set-customer-queue-flow.md)
+ [Atur aliran pemutusan](set-disconnect-flow.md)
+ [Atur aliran tahan](set-hold-flow.md)
+ [Mengatur perilaku logging](set-logging-behavior.md)
+ [Atur aliran bisikan](set-whisper-flow.md)
+ [Atur antrian kerja](set-working-queue.md)
+ [Transfer ke aliran](transfer-to-flow.md)
+ [Transfer ke nomor telepon](transfer-to-phone-number.md)
+ [Tunggu](wait.md)
### Informasi selengkapnya
Untuk informasi selengkapnya tentang menggunakan atribut sesi Amazon Lex, lihat [Mengelola Konteks Percakapan](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html) di *Panduan Pengembang Amazon Amazon Lex V1*.
# Cara menggunakan bot Amazon Lex yang sama untuk suara dan obrolan
Anda dapat menggunakan bot yang sama untuk suara dan obrolan. Namun, Anda mungkin ingin bot merespons secara berbeda berdasarkan saluran. Misalnya, Anda ingin mengembalikan SSML untuk suara sehingga nomor dibaca sebagai nomor telepon, tetapi Anda ingin mengembalikan teks normal ke obrolan. Anda dapat melakukan ini dengan meneruskan atribut **Channel**.
1. Di blok **masukan Dapatkan pelanggan**, pilih tab **Amazon Lex**.
1. Di bawah **atribut Session**, pilih **Tambahkan atribut**. Di kotak **kunci Tujuan**, masukkan **PhoneNumber**. Pilih **Set secara dinamis**. Di kotak **Namespace**, pilih **Sistem**, dan di kotak **Nilai**, pilih **Nomor Pelanggan**, seperti yang ditunjukkan pada gambar berikut.
![\[Halaman properti dari blok masukan Dapatkan pelanggan, bagian atribut Sesi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/session_attributes_customer_number.png)
1. Pilih **Tambahkan atribut** lagi.
1. Pilih **Set secara dinamis**. Di kotak **kunci Tujuan**, masukkan **CallType**. Di kotak **Namespace**, pilih **Sistem**, dan di kotak **Nilai** pilih **Saluran**, seperti yang ditunjukkan pada gambar berikut.
![\[Bagian Set dinamis.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/session_attributes_call_type_channel.png)
1. Pilih **Simpan**.
1. Dalam fungsi Lambda Anda, Anda dapat mengakses nilai ini di `SessionAttributes` bidang di acara yang masuk.
# Menyimpan nilai dari fungsi Lambda sebagai atribut kontak di Amazon Connect
Ambil data dari sistem yang digunakan organisasi Anda secara internal, seperti sistem pemesanan atau database lain dengan fungsi Lambda, dan simpan nilai sebagai atribut yang kemudian dapat direferensikan dalam alur.
Fungsi Lambda mengembalikan respons dari sistem internal Anda dalam bentuk pasangan kunci-nilai data. Anda dapat mereferensikan nilai yang dikembalikan di namespace Eksternal. Misalnya, `$.External.attributeName`. Untuk menggunakan atribut nanti dalam alur, Anda dapat menyalin pasangan nilai kunci ke atribut yang ditentukan pengguna dengan menggunakan blok Atribut kontak **Set**. Anda kemudian dapat menentukan logika untuk cabang kontak Anda berdasarkan nilai atribut dengan menggunakan blok **Periksa atribut kontak**. Atribut kontak apa pun yang diambil dari fungsi Lambda akan ditimpa saat Anda memanggil fungsi Lambda lainnya. Pastikan Anda menyimpan atribut eksternal jika Anda ingin mereferensikannya nanti dalam alur.
**Tip**
Untuk informasi tentang menjalankan fungsi Lambda dari alur, [Berikan Amazon Connect akses ke AWS Lambda fungsi Anda](connect-lambda-functions.md) lihat Topik juga menunjukkan cara menggunakan respons fungsi Lambda.
**Untuk menyimpan nilai eksternal dari fungsi Lambda sebagai atribut kontak**
1. Di Amazon Connect, pilih **Routing**, **alur Kontak**.
1. Pilih alur yang ada, atau buat yang baru.
1. Tambahkan [Fungsi AWS Lambda ](invoke-lambda-function-block.md) blok, lalu pilih judul blok untuk membuka pengaturan blok tersebut.
1. Tambahkan **Fungsi ARN** ke AWS Lambda fungsi Anda yang mengambil data pelanggan dari sistem internal Anda.
1. Setelah [Fungsi AWS Lambda ](invoke-lambda-function-block.md) blok, tambahkan blok **Atur atribut kontak** dan hubungkan cabang **Sukses** [Fungsi AWS Lambda ](invoke-lambda-function-block.md) blok ke sana.
1. Edit blok **Set atribut kontak**, dan pilih **Use atribut**.
1. Untuk **kunci Tujuan**, ketik nama yang akan digunakan sebagai referensi ke atribut, seperti CustomerName. Ini adalah nilai yang Anda gunakan di bidang **Atribut** di blok lain untuk mereferensikan atribut ini.
1. Untuk **Jenis**, pilih **Eksternal**.
1. Untuk **Atribut**, masukkan nama atribut yang dikembalikan dari fungsi Lambda. Nama atribut yang dikembalikan dari fungsi akan bervariasi tergantung pada sistem internal Anda dan fungsi yang Anda gunakan.
*Setelah blok ini dijalankan selama aliran, nilai disimpan sebagai atribut yang ditentukan pengguna dengan nama yang ditentukan oleh **kunci Destination**, dalam hal ini CustomerName.* Itu dapat diakses di blok apa pun yang menggunakan atribut dinamis.
Untuk membuat cabang alur berdasarkan nilai atribut eksternal, seperti nomor akun, gunakan blok **Periksa atribut kontak**, lalu tambahkan kondisi untuk membandingkan nilai atribut tersebut. Selanjutnya, cabang aliran berdasarkan kondisi.
****
1. Di blok **Periksa atribut kontak**, untuk **Atribut untuk memeriksa** lakukan salah satu hal berikut:
+ Pilih **Eksternal** untuk **Jenis**, lalu masukkan nama kunci yang dikembalikan dari fungsi Lambda di bidang **Atribut**.
**penting**
Atribut apa pun yang dikembalikan dari suatu AWS Lambda fungsi akan ditimpa saat Anda memanggil fungsi Lambda lainnya. Untuk mereferensikan atribut nanti dalam alur, simpan sebagai atribut yang ditentukan pengguna.
+ Pilih **User Defined** for the **Type**, dan di bidang **Atribut**, ketikkan nama yang Anda tentukan sebagai **kunci Tujuan** di blok **Set atribut kontak**.
1. Pilih **Tambahkan kondisi lain**.
1. Di bawah **Kondisi untuk memeriksa**, pilih operator untuk kondisi, lalu masukkan nilai untuk dibandingkan dengan nilai atribut. Blok membuat cabang untuk setiap perbandingan yang Anda masukkan, memungkinkan Anda merutekan kontak berdasarkan kondisi yang ditentukan. Jika tidak ada kondisi yang cocok, kontak akan mengambil cabang **No Match** dari blok.