Klant Adres Postcode Plaats
Datum 30-11-2020 Behandeld door Remco Nowee
Betreft Installatiedocument Synction
Inhoud
Inleiding ... 3
1. Perfectview CRM Online ... 3
1.1. Gegevens delen met Technoberg ... 3
1.2. Configureren /Controleren instellingen Xelion ... 5
2. Microsoft Navision 2016 en 2017 ... 6
2.1. Installeren extensie ... 6
2.2. Benodigde informatie ... 6
2.3. Opzetten link met Xelion ... 7
2.4. Xelion Users aanmaken ... 9
3. Microsoft Dynamics CRM 2017 ... 10
3.1. Gegevens delen met Technoberg ... 10
3.2. Configureren /Controleren instellingen Xelion ... 10
4. Microsoft Dynamics 365 ... 11
4.1. Voorbereiding ... 11
4.2. Aanmaken Synction user ... 12
4.3. Configureren /Controleren instellingen Xelion ... 13
4.4. Delen gegevens met Technoberg ... 14
Inleiding
Met dit installatiedocument beschikt u over alle informatie betreffende het installeren van Synction.
Synction bewerkstelligt de koppeling tussen uw ERP/CRM systeem en de Xelion telefooncentrale.
Op dit moment is Synction beschikbaar voor de volgende applicaties/versies;
- Perfectview CRM Online - Microsoft Navision 2016 - Microsoft Navision 2017
- Microsoft Dynamics Business Central (In ontwikkeling) - Microsoft Dynamis CRM 2017
- Microsoft Dynamics 365
In dit document wordt beschreven welke informatie Technoberg van u nodig heeft om de omgeving op te zetten. Verder staat in dit document welke acties u als klant of uw beheerder moet uitvoeren om de koppeling mogelijk te maken. Wij hebben dit per versie beschreven.
1. Perfectview CRM Online
1.1. Gegevens delen met Technoberg
Technoberg heeft Om een koppeling tot stand te kunnen brengenheeft Technoberg de volgende gegevens nodig.
- Xelion API url
- Xelion API account met beheerdersrechten - Xelion password
- Xelion Tenant - Perfectview API Key - Perfectview DatabaseId - Perfectview UserId
Voor de laatste 3 perfectview gegevens is het belangrijk dat u als klant een aantal keys genereert in Perfectview die Technoberg nodig heeft om de koppeling te leggen tussen Perfectview en Xelion.
U doet dit als volgt:
1. Klik op instellingen
2. Klik hierna op koppelingen
3. Kies voor de API instellingen
4. Geef deze 3 keys door aan Technoberg.
1.2. Configureren /Controleren instellingen Xelion
- Log in als Xelion beheerder - Klik op Beheer
- Klik op CSV importschema
- Check of er een locatie staat, gebruik anders /tmp/ voor de configuratiefiles - Kies een maximum aantal logs, standaard gebruiken wij 10
In het filmpje hieronder laten wij de locatie zien waar u dit kunt bekijken of wijzigen.
2. Microsoft Navision 2016 en 2017
2.1. Installeren extensie
Installeer de Xelion extensie volgens de reguliere microsoft wijze.
De eerste stap is altijd het toewijzen van de Xelion admin rol aan een gebruiker die de users later mag aanmaken.
2.2. Benodigde informatie
De Beheerder heeft de volgende informatie nodig om Navision in te richten voor het gebruik van de koppeling met Xelion
- ServerURL Xelion centrale (deze krijgt u van Technoberg na aanlevering van URL Xelion zie hoofdstuk 2.3)
- Navision usernames van xelion gebruikers
- Xelion telefoonnummers van navision users (alleen voor hardphone) - Rechtenstructuur voor audio permissie (wie mag downloaden)
2.3. Delen gegevens met Technoberg
Om de koppeling te kunnen bewerkstelligen is het noodzakelijk onderstaande gegevens te delen met Technoberg.
Xelion
- Xelion API account met beheerdersrechten - Tenant id
- URL API
Navision
- Partner code van uw Nav/BC leverancier (zie hoofdstuk 2.4)
2.4. De extensie toevoegen aan uw Nav/BC licentie
Om deze extensie de kunnen gebruiken in Navision/Business Central dient uw licentie te worden geupgrade. Om deze upgrade uit te voeren hebben wij de partner code van uw Nav/BC leverancier nodig. Wij kunnen dan uw leverancier de mogelijkheid geven om de rechten voor de extensie toe te voegen aan uw licentie. Zodra wij dit in hebben gesteld (dit laten wij u weten) kunt u contact opnemen met de leverancier van uw licentie om een nieuwe versie van uw licentie te krijgen. Zodra u dan de licentie hebt geïmporteerd in uw Nav/BC omgeving kunt u de onderdelen van de extensie gebruiken.
2.5. Opzetten link met Xelion
Ga via zoeken naar de Xelion setup pagina en vul de volgende velden in op het tabblad Home
General
Authkey Wordt automatisch gegenereerd
AuthkeyValidTill Wordt automatisch gegenereerd renewalToken Wordt automatisch gegenereerd
ServerURL Link die je hebt ontvangen van Technoberg (gebaseerd op Xelion server link)
AdminUser Gebruikersnaam van de Xelion admin user AdminPassword Password van de Xelion admin user User Space User space van Xelion
License
LicenseAuth Key Worden door Technoberg aangeleverd License Tenant Worden door Technoberg aangeleverd LicenseValid Till Wordt automatisch gegenereerd LicensLast Checked Wordt automatisch gegenereerd LicenseAuthToken Wordt automatisch gegenereerd LicenseRenewal Token Wordt automatisch gegenereerd LicenseAuthToenValidTill Wordt automatisch gegenereerd
Open na het invullen van de gegevens het tabblad Actions.
- Klik op “Create the setup on the Xelion Server to start using Dynamics NAV”
Nu is de link gelegd tussen de Xelion VoIP centrale en Navision.
Om alle telefoonnummers vanuit navision initieel te synchroniseren met Xelion klik je op “Initialize phonebook”
2.6. Xelion Users aanmaken
Om er voor te zorgen dat gebruikers de koppeling kunnen gebruiken is het van belang dat zij worden toegevoegd aan pagina “Xelion activated users”.
Voor elke gebruiker dient het volgende te worden ingevuld:
UserSecurityId Wordt automatisch gegenereerd
UserName Vul hier de username van de Navision gebruikers in ContactPreferredCallType Vul hier de methode in van uitbellen
Hardphone → zowel softphone als hardphone kan gebruikt worden Softphone → alleen softphone kan gebruikt worden
Phone No. Xelion telefoonnummer (alleen noodzakelijk bij het gebruik van hardphone)
All audio permission Vink de gebruiker aan die toestemming heeft om de audio files van opgenomen gesprekken te downloaden.
3. Microsoft Dynamics CRM 2017
3.1. Gegevens delen met Technoberg
Om een koppeling te bewerkstelligen met Xelion is het van belang dat de volgende gegevens worden gedeeld met Technoberg
Dynamics
- Beheerder account Dynamics CRM 2017 Xelion
- Beheerder userid + wachtwoord - Tenant id
- URL API
3.2. Configureren /Controleren instellingen Xelion
- Log in als Xelion beheerder - Klik op Beheer
- Klik op CSV importschema
- Check of er een locatie staat, gebruik anders /tmp/ voor de configuratiefiles - Kies een maximum aantal logs, standaard gebruiken wij 10
In het filmpje hieronder laten wij de locatie zien waar u dit kunt bekijken of wijzigen.
4. Microsoft Dynamics 365
4.1. Voorbereiding
Om gebruik te kunnen maken van de Synction koppeling moet de app eerst geregistreerd worden in de azure coApp registereren in Azure portal;
- Open de azure portal van de organisatie - Klik op “Azure active Directory”
- Klik op “App registrations”
- Klik op “new registration”
- Vul een naam voor de applicatie, wij adviseren om Synction te gebruiken.
- Kies de “Supported account types” (wie heeft toegang tot de applicatie?) - Klik op “Register”
Azure heeft nu een applicatie geregistreerd en de volgende belangrijke gegevens zijn zichtbaar - Application(Client)ID
- Directory(Tenant)ID
Voer nu de volgende stappen uit - Klik nu op Certificates & secrets - Klik op “New client secret”
- Geef de Client secret een naam die vanzelfsprekend is - Kies een geldigheidsduur
- Kopieer de value van de secret id en bewaar hem ergens . (Let op: dit werkt als een wachtwoord, wanneer je opnieuw inlogt is deze onleesbaar geworden en kan je hem niet meer kopieren.)
- Klik op API permissions
- Klik op add permissions en daarna op Dynamics CRM - Vink het blokje bij user_impersonation aan.
- Klik op “Add permissions
- Wanneer je geen rechten hebt om de rechten te accorderen laat degene die dat wel kan dan doen.
All stappen worden in onderstaand filmpje nog een keer doorlopen.
4.2. Aanmaken Synction user
Om de automatische acties te kunnen uitvoeren is er een CRM user nodig dee maak je alsvolgt aan.
- Klik op het tandwieltje rechtsboven en kies “geavanceerde instellingen”
- Klik op de optie “Beveiliging”
- Klik op het pijltje naast instellingen en kies voor “gebruikers”
- Klik op het pijltje naast ingeschakelde gebruikers en kies voor “Gebruikers van toepassing - Het gebruikersscherm komt tevoorschijn, klik nu op “nieuw”
- Vul bij gebruikersnaam het e-mailadres is van de betreffende gebruiker, Let op het mag geen bestaand e-mailadres zijn.
- Kopieer de application(client)ID uit de azureportal die je net hebt aangemaakt en kopieer deze in het veld “Toepassings-id”
- Vul een naam in voor de gebruiker. Tip gebruik bijvoorbeeld “Synction user”
- Vul het e-mailadres weer in maar nu in het veld “primair e-mailadres”
- Klik nu op opslaan
- De Url van toepassings-ID en Object van Azure AD worden vanzelf ingevuld.
- De Gebruiker is aangemaakt.
All stappen worden in onderstaand filmpje nog een keer doorlopen.
4.3. Aanmaken en toekennen synction rol
- Creer een nieuwe beveiligingsrol en noem deze Synction
- Ken de juiste rechten aan deze rol toe, het gaat om de kernrecord “ activiteit”
- De rol moet kunnen” maken, lezen, schrijven, Toevoegen en Toevoegen aan”
- Hierna moet de rol worden toegekend aan de synction gebruiker die u in 4.2 heeft aangemaakt.
Dit alles wordt in onderstaande filmpje nogmaals weergegeven.
4.4. Configureren /Controleren instellingen Xelion
- Log in als Xelion beheerder - Klik op Beheer
- Klik op CSV importschema
- Check of er een locatie staat, gebruik anders /tmp/ voor de configuratiefiles - Kies een maximum aantal logs, standaard gebruiken wij 10
In het filmpje hieronder laten wij de locatie zien waar u dit kunt bekijken of wijzigen.
4.5. Delen gegevens met Technoberg
Om de koppeling te kunnen bewerkstelligen is het noodzakelijk onderstaande gegevens te delen met Technoberg.
Azure AD app registratie gegevens - TenantID
- ClientID - CLientSecretID - URL omgeving
- Versienummer API Dynamics
Xelion
- Xelion API account met beheerdersrechten - Tenant id
- URL API