3CX-integraatio Office 365:n kanssa Azure API:n kautta

PBX 3CX v16 Pro- ja Enterprise-versiot tarjoavat täyden integraation Office 365 -sovelluksiin. Erityisesti seuraava on toteutettu:

• Office 365 -käyttäjien ja 3CX-laajennusten (käyttäjät) synkronointi.
• Office-käyttäjien henkilökohtaisten yhteystietojen synkronointi ja henkilökohtainen 3CX-osoitekirja.
• Office 365:n käyttäjän kalenterin (varattu) tilojen ja 3CX-alanumeron tilan synkronointi.   

3CX käyttää laajennusta lähtevien puhelujen soittamiseen Office-sovellusten verkkoliittymästä 3CX Soita napsauttamalla selaimille kromi и Firefox. Voit käyttää myös pikanäppäimiä 3CX-sovellus Windowsille.

Aloitaksesi tarvitset Office 3CX -tilauksen ja Office-portaalin järjestelmänvalvojan tunnistetiedot, joilla on "Global Administrator" -oikeudet.

Joissakin Office 365 -tilauksissa on rajoitettu tai ei ollenkaan integraatio 3CX:n kanssa:

• Tilaukset ilman käyttäjähallintaa, ts. kaikki kotitilaukset.
• Tilaukset ilman Exchangea eivät voi synkronoida yhteystietoja ja kalenteria (Office 365 Business ja Office 365 Pro Plus).

Office 365 -palvelimilla on oltava suora yhteys 3CX-palvelimeesi reaaliaikaisten tilojen välittämiseksi. Jos jatkuva yhteys ei ole mahdollista, 3CX suorittaa silti päivittäisen synkronoinnin.

Huomaa, että synkronointi suoritetaan vain yhteen suuntaan – Office 365:stä 3CX:ään. Onnistunut synkronointi edellyttää, että Office 365 -käyttäjien "UserType"-attribuutin arvo on "Jäsen" (asetettu Active Directoryssa). Jos Office 365:stä synkronoitu käyttäjä poistetaan tai sitä muutetaan 3CX-liitännän kautta, se palaa edelliseen tilaan seuraavan manuaalisen tai automaattisen synkronoinnin aikana.

Microsoft Azure -todennussovellus

Ensimmäinen yhteysvaihe Office 365 integraatio - yksittäisen sovelluksen luominen tilillesi integroinnin valtuuttamiseksi.

1. Siirry 3CX-hallintaliittymässä kohtaan Asetukset - Office 365 - Asetukset-välilehti - Vaihe 3 ja kopioi uudelleenohjauksen URL-osoite.
2. Kirjaudu Office 365 -portaaliin Global Administrator -tunnuksillasi ja siirry osoitteeseen Microsoft Azure -sovellusrekisteröinnit.
3. Napsauta Uusi rekisteröinti ja määritä sovelluksen nimi, esimerkiksi 3CX PBX Office 365 Sync -sovellus.
4. Jätä Tuetut tilityypit -osioon oletusasetus Tilit vain tässä organisaatiohakemistossa
5. Valitse Uudelleenohjaus-URI-osiossa (valinnainen) tyyppi Web ja liitä uudelleenohjaus-URI 3CX-liitäntäosiosta: Asetukset > Office 365 -integrointi > Asetukset-välilehti > Vaihe 3. Alusta ja käyttöoikeudet -osio, esim. yritys.3cx.eu:5001/oauth2office2
6. Napsauta Rekisteröidy ja sovellus luodaan.
7. Luodun sovelluksen asetussivu avautuu. Kopioi App ID (Client) -arvo ja liitä se sopivasta kentästä 3CX-hallintaliittymässä, Asetukset > Office 365 -integrointi > Asetukset-välilehti > Vaihe 1. Määritä sovellustunnus.

Todennusavaimet

Nyt sinun on luotava julkisen avaimen luottamus 3CX v16 -järjestelmäsi ja Office 365 -portaalissa luodun sovelluksen välille.

1. Napsauta 3CX-käyttöliittymässä (Asetukset > Office 365:n integrointi > Asetukset-välilehti) Luo uusi avainpari ja tallenna public_key.pem-avain.
2. Siirry sovelluksen asetussivulle Varmenteet ja salaisuudet -osiossa. Napsauta Lataa varmenne ja lähetä luotu avain.

Sovelluksen käyttöoikeudet

Viimeinen asennusvaihe on API-oikeuksien määrittäminen API-käyttöoikeudet-osiossa. Nämä käyttöoikeudet määrittävät, kuinka 3CX-järjestelmäsi voi käyttää Office 365 -tiliäsi.

1. Siirry kohtaan API Permissions, napsauta Add Permission ja valitse Microsoft Graph.
2. Lisää API-oikeudet kohdassa Sovellusoikeudet: Kalenterit > Calendars.Read, Yhteystiedot > Yhteystiedot.Read, Hakemisto > Directory.Read.All ja napsauta Lisää käyttöoikeuksia.
3. Napsauta Myönnä suostumus -osiossa Myönnä järjestelmänvalvojan suostumus kohteelle... ottaaksesi käyttöoikeudet käyttöön.
4. Odota noin 10 minuuttia, jotta muutokset tulevat voimaan oikein.
5. Vaihda 3CX-käyttöliittymään ja napsauta Integrointi Office 365:n kanssa -osiossa Kirjaudu sisään Office 365:een. Vahvista luodun sovelluksen käyttöoikeudet ja järjestelmien välinen yhteys muodostetaan.

Synkronointiominaisuudet

Synkronointi 3CX:n ja Office 365:n välillä on määritetty kolmella välilehdellä:

• Käyttäjien synkronointi - Office 365 -käyttäjät synkronoidaan 3CX-käyttäjien (laajennusten) kanssa. 3CX-hallintaliittymässä synkronoidut käyttäjät sijoitetaan Azure AD -organisaatioryhmään.
• Yhteystietojen synkronointi – Office 365:n henkilökohtaiset yhteystiedot synkronoidaan 3CX-osoitekirjan kanssa. Käyttäjä näkee nämä yhteystiedot 3CX-sovelluksissa kaikille alustoille.
• Kalenterin synkronointi - muuttaa automaattisesti 3CX-laajennuksen tilaa sen mukaan, onko se varattu Office 365 -kalenterissa:

Kun Office 365 -kalenterin tapahtuma on suoritettu, myös 3CX-käyttäjän tila synkronoidaan ja palautetaan edelliseen tilaan.

Kaikki synkronointielementit voidaan määrittää sekä kaikille Office 365 -käyttäjille että valituille käyttäjille.

Tämä viimeistelee integroinnin.

Lähde: will.com