Gateway Telepon Dialogflow

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Fitur gateway telepon Dialogflow menyediakan antarmuka telepon untuk agen Anda. Solusi ini digunakan untuk membuat solusi IVR (tanggapan suara interaktif) percakapan yang terintegrasi dengan seluruh jaringan pusat panggilan Anda. Saat ini, Anda dapat memilih nomor telepon yang dihosting oleh Google.

Untuk mengetahui informasi kuota dan harga gateway telepon, lihat halaman Harga dan Kuota dan Batas.

Batasan

Dukungan bahasa

Integrasi ini hanya mendukung penggunaan satu bahasa per agen.

Jika model ucapan yang ditingkatkan diaktifkan untuk agen, integrasi ini hanya mendukung bahasa berikut:

• Inggris (en)
• Inggris - Amerika Serikat (en-US)

Jika model ucapan yang ditingkatkan kualitasnya dinonaktifkan untuk agen, lihat kolom Ponsel di halaman Referensi bahasa untuk mengetahui daftar bahasa yang didukung.

Dukungan nomor telepon

Hanya nomor telepon AS yang didukung, baik untuk panggilan masuk maupun untuk transfer panggilan.

Sebelum memulai

Anda harus melakukan hal berikut sebelum membaca panduan ini:

1. Baca Dasar-dasar Dialogflow.
2. Lakukan langkah-langkah penyiapan.

Membuat agen

Jika Anda belum membuat agen, buat sekarang:

1. Buka konsol Dialogflow ES.
2. Jika diminta, login ke Konsol Dialogflow. Lihat Ringkasan konsol Dialogflow untuk informasi selengkapnya.
3. Klik Buat Agen di menu sidebar kiri. (Jika Anda sudah memiliki agen lain, klik nama agen, scroll ke bawah, lalu klik Buat agen baru.)
4. Masukkan nama agen, bahasa default, dan zona waktu default Anda.
5. Jika Anda telah membuat project, masukkan project tersebut. Jika Anda ingin mengizinkan Dialogflow Console membuat project, pilih Create a new Google project.
6. Klik tombol Buat.

Mengimpor file contoh ke agen Anda

Langkah-langkah dalam panduan ini membuat asumsi tentang agen Anda, sehingga Anda perlu import agen yang disiapkan untuk panduan ini. Saat mengimpor, langkah-langkah ini menggunakan opsi restore, yang menimpa semua setelan, intent, dan entity agen.

Untuk mengimpor file, ikuti langkah-langkah berikut:

1. Download file telephony-bot.zip.
2. Buka konsol Dialogflow ES.
3. Pilih agen Anda.
4. Klik tombol setelan di samping nama agen.
5. Pilih tab Ekspor dan Impor.
6. Pilih Pulihkan Dari Zip dan ikuti petunjuk untuk memulihkan file zip yang Anda download.

Mengaktifkan fitur beta

Pastikan fitur beta diaktifkan:

1. Buka konsol Dialogflow ES.
2. Pilih agen.
3. Klik tombol setelan di samping nama agen.
4. Scroll ke bawah saat berada di tab General dan pastikan Beta Features diaktifkan.
5. Jika Anda telah melakukan perubahan, klik Simpan.

Menyiapkan gateway ponsel

Untuk menyiapkan gateway, ikuti langkah-langkah berikut:

1. Pilih penyedia:
   1. Buka konsol Dialogflow ES.
   2. Pilih agen Anda.
   3. Klik Integrasi.
      
   4. Klik Dialogflow Phone Gateway.
      
2. Konfigurasi Gateway Telepon:
   1. Pilih bahasa.
   2. Pilih kode negara untuk nomor telepon.
   3. Opsional. Pilih kode area pilihan.
   4. Klik Berikutnya.
      
3. Pilih angka:
   1. Pilih nomor telepon dari daftar.
   2. Klik Buat.
      
4. Penyelesaian:
   1. Gateway kini aktif.
   2. Atau, ubah lingkungan.
   3. Simpan nomor telepon yang ditampilkan dan tutup jendela dialog. Anda dapat mengklik tombol integrasi Dialogflow Phone Gateway lagi untuk mengambil informasi ini.
      

Menelepon nomor telepon

Anda kini dapat menelepon nomor tersebut dan mengikuti petunjuk suara yang sederhana. Interaksi ditentukan di agen Anda.

Catatan: Ada kuota dan batas untuk fitur ini. Jika Anda menerima sinyal sibuk atau panggilan terputus, Anda mungkin telah melampaui kuota.

Catatan: Jika Anda memutuskan untuk menghapus agen, tetapi tetap menggunakan project Google Cloud, nonaktifkan integrasi Phone Gateway sebelum penghapusan agen.

Memeriksa intent

Setelah Anda memiliki agen gateway telepon yang berfungsi, mari kita lihat intent yang Anda impor. Hal ini akan membantu Anda memahami cara membuat agen gateway telepon Anda sendiri.

Menyambut penelepon

Saat Anda menelepon nomor tersebut, agen akan menyapa Anda dan memberikan daftar opsi. Ikuti langkah-langkah berikut untuk melihat cara konfigurasinya:

1. Buka konsol Dialogflow ES.
2. Pilih agen Anda.
3. Klik Intent.
4. Klik Default Welcome Intent.
5. Scroll ke bawah ke bagian Peristiwa. Perhatikan bahwa peristiwa Selamat Datang (WELCOME) dan Selamat Datang Telepon (TELEPHONY_WELCOME) ada, yang berarti bahwa semua jenis peristiwa selamat datang akan memicu intent ini. Sebagai alternatif, Anda dapat membuat intent terpisah, yang masing-masing ditujukan untuk peristiwa sambutan tertentu.
6. Scroll ke bawah ke bagian Respons, lalu klik tab DIALOGFLOW PHONE GATEWAY.
7. Perhatikan bahwa respons Synthesize speech berisi pesan selamat datang yang Anda dengar saat menelepon nomor tersebut.

Respons terhadap perintah pengujian

Setelah Anda merespons dengan "test", agen akan menampilkan daftar opsi baru. Ikuti langkah-langkah berikut untuk melihat cara konfigurasinya:

1. Klik Intent.
2. Klik Uji Intent Telepon.
3. Scroll ke bawah ke bagian Respons, lalu klik tab DIALOGFLOW PHONE GATEWAY.
4. Perhatikan bahwa respons Synthesize speech berisi respons yang Anda dengar setelah Anda mengucapkan "test".

Menetapkan konteks

Setelah mengucapkan "test", ada dua kemungkinan perintah yang dapat Anda buat: "transfer" atau "terminate". Hal ini bukan batasan agen gateway telepon; hanya cara intent ini ditentukan. Intent yang terkait dengan perintah ini dilengkapi dengan konteks. Ikuti langkah-langkah berikut untuk melihat cara konfigurasinya:

1. Scroll ke bagian Konteks di bagian atas.
2. Perhatikan konteks output TestTelephonyIntent-followup.
3. Klik Intent.
4. Klik tombol perluasan di samping Test Telephony Intent.
5. Klik Test Telephony Intent - Terminate
6. Scroll ke bagian Konteks di bagian atas.
7. Perhatikan konteks input TestTelephonyIntent-followup.

Mengakhiri panggilan

Saat Anda merespons dengan "akhiri", agen akan mengucapkan "selamat tinggal" dan mengakhiri panggilan. Ikuti langkah-langkah berikut untuk melihat cara konfigurasinya:

1. Scroll ke bawah ke bagian Frasa pelatihan dan catat frasa yang digunakan untuk mengakhiri panggilan.
2. Scroll ke bawah ke bagian Respons, lalu klik tab DIALOGFLOW PHONE GATEWAY.
3. Perhatikan bahwa respons Synthesize speech berisi "goodbye".
4. Perhatikan bahwa Set this intent as end of conversation diaktifkan. Jika diaktifkan, Dialogflow akan menghentikan panggilan telepon setelah memutar semua perintah audio lainnya.

Catatan: Jika menggunakan fulfillment, Anda dapat menghentikan panggilan dengan menetapkan kolom end_interaction dari pesan WebhookResponse.

Pesan respons lengkap gateway telepon

Intent untuk contoh ini menggunakan pesan respons lengkap untuk respons gateway telepon. Berikut adalah jenis yang dapat Anda gunakan:

• Putar audio: Memutar file audio yang disediakan. Tentukan URI ke objek Cloud Storage yang berisi audio yang akan diputar. Misalnya, 'gs://bucket/object'. Objek harus berisi satu saluran (mono) audio PCM linear (2 byte / sampel) pada 8 kHz.
• Melakukan sintesis ucapan: Melakukan sintesis teks yang diberikan ke audio dan memutarnya. Atau, Anda dapat mengaktifkan Gunakan respons dari tab DEFAULT sebagai respons pertama, yang akan menggunakan respons default untuk menyintesis respons ucapan. Jika Anda hanya menentukan respons default, dan tidak mengaktifkan Gunakan respons dari tab DEFAULT sebagai respons pertama, hanya teks yang diisi di QueryResult.fulfillment_text (diisi dengan respons teks yang dipilih secara acak), yang disintesis menjadi audio.
• Transfer panggilan: Mentransfer penelepon ke nomor lain. Durasi waktu yang dihabiskan untuk panggilan yang dialihkan disertakan dalam total durasi panggilan, dan tagihan Dialogflow diterapkan hingga panggilan berakhir.

Catatan: Saat menambahkan pesan multimedia, Anda dapat mengarahkan kursor ke ? untuk mendapatkan informasi selengkapnya tentang pesan dan inputnya.

Setelan agen

Anda dapat mengontrol berbagai aspek sintesis ucapan. Lihat setelan ucapan agen.

Menggunakan simulator Dialogflow

Saat menguji atau bereksperimen dengan agen gateway telepon, Anda tidak perlu melakukan panggilan telepon. Anda dapat berinteraksi dengan agen dan menerima respons audio melalui simulator Dialogflow:

1. Ketik "halo" lalu tekan tombol kembali
2. Ubah Default Response menjadi DIALOGFLOW PHONE GATEWAY
3. Klik tombol Putar Audio untuk mendengar respons agen
4. Melanjutkan percakapan dengan agen

Nomor bebas pulsa

Anda dapat meminta nomor telepon dengan kode area 833. Perhatikan bahwa nomor bebas pulsa harganya lebih tinggi.

Acara

Peristiwa berikut dipanggil oleh integrasi ini:

Acara	Deskripsi
TELEPHONY_WELCOME	Dipicu saat seseorang menelepon nomor telepon yang terkait dengan agen Dialogflow Anda.

Pemanasan agen

Saat pengguna akhir memanggil agen Dialogflow Phone Gateway, Dialogflow akan memulai dengan memuat agen untuk respons cepat terhadap ucapan awal pengguna akhir. Saat agen dimuat, ponsel terus berdering. Dialogflow melakukannya dengan mengirimkan permintaan deteksi intent ke agen Anda. Teks permintaan ini adalah TELEPHONY_WARMUP.

Mengambil nomor telepon pemanggil

Anda dapat mengambil nilai caller_id dari kolom OriginalDetectIntentRequest.payload dalam permintaan webhook jika menggunakan edisi Dialogflow Essentials. Dalam edisi Uji Coba Dialogflow, nilai caller_id disamarkan.