Mengaktifkan Customer Experience Insights

Sebelum menggunakan Customer Experience Insights (CX Insights) untuk menganalisis data percakapan, Anda harus mengaktifkan API tertentu.

Dalam panduan memulai ini, Anda akan menyelesaikan tindakan berikut:

  1. Aktifkan API:

  2. Mengirim permintaan ke Contact Center AI Insights API dan menerima respons.

  3. Secara opsional, gunakan CX Insights dengan Kontrol Layanan VPC.

Sebelum memulai

Batasan keamanan yang ditentukan oleh organisasi mungkin mencegah Anda menyelesaikan langkah-langkah berikut. Untuk mengetahui informasi pemecahan masalah, lihat Mengembangkan aplikasi di lingkungan Google Cloud yang terbatas.

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the Cloud Speech-to-Text, Cloud Storage, Contact Center AI Insights, Dialogflow, and Sensitive Data Protection (DLP) APIs.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

Mengirim permintaan dan menerima respons

  1. Instal dan siapkan Google Cloud CLI. Anda dapat menyiapkan gcloud CLI di salah satu lingkungan pengembangan berikut:

    Cloud Shell

    Untuk menggunakan terminal online dengan gcloud CLI yang sudah disiapkan, aktifkan Cloud Shell:

    Di bagian bawah halaman ini, sesi Cloud Shell akan dimulai dan menampilkan perintah command line. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.

    Shell lokal

    Untuk menggunakan lingkungan pengembangan lokal, ikuti langkah-langkah berikut:

    1. Instal gcloud CLI.
    2. Lakukan inisialisasi gcloud CLI.

  2. Buat kredensial autentikasi lokal untuk akun pengguna Anda: 

    gcloud auth application-default login

    Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, konfirmasi bahwa Anda telah login ke gcloud CLI dengan identitas gabungan Anda.

  3. Verifikasi penyiapan Anda dengan menjalankan perintah berikut, yang mencantumkan semua percakapan CX Insights Anda.

    curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/conversations"

    Ganti kode berikut:

    • PROJECT_ID: Google Cloud Project ID Anda.
    • LOCATION: region tempat Anda menjalankan permintaan ini.

    Perintah akan menampilkan kamus kosong: {}.

Opsional: Menggunakan CX Insights dengan Kontrol Layanan VPC

Untuk menggunakan CX Insights dengan Kontrol Layanan VPC, tambahkan CX Insights ke perimeter keamanan Anda. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Kontrol Layanan VPC.

Langkah berikutnya