Integrasjon av 3CX med Office 365 via Azure API

3CX v16 Pro og Enterprise utgaver tilbyr full integrasjon med Office 365-applikasjoner. Spesielt er følgende implementert:

• Synkronisering av Office 365-brukere og tilleggstelefonnumre (brukere) i 3CX.
• Synkronisering av personlige kontakter fra Office-brukere og 3CXs personlige adressebok.
• Synkronisering av status (opptatthet) i Office 365-kalenderen og statusen for tilleggstelefonnummeret i 3CX.   

For å foreta utgående anrop fra nettgrensesnittet til Office-applikasjoner, bruker 3CX utvidelsen 3CX Klikk for å ringe for nettlesere Chrome og Firefox. Det er også mulig å bruke hurtigtaster i 3CX-applikasjonen for Windows.

For å komme i gang, trenger du et abonnement på Office 3CX og administratorlegitimasjon fra Office-portalen med 'Global Administrator'-rettigheter.

Noen Office 365-abonnementer har begrenset mulighet for integrasjon med 3CX eller har ikke det i det hele tatt:

• Abonnementer uten brukeradministrasjon, dvs. alle 'hjemme'-abonnementer.
• Abonnementer uten Exchange kan ikke synkronisere kontakter og kalender (Office 365 Business og Office 365 Pro Plus).

Office 365-servere må ha en direkte forbindelse til 3CX-serveren din for å overføre status i sanntid. Hvis det ikke er mulig å opprettholde en konstant tilkobling, vil 3CX fortsatt utføre daglig synkronisering.

Vær oppmerksom på at synkroniseringen kun skjer i én retning — fra Office 365 til 3CX. For at synkroniseringen skal lykkes, må Office 365-brukere ha attributtet 'UserType' satt til 'Member' (setter i Active Directory). Hvis en synkronisert bruker fra Office 365 blir fjernet eller modifisert via 3CX-grensesnittet, vil den gå tilbake til sin tidligere tilstand ved neste manuelle eller automatiske synkronisering.

Microsoft Azure autentiseringsapplikasjon

Den første trinnet for å koble Office 365-integrasjon er å opprette en individuell applikasjon i kontoen din for autorisasjon av integrasjonen.

1. I 3CX-administrasjonsgrensesnittet, gå til Innstillinger — Office 365 — fanen Innstillinger — seksjon Steg 3 og kopier Redirect URL.
2. Logg inn på Office 365-portalen med Global Administrator-legitimasjonen din og gå til siden Registrering av Microsoft Azure-applikasjoner.
3. Klikk på Ny registrering og angi navn på applikasjonen, for eksempel 3CX PBX Office 365 Sync App.
4. Under Støttede kontotyper lar du standardvalget stå: Konti bare i denne organisasjonskatalogen.
5. I avsnittet for URI-omdirigering (valgfritt) angir du type Web og limer inn URI-omdirigeringen fra grensesnittet til 3CX: Alternativer > Integrasjon med Office 365 > fanen Alternativer > avsnitt Trinn 3. Plattform og tillatelser, for eksempel, company.3cx.eu:5001/oauth2office2
6. Klikk Registrer, så vil applikasjonen bli opprettet.
7. Siden for innstillinger for den opprettede applikasjonen åpnes. Kopier verdien for Applikasjons-ID (klient) og lim den inn i det tilsvarende feltet i administrasjonsgrensesnittet til 3CX, Alternativer > Integrasjon med Office 365 > fanen Alternativer > Trinn 1. Konfigurer App-ID.

Autentiseringsnøkler

Det er nå nødvendig å etablere tillitsforhold med offentlig nøkkel mellom systemet ditt, 3CX v16, og den opprettede applikasjonen i Office 365-portalen.

1. I 3CX-grensesnittet (delen Alternativer > Integrasjon med Office 365 > fanen Alternativer) klikker du på Generer nytt nøkkelpar og lagrer nøkkelen public_key.pem.
2. Gå til applikasjonsinnstillingene under Sertifikater og hemmeligheter. Klikk på Send sertifikat og last opp den opprettede nøkkelen.

Tillatelser for applikasjonen

Det siste trinnet i oppsettet er å angi API-tillatelser i avsnittet API-tillatelser. Disse tillatelsene bestemmer tilgangsreglene for systemet ditt, 3CX, til Office 365-kontoen.

1. Gå til avsnittet API-tillatelser, klikk på Legg til tillatelse og velg Microsoft Graph.
2. Legg til API-tillatelser i avsnittet Applikasjonstillatelser: Kalender > Kalender.Les, Kontakter > Kontakter.Les, Katalog > Katalog.Les.All og klikk på Legg til tillatelser.
3. I delen Gi samtykke, klikk på Gi administratorens samtykke for …, for å aktivere tillatelsene.
4. Vent i omtrent 10 minutter for at endringene skal tre i kraft.
5. Bytt til 3CX-grensesnittet og i delen Integrasjon med Office 365 klikker du på Logg inn på Office 365. Bekreft tillatelsene for den opprettede applikasjonen, og forbindelsen mellom systemene vil bli etablert.

Synkroniseringsfunksjoner

Synkronisering mellom 3CX og Office 365 konfigureres i tre faner:

• Brukersynkronisering — Office 365-brukere synkroniseres med brukere (tilleggsnumre) i 3CX. I administrasjonsgrensesnittet til 3CX plasseres de synkroniserte brukerne i organisasjonsgruppen Azure AD.
• Synkronisering av kontakter – personlige kontakter fra Office 365 synkroniseres med adresseboken til 3CX. Brukeren ser disse kontaktene i 3CX-applikasjoner for alle plattformer.
• Synkronisering av kalender – automatisk endring av status for 3CX-tilleggsnummeret avhengig av tilgjengelighet i Office 365-kalenderen:

Etter at arrangementet er avsluttet i Office 365-kalenderen, synkroniseres også statusen for 3CX-brukeren og går tilbake til forrige tilstand.

Alle synkroniseringselementer kan konfigureres både for alle Office 365-brukere og for utvalgte brukere.

Integrasjonen er nå fullført.

Kilde: habr.com