Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Blok aliran di Amazon Connect: Prompt putar Topik ini mendefinisikan blok aliran untuk memutar permintaan audio, text-to-speech pesan, atau respons obrolan kepada pelanggan dan agen. ## Deskripsi Gunakan blok aliran ini untuk memutar prompt audio atau text-to-speech pesan, atau untuk mengirim respons obrolan. Anda dapat memutar prompt ke pelanggan (penelepon atau pelanggan menggunakan obrolan) dan agen. Untuk panggilan, Anda memiliki opsi berikut: + **Gunakan petunjuk yang direkam sebelumnya**: Amazon Connect menyediakan pustaka opsi siap pakai. + **Rekam petunjuk Anda sendiri**. Anda memiliki opsi berikut: + Gunakan perpustakaan Amazon Connect. Unggah rekaman Anda langsung dari situs web Amazon Connect admin. + Gunakan Amazon S3. Simpan prompt Anda di S3 dan akses secara dinamis selama panggilan. + **T ext-to-speech**. Berikan teks biasa atau SSML (Speech Synthesis Markup Language) agar diucapkan sebagai audio. Untuk obrolan, Anda memiliki opsi berikut: + **Teks hanya meminta**. Kirim pesan teks biasa ke pelanggan dan agen. Opsi audio, seperti permintaan yang direkam sebelumnya, tidak tersedia untuk obrolan. ## Gunakan kasus untuk blok ini Blok aliran ini dirancang untuk digunakan dalam skenario berikut: + Mainkan salam kepada pelanggan. Misalnya, “Selamat datang di jalur layanan pelanggan kami.” + Memberikan informasi yang diambil dari database kembali ke pelanggan atau agen. Misalnya, “Saldo akun Anda adalah \$1123,45.” + Putar audio yang direkam sebelumnya saat pelanggan dalam antrian atau ditahan. + Putar audio yang direkam sebelumnya dengan suara Anda sendiri dari ember S3 Anda. + Dalam aliran masuk, putar pesan audio atau pesan teks ke pelanggan dan agen secara bersamaan. ## Persyaratan untuk petunjuk + **Format yang didukung**: Amazon Connect mendukung file.wav untuk digunakan untuk prompt Anda. Anda harus menggunakan file.wav yang 8KHz, dan audio saluran mono dengan pengkodean U-Law. Jika tidak, prompt tidak akan diputar dengan benar. Anda dapat menggunakan alat pihak ketiga yang tersedia untuk umum untuk mengonversi file.wav Anda ke pengkodean U-Law. Setelah mengonversi file, unggah ke Amazon Connect. + **Ukuran**: Amazon Connect mendukung prompt yang kurang dari 50MB dan kurang dari lima menit. + **Saat menyimpan prompt dalam bucket S3:** Untuk AWS Wilayah yang dinonaktifkan secara default (juga disebut Wilayah [keikutsertaan](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html)) seperti Afrika (Cape Town), bucket Anda harus berada di Wilayah yang sama. ## Jenis kontak | Jenis kontak | Didukung? | | --- | --- | | Suara | Ya | | Obrolan | Ya Jika kontak obrolan dialihkan ke blok ini, tetapi blok dikonfigurasi untuk panggilan, kontak dialihkan ke cabang **Kesalahan**. | | Tugas | Ya Jika kontak tugas dirutekan ke blok ini, tetapi blok dikonfigurasi untuk panggilan, kontak dialihkan ke cabang **Kesalahan**. | | Email | Tidak - mengambil cabang **Sukses** tetapi tidak berpengaruh | **Jika kontak callback tanpa agen atau pelanggan dirutekan ke blok ini, kontak dialihkan ke cabang Error.** ## Jenis aliran Anda dapat menggunakan blok ini dalam [jenis aliran](create-contact-flow.md#contact-flow-types) berikut: | Jenis aliran | Didukung? | | --- | --- | | Aliran masuk | Ya | | Alur antrian pelanggan | Ya. Anda dapat memutar prompt dari perpustakaan Amazon Connect tetapi tidak meminta yang disimpan di Amazon S3. | | Alur penahanan pelanggan | Tidak, gunakan blok [Permintaan loop](loop-prompts.md) aliran sebagai gantinya | | Aliran bisikan pelanggan | Ya. Anda dapat memutar prompt dari perpustakaan Amazon Connect tetapi tidak meminta yang disimpan di Amazon S3. | | Aliran bisikan keluar | Ya. Anda dapat memutar prompt dari perpustakaan Amazon Connect tetapi tidak meminta yang disimpan di Amazon S3. | | Agen menahan aliran | Tidak, gunakan blok [Permintaan loop](loop-prompts.md) aliran sebagai gantinya | | Aliran bisikan agen | Ya. Anda dapat memutar prompt dari perpustakaan Amazon Connect tetapi tidak meminta yang disimpan di Amazon S3. | | Transfer ke aliran agen | Ya | | Transfer ke aliran antrian | Ya | ## Cara mengkonfigurasi blok ini Anda dapat mengonfigurasi blok **prompt Play** dengan menggunakan situs web Amazon Connect admin atau dengan menggunakan [MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html)tindakan dalam bahasa Amazon Connect Flow. **Topics** + [Prompt yang disimpan di pustaka prompt Amazon Connect](#play-properties-library) + [Prompt disimpan di Amazon S3](#play-properties-s3) + [Text-to-speech atau teks obrolan](#play-properties-text-to-speech) + [Cabang blok aliran](#play-branches) + [Kiat konfigurasi tambahan](#play-tips) + [Data yang dihasilkan oleh blok ini](#play-data) ### Prompt yang disimpan di pustaka prompt Amazon Connect 1. Di flow designer, buka panel konfigurasi untuk blok **prompt Play**. 1. Pilih **Pilih dari pustaka prompt (audio)**. 1. Pilih dari salah satu petunjuk yang direkam sebelumnya yang disertakan dengan Amazon Connect, atau gunakan situs web Amazon Connect admin untuk [merekam dan mengunggah](prompts.md) prompt Anda sendiri. Tidak ada cara untuk mengunggah prompt secara massal. Gambar berikut menunjukkan halaman **Properti** dari blok **prompt Putar** yang dikonfigurasi untuk memutar prompt Audio dari pustaka prompt. ![\[Halaman properti dari blok prompt Play, pustaka prompt.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/playprompt-properties-library-manually.png) Contoh kode berikut menunjukkan bagaimana konfigurasi yang sama ini akan diwakili oleh [MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html)tindakan dalam bahasa Flow: ``` { "Identifier": "12345678-1234-1234-1234-123456789012", "Type": "MessageParticipant", "Parameters": { "PromptId": "arn:aws:connect:us-west-2:1111111111:instance/aaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/prompt/abcdef-abcd-abcd-abcd-abcdefghijkl" }, "Transitions": { "NextAction": "a625f619-81b0-46c3-a855-89151600bdb1", "Errors": [ { "NextAction": "a625f619-81b0-46c3-a855-89151600bdb1", "ErrorType": "NoMatchingError" } ] } } ``` ### Prompt disimpan di Amazon S3 Simpan sebanyak mungkin petunjuk yang Anda butuhkan dalam ember S3 dan kemudian rujuk ke sana dengan menentukan jalur bucket. Untuk performa terbaik, sebaiknya buat bucket S3 di AWS Region yang sama dengan instans Amazon Connect Anda. **Untuk menentukan file audio dari bucket S3** 1. Di flow designer, buka panel konfigurasi untuk blok **prompt Play**. 1. Pilih **Tentukan file audio dari bucket S3**. 1. Pilih **Setel secara manual**, lalu tentukan jalur file S3 yang menunjuk ke prompt audio di S3. Misalnya, `https://u1.s3.amazonaws.com/en.lob1/welcome.wav`. Gambar berikut menunjukkan halaman **Properties** dari blok **prompt Play** yang dikonfigurasi untuk mengatur jalur file S3 secara manual. ![\[Halaman properti dari blok prompt Play, jalur file S3 ditentukan secara manual.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/playprompt-properties-s3-manually.png) Contoh kode berikut menunjukkan bagaimana konfigurasi yang sama ini akan diwakili oleh [MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html)tindakan dalam bahasa Flow: ``` { "Identifier": "UniqueIdentifier", "Type": "MessageParticipant", "Parameters": { "Media": { "Uri": "https://u1.s3.amazonaws.com/en.lob1/welcome.wav", "SourceType": "S3", "MediaType": "Audio" } }, "Transitions": { "NextAction": "Next action identifier on success", "Errors": [ { "NextAction": "Next action identifier on failure", "ErrorType": "NoMatchingError" } ] } } ``` **Untuk menggunakan atribut untuk menentukan jalur file audio dari bucket S3** + Anda dapat menentukan jalur bucket S3 menggunakan atribut, seperti yang ditunjukkan pada gambar berikut: ![\[Jalur file S3 ditentukan secara manual menggunakan atribut.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/playprompt-properties-s3-jsonpath.png) —ATAU— + Anda dapat memberikan jalur S3 dengan penggabungan, seperti yang ditunjukkan pada contoh berikut. Ini memungkinkan Anda untuk mempersonalisasi prompt, misalnya, berdasarkan lini bisnis dan bahasa. Misalnya: `https://example.s3.amazon.aws.com/$['Attributes']['Language']/$['Attributes']['LOB']/1.wav` Contoh kode berikut menunjukkan bagaimana konfigurasi yang sama ini akan diwakili oleh [MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html)tindakan dalam bahasa Flow: ``` { "Identifier": "UniqueIdentifier", "Type": "MessageParticipant", "Parameters": { "Media": { "Uri": "https://u1.s3.amazonaws.com/$['Attributes']['Language']/$['Attributes']['LOB']/1.wav", "SourceType": "S3", "MediaType": "Audio" } }, "Transitions": { "NextAction": "Next action identifier on success", "Errors": [ { "NextAction": "Next action identifier on failure", "ErrorType": "NoMatchingError" } ] } } ``` **Untuk menentukan jalur S3 secara dinamis dengan menggunakan atribut kontak yang ditentukan pengguna** 1. **Gambar berikut menunjukkan atribut yang ditentukan pengguna bernama S3FilePath.** ![\[Jalur file S3 diatur secara dinamis, namespace disetel ke yang ditentukan Pengguna.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/playprompt-properties-s3-attributes.png) Contoh kode berikut menunjukkan bagaimana konfigurasi yang sama ini akan diwakili oleh [MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html)tindakan dalam bahasa Flow: ``` { "Parameters": { "Media": { "Uri": "$.Attributes.MyFile", "SourceType": "S3", "MediaType": "Audio" } }, "Identifier": "9ab5c4ee-7da8-44b3-b6c9-07f24e1846dc", "Type": "MessageParticipant", "Transitions": { "NextAction": "a625f619-81b0-46c3-a855-89151600bdb1", "Errors": [ { "NextAction": "a625f619-81b0-46c3-a855-89151600bdb1", "ErrorType": "NoMatchingError" } ] } } ``` Gambar berikut menunjukkan seperti apa blok ini ketika jalur S3 diatur secara dinamis. Ini menunjukkan jalur S3, dan memiliki dua cabang: **Sukses** dan **Kesalahan**. ![\[Blok prompt Play yang dikonfigurasi untuk jalur S3.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/play-prompt-configured2.png) ### Text-to-speech atau teks obrolan Anda dapat memasukkan prompt dalam teks biasa atau SSML. Permintaan berbasis teks ini diputar sebagai permintaan audio kepada pelanggan yang menggunakan Amazon Polly. Misalnya, gambar berikut menunjukkan blok **prompt Play** yang dikonfigurasi untuk memutar pesan **Terima kasih telah menelepon** ke pelanggan. ![\[Sebuah text-to-speech prompt diatur secara manual.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/play-prompt-sample-ssml.png) Contoh kode berikut menunjukkan bagaimana konfigurasi yang sama ini akan diwakili oleh [MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html)tindakan dalam bahasa Flow: ``` { "Parameters": { "Text": "Thank you for calling" }, "Identifier": "9ab5c4ee-7da8-44b3-b6c9-07f24e1846dc", "Type": "MessageParticipant", "Transitions": { "NextAction": "a625f619-81b0-46c3-a855-89151600bdb1", "Errors": [ { "NextAction": "a625f619-81b0-46c3-a855-89151600bdb1", "ErrorType": "NoMatchingError" } ] } } ``` Teks masukan yang disempurnakan SSML memberi Anda kontrol lebih besar atas cara Amazon Connect menghasilkan ucapan dari teks yang Anda berikan. Anda dapat menyesuaikan dan mengontrol aspek ucapan seperti pengucapan, volume, dan kecepatan. Untuk daftar tag SSML yang dapat Anda gunakan dengan Amazon Connect, lihat. [Tag SSML didukung oleh Amazon Connect](supported-ssml-tags.md) Untuk informasi selengkapnya, lihat [Tambahkan text-to-speech ke petunjuk di blok aliran di Amazon Polly](text-to-speech.md). Gambar berikut menunjukkan seperti apa blok **prompt Play** saat dikonfigurasi text-to-speech. Ini menunjukkan teks yang akan dimainkan, dan memiliki dua cabang: **Sukses** dan **Kesalahan**. ![\[Blok prompt Play yang dikonfigurasi untuk text-to-speech.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/play-prompt-configured.png) ### Cabang blok aliran Blok ini mendukung cabang keluaran berikut: + **Sukses**: Menunjukkan berhasil memutar audio atau pesan teks yang disediakan. + **Kesalahan**: Menunjukkan kegagalan untuk memutar pesan audio atau teks yang disediakan. + **Oke**: Beberapa alur yang ada memiliki versi blok **prompt Play** yang tidak memiliki cabang **Kesalahan**. Dalam hal ini, cabang **Okay** akan selalu diambil saat runtime. Jika Anda memperbarui konfigurasi blok **prompt Play** yang tidak memiliki cabang **Kesalahan**, cabang **Kesalahan** akan ditambahkan ke blok secara otomatis di editor. ### Kiat konfigurasi tambahan + Untuk step-by-step petunjuk tentang cara mengatur prompt dinamis menggunakan atribut kontak, lihat[Pilih secara dinamis permintaan mana yang akan diputar di Amazon Connect](dynamically-select-prompts.md). + Saat memutar prompt dari bucket S3, untuk performa terbaik, sebaiknya buat bucket di AWS Wilayah yang sama dengan instans Amazon Connect Anda. + Saat Anda menggunakan teks, baik untuk text-to-speech atau mengobrol, Anda dapat menggunakan maksimum 3.000 karakter yang ditagih, yang merupakan total 6.000 karakter. Anda juga dapat menentukan teks dalam aliran menggunakan atribut kontak. ### Data yang dihasilkan oleh blok ini Blok ini tidak menghasilkan data apa pun. ## Skenario kesalahan Kontak dialihkan ke cabang **Error** dalam situasi berikut: + **Jika kontak callback tanpa agen atau pelanggan dirutekan ke blok ini, kontak dialihkan ke cabang Error.** + Amazon Connect tidak dapat mengunduh prompt dari S3. Ini mungkin disebabkan oleh jalur file yang salah, atau kebijakan bucket S3 tidak diatur dengan benar dan Amazon Connect tidak memiliki akses. Untuk petunjuk tentang cara menerapkan kebijakan, dan templat yang dapat Anda gunakan, lihat[Siapkan petunjuk untuk memutar dari bucket S3 di Amazon Connect](setup-prompts-s3.md). + Format file audio salah. Hanya file.wav yang didukung. + File audio lebih besar dari 50MB atau lebih dari lima menit. + SSML tidak benar. + text-to-speechPanjangnya melebihi 6000 karakter. + Nama Sumber Daya Amazon (ARN) untuk prompt tidak benar. ## Aliran sampel Semua aliran sampel menggunakan blok **prompt Play**. Lihatlah untuk melihat **prompt Putar [Contoh aliran masuk di Amazon Connect untuk pengalaman kontak pertama](sample-inbound-flow.md)** untuk obrolan dan satu untuk audio. ## Sumber daya lainnya Lihat topik berikut untuk mempelajari lebih lanjut tentang petunjuk. + [Buat prompt di Amazon Connect](prompts.md) + [Tindakan cepat](https://docs.aws.amazon.com/connect/latest/APIReference/prompts-api.html) dalam Panduan Referensi Amazon Connect API.