Let op: TOPdesk is een betaalde integratie, aan deze koppeling zijn extra kosten verbonden. Het aanzetten van deze integratie valt buiten de bestaande dienstverlening van Embrace. Neem hierover contact op met je accountmanager.
Dit artikel bestaat uit de volgende secties:
Embrace x TOPdesk
Met deze integratie kunnen gebruikers:
- Meldingen op de startpagina raadplegen via de TOPdesk widget
- Direct informatie in TOPdesk doorzoeken met de Embrace zoekmachine
Bekijk ook de factsheet voor meer informatie: TOPdesk
Configuratie
TOPdesk widget
Voor de incidenten widget is een TOPdesk behandelaarsaccount nodig met een API key en de juiste rechten:
- maak een nieuwe behandelaarsaccount aan met bijvoorbeeld de naam
EmbraceBehandelaar - maak een nieuwe rechtengroep aan met bijvoorbeeld de naam
EmbraceBehandelaarRechten - geef deze nieuwe rechtengroep de volgende rechten:
- voeg de nieuwe behandelaar (
EmbraceBehandelaar) toe aan deze nieuwe rechtengroep (EmbraceBehandelaarRechten) - log in TOPdesk in met dit nieuwe behandelaarsaccount (
EmbraceBehandelaar) - ga naar gebruikersinstellingen (rechtsboven (mijn instellingen))
- hier vind het applicatie overzicht, klik op toevoegen en maak hier een applicatiewachtwoord aan en geef deze een lange geldigheid (bv tot 2035) om te voorkomen dat de koppeling op korte termijn stuk gaat. De naam van de applicatiewachtwoord maakt niet uit en wordt verder nergens gebruikt.
- bewaar het applicatie wachtwoord goed want die moet later in Embrace ingevuld worden:
TOPdesk zoekplugin
Voor de zoekplugin is een TOPdesk persoon nodig (én bovenstaande behandelaar).
- maak een nieuwe persoon aan met bijvoorbeeld de naam
EmbracePersoon - geef deze persoon een inlog in selfserviceportal met dezelfde naam
EmbracePersoon
Algemene configuratie
In omgevingsbeheer van Embrace kan de koppeling gemaakt worden bij koppelingen / TOPDesk.
Hier moeten de volgende gegevens ingevuld worden:
| Veld | Waarde |
|---|---|
| Root url of TOPdesk | URL van de TOPDesk omgeving. Bijvoorbeeld: https://klant.topdesk.net. |
| Username of operator | Authenticatie gegevens voor de incidenten widget. Voer hier de gebruikersnaam in van het behandelaarsaccount (bijvoorbeeld EmbraceBehandelaar). |
| Application password of operator | Authenticatie gegevens voor de incidenten widget. Voer hier de applicatie wachtwoord in die aangemaakt is. Bijvoorbeeld: 2moxy-q26gp-mlojs-jjxx7-i4dji LET OP! Gebruik niet per ongeluk het wachtwoord van EmbraceBehandelaar maar gebruik de applicatie wachtwoord! |
| Username of (normal) person | Authenticatie gegevens voor de knowledgebase zoekplugin. Gebruik hier de gebruikersnaam van een aanmelder/persoon (bijvoorbeeld EmbracePersoon). |
| Password of (normal) person | Authenticatie gegevens voor de knowledgebase zoekplugin. Gebruik hier het wachtwoord dat hoort bij de aanmelder/persoon. |
| Position on which the results are shown in search | Dit getal bepaalt op welke plek in de zoekresultaten de resultaten uit TOPdesk getoond worden. Experimenteer hiermee om de juiste plek te bepalen. |
Voor TOPdesk is de configuratie nu klaar en kan de configuratie opgeslagen worden met de knop Koppelen. Voordat het wordt opgeslagen wordt er getest of de ingevoerde gegevens kloppen. Als dit niet lukt zal er foutinformatie op het scherm getoond worden.
Troubleshooting
-
Geen incidenten in widget getoond
Wanneer na juiste configuratie (loop bovenstaande configuratiestappen na en stel de rechten zoals voorgesteld in) alsnog geen resultaten in de widget opleveren, kan eerst gekeken worden of de koppeling gelegd is en/of fouten teruggeeft.
- Check of in de zoekresultaten van het intranet TOPdesk kennisbank resultaten naar voren komen. Zo ja, dan is de koppeling wel gelukt. Zo nee, dan gaat er nog iets mis bij de koppeling.
- Check de logs van Embrace. Krijg je foutmeldingen terug?
-
Categorie-/behandelaarfilters
Wanneer een klant gebruik maakt van categoriefilters/behandelaarfilters met betrekking tot zichtbaarheid, dan moet het EmbraceBehandelaar account ook alles kunnen zien (afhankelijk van de meldingen die je binnen Embrace zichtbaar wil hebben).
Als dit niet ingesteld is, zal je geen resultaten in de widget getoond krijgen, krijg je geen errormeldingen in de Embrace logs, maar wel resultaten uit de TOPdesk kennisbank in de zoekresultaten op het intranet.
-
Koppeling kan niet geactiveerd worden, "Er is iets fout gegaan".
Via de browser console kan (door Embrace) gecheckt worden wat er is misgaat, bijvoorbeeld dat het wachtwoord/gebruikersnaam niet correct is.