Dit artikel is vertaald met behulp van AI en kan kleine onnauwkeurigheden bevatten. Raadpleeg de Engelse versie voor volledige nauwkeurigheid.
Deze instructie beschrijft de configuraties die in TOPdesk moeten worden uitgevoerd om de BlueDolphin TOPdesk Connector in te stellen voor één TOPdesk-template naar de BlueDolphin Objectdefinitie Type-koppeling.
Herhaal deze instructie voor elk BlueDolphin Objectdefinitie Type dat je vanuit TOPdesk wilt ophalen.
LET OP: Integratie ondersteunt geen relaties in BlueDolphin.
Vereisten:
Integratie-URL - connector-URL die wordt aangeleverd door ValueBlue (Webhook URL)
Actiereeks in TOPdesk
Actiereeks-script in TOPdesk dat wordt aangeleverd door ValueBlue
Variabele Instellingen in Actiereeks
TOPdesk API Key - TOPdesk-inloggegevens met de juiste toegang via de TOPdesk API
TOPdesk API User - TOPdesk-inloggegevens met de juiste toegang via de TOPdesk API
Minimaal benodigde toegang is een operatoraccount met lees- en schrijfrechten op het asset-template dat je wilt synchroniseren. Als een persoon, persongroep, operator, operatorgroep of leverancier moet worden opgehaald, zijn ook leesrechten op de ondersteunende bestanden vereist.
LET OP: Je kunt de operator blokkeren voor het inloggen op de TOPdesk GUI.
BlueDolphin Configuratie
Zodra je de template met de naam - BIF: TOPdesk Entity -> BlueDolphin Object (CREATE, UPDATE) hebt geïnstalleerd, word je doorgestuurd naar de configuratiepagina.
Vul in het gedeelte Configuratie alle verplichte velden in aan de hand van de tabel hieronder.
Klik op Verifieer en Koppel om te controleren of de connectorgegevens correct zijn.
Als de verbinding succesvol is, verschijnt rechtsonder verbonden en wordt het veld Integratie Mapping zichtbaar.
In de Integratie Mapping koppel je TOPdesk-velden aan de BlueDolphin objectdefinities die je wilt koppelen.
Dit is de één-op-één veldmappingtabel van de TOPdesk-templatevelden naar de BlueDolphin Object Type-eigenschappen of vragenlijstvelden.
Klik rechtsonder op Activeer.
Neem de waarde van de Webhook URL over, deze heb je nodig voor de webhookconfiguratie aan de Topdesk-kant. Zie de bijlagen onderaan het artikel.
Configuratievelden
Vul alle gegevens in zoals beschreven in de tabel,
Sectie | Veld | Beschrijving |
Flow Naam |
| Templatenaam |
Webhook URL |
| Webhook-eindpunt |
Topdesk configuratie (Bron) | Instance URL | Adres-URL van de TOPdesk API |
| Gebruikersnaam | TOPdesk API-accountnaam |
| API Key | TOPdesk API Key |
| Asset type | Template uit TOPdesk die je wilt koppelen aan BlueDolphin |
| BlueDolphin ID-veld (Optioneel) | BlueDolphin ID-velden aangemaakt in TOPdesk. Bijvoorbeeld: bluedolphin-id.
LET OP: Als dit optionele veld leeg blijft, wordt een fallbackmechanisme geactiveerd om een object de volgende keer op titel te zoeken wanneer er een wijziging is in het TOPdesk-asset. Als de assetnaam wordt gewijzigd, kan dit leiden tot het aanmaken van een nieuw object. |
| BlueDolphin Titelveld (Optioneel) | In Topdesk verwijst 'name' naar de Asset ID en dit komt overeen met de titel in BlueDolphin. Dit veld moet worden ingevuld met 'name' voor de TOPdesk-integratie. |
Bluedolphin configuratie (Doel) | API URL | Selecteer de URL uit een dropdown |
| API Key | |
| Workspace ID | BlueDolphin Workspace ID die je wilt koppelen. Admin-> Configuratie-> Bedrijfsonderdelen Selecteer de workspace die je wilt gebruiken en kopieer en plak het laatste deel van de URL. LET OP: Tenants zonder workspace moeten de “get workspace”-call van de publieke API gebruiken om deze op te halen. |
| Objectdefinitie ID | BlueDolphin Objectdefinitie ID die je wilt koppelen. Admin-> Configuratie-> Objectdefinitie: Selecteer de objectdefinitie die je wilt gebruiken en kopieer en plak het laatste deel van de URL. |
TOPdesk-pakket: De benodigde configuratie voor TOPdesk is beschikbaar in het bijgevoegde .zip-bestand.
Het is nu mogelijk om een bidirectionele datastroom van BlueDolphin naar TOPDesk te hebben. Zie het artikel BlueDolphin naar TopDesk Integratie.