Integrazione 3CX con Office 365 tramite API di Azure

Il PBX 3CX v16 edizioni Pro ed Enterprise offre la piena integrazione con gli applicativi Office 365. In particolare viene implementato:

• Sincronizzazione degli utenti di Office 365 e degli interni 3CX (utenti).
• Sincronizzazione dei contatti personali degli utenti Office e della rubrica personale 3CX.
• Sincronizzazione degli stati del calendario utente di Office 365 (occupato) e dello stato del numero di interno 3CX.   

Per effettuare chiamate in uscita dall'interfaccia web delle applicazioni Office, 3CX utilizza l'interno 3CX Clicca per chiamare per i browser Chrome и Firefox. Puoi anche utilizzare le scorciatoie da tastiera in Applicazione 3CX per Windows.

Per iniziare, avrai bisogno di un abbonamento a Office 3CX e delle credenziali di amministratore del portale Office con privilegi di "Amministratore globale".

Alcuni abbonamenti a Office 365 hanno un'integrazione limitata o assente con 3CX:

• Abbonamenti senza gestione degli utenti, ad es. tutti gli abbonamenti “domestici”.
• Gli abbonamenti senza Exchange non possono sincronizzare contatti e calendario (Office 365 Business e Office 365 Pro Plus).

I server Office 365 devono avere una connessione diretta al server 3CX per trasmettere stati in tempo reale. Se una connessione persistente non è possibile, 3CX eseguirà comunque la sincronizzazione giornaliera.

Tieni presente che la sincronizzazione viene eseguita solo in una direzione: da Office 365 a 3CX. Per una corretta sincronizzazione, gli utenti di Office 365 devono avere l'attributo "UserType" impostato su "Membro" (impostato in Active Directory). Se un utente sincronizzato da Office 365 viene eliminato o modificato tramite l'interfaccia 3CX, ritorna allo stato precedente durante la successiva sincronizzazione manuale o automatica.

Applicazione di autenticazione di Microsoft Azure

Primo passaggio di connessione Integrazione con Office 365 — creazione di un'applicazione individuale nel tuo account per autorizzare l'integrazione.

1. Nell'interfaccia di gestione 3CX, vai su Impostazioni - Office 365 - scheda Impostazioni - sezione Passaggio 3 e copia l'URL di reindirizzamento.
2. Accedi al portale di Office 365 con le credenziali di amministratore globale e vai a Registrazioni di applicazioni Microsoft Azure.
3. Fare clic su Nuova registrazione e specificare il nome dell'applicazione, ad esempio App 3CX PBX Office 365 Sync.
4. Nella sezione Tipi di account supportati, lascia l'opzione predefinita Solo account in questa directory dell'organizzazione
5. Nella sezione URI di reindirizzamento (opzionale), seleziona il tipo Web e incolla l'URI di reindirizzamento dalla sezione dell'interfaccia 3CX: Impostazioni > Integrazione Office 365 > scheda Impostazioni > Passaggio 3. Sezione Piattaforma e autorizzazioni, ad es. azienda.3cx.eu:5001/oauth2office2
6. Fare clic su Registra e l'applicazione verrà creata.
7. Si apre la pagina delle impostazioni per l'applicazione creata. Copia il valore dell'ID app (client) e incollalo dal campo appropriato nell'interfaccia di gestione 3CX, Impostazioni > Integrazione con Office 365 > scheda Opzioni > Passaggio 1. Configura l'ID app.

Chiavi di autenticazione

Ora devi stabilire un trust con chiave pubblica tra il tuo sistema 3CX v16 e l'applicazione creata nel portale Office 365.

1. Nell'interfaccia 3CX (Impostazioni > Integrazione Office 365 > scheda Opzioni), fai clic su Genera una nuova coppia di chiavi e salva la chiave public_key.pem.
2. Vai alla pagina delle impostazioni dell'applicazione nella sezione Certificati e segreti. Fare clic su Carica certificato e caricare la chiave generata.

Autorizzazioni dell'applicazione

Il passaggio finale della configurazione consiste nell'impostare le autorizzazioni API nella sezione Autorizzazioni API. Queste autorizzazioni determinano il modo in cui il tuo sistema 3CX può accedere al tuo account Office 365.

1. Vai ad Autorizzazioni API, fai clic su Aggiungi autorizzazione e seleziona Microsoft Graph.
2. Aggiungi le autorizzazioni API in Autorizzazioni applicazione: Calendari > Calendars.Read, Contatti > Contatti.Read, Directory > Directory.Read.All e fai clic su Aggiungi autorizzazioni.
3. Nella sezione Concedi il consenso, fai clic su Concedi il consenso dell'amministratore per... per abilitare le autorizzazioni.
4. Attendere circa 10 minuti affinché le modifiche abbiano effetto correttamente.
5. Passa all'interfaccia 3CX e nella sezione Integrazione con Office 365, clicca su Accedi a Office 365. Conferma i permessi per l'applicazione creata e verrà stabilita la connessione tra i sistemi.

Funzionalità di sincronizzazione

La sincronizzazione tra 3CX e Office 365 è configurata in tre schede:

• Sincronizzazione degli utenti: gli utenti di Office 365 vengono sincronizzati con gli utenti 3CX (interni). Nell'interfaccia di gestione 3CX, gli utenti sincronizzati vengono inseriti nel gruppo dell'organizzazione Azure AD.
• Sincronizzazione dei contatti - I contatti personali di Office 365 sono sincronizzati con la rubrica 3CX. L'utente vede questi contatti nelle applicazioni 3CX per tutte le piattaforme.
• Sincronizzazione del calendario - cambia automaticamente lo stato di un interno 3CX a seconda che sia occupato nel calendario di Office 365:

Dopo che un evento nel calendario di Office 365 è stato completato, anche lo stato dell'utente 3CX viene sincronizzato e riportato al suo stato precedente.

Tutti gli elementi di sincronizzazione possono essere configurati sia per tutti gli utenti di Office 365 che per gli utenti selezionati.

Questo completa l'integrazione.

Fonte: habr.com