Integrazione 3CX cù Office 365 via API Azure

L'edizioni PBX 3CX v16 Pro è Enterprise offre una integrazione completa cù l'applicazioni Office 365. In particulare, i seguenti sò implementati:

• Sincronizazione di l'utilizatori di Office 365 è estensioni 3CX (utilizatori).
• Sincronizazione di cuntatti persunali di l'utilizatori di l'Office è u libru di indirizzu persunale 3CX.
• Sincronizazione di i stati di u calendariu di l'utilizatori di Office 365 (occupatu) è u statutu di u numeru di estensione 3CX.   

Per fà e chjama in uscita da l'interfaccia web di l'applicazioni Office, 3CX usa l'estensione 3CX Cliccate per chjamà per i navigatori Chrome и brumann. Pudete ancu aduprà scurciate di tastiera in Applicazione 3CX per Windows.

Per cumincià, avete bisognu di un abbonamentu à l'Office 3CX è di e credenziali di l'amministratore di u portale Office cù privilegi "Amministratore Globale".

Certi abbonamenti Office 365 anu una integrazione limitata o nulla cù 3CX:

• Abbonamenti senza gestione di l'utilizatori, i.e. tutti l'abbonamenti "casa".
• L'abbonamenti senza Exchange ùn ponu micca sincronizà i cuntatti è u calendariu (Office 365 Business è Office 365 Pro Plus).

I servitori Office 365 deve avè una cunnessione diretta à u vostru servitore 3CX per trasmette stati in tempu reale. Se una cunnessione persistente ùn hè micca pussibule, 3CX hà da fà sempre a sincronizazione di ogni ghjornu.

Per piacè nutate chì a sincronizazione hè realizata in una sola direzzione - da Office 365 à 3CX. Per una sincronizazione successu, l'utilizatori di Office 365 anu da avè l'attributu "UserType" impostatu à "Membru" (impostatu in Active Directory). Se un utilizatore sincronizatu da Office 365 hè sguassatu o mudificatu attraversu l'interfaccia 3CX, torna à u statu precedente durante a prossima sincronizazione manuale o automatica.

Applicazione di autenticazione Microsoft Azure

U primu passu di cunnessione Integrazione di Office 365 - creazione di una applicazione individuale in u vostru contu per autorizà l'integrazione.

1. In l'interfaccia di gestione 3CX, andate in Settings - Office 365 - Settings tab - Step 3 section è copiate l'URL di redirezzione.
2. Accedi à u portale Office 365 cù e vostre credenziali di Amministratore Globale è andate à Registrazioni di l'applicazione Microsoft Azure.
3. Cliccate New registration è specificate u nome di l'applicazione, per esempiu, 3CX PBX Office 365 Sync App.
4. In a sezione Tipi di cunti supportati, lasciate l'opzione predeterminata Accounts in questu repertoriu di l'urganizazione solu
5. In a sezione Redirect URI (opcional), selezziunate u tipu Web è incollà l'URI di redirect da a sezione di l'interfaccia 3CX: Settings> Office 365 Integration> Settings tab> Step 3. Platform and Permissions section, p.e. cumpagnia.3cx.eu: 5001/oauth2office2
6. Cliccate Registrate è l'applicazione serà creata.
7. A pagina di paràmetri per l'applicazione creata si apre. Copia u valore App ID (Client) è incollà da u campu appropritatu in l'interfaccia di gestione 3CX, Settings> Office 365 Integration> Options tab> Step 1. Configure the App ID.

Chjavi di autenticazione

Avà avete bisognu di stabilisce una fiducia di chjave publica trà u vostru sistema 3CX v16 è l'applicazione creata in u portale Office 365.

1. In l'interfaccia 3CX (Settings> Office 365 Integration> Opzioni tab), cliccate Generate a new key pair and save the public_key.pem key.
2. Andà à a pagina di paràmetri di l'applicazione in a sezione Certificati è Secrets. Cliccate Carica Certificatu è caricate a chjave generata.

Permessi di l'applicazione

L'ultimu passu di cunfigurazione hè di stabilisce i permessi API in a sezione Permissions API. Questi permessi determinanu cumu u vostru sistema 3CX pò accede à u vostru contu Office 365.

1. Andate à API Permissions, cliccate Add Permission è selezziunate Microsoft Graph.
2. Aghjunghjite permessi API sottu Permessi di l'applicazione: Calendari> Calendari.Leghjite, Cuntatti> Contacts.Read, Directory> Directory.Read.All è cliccate Add Permissions.
3. In a sezione Concede Consensu, cliccate Concede Consensu di l'Amministratore per ... per attivà i permessi.
4. Aspettate circa 10 minuti per i cambiamenti per avè effettu currettamente.
5. Cambia à l'interfaccia 3CX è in a sezione Integrazione cù Office 365, cliccate Sign in Office 365. Confirmate i permessi per l'applicazione creata è a cunnessione trà i sistemi serà stabilitu.

Capacità di sincronizazione

A sincronizazione trà 3CX è Office 365 hè cunfigurata in trè tabulazioni:

• Sincronizazione di l'utilizatori - L'utilizatori di l'Office 365 sò sincronizati cù l'utilizatori 3CX (estensioni). In l'interfaccia di gestione 3CX, l'utilizatori sincronizati sò posti in u gruppu d'urganizazione Azure AD.
• Sincronizazione di cuntatti - I cuntatti persunali di l'Office 365 sò sincronizati cù u libru di indirizzu 3CX. L'utilizatore vede questi cuntatti in l'applicazioni 3CX per tutte e plataforme.
• Sincronizazione di u calendariu - cambia automaticamente u statutu di una estensione 3CX secondu s'ellu hè occupatu in u calendariu Office 365:

Dopu chì un avvenimentu in u calendariu Office 365 hè cumpletu, u statutu di l'utilizatori 3CX hè ancu sincronizatu è tornatu à u so statu precedente.

Tutti l'elementi di sincronizazione ponu esse cunfigurati per tutti l'utilizatori di Office 365 è per l'utilizatori selezziunati.

Questu cumpleta l'integrazione.

Source: www.habr.com