Halaman ini mendokumentasikan langkah-langkah yang diperlukan untuk mengonfigurasi project Google Cloud untuk integrasi telepon.
Pilih atau buat Google Cloud project
SIP Trunk terhubung ke project hanya untuk alasan komunikasi, tetapi dampaknya tidak terbatas pada project tertentu.
Misalnya, Anda mungkin 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/nama host yang sama akan gagal.
Sebaiknya gunakan project yang berbeda khusus untuk mengelola SIP Trunk. Hal ini memungkinkan tim yang berbeda bertanggung jawab atas trunk, dan dalam UI Trunk, mereka dapat membuat berbagai grup SBC untuk pengembangan, pengujian, dan produksi.
Untuk menggunakan layanan yang disediakan oleh Google Cloud, Anda harus membuat project. Project menyusun semua Google Cloud resource 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 mengatur Google Cloud resource dalam hierarki resource. Saat membuat project, catat ID project. ID ini dibutuhkan untuk membuat panggilan API. Untuk mengetahui informasi selengkapnya tentang project, lihat dokumentasi Resource Manager.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Izin
- Di Google Cloud Console, buka IAM & Admin -> IAM.
- Pilih akun layanan yang ada atau buat akun layanan baru, dan pastikan akun tersebut memiliki peran
Dialogflow API Adminyang ditetapkan untuknya. Peran ini diperlukan untuk integrasi telepon.
Akses API nomor telepon
Penggunaan metode API nomor telepon memerlukan akses khusus. Hubungi perwakilan Google Anda untuk mendapatkan informasi selengkapnya.
Mengonfigurasi Dialogflow, profil percakapan, dan nomor telepon
Bagian ini memandu Anda melalui proses pembuatan profil percakapan AI percakapan dengan nomor telepon Google Telephony Platform (GTP) yang terkait.
- Buka Colab Enterprise Jika diminta, aktifkan Compute Engine, Dataform, dan Vertex API.
- Klik Impor notebook, lalu pilih URL sebagai sumber data. Masukkan URL repositori GitHub ini, lalu klik IMPORT.
- Di kolom
PROJECT_ID, masukkan Google Cloud project ID untuk project yang ingin Anda kaitkan dengan integrasi. Project yang ada dapat ditemukan di menu drop-down di bagian atas halaman di Konsol Cloud. - Masukkan region pilihan Anda di kolom
REGION. Semua wilayah 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. Saat diminta, izinkan notebook mengakses kredensial Google Anda.
- Luaskan bagian Mengonfigurasi Conversational AI untuk SIP/SIPREC. Di bagian Buat agen Dialogflow ES dummy..., klik Tampilkan kode dan jalankan kode tanpa membuat perubahan apa pun. Perintah ini membuat agen Dialogflow ES dummy dan menetapkan tingkatnya ke Enterprise. Agen Dialogflow ES dummy 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: 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 Agen Percakapan (Dialogflow CX) yang ingin Anda kaitkan dengan profil percakapan yang dihasilkan.
- Jalankan kode. Output akan mencakup nama
ConversationProfileyang dibuat, setelan keamanan, dan nomor telepon GTP. - Buka konsol Dialogflow ES
untuk memverifikasi bahwa agen bernama
Dummy_ES_agenttelah dibuat. Klik Setelan untuk memverifikasi bahwa agen dikaitkan dengan projectGoogle Cloud yang benar dan telah diupgrade ke edisi Essentials. - Buka
konsol Agent Assist.
Klik Profil percakapan di menu sebelah kiri untuk memverifikasi bahwa profil percakapan dengan
CONVERSATION_PROFILE_NAMEyang Anda masukkan telah dibuat. - Buka konsol Conversational AI Insights. Verifikasi bahwa semua transkrip percakapan yang terkait dengan agen Agen Percakapan (Dialogflow CX) Anda telah diimpor.
(Opsional) Minta penambahan kuota untuk durasi panggilan Dialogflow CX Phone Gateway
Langganan Dialogflow ES Essentials dan Agen Percakapan (Dialogflow CX) dilengkapi dengan kuota standar yang tersedia. Jika Anda tidak menggunakan Dialogflow sama sekali, misalnya hanya Agent Assist, Transkripsi, atau Perekaman Panggilan, kuota default Anda sama dengan kuota Dialogflow ES Essentials.
Anda memiliki opsi untuk meminta penambahan kuota jika diperlukan berdasarkan perkiraan 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
Anda dapat mengaktifkan pencatatan audit untuk Dialogflow API (dialogflow.googleapis.com) untuk Pembacaan Admin, Pembacaan Data, dan Penulisan Data. Dengan begitu, Anda dapat melihat semua panggilan Conversational AI API individual yang dilakukan dan kredensial yang digunakan untuk otorisasi dan penggunaan. Hal ini dapat berguna untuk pemecahan masalah dan proses debug.
Langkah berikutnya
Pelajari cara menyiapkan dan mengonfigurasi SBC.