Mengonfigurasi saluran email Anda untuk OAuth dengan Gmail

Halaman ini menjelaskan cara menggunakan Google Cloud untuk membuat kredensial OAuth guna mengonfigurasi saluran email Contact Center AI Platform (CCAI Platform).

Sebelum memulai

Pastikan Anda memiliki hal berikut:

• Akun Google Cloud . Untuk mengetahui informasi selengkapnya, lihat Mulai menggunakan Google Cloud.

• Project Google Cloud . Untuk informasi selengkapnya, lihat Membuat dan mengelola project.

Selain itu, pastikan penagihan diaktifkan untuk project Google Cloud Anda. Untuk informasi selengkapnya, lihat Memverifikasi status penagihan project Anda.

Membuat kredensial OAuth

Anda dapat menggunakan Google Cloud untuk membuat kredensial OAuth—client ID dan client secret. Jika belum mengonfigurasi layar izin, Anda harus melakukannya sebelum dapat membuat kredensial OAuth. Untuk mengetahui informasi selengkapnya tentang OAuth, lihat Menggunakan OAuth 2.0 untuk Mengakses Google API.

Untuk membuat kredensial OAuth dan mengonfigurasi layar izin, lakukan langkah berikut:

1. Di konsol Google Cloud , buka dasbor pemilih project, lalu pilih project yang ingin Anda gunakan untuk membuat kredensial OAuth.

   Dasbor pemilih project

2. Buka halaman API dan Layanan, lalu di menu navigasi, klik Kredensial.

   Kredensial

3. Jika Anda belum mengonfigurasi layar izin untuk project ini, tombol Configure consent screen akan muncul. Google CloudDalam hal ini, konfigurasi layar izin Anda menggunakan prosedur berikut. Jika tidak, lewati ke langkah 4.

   1. Klik Konfigurasi layar izin. Halaman OAuth consent screen akan ditampilkan.

   2. Bergantung pada kasus penggunaan Anda, pilih Internal atau Eksternal, lalu klik Buat. Panel Layar izin OAuth akan ditampilkan.

   3. Masukkan informasi di halaman Informasi aplikasi sesuai dengan petunjuk di layar, lalu klik Simpan dan lanjutkan. Panel Cakupan akan ditampilkan.

   4. Klik Tambahkan atau hapus cakupan. Panel Perbarui cakupan yang dipilih akan muncul.

   5. Pilih cakupan yang sesuai untuk kasus penggunaan Anda, lalu klik Perbarui.

   6. Klik Simpan dan lanjutkan. Panel Pengguna pengujian akan ditampilkan.

   7. Jika Anda ingin menambahkan pengguna untuk menguji akses ke aplikasi Anda, klik Tambahkan pengguna. Panel Tambahkan pengguna akan ditampilkan.

   8. Di kolom kosong, tambahkan satu atau beberapa alamat email dari Akun Google, lalu klik Tambahkan.

   9. Klik Simpan dan lanjutkan. Panel Ringkasan akan ditampilkan.

   10. Tinjau informasi layar izin OAuth Anda, lalu klik Kembali ke dasbor.

   11. Jika Anda ingin memublikasikan aplikasi ke produksi sekarang, klik Publikasikan aplikasi, lalu klik Konfirmasi di dialog konfirmasi. Layar izin Anda telah dikonfigurasi.

4. Pada menu navigasi, klik Kredensial.

5. Klik Buat kredensial, lalu klik ID klien OAuth.

6. Di kolom Application type, klik Web application.

7. Di kolom Name, masukkan nama untuk klien Anda.

8. Di area Authorized JavaScript origins, klik Add IRI.

9. Di kolom URIs, masukkan https://TENANT_NAME.ccaiplatform.com, dengan mengganti TENANT_NAME dengan nama tenant Anda.

10. Di area Authorized redirect URIs, klik Add URI.

11. Di kolom URI, masukkan https://TENANT_NAME.ccaiplatform.com/v1/email_accounts/oauth_callback, dengan mengganti TENANT_NAME dengan nama tenant Anda.

12. Klik Create. Dialog OAuth client created akan ditampilkan.

13. Klik Download JSON untuk mendownload file JSON yang berisi client ID dan secret klien Anda ke komputer, lalu klik OK.

    Penting: Simpan file JSON ini di tempat yang aman, karena berisi kredensial OAuth Anda.

Mendapatkan client ID dan rahasia klien Anda

Setelah membuat kredensial OAuth, Anda dapat memperoleh client ID dan client secret kapan saja.

Untuk mendapatkan client ID dan rahasia klien, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman APIs and Services. Di menu navigasi, klik Credentials.

   Kredensial

2. Di area Client ID OAuth 2.0, klik klien yang ID klien dan rahasia kliennya Anda inginkan. Client ID dan rahasia klien Anda ditampilkan di area Informasi tambahan.

Mengonfigurasi setelan SSO untuk saluran email

Gunakan client ID dan rahasia klien yang Anda buat di Buat kredensial OAuth untuk mengonfigurasi setelan single sign-on (SSO) untuk saluran email.

Untuk mengonfigurasi setelan SSO, lakukan hal berikut:

1. Di portal CCAI Platform, klik Menu, lalu klik Settings > Developer settings.

2. Buka panel Pengelolaan akun email, lalu klik Kelola akun email.

3. Di halaman Email account management, klik Email SSO.

4. Di panel Email SSO, konfigurasi setelan seperti yang ditunjukkan dalam daftar berikut:

   • URL otorisasi. Masukkan https://accounts.google.com/o/oauth2/v2/auth?prompt=select_account consent.

     Penting: Sertakan spasi sebelum consent.

   • URL Token. Masukkan https://oauth2.googleapis.com/token.

   • Client ID. Masukkan client ID yang Anda buat di Buat kredensial OAuth. Jika Anda tidak menyimpan ID klien, lihat Mendapatkan ID klien dan Rahasia klien.

   • Client secret. Masukkan rahasia klien yang Anda buat di Buat kredensial OAuth. Jika Anda tidak menyimpan rahasia klien, lihat Mendapatkan client ID dan rahasia klien Anda.

   • Cakupan. Masukkan https://mail.google.com/.

   • State. Kosongkan kolom ini.

   • Jenis akses. Masukkan offline.

   • Jenis hibah. Masukkan Authorization Code.

   • Hapus centang pada kotak Include the Grant Type as part of the Authorization URL and Token URL.

   • Centang kotak Sertakan URL Pengalihan sebagai bagian dari URL Otorisasi dan URL Token, lalu klik Simpan. Saluran email Anda dikonfigurasi untuk OAuth.