3CX-integrasjon med Office 365 via Azure API

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

• Synkronisering av Office 365-brukere og 3CX-utvidelser (brukere).
• Synkronisering av personlige kontakter til Office-brukere og 3CX personlig adressebok.
• Synkronisering av Office 365-brukerkalenderstatuser (opptatt) og 3CX-tilknytningsnummerstatus.   

For å foreta utgående anrop fra nettgrensesnittet til Office-applikasjoner, bruker 3CX utvidelsen 3CX Klikk for å ringe for nettlesere Chrome и Firefox. Du kan også bruke hurtigtaster i 3CX-applikasjon for Windows.

For å komme i gang trenger du et Office 3CX-abonnement og Office-portaladministratorlegitimasjon med "Global Administrator"-privilegier.

Noen Office 365-abonnementer har begrenset eller ingen integrasjon med 3CX:

• 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 tilkobling til 3CX-serveren din for å overføre sanntidsstatuser. Hvis en vedvarende tilkobling ikke er mulig, vil 3CX fortsatt utføre daglig synkronisering.

Vær oppmerksom på at synkronisering kun utføres i én retning - fra Office 365 til 3CX. For vellykket synkronisering må Office 365-brukere ha «UserType»-attributtet satt til «Member» (satt i Active Directory). Hvis en bruker synkronisert fra Office 365 slettes eller endres gjennom 3CX-grensesnittet, går den tilbake til forrige tilstand under neste manuelle eller automatiske synkronisering.

Microsoft Azure Authentication Application

Første tilkoblingstrinn Office 365-integrasjon — opprettelse av en individuell applikasjon i kontoen din for å autorisere integrasjon.

1. I 3CX-administrasjonsgrensesnittet, gå til Innstillinger - Office 365 - Innstillinger-fanen - Trinn 3-delen og kopier omdirigerings-URLen.
2. Logg på Office 365-portalen med din Global Administrator-legitimasjon og gå til Microsoft Azure-applikasjonsregistreringer.
3. Klikk Ny registrering og angi applikasjonsnavnet, for eksempel 3CX PBX Office 365 Sync App.
4. I delen Støttede kontotyper lar du standardalternativet Kontoer bare være i denne organisasjonskatalogen
5. I Redirect URI-delen (valgfritt), velg typen Web og lim inn omdirigerings-URIen fra 3CX-grensesnittdelen: Innstillinger > Office 365-integrasjon > Innstillinger-fanen > Trinn 3. Plattform- og tillatelsesdelen, f.eks. selskap.3cx.eu:5001/oauth2office2
6. Klikk på Registrer og søknaden opprettes.
7. Innstillingssiden for det opprettede programmet åpnes. Kopier app-ID-verdien (klient) og lim den inn fra det aktuelle feltet i 3CX-administrasjonsgrensesnittet, Innstillinger > Office 365-integrasjon > fanen Alternativer > Trinn 1. Konfigurer app-ID.

Autentiseringsnøkler

Nå må du etablere en offentlig nøkkeltillit mellom 3CX v16-systemet og den opprettede applikasjonen i Office 365-portalen.

1. I 3CX-grensesnittet (Innstillinger > Office 365-integrasjon > fanen Alternativer), klikk Generer et nytt nøkkelpar og lagre public_key.pem-nøkkelen.
2. Gå til siden for applikasjonsinnstillinger i delen Sertifikater og hemmeligheter. Klikk på Last opp sertifikat og last opp den genererte nøkkelen.

Programtillatelser

Det siste oppsetttrinnet er å angi API-tillatelser i delen API-tillatelser. Disse tillatelsene bestemmer hvordan 3CX-systemet ditt kan få tilgang til Office 365-kontoen din.

1. Gå til API-tillatelser, klikk på Legg til tillatelse og velg Microsoft Graph.
2. Legg til API-tillatelser under Application Permissions: Calendars > Calendars.Read, Contacts > Contacts.Read, Directory > Directory.Read.All og klikk på Add Permissions.
3. I delen Gi samtykke klikker du Gi administratorsamtykke for... for å aktivere tillatelser.
4. Vent ca. 10 minutter til endringene trer i kraft på riktig måte.
5. Bytt til 3CX-grensesnittet og i Integrasjon med Office 365-delen klikker du på Logg på Office 365. Bekreft tillatelsene for den opprettede applikasjonen og forbindelsen mellom systemene vil bli etablert.

Synkroniseringsmuligheter

Synkronisering mellom 3CX og Office 365 er konfigurert i tre faner:

• Brukersynkronisering - Office 365-brukere synkroniseres med 3CX-brukere (utvidelser). I 3CX-administrasjonsgrensesnittet plasseres synkroniserte brukere i Azure AD-organisasjonsgruppen.
• Kontaktsynkronisering - Office 365 personlige kontakter synkroniseres med 3CX-adresseboken. Brukeren ser disse kontaktene i 3CX-applikasjoner for alle plattformer.
• Kalendersynkronisering – endrer automatisk statusen til en 3CX-utvidelse avhengig av om den er opptatt i Office 365-kalenderen:

Etter at en hendelse i Office 365-kalenderen er fullført, synkroniseres også 3CX-brukerstatusen og returneres til sin forrige tilstand.

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

Dette fullfører integrasjonen.

Kilde: www.habr.com