Integrasi 3CX dengan Office 365 melalui Azure API

Edisi PBX 3CX v16 Pro dan Enterprise menawarkan integrasi penuh dengan aplikasi Office 365. Secara khusus, hal berikut ini diterapkan:

• Sinkronisasi pengguna Office 365 dan ekstensi 3CX (pengguna).
• Sinkronisasi kontak pribadi pengguna Office dan buku alamat pribadi 3CX.
• Sinkronisasi status kalender pengguna Office 365 (sibuk) dan status nomor ekstensi 3CX.   

Untuk melakukan panggilan keluar dari antarmuka web aplikasi Office, 3CX menggunakan ekstensi 3CX Klik untuk Menelepon untuk browser Chrome и Firefox. Anda juga dapat menggunakan pintasan keyboard di Aplikasi 3CX untuk Windows.

Untuk memulai, Anda memerlukan langganan Office 3CX dan kredensial administrator portal Office dengan hak istimewa "Administrator Global".

Beberapa langganan Office 365 memiliki integrasi terbatas atau tidak sama sekali dengan 3CX:

• Langganan tanpa manajemen pengguna, mis. semua langganan “rumah”.
• Langganan tanpa Exchange tidak dapat menyinkronkan kontak dan kalender (Office 365 Business dan Office 365 Pro Plus).

Server Office 365 harus memiliki koneksi langsung ke server 3CX Anda untuk mengirimkan status waktu nyata. Jika koneksi persisten tidak memungkinkan, 3CX akan tetap melakukan sinkronisasi harian.

Harap dicatat bahwa sinkronisasi dilakukan hanya dalam satu arah - dari Office 365 ke 3CX. Agar sinkronisasi berhasil, pengguna Office 365 harus menyetel atribut "UserType" ke "Member" (diatur di Direktori Aktif). Jika pengguna yang disinkronkan dari Office 365 dihapus atau diubah melalui antarmuka 3CX, pengguna akan kembali ke keadaan sebelumnya selama sinkronisasi manual atau otomatis berikutnya.

Aplikasi Otentikasi Microsoft Azure

Langkah koneksi pertama Integrasi Office 365 — pembuatan aplikasi individual di akun Anda untuk mengotorisasi integrasi.

1. Di antarmuka manajemen 3CX, buka bagian Pengaturan - Office 365 - tab Pengaturan - Langkah 3 dan salin URL Pengalihan.
2. Masuk ke portal Office 365 dengan kredensial Administrator Global Anda dan masuk ke Pendaftaran Aplikasi Microsoft Azure.
3. Klik Pendaftaran baru dan tentukan nama aplikasi, misalnya Aplikasi Sinkronisasi 3CX PBX Office 365.
4. Di bagian Jenis akun yang didukung, biarkan opsi default Akun di direktori organisasi ini saja
5. Di bagian Redirect URI (opsional), pilih jenis Web dan tempelkan URI pengalihan dari bagian antarmuka 3CX: Pengaturan > Integrasi Office 365 > tab Pengaturan > Langkah 3. Bagian platform dan izin, misalnya. perusahaan.3cx.eu:5001/oauth2office2
6. Klik Daftar dan aplikasi akan dibuat.
7. Halaman pengaturan untuk aplikasi yang dibuat akan terbuka. Salin nilai ID Aplikasi (Klien) dan tempelkan dari bidang yang sesuai di antarmuka manajemen 3CX, Pengaturan > Integrasi Office 365 > tab Opsi > Langkah 1. Konfigurasikan ID Aplikasi.

Kunci otentikasi

Sekarang Anda perlu membangun kepercayaan kunci publik antara sistem 3CX v16 Anda dan aplikasi yang dibuat di portal Office 365.

1. Di antarmuka 3CX (Pengaturan > Integrasi Office 365 > tab Opsi), klik Buat pasangan kunci baru dan simpan kunci public_key.pem.
2. Buka halaman pengaturan aplikasi di bagian Sertifikat dan rahasia. Klik Unggah Sertifikat dan unggah kunci yang dihasilkan.

Izin Aplikasi

Langkah penyiapan terakhir adalah mengatur izin API di bagian Izin API. Izin ini menentukan bagaimana sistem 3CX Anda dapat mengakses akun Office 365 Anda.

1. Buka Izin API, klik Tambahkan Izin dan pilih Microsoft Graph.
2. Tambahkan izin API pada Izin Aplikasi: Kalender > Kalender.Baca, Kontak > Kontak.Baca, Direktori > Direktori.Baca.Semua dan klik Tambahkan Izin.
3. Di bagian Berikan Persetujuan, klik Berikan Persetujuan Administrator untuk... untuk mengaktifkan izin.
4. Tunggu sekitar 10 menit hingga perubahan diterapkan dengan benar.
5. Beralih ke antarmuka 3CX dan di bagian Integrasi dengan Office 365, klik Masuk ke Office 365. Konfirmasikan izin untuk aplikasi yang dibuat dan koneksi antar sistem akan dibuat.

Kemampuan sinkronisasi

Sinkronisasi antara 3CX dan Office 365 dikonfigurasi dalam tiga tab:

• Sinkronisasi pengguna - Pengguna Office 365 disinkronkan dengan pengguna 3CX (ekstensi). Di antarmuka manajemen 3CX, pengguna yang disinkronkan ditempatkan di grup organisasi Azure Active Directory.
• Sinkronisasi kontak - Kontak pribadi Office 365 disinkronkan dengan buku alamat 3CX. Pengguna melihat kontak ini di aplikasi 3CX untuk semua platform.
• Sinkronisasi kalender - secara otomatis mengubah status ekstensi 3CX bergantung pada apakah ekstensi tersebut sibuk di kalender Office 365:

Setelah acara di kalender Office 365 selesai, status pengguna 3CX juga disinkronkan dan dikembalikan ke keadaan sebelumnya.

Semua elemen sinkronisasi dapat dikonfigurasi untuk semua pengguna Office 365 dan pengguna terpilih.

Ini menyelesaikan integrasi.

Sumber: www.habr.com