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 je in TOPdesk moet uitvoeren om de BlueDolphin TOPdesk Connector in te stellen voor een enkele 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 door BlueDolphin wordt aangeleverd (Webhook URL)
Actiesequentiescript: Automatiseringsscript in TOPdesk dat door BlueDolphin wordt aangeleverd
Variabele instellingen in het actiesequentiescript:
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 de asset-template die 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 - BIF: TOPdesk Entity -> BlueDolphin Object (CREATE, UPDATE) template 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 juist 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 verbinden.
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 |
| Naam van de template |
Webhook URL |
| Webhook endpoint |
TOPdesk configuratie (Bron) |
| LET OP: BlueDolphin ondersteunt alleen bekende domeinen van derden. Als je een aangepaste TOPdesk-URL gebruikt, werkt de integratie niet. |
| 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 die in TOPdesk zijn aangemaakt. Bijvoorbeeld: bluedolphin-id.
LET OP: Als dit optionele veld leeg blijft, wordt een fallbackmechanisme geactiveerd om een object te vinden op basis van de titel zodra er een wijziging is in de 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 voor de relevante regio. |
| API Key | |
| Bedrijfsonderdeel | Selecteer het BlueDolphin bedrijfsonderdeel/werkruimte uit de lijst. |
| Objectdefinitie | Selecteer de BlueDolphin Objectdefinitie die je wilt koppelen uit de lijst. |
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.