Dokumen ini menjelaskan langkah-langkah yang diperlukan untuk mengonfigurasi projectGoogle Cloud untuk integrasi telepon.
Pilih atau buat project Google Cloud
Trunk SIP terhubung ke project hanya untuk alasan komunikasi, tetapi efeknya tidak terbatas pada project tertentu.
Misalnya, Anda dapat memiliki tiga project berbeda (pengembangan, pengujian, produksi). Jika trunk SIP yang sama digunakan untuk semua komunikasi SBC ke GTP, hanya permintaan pertama untuk membuat trunk SIP yang akan berhasil, dan permintaan lainnya untuk membuat trunk SIP di region dan nama host yang sama akan gagal.
Anda dapat menggunakan project lain untuk tujuan mengelola trunk SIP saja. Hal ini memungkinkan tim lain mengelola trunk, dan dalam UI trunk, Anda dapat membuat berbagai grup SBC untuk pengembangan, pengujian, dan produksi.
Untuk menggunakan layanan yang disediakan oleh Google Cloud, Anda harus membuat sebuah project. Sebuah project akan mengorganisasikan semua resource Google Cloud Anda. Sebuah project terdiri dari sekumpulan kolaborator, API yang diaktifkan (dan resource lainnya), alat pemantauan, informasi penagihan, serta kontrol akses dan autentikasi. Anda dapat membuat satu project, atau membuat beberapa project dan menggunakannya untuk mengorganisasikan resource Google Cloud dalam hierarki resource. Saat membuat sebuah project, catat project ID dari project tersebut. ID ini dibutuhkan untuk membuat panggilan API. Untuk mengetahui informasi selengkapnya tentang project, baca dokumentasi Resource Manager.
Di konsol Google Cloud , pada halaman pemilih project, pilih atau buat project Google Cloud .
Peran yang diperlukan untuk memilih atau membuat project
- Memilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project apa pun yang perannya telah diberikan kepada Anda.
-
Membuat project: Untuk membuat project, Anda memerlukan peran Project Creator
(
roles/resourcemanager.projectCreator), yang berisi izinresourcemanager.projects.create. Pelajari cara memberikan peran.
Izin
- Di konsol Google Cloud , buka IAM & Admin > IAM.
- Pilih akun layanan yang ada atau buat akun layanan baru, lalu tetapkan peran
Dialogflow API Adminke akun layanan tersebut. Peran ini diperlukan untuk integrasi telepon.
Akses API nomor telepon
Penggunaan metode API nomor telepon memerlukan akses khusus. Hubungi perwakilan Google untuk mendapatkan informasi selengkapnya.
Mengonfigurasi Dialogflow, profil percakapan, dan nomor telepon
Bagian ini menjelaskan cara membuat profil percakapan Conversational AI dengan nomor telepon Google Telephony Platform (GTP) terkait.
- Buka Colab Enterprise. Jika diminta, aktifkan API Compute Engine, Dataform, dan Vertex.
- Pilih Import notebooks, lalu pilih URL sebagai sumber data. Masukkan URL repositori GitHub, lalu pilih Import.
- Di kolom
PROJECT_ID, masukkan project ID Google Cloud untuk project yang ingin Anda kaitkan dengan integrasi. Temukan project yang ada di menu di bagian atas halaman di konsolGoogle Cloud . - Masukkan region yang Anda pilih di kolom
REGION. Semua region Dialogflow didukung. - Biarkan kolom
JWTapa adanya, atau masukkan nilaiJWTAnda di sini. Jika dibiarkan kosong, SSO akan digunakan secara default. - Klik tombol putar di bagian Project atas untuk menjalankan bagian kode tersebut. Jika diminta, izinkan notebook mengakses kredensial Google Anda.
- Luaskan bagian Mengonfigurasi AI Percakapan untuk SIP/SIPREC. Di bagian Create a dummy Dialogflow ES agent..., klik Show code dan jalankan kode tanpa melakukan perubahan apa pun. Tindakan ini akan membuat agen Dialogflow ES tiruan dan menetapkan tingkatannya ke Enterprise. Agen Dialogflow ES tiruan diperlukan untuk mengakses endpoint Dialogflow API. Setiap project Google Cloud dapat memiliki satu agen Dialogflow ES.
- Luaskan untuk menampilkan kode di bagian Script to create a
ConversationProfile....CONVERSATION_PROFILE_NAME: String ini dapat berupa string apa pun. Anda dapat menggunakan nilai default atau memasukkan nilai Anda sendiri.SECURITY_SETTINGS: Dapat berupa string apa pun. Anda dapat menggunakan nilai default atau memasukkan nilai Anda sendiri.PHONE_NUMBER_COUNTRY_CODE: Masukkan kode negara yang ingin Anda kaitkan dengan nomor telepon GTP Anda.CX_AGENT_NAME: Masukkan nama agen Dialogflow CX yang ingin Anda kaitkan dengan profil percakapan yang dihasilkan.
- Jalankan kode. Output akan menyertakan nama
ConversationProfileyang dihasilkan, setelan keamanan, dan nomor telepon GTP. - Buka konsol Dialogflow ES untuk
memastikan bahwa agen bernama
Dummy_ES_agenttelah dibuat. Klik Settings untuk memverifikasi bahwa agen terkait dengan project Google Cloud yang benar dan telah diupgrade ke edisi Essentials. - Buka
konsol Agent Assist.
Klik Conversation profiles di menu navigasi untuk memverifikasi bahwa profil percakapan dengan
CONVERSATION_PROFILE_NAMEyang Anda masukkan telah dibuat. - Buka konsol Conversational AI Insights. Pastikan semua transkrip percakapan yang terkait dengan agen Dialogflow CX Anda telah diimpor.
(Opsional) Meminta penambahan kuota untuk durasi panggilan Gateway Telepon Dialogflow CX
Langganan Dialogflow ES Essentials dan Dialogflow CX dilengkapi dengan kuota standar yang tersedia. Jika Anda tidak menggunakan Dialogflow sama sekali, misalnya hanya menggunakan Agent Assist, Transkripsi, atau Perekaman Panggilan, kuota default Anda sama dengan kuota Dialogflow ES Essentials.
Anda dapat meminta penambahan kuota jika diperlukan berdasarkan estimasi traffic Anda. Dalam sebagian besar kasus penggunaan, kuota standar sudah cukup untuk penyiapan dan pengujian, tetapi aplikasi runtime memerlukan peningkatan. Lihat halaman kuota Dialogflow untuk mengetahui detail kuota dan petunjuk untuk meminta penambahan kuota.
(Opsional) Mengaktifkan logging audit untuk Dialogflow API
Untuk mengaktifkan log audit untuk Dialogflow API (dialogflow.googleapis.com) untuk Admin Read, Data Read, dan Data Write, gunakan fitur ini untuk melihat semua panggilan AI percakapan API individual yang dilakukan dan kredensial yang digunakan untuk otorisasi dan konsumsi. Dengan begitu, Anda dapat memecahkan masalah dan men-debug masalah secara lebih efektif.
Langkah berikutnya
- Pelajari cara menyiapkan dan mengonfigurasi SBC.