Mengonfigurasi saluran email Anda untuk OAuth dengan Microsoft Office 365

Dokumen ini menunjukkan cara mengonfigurasi saluran email Contact Center AI Platform (CCAI Platform) untuk mendukung Microsoft OAuth.

Prasyarat

  1. Akun Azure dengan langganan aktif. Akun tersebut harus memiliki akses pengelolaan Microsoft Entra, sehingga harus dikonfigurasi sebagai salah satu peran berikut:

    • Administrator aplikasi
    • Developer aplikasi
    • Administrator aplikasi cloud

  2. Tenant Microsoft Entra. Lihat panduan memulai Microsoft untuk mengetahui petunjuk tentang cara membuat tenant.

Pastikan akun email mengizinkan IMAP &SMTP

CCAI Platform menggunakan IMAP dan SMTP untuk mengirim dan menerima email dari Microsoft. Karena akun Microsoft dapat terhubung ke program yang berbeda, penting untuk memastikan bahwa IMAP atau SMTP tidak diblokir oleh program sekunder lainnya. Langkah-langkah berikut akan memandu Anda melalui beberapa tempat umum untuk diperiksa di Microsoft.

  1. Buka Pengguna > Pengguna aktif di panel navigasi sebelah kiri.

  2. Pilih pengguna untuk diverifikasi.

  3. Klik Email. Jika Anda melihat "Pengguna ini tidak memiliki lisensi Exchange Online", Anda harus memberikan lisensi yang tepat kepada pengguna untuk menggunakan Exchange. Tanpa lisensi yang tepat, CCAI Platform tidak akan dapat mengirim atau menerima email untuk akun pengguna ini.

  4. Setelah lisensi yang tepat ditambahkan, pilih Kelola aplikasi email di tab Email. Pastikan IMAP dan SMTP yang Diautentikasi dicentang.

  5. Klik Simpan.

  6. Buka Kotak surat di panel navigasi sebelah kiri.

  7. Pilih akun pengguna yang ingin Anda periksa.

  8. Di tab Umum, pilih Kelola setelan aplikasi email. Pastikan tombol IMAP diaktifkan.

Mendaftarkan aplikasi

  1. Login ke pusat admin Microsoft Entra. Jika Anda memiliki beberapa tenant, gunakan filter Direktori + Langganan untuk beralih ke tenant yang benar.

  2. Buka Identitas > Aplikasi > Pendaftaran aplikasi > Pendaftaran baru.

  3. Masukkan Nama tampilan yang dapat diidentifikasi. Beberapa pendaftaran aplikasi dapat menggunakan nama yang sama. ID klien adalah yang digunakan program untuk mengidentifikasi aplikasi. Namun, karena pengguna program dapat melihat nama yang Anda buat, memberikan nama yang unik dapat mempercepat pendaftaran.

  4. Tentukan jenis akun yang dapat menggunakan aplikasi, atau audiens login. Beberapa jenis akun didukung:

    1. Akun hanya di direktori organisasi ini: Pilih opsi ini jika Anda membuat aplikasi untuk digunakan hanya oleh pengguna (atau tamu) dalam satu tenant. Hal ini terkadang disebut sebagai aplikasi lini bisnis (LOB).

    2. Akun di direktori organisasi mana pun: Pilih opsi ini jika Anda ingin pengguna di tenant mana pun dapat menggunakan aplikasi ini. Opsi ini lebih disukai untuk konfigurasi multi-tenant.

    3. Akun di direktori organisasi mana pun dan akun Microsoft pribadi: Pilih opsi ini jika Anda ingin pengguna di tenant mana pun dapat menggunakan aplikasi ini, serta pengguna yang memiliki akun Microsoft pribadi .

    4. Akun Microsoft pribadi: Pilih opsi ini jika Anda hanya ingin membuat aplikasi untuk pengguna yang memiliki akun Microsoft pribadi. Mencakup akun Microsoft, Skype, Xbox, Live, dan Hotmail.

  5. Untuk URI Pengalihan, pilih Web dan masukkan https://{tenant}.ccaiplatform.com/v1/email_accounts/oauth_callback. Ganti {tenant}` dengan nama tenant CCAI Platform Anda.

  6. Klik Daftar untuk menyelesaikan pendaftaran aplikasi awal.

  7. Setelah pendaftaran selesai, Anda akan melihat layar Ringkasan. Perhatikan informasi berikut, yang akan Anda perlukan saat menyelesaikan proses di CCAI Platform:

    • ID Aplikasi (klien)
    • ID Direktori (tenant)

Mengaktifkan aplikasi

  1. Login ke pusat admin Microsoft Entra.

  2. Buka Identitas > Aplikasi > Aplikasi Perusahaan , lalu pilih aplikasi.

  3. Buka Properti.

  4. Ubah Dapat dilihat oleh pengguna? menjadi Ya.

Menambahkan kredensial aplikasi

Buat rahasia klien untuk digunakan di platform CCAI Platform.

  1. Login ke pusat admin Microsoft Entra.

  2. Buka Identitas > Aplikasi > Pendaftaran aplikasi , lalu pilih aplikasi.

  3. Buka Sertifikat & rahasia > Rahasia klien > Rahasia klien baru. Tindakan ini akan membuka panel untuk memberi nama rahasia.

  4. Tambahkan deskripsi untuk rahasia klien.

  5. Pilih tanggal habis masa berlaku untuk rahasia, atau tentukan masa aktif kustom. Masa aktif rahasia klien dibatasi hingga dua tahun (24 bulan) atau kurang. Namun, Microsoft merekomendasikan untuk menetapkan nilai masa berlaku kurang dari 12 bulan.

  6. Klik Tambahkan. Catat nilai rahasia. Anda akan memerlukannya untuk menyelesaikan proses di CCAI Platform.

Menambahkan izin API

Graph API memungkinkan token akses berfungsi dengan IMAP, yang diperlukan untuk operasi saluran email CCAI Platform.

  1. Login ke pusat admin Microsoft Entra.

  2. Buka Identitas > Aplikasi > Pendaftaran aplikasi , lalu pilih aplikasi.

  3. Pilih Izin API > Tambahkan izin.

  4. Pilih Microsoft Graph.

  5. Pilih Izin yang didelegasikan. Gunakan kolom penelusuran Pilih izin untuk melakukan penelusuran berikut dan centang kotak di samping hasil yang tepat:

    • IMAP: Centang IMAP.AccessAsUser.All
    • offline: Centang offline_access
    • openid: Centang openid
    • smtp: SMTP.Send

  6. Klik Add permissions.

Menambahkan kredensial ke CCAI Platform

Setelah penyiapan Microsoft selesai, gunakan informasi dari proses penyiapan untuk menyelesaikan koneksi antara kedua program di CCAI Platform. Buka Setelan > Pengelolaan Akun Email > SO Email , lalu masukkan informasi berikut:

Jenis Akses: kosongkan.

URL Otorisasi: https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/authorize. {tenant_id} adalah ID Direktori (tenant) dari aplikasi Microsoft.

URL Token: https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token. {tenant_id} adalah ID Direktori (tenant) dari aplikasi Microsoft.

ID Klien: ID Aplikasi (klien) dari aplikasi Microsoft.

Rahasia Klien: Nilai Rahasia Klien dari aplikasi Microsoft.

Cakupan: Masukkan nilai berikut. Nilai tersebut tidak perlu dipisahkan dengan koma, tetapi semuanya harus ada.

  • openid email offline_access
  • https://outlook.office.com/IMAP.AccessAsUser.All
  • https://outlook.office.com/SMTP.Send

Status: kosongkan.

Jenis Akses: kosongkan.

Jenis Pemberian: Kode Otorisasi

Hapus centang "Sertakan Jenis Pemberian sebagai bagian dari URL Otorisasi dan URL Token".

Centang "Sertakan URL Pengalihan sebagai bagian dari URL Otorisasi dan URL Token".

Klik Simpan.