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 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

Platform CCAI menggunakan IMAP dan SMTP untuk mengirim dan menerima email dari Microsoft. Karena akun Microsoft dapat dihubungkan ke berbagai program, Anda harus memastikan bahwa IMAP atau SMTP tidak diblokir oleh program sekunder lainnya. Langkah-langkah berikut akan memandu Anda memeriksa beberapa tempat umum di Microsoft.

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

  2. Pilih pengguna yang akan diverifikasi.

  3. Klik Mail. Jika Anda melihat "Pengguna ini tidak memiliki lisensi Exchange Online", berarti Anda harus memberi pengguna lisensi yang tepat untuk menggunakan Exchange. Tanpa lisensi yang tepat, Platform CCAI 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 kiri.

  7. Pilih akun pengguna yang ingin Anda periksa.

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

Daftarkan aplikasi

  1. Login ke pusat administrator Microsoft Entra. Jika Anda memiliki beberapa tenant, gunakan filter Directories + Subscriptions untuk beralih ke tenant yang benar.

  2. Buka Identity > Applications > App registrations > New registration.

  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 telah 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. Accounts in this organizational directory only: Pilih opsi ini jika Anda membuat aplikasi untuk digunakan hanya oleh pengguna (atau tamu) di 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. Catat informasi berikut, yang akan Anda perlukan saat menyelesaikan proses di Platform CCAI:

    • ID Aplikasi (klien)
    • Directory (tenant) ID

Aktifkan aplikasi

  1. Login ke pusat administrator Microsoft Entra.

  2. Buka Identity > Applications > Enterprise Applications, lalu pilih aplikasi.

  3. Buka Properti.

  4. Alihkan Terlihat oleh pengguna? ke Ya.

Menambahkan kredensial aplikasi

Buat rahasia klien untuk digunakan di platform CCAI Platform.

  1. Login ke pusat administrator Microsoft Entra.

  2. Buka Identity > Applications > App registrations, lalu pilih aplikasi.

  3. Buka Certificates & secrets > Client secrets > New client secret. Langkah ini akan membuka panel agar Anda dapat memberi nama secret.

  4. Tambahkan deskripsi untuk rahasia klien.

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

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

Menambahkan izin API

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

  1. Login ke pusat administrator Microsoft Entra.

  2. Buka Identity > Applications > App registrations, lalu pilih aplikasi.

  3. Pilih API permissions > Add a permission.

  4. Pilih Microsoft Graph.

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

    • IMAP: Periksa IMAP.AccessAsUser.All
    • offline: Periksa offline_access
    • openid: Periksa 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 Platform CCAI. Buka Setelan > Pengelolaan Akun Email > Email SO dan masukkan informasi berikut:

Jenis Akses: biarkan kosong.

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.

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

Rahasia Klien: Nilai Rahasia Klien dari aplikasi Microsoft.

Cakupan: Masukkan nilai berikut. 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

Negara bagian: biarkan kosong.

Jenis Akses: biarkan kosong.

Grant Type: Authorization Code

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

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

Klik Simpan.