Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Bidang cuplikan widget yang didukung di Amazon Connect yang dapat disesuaikan
Tabel berikut mencantumkan bidang cuplikan widget komunikasi yang dapat Anda sesuaikan. Contoh kode setelah tabel menunjukkan cara menggunakan bidang cuplikan.
| Bidang cuplikan | Tipe | Deskripsi | Dokumentasi tambahan |
| --- | --- | --- | --- |
| `snippetId` | String | Wajib, dibuat secara otomatis | T/A |
| `styles` | String | Wajib, dibuat secara otomatis | T/A |
| `supportedMessagingContentTypes` | Array | Wajib, dibuat secara otomatis | T/A |
| `customLaunchBehavior` | Objek | Sesuaikan cara situs web Anda merender dan meluncurkan ikon widget yang dihosting | [Sesuaikan perilaku peluncuran widget dan ikon tombol untuk situs web Anda yang dihosting di Amazon Connect](customize-widget-launch.md), kemudian dalam topik ini |
| `authenticate` | Fungsi | Fungsi callback untuk mengaktifkan keamanan JWT di situs web Anda | [Langkah 2: Tentukan domain situs web tempat Anda berharap untuk menampilkan widget komunikasi](add-chat-to-website.md#chat-widget-domains), sebelumnya di bagian ini. |
| `customerDisplayName` | Fungsi | Berikan nama tampilan pelanggan saat menginisialisasi kontak | [Berikan nama tampilan pelanggan saat obrolan Amazon Connect dimulai](pass-display-name-chat.md), nanti di bagian ini. |
| `customStyles` | Objek | Ganti gaya CSS default | [Meneruskan properti kustom untuk mengganti default di widget komunikasi di Amazon Connect](pass-custom-styles.md), nanti di bagian ini. |
| `chatDurationInMinutes` | Bilangan | Total durasi sesi obrolan yang baru dimulai | Default: 1500 - Min 60, Maks: 10080 |
| `enableLogs` | Boolean | Aktifkan log debugging | Bawaan: salah |
| `language` | String | Amazon Connect dapat melakukan terjemahan untuk kode bahasa format ISO-639 yang didukung. Untuk informasi lebih lanjut, lihat [https://en.wikipedia. org/wiki/List\$1of\$1ISO\$1639-1\$1kode](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes). Ini tidak akan menerjemahkan penggantian teks khusus dan konten pesan (baik dikirim maupun diterima). | Default: en\$1US. Didukung: 'cs\$1cz', 'da\$1dk', 'de\$1de', 'en\$1au', 'en\$1ca', 'en\$1gb', 'en\$1us', 'es\$1es', 'fi\$1fi', 'fr\$1fr', 'hu\$1hu', 'id\$1id', 'it\$1it', 'Ja\$1jp', 'Ko\$1kr', 'NL\$1nl', 'NN\$1no' 'PT\$1BR', 'PT\$1pt', 'Sk\$1SK', 'Sv\$1se', 'zh\$1cn', 'zh\$1tw' |
| `disableCSM` | Boolean | Nonaktifkan pelacakan metrik sisi klien dari widget komunikasi. | Bawaan: salah |
| `nonce` | String | Nilai jabat tangan antara iframe dan kebijakan csp situs web pelanggan. Contoh: pelanggan csp memungkinkan nilai 1234 nonce, iframe yang menarik skrip lain harus memiliki nilai 1234 nonce yang sama sehingga browser tahu itu adalah skrip tepercaya oleh situs induk iframe. | Default: tidak terdefinisi |
| `customizationObject` | Objek | Sesuaikan tata letak dan transkrip widget | Untuk informasi lebih lanjut, lihat[Kustomisasi tambahan untuk widget obrolan Amazon Connect](pass-customization-object.md), nanti di bagian ini. |
| `contactAttributes` | Objek | Teruskan atribut ke alur kontak langsung dari kode cuplikan, tanpa pengaturan JWT | Untuk informasi selengkapnya, lihat [Melewati atribut kontak saat obrolan diinisialisasi](https://docs.aws.amazon.com/connect/latest/adminguide/pass-contact-attributes-chat.html). |
| `customDisplayNames` | Objek | Ganti nama tampilan Sistem atau Bot dan konfigurasi logo yang disetel di situs web admin Amazon Connect. | Untuk informasi selengkapnya, lihat [Cara meneruskan nama dan logo tampilan sistem dan bot override untuk widget komunikasi](https://docs.aws.amazon.com/connect/latest/adminguide/pass-custom-styles.html#pass-override-system). |
| `contactMetadataHandler` | Fungsi | Fungsi callback untuk mengakses Contactid. Misalnya, tambahkan event listener untuk menangani skenario seperti memanggil StopContact fungsi dengan Contactid saat tab browser ditutup atau mempertahankan persistensi obrolan dengan Contactid sebelumnya. | |
| `registerCallback` | Objek | Hal ini memungkinkan untuk mengeksekusi callback untuk peristiwa siklus hidup yang terbuka. Untuk informasi selengkapnya, lihat [amazon-connect-chatjs](https://github.com/amazon-connect/amazon-connect-chatjs). | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/supported-snippet-fields.html) |
| `initialMessage` | String | Pesan untuk dikirim ke obrolan yang baru dibuat. Kendala Panjang: Minimal 1, Maksimum 1024. | Untuk memanggil bot Lex yang dikonfigurasi dalam alur kontak menggunakan pesan awal, ubah [blok aliran input Dapatkan pelanggan](get-customer-input.md) dengan memilih opsi **Inisialisasi bot dengan pesan**. Untuk informasi selengkapnya, lihat [Cara mengonfigurasi blok aliran masukan Dapatkan pelanggan](get-customer-input.md#get-customer-input-properties). |
| `authenticationParameters` | Objek | Hal ini memungkinkan blok [Otentikasi Pelanggan](authenticate-customer.md) aliran | Untuk informasi selengkapnya, lihat [Aktifkan otentikasi pelanggan](enable-connect-managed-auth.md). |
| `mockLexBotTyping` | Boolean | Aktifkan indikator pengetikan mengejek untuk pesan Lex Bot. | Bawaan: salah |
| `customStartChat` | Fungsi | Fungsi callback untuk memanggil Start Chat API dari backend Anda. | Untuk informasi selengkapnya, lihat [UI widget yang di-host dengan API Mulai Obrolan kustom](https://github.com/amazon-connect/amazon-connect-chat-interface#option-3-hosted-widget-ui-with-custom-start-chat-api) |
Contoh berikut menunjukkan cara menambahkan bidang cuplikan ke skrip HTML yang menambahkan widget obrolan ke situs web Anda.
```
(function(w, d, x, id) { /* ... */})(window, document,
'amazon_connect', 'widgetId');
amazon_connect('snippetId', 'snippetId');
amazon_connect('styles', /* ... */);
amazon_connect('registerCallback', {
// Custom event example
// WIDGET_FRAME_CLOSED
/**
* This event is triggered when user clicks on the chat widget close button,
* either widget close button was clicked when error in the chat session or normally by the user.
* This event can be used for webview use cases to go back to main app
*
* @param {string} status - The reason for widget closure
* - "error_chat": Indicates the user clicked on widget close button due to an error in the chat session
* - "close_chat": Indicates the user clicked on widget close button normally by the user
*/
'WIDGET_FRAME_CLOSED': (eventName, { status }) => {
// You can implement custom logic based on the status value(error_chat or close_chat)
if (status == "error_chat") {
// handle error chat
} else if (status == "close_chat") {
// handle close chat
}
},
// System event example
/**
* chatDetails: {
* contactId: string,
* participantId: string,
* participantToken: string,
* }
* data: {
* AbsoluteTime?: string,
* ContentType?: string,
* Type?: string,
* ParticipantId?: string,
* DisplayName?: string,
* ParticipantRole?: string,
* InitialContactId?: string
* }
*/
'PARTICIPANT_JOINED': (eventName, { chatDetails, data }) => {
alert(`${data.ParticipantRole} joined the chat.`);
},
'event_Name_3': callback(function),
'event_Name_4': callback(function),
// ...
});
amazon_connect('initialMessage', 'Your initial message string');
// ...
amazon_connect('snippetFieldHere', /* ... */);
```