Profil OAuth email memungkinkan Anda mengelola setelan OAuth untuk akun email di Contact Center AI Platform (CCAI Platform). Daripada menggunakan satu konfigurasi OAuth global untuk semua akun IMAP OAuth, Anda dapat membuat profil OAuth email terpisah dan menautkan setiap akun email ke profil yang harus digunakannya.
Untuk Microsoft 365, profil OAuth email mendukung jenis pemberian kredensial klien. Jenis pemberian ini melakukan autentikasi di tingkat aplikasi, bukan mengandalkan
login pengguna individual. Fitur ini sangat berguna untuk kotak surat bersama, seperti support@company.com, karena akses tidak bergantung pada sandi, sesi izin, atau status kepegawaian satu pengguna admin.
Halaman ini menunjukkan cara menyiapkan profil OAuth email untuk Microsoft 365, menggunakan kredensial klien.
Kode otorisasi versus kredensial klien
CCAI Platform mendukung jenis pemberian kredensial klien dan kode otorisasi OAuth untuk akun email. Tabel berikut membandingkan jenis pemberian ini:
| Jenis hibah | Paling cocok untuk | Cara kerjanya |
|---|---|---|
| Kode otorisasi | Kotak surat khusus pengguna | Administrator atau pengguna kotak surat login melalui alur pemberian izin Microsoft OAuth. |
| Kredensial klien | Kotak surat Microsoft 365 yang dikelola bersama atau aplikasi | CCAI Platform menggunakan pendaftaran aplikasi, secret klien, dan izin tingkat instance untuk meminta akses tanpa login pengguna interaktif. |
Setiap profil OAuth email menggunakan satu jenis pemberian izin. Jika organisasi Anda memerlukan jenis pemberian izin, penyedia, atau konfigurasi kotak surat yang berbeda, buat profil OAuth email terpisah dan tautkan setiap akun email ke profil yang sesuai.
Sebelum memulai
Pastikan Anda memiliki hal berikut:
Instance Microsoft 365.
Akses administrator Microsoft Entra.
Akun administrator Platform CCAI dengan izin untuk mengelola setelan email.
PowerShell diinstal secara lokal.
Modul PowerShell
ExchangeOnlineManagementtelah diinstal.ID instance Microsoft untuk direktori Anda.
Anda juga perlu mengetahui kotak surat mana yang harus diakses CCAI Platform.
Membuat pendaftaran aplikasi Microsoft Entra
CCAI Platform menggunakan pendaftaran aplikasi Microsoft Entra untuk meminta token OAuth untuk akses email Microsoft 365.
Untuk membuat pendaftaran aplikasi Microsoft Entra, ikuti langkah-langkah berikut:
Di Microsoft Azure, buka Microsoft Entra ID > App registrations.
Pilih Pendaftaran baru.
Masukkan nama yang jelas untuk aplikasi, seperti CCAI Platform Email OAuth.
Selesaikan pendaftaran.
Salin Application (client) ID.
Salin ID Direktori (tenant).
Gunakan nilai ini saat Anda membuat profil OAuth email.
Buat rahasia klien
Untuk membuat secret klien, ikuti langkah-langkah berikut:
Di pendaftaran aplikasi, buka Certificates & secrets.
Buat rahasia klien baru.
Segera salin nilai rahasia.
Menambahkan izin Microsoft API
Aplikasi memerlukan izin untuk mengakses dan mengirim email melalui Exchange Online.
Untuk menambahkan izin Microsoft API, ikuti langkah-langkah berikut:
Di pendaftaran aplikasi, buka API permissions.
Pilih Tambahkan izin.
Pilih Office 365 Exchange Online.
Pilih Izin aplikasi.
Tambahkan izin yang diperlukan:
IMAP.AccessAsAppSMTP.SendAsApp
Jika Anda ingin CCAI Platform menampilkan kotak surat Microsoft 365 yang tersedia di menu drop-down, tambahkan izin aplikasi Microsoft Graph yang diperlukan untuk mencantumkan pengguna atau kotak surat untuk instance Anda.
Pilih Grant admin consent for your organization.
Konfirmasi bahwa izin ditampilkan sebagai diberikan sebelum melanjutkan.
Memberi aplikasi akses ke kotak surat
Setelah aplikasi memiliki izin tingkat instance, berikan akses ke kotak surat tertentu yang harus dihubungkan oleh CCAI Platform.
Untuk memberikan akses aplikasi ke kotak surat, ikuti langkah-langkah berikut:
Buka PowerShell.
Hubungkan ke Exchange Online:
Connect-ExchangeOnline -Organization TENANT_IDGanti
TENANT_IDdengan ID Direktori Microsoft 365 (tenant) Anda.Daftarkan principal layanan di Exchange:
New-ServicePrincipal ` -AppId APPLICATION_CLIENT_ID ` -ObjectId OBJECT_IDGanti kode berikut:
APPLICATION_CLIENT_ID: ID Aplikasi (klien) dari pendaftaran aplikasi Microsoft Entra AndaOBJECT_ID: ID objek dari aplikasi Enterprise
Memberikan akses kotak surat:
Add-MailboxPermission ` -Identity EMAIL_ADDRESS ` -User SERVICE_PRINCIPAL_ID ` -AccessRights FullAccessGanti kode berikut:
EMAIL_ADDRESS: alamat email kotak surat yang harus diakses oleh Platform CCAISERVICE_PRINCIPAL_ID: ID akun utama layanan
Membuat profil OAuth email di Platform CCAI
Untuk membuat profil OAuth email bagi konfigurasi kredensial klien Microsoft 365, ikuti langkah-langkah berikut:
Di portal Platform CCAI, klik Setelan > Setelan Developer. Jika Anda tidak melihat menu Setelan, klik Menu.
Buka panel Email Account Management, lalu klik Manage Email Account. Halaman Pengelolaan Akun Email akan muncul.
Klik tab Email OAuth.
Klik Tambahkan Profil.
Di kolom Name, masukkan nama profil.
Di daftar Grant Type, pilih Client Credentials.
Di kolom Token URL, masukkan endpoint token Microsoft OAuth untuk instance Anda.
Di kolom Client ID, masukkan ID Aplikasi (klien) dari Microsoft Entra.
Di kolom Client secret, masukkan nilai rahasia klien dari Microsoft Entra.
Di kolom Audience, masukkan audiens.
Di kolom Cakupan, masukkan cakupan.
Di kolom Negara bagian, masukkan negara bagian.
Di kolom Access Type, masukkan jenis akses.
Klik Simpan.
Menautkan akun email ke profil OAuth
Untuk menautkan akun email ke profil OAuth, ikuti langkah-langkah berikut:
Di portal Platform CCAI, klik Setelan > Setelan Developer. Jika Anda tidak melihat menu Setelan, klik Menu.
Buka panel Email Account Management, lalu klik Manage Email Account. Halaman Pengelolaan Akun Email akan muncul.
Klik tab Daftar akun email.
Untuk akun email yang ingin Anda edit, klik , lalu klik Edit akun email.
Pada daftar Email service, pilih OAuth IMAP.
Dalam daftar OAuth Profile, pilih profil OAuth yang Anda buat dalam prosedur sebelumnya.
Klik Tautkan.
Di daftar ID Email, pilih kotak surat Anda.
Klik Simpan.
Penautan mengonfirmasi bahwa CCAI Platform dapat melakukan autentikasi dengan profil OAuth yang dipilih. Pilihan kotak surat memberi tahu CCAI Platform kotak surat mana yang harus digunakan oleh akun email.
Jika CCAI Platform tidak dapat mengambil daftar kotak surat dari Microsoft, formulir akan kembali ke entri alamat email manual. Masukkan alamat kotak surat secara manual, lalu simpan akun.
Pemecahan masalah
| Masalah | Resolusi |
|---|---|
| Daftar kotak surat tidak dimuat | Pastikan aplikasi Microsoft memiliki izin Microsoft Graph dan izin administrator yang diperlukan. Anda dapat memasukkan kotak surat secara manual jika drop-down tidak tersedia. |
| Penautan gagal karena error autentikasi | Konfirmasi bahwa URL token, ID instance, rahasia klien, dan ID klien sudah benar. Selain itu, pastikan masa berlaku rahasia klien belum berakhir. |
| Kotak surat tidak dapat mengirim atau menerima email | Pastikan aplikasi memiliki izin kotak surat di Exchange Online dan akun email ditautkan ke profil OAuth email yang benar. |