Komponen bawaan ucapan

Komponen bawaan salam mengambil nomor telepon pemanggil (ANI), jika tersedia. Jika nomor telepon diambil, komponen akan melakukan autentikasi ringan menggunakan nomor telepon, memvalidasinya terhadap nomor telepon yang terdaftar. Kemudian, agen menyapa pengguna akhir dengan pesan yang dipersonalisasi berdasarkan informasi akunnya.

Batasan

Selain batasan komponen bawaan umum, komponen bawaan ini memiliki batasan berikut:

  • Komponen ini mengasumsikan bahwa nomor telepon pelanggan dikelola dalam sistem CRM (Customer Relationship Management) atau layanan lainnya.
  • Pelanggan lama yang menggunakan nomor telepon alternatif untuk menghubungi tidak akan diautentikasi oleh komponen ini.

Contoh dialog

Contoh dialog berikut menunjukkan skenario umum yang ditangani oleh komponen bawaan ini. Contoh dialog menunjukkan perilaku saat komponen dipanggil melalui telepon, yang memicu Maksud Selamat Datang Default dan respons agen pertama di awal percakapan.

Pengguna akhir yang diautentikasi

Pengguna akhir diidentifikasi berdasarkan nomor telepon yang menelepon dan menerima pesan sapaan yang dipersonalisasi.

Input pengguna Respons agen
Halo [Caller First Name]. Terima kasih telah menghubungi [Nama Perusahaan], kami berkomitmen untuk kesehatan finansial Anda. Ada yang bisa kami bantu?

Pengguna akhir tidak dikenal

Nomor telepon pengguna akhir tidak diidentifikasi dan pengguna akhir disambut dengan pesan salam standar.

Input pengguna Respons agen
Terima kasih telah menghubungi [Nama Perusahaan], kami berkomitmen untuk kesehatan finansial Anda. Ada yang bisa kami bantu?

Konvensi penamaan

Komponen bawaan ini menggunakan konvensi penamaan berikut:

Fitur Format Contoh
Flow [Nama Komponen] Salam
Parameter [param_name] ani_auth
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_greeting:get_account_details

Parameter input

Parameter input adalah parameter yang digunakan untuk mengonfigurasi perilaku tertentu komponen. Parameter akan digunakan oleh satu atau beberapa kondisi dalam alur untuk menentukan perilaku komponen. Parameter cakupan alur harus ditetapkan di halaman awal komponen seperti yang dijelaskan di bawah. Parameter cakupan sesi dapat ditetapkan oleh alur panggilan, atau di halaman mulai komponen ini.

Komponen bawaan ini menerima parameter input berikut:

Nama Parameter Deskripsi Format Input
$flow.company_name Mencatat nama perusahaan yang akan digunakan secara dinamis dalam perintah Sapaan. string

Untuk mengonfigurasi parameter input untuk komponen ini, perluas untuk mendapatkan petunjuk.

  1. Buka konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Build.
  5. Klik komponen yang diimpor di bagian Alur.
  6. Klik Halaman Awal di bagian Halaman.
  7. Klik Rute true di Halaman Mulai.
  8. Di jendela Rute, edit nilai Preset Parameter sesuai kebutuhan.
  9. Klik Simpan.

Parameter output

Parameter output adalah parameter sesi yang akan tetap aktif setelah keluar dari komponen. Parameter ini berisi informasi penting yang dikumpulkan oleh komponen. Komponen bawaan ini memberikan nilai untuk parameter output berikut:

Nama Parameter Deskripsi Format Output
ani_auth Parameter ini merekam hasil autentikasi berbasis ANI. Secara default, nilainya adalah false. boolean
auth_level Menunjukkan tingkat autentikasi pemanggil. Secara default, nilainya adalah null. -1 menunjukkan bahwa pengguna tidak diautentikasi oleh ANI-nya. 0 menunjukkan bahwa autentikasi ANI berhasil. bilangan bulat

Penyiapan dasar

Untuk menyiapkan komponen bawaan ini:

  1. Impor komponen bawaan.
  2. Konfigurasi webhook fleksibel yang disediakan dengan layanan eksternal Anda, lihat Penyiapan webhook di bawah.

Penyiapan webhook

Untuk menggunakan komponen ini, Anda harus mengonfigurasi webhook fleksibel yang disertakan untuk mengambil informasi yang diperlukan dari layanan eksternal Anda.

Mendapatkan detail akun

Webhook prebuilt_components_greeting:get_account_details digunakan oleh komponen untuk mengidentifikasi pemanggil menggunakan ANI-nya. Jika nomor telepon penelepon ada di layanan eksternal yang dikonfigurasi, informasi yang relevan untuk mempersonalisasi pengalaman akan diambil, termasuk nama dan email penelepon.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.

Nama Parameter Deskripsi Format Output
phone_number Nomor telepon penelepon (ANI) bilangan bulat

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter Deskripsi Format Output
user_first_name Nama depan pengguna akhir, digunakan untuk memberikan sapaan yang dipersonalisasi. string

Untuk mengonfigurasi webhook Get Account Details untuk komponen ini, luaskan petunjuknya.

  1. Buka konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhook.
  6. Pilih webhook prebuilt_components_greeting:get_account_details.
  7. Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
  9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
  10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
  11. Klik Simpan.

Selesai

Agen dan webhook-nya kini telah disiapkan dan siap diuji.