Gateway ponsel Dialogflow

Beta

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. Layanan ini digunakan untuk membuat solusi IVR (respons suara interaktif) percakapan yang terintegrasi dengan jaringan pusat panggilan Anda yang lain. Saat ini, Anda dapat memilih nomor telepon yang dihosting oleh Google.

Untuk mengetahui informasi kuota dan harga gateway ponsel, lihat halaman Harga serta 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 - AS (en-US)

Jika model ucapan yang ditingkatkan dinonaktifkan untuk agen, lihat kolom Telepon 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, buatlah sekarang:

1. Buka Dialogflow ES Console.
2. Jika diminta, login ke Konsol Dialogflow. Lihat Ringkasan konsol Dialogflow untuk mengetahui informasi selengkapnya.
3. Klik Create Agent di menu sidebar kiri. (Jika Anda sudah memiliki agen lain, klik nama agen, scroll ke bagian bawah, lalu klik Buat agen baru.)
4. Masukkan nama agen, bahasa default, dan zona waktu default.
5. Jika Anda sudah membuat project, masukkan project tersebut. Jika Anda ingin mengizinkan Konsol Dialogflow untuk 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 sudah 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 Dialogflow ES Console.
3. Pilih agen Anda.
4. Klik tombol setelan di samping nama agen.
5. Pilih tab Ekspor dan Impor.
6. Pilih Restore From Zip dan ikuti petunjuk untuk memulihkan file zip yang Anda download.

Mengaktifkan fitur beta

Pastikan fitur beta diaktifkan:

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

Menyiapkan gateway ponsel

Untuk menyiapkan gateway, ikuti langkah-langkah berikut:

1. Pilih penyedia:
   1. Buka Dialogflow ES Console.
   2. Pilih agen Anda.
   3. Klik Integrations.
      
   4. Klik Dialogflow Phone Gateway.
      
2. Konfigurasikan Gateway Telepon:
   1. Pilih bahasa.
   2. Pilih kode negara untuk nomor telepon tersebut.
   3. Opsional. Pilih kode area yang diinginkan.
   4. Klik Berikutnya.
      
3. Pilih nomor:
   1. Pilih nomor telepon dari daftar.
   2. Klik Buat.
      
4. Penyelesaian:
   1. Gateway kini aktif.
   2. Jika ingin, Anda dapat mengubah lingkungan.
   3. Simpan nomor telepon yang ditampilkan dan tutup jendela dialog. Anda dapat mengklik tombol integrasi Dialogflow Phone Gateway lagi untuk mengambil informasi ini.
      

Hubungi nomor telepon

Sekarang Anda dapat menelepon nomor tersebut dan mengikuti petunjuk suara sederhana. Interaksi ditentukan dalam agen Anda.

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

Catatan: Jika Anda memutuskan untuk menghapus agen, tetapi tetap menggunakan project GCP, nonaktifkan integrasi Gateway Telepon sebelum penghapusan agen.

Memeriksa intent

Setelah Anda memiliki agen gateway ponsel yang berfungsi, mari kita lihat intent yang Anda impor. Ini akan membantu Anda memahami cara membangun agen gateway telepon Anda sendiri.

Menyambut penelepon

Ketika Anda menelepon nomor tersebut, agen tersebut menyapa Anda dan memberikan daftar opsi. Ikuti langkah-langkah berikut untuk melihat cara konfigurasi ini:

1. Buka Dialogflow ES Console.
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 Peristiwa Sambutan Telepon (TELEPHONY_WELCOME) ada, yang berarti semua jenis peristiwa sambutan akan memicu intent ini. Sebagai alternatif, Anda dapat membuat intent terpisah, masing-masing dikhususkan untuk peristiwa sambutan tertentu.
6. Scroll ke bawah ke bagian Respons, lalu klik tab GATEWAY TELEPON DIALOGFLOW.
7. Perhatikan bahwa respons Synthesize speech berisi pesan selamat datang yang Anda dengar saat memanggil nomor tersebut.

Respons terhadap perintah pengujian

Setelah Anda merespons dengan "{i>test<i}", agen memberikan daftar opsi baru. Ikuti langkah-langkah berikut untuk melihat cara konfigurasi ini:

1. Klik Intent.
2. Klik Test Telephony Intent.
3. Scroll ke bawah ke bagian Respons, lalu klik tab GATEWAY TELEPON DIALOGFLOW.
4. Perlu diperhatikan bahwa respons Synthesize speech berisi respons yang Anda dengar setelah mengucapkan "uji".

Menyetel konteks

Setelah mengucapkan "uji", ada dua kemungkinan perintah yang dapat Anda lakukan: "transfer" atau "hentikan". Ini bukanlah batasan untuk agen gateway telepon; cara ini menjelaskan cara intent ini didefinisikan. Intent yang terkait dengan perintah ini disediakan dengan konteks. Ikuti langkah-langkah berikut untuk melihat cara konfigurasi ini:

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

Menghentikan panggilan

Ketika Anda menanggapi dengan "hentikan", agen mengucapkan "selamat tinggal" dan menghentikan panggilan. Ikuti langkah-langkah berikut untuk melihat cara konfigurasi ini:

1. Scroll ke bawah ke bagian Frasa pelatihan dan catat frasa yang digunakan untuk menghentikan panggilan.
2. Scroll ke bawah ke bagian Respons, lalu klik tab GATEWAY TELEPON DIALOGFLOW.
3. Perhatikan bahwa respons Sintesis ucapan berisi "selamat tinggal".
4. Perhatikan bahwa opsi Tetapkan intent ini sebagai akhir percakapan diaktifkan. Jika ini diaktifkan, Dialogflow akan menghentikan panggilan telepon setelah memutar semua perintah audio lainnya.

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

Pesan respons kaya gateway ponsel

Intent untuk contoh ini menggunakan pesan respons yang lengkap untuk respons gateway ponsel. Berikut adalah jenis-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 8kHz.
• Mensintesis ucapan: Menyintesis teks yang disediakan 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 ditransfer disertakan dalam total durasi panggilan, dan biaya Dialogflow akan diterapkan hingga panggilan berakhir.

Catatan: Saat menambahkan pesan kaya, Anda dapat mengarahkan kursor ke ikon ? 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" dan tekan tombol return
2. Ubah Default Response ke DIALOGFLOW PHONE GATEWAY
3. Klik tombol Putar Audio untuk mendengarkan respons agen
4. Lanjutkan percakapan dengan agen

Nomor bebas pulsa

Anda dapat meminta nomor telepon dengan kode area 833. Perlu diperhatikan bahwa nomor bebas pulsa memiliki harga 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 pengguna akhir awal. Selagi agen dimuat, ponsel akan terus berdering. Dialogflow melakukannya dengan mengirimkan permintaan intent deteksi ke agen Anda. Teks permintaan ini adalah TELEPHONY_WARMUP.

Ambil nomor telepon penelepon

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