Blok aliran: Prompt putar - Amazon Connect
DeskripsiGunakan kasus untuk blok iniPersyaratan untuk petunjukJenis kontakJenis aliranCara mengkonfigurasi blok iniSkenario kesalahanAliran sampelSumber daya lainnya

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

Blok aliran: Prompt putar

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 $123,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) 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 dialihkan ke blok ini, kontak dialihkan ke cabang Success, tetapi prompt tidak dimainkan.

Jenis aliran

Anda dapat menggunakan blok ini dalam jenis aliran 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 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 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 MessageParticipanttindakan dalam bahasa Amazon Connect Flow.

Prompt yang disimpan di pustaka prompt Amazon Connect

  1. Di flow designer, buka panel konfigurasi untuk blok prompt Play.

  2. Pilih Pilih dari pustaka prompt (audio).

  3. Pilih salah satu petunjuk yang direkam sebelumnya yang disertakan dengan Amazon Connect, atau gunakan situs web Amazon Connect admin untuk merekam dan mengunggah 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.

Contoh kode berikut menunjukkan bagaimana konfigurasi yang sama ini akan diwakili oleh MessageParticipanttindakan 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.

  2. Pilih Tentukan file audio dari bucket S3.

  3. 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.

    Contoh kode berikut menunjukkan bagaimana konfigurasi yang sama ini akan diwakili oleh MessageParticipanttindakan 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.

— 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 MessageParticipanttindakan 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.

Contoh kode berikut menunjukkan bagaimana konfigurasi yang sama ini akan diwakili oleh MessageParticipanttindakan 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.

T ext-to-speech atau teks obrolan

Anda dapat memasukkan prompt dalam teks biasa atauSSML. 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.

Contoh kode berikut menunjukkan bagaimana konfigurasi yang sama ini akan diwakili oleh MessageParticipanttindakan dalam bahasa Flow:

{
   "Parameters": {
       "Text": "<speak>Thank you for calling</speak>"
   },
   "Identifier": "9ab5c4ee-7da8-44b3-b6c9-07f24e1846dc",
   "Type": "MessageParticipant",
   "Transitions": {
       "NextAction": "a625f619-81b0-46c3-a855-89151600bdb1",
       "Errors": [
           {
               "NextAction": "a625f619-81b0-46c3-a855-89151600bdb1",
               "ErrorType": "NoMatchingError"
           }
       ]
   }
}

SSMLTeks masukan yang disempurnakan 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 SSML tag yang dapat Anda gunakan dengan Amazon Connect, lihatSSMLtag yang didukung oleh Amazon Connect.

Untuk informasi selengkapnya, lihat Tambahkan text-to-speech ke prompt.

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.

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 Error. 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, lihatSecara dinamis memilih prompt mana yang akan dimainkan.

  • 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 Kesalahan dalam situasi berikut:

  • 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, lihatSiapkan petunjuk untuk bermain dari ember S3.

  • Format file audio salah. Hanya file.wav yang didukung.

  • File audio lebih besar dari 50MB atau lebih dari lima menit.

  • SSMLItu tidak benar.

  • text-to-speech Panjangnya 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 Play Sampel aliran masuk (pengalaman kontak pertama) untuk obrolan dan satu untuk audio.

Sumber daya lainnya

Lihat topik berikut untuk mempelajari lebih lanjut tentang petunjuk.