Dit artikel is vertaald met behulp van AI en kan kleine onnauwkeurigheden bevatten. Raadpleeg de Engelse versie voor volledige nauwkeurigheid.
BlueDolphin-objecten worden gesynchroniseerd naar TOPdesk als assets met bijbehorende templates. Een objectdefinitie in BlueDolphin staat gelijk aan een template in TOPdesk.
Voorbereiding
Voordat je de configuratiestappen in BlueDolphin start, zorg ervoor dat de volgende velden zijn aangemaakt (of al bestaan):
De TOPdesk Asset ID-eigenschap in BlueDolphin
Een veld om de BlueDolphin Object ID op te slaan in het assettemplate in TOPdesk
Maak in BlueDolphin een eigenschap aan met de naam TOPdesk Asset ID op het object om een asset-ID op te slaan voor het bijwerken van een asset na aanmaak. Je vult deze eigenschap in bij het tekstvak Asset ID Field in de BlueDolphin Marketplace-interface.
Maak in TOPdesk een veld aan met de naam bluedolphin-id op het TOPdesk assettemplate om een BlueDolphin Object ID op te slaan voor het bijwerken van een asset na aanmaak.
Definieer het BlueDolphin ID-veld via Modules->Asset Management->Template Designer in TOPdesk. Je vult deze eigenschap in bij het tekstvak BlueDolphin ID Field in de BlueDolphin Marketplace-interface.
LET OP:
Zorg dat de waarden in BlueDolphin en TOPdesk overeenkomen om conflicten te voorkomen:
Als het aantal decimalen verschilt, zal het systeem afronden of nullen toevoegen om de waarden gelijk te maken.
Als een BlueDolphin-tekstveld langer is dan het toegestane aantal tekens in TOPdesk, wordt de tekst volledig genegeerd (niet afgekapt).
Configuratie toe te voegen vanuit BlueDolphin
Na het installeren van de template "BIF: BlueDolphin Entity -> BlueDolphin Object (CREATE, UPDATE)", word je doorgestuurd naar de configuratiepagina.
Gebruik de webhook-URL, objectdefinitie-ID en workspace-ID om een webhook aan te maken voor ObjectCreated- en ObjectUpdated-events. Raadpleeg het artikel Een abonnement aanmaken voor meer informatie
Vul in het gedeelte Algemene Configuratie alle verplichte velden in zoals hieronder weergegeven. Raadpleeg de Configuratievelden-tabel voor uitleg.
Klik op Verifieer en Koppel om de connectorgegevens te bevestigen.
Als dit gelukt is, verschijnt “Verbonden” onderaan en wordt het veld Integratie Mapping zichtbaar.
Koppel in Integratie Mapping de BlueDolphin-velden aan de TOPdesk-velden. Dit zorgt voor een één-op-één mapping tussen BlueDolphin-eigenschappen of vragenlijsten en TOPdesk-templatevelden.
Klik rechtsonder op Activeer.
Algemene Configuratievelden
Vul alle gegevens in zoals beschreven in de tabel,
Sectie | Veld | Beschrijving |
Flow Naam |
| BIF: BlueDolphin Object → TOPdesk Entity (CREATE, UPDATE) |
Webhook URL |
| BlueDolphin webhook endpoint. Zie Een abonnement aanmaken |
Algemene Configuratie | API URL | BlueDolphin API URL Voor US-tenants: https://public-api.us.bluedolphin.app/
|
| Tenant Naam (Verplicht) | Je tenantnaam vind je in de BlueDolphin URL achter "app/" |
| API Key (Verplicht) | BlueDolphin API Key: Nieuwe API Key aanmaken |
| Asset ID (Verplicht) | Moet ingesteld zijn als “TOPdesk Asset ID” Naam van de objecteigenschap in BlueDolphin om het ID van het nieuw aangemaakte asset op te slaan. |
| Objectdefinitie ID (Verplicht) | BlueDolphin Objectdefinitie-ID die je wilt koppelen. Admin-> Configuratie-> Objectdefinitie: Selecteer de gewenste objectdefinitie en kopieer en plak het laatste deel van de URL. |
| Workspace ID (Verplicht) | BlueDolphin Workspace ID die je wilt koppelen. Admin-> Configuratie-> Bedrijfsonderdelen Selecteer de gewenste workspace en kopieer en plak het laatste deel van de URL.
|
| Instance URL (Verplicht) | Adres-URL van de TOPdesk API. Verwijder het pad gedeelte van de URL en eventuele schuine strepen aan het einde.
Bijvoorbeeld:
|
| Gebruikersnaam (Verplicht) | TOPdesk accountnaam |
| API Key (Verplicht) | TOPdesk API Key |
| Assettype (Verplicht) | Template uit TOPdesk die je wilt koppelen aan BlueDolphin |
| BlueDolphin ID-veld (Verplicht) | Assetveld-ID in TOPdesk waar BlueDolphin het ID van het BlueDolphin-object opslaat. Standaard is dit “bluedolphin-id” |
|
(Verplicht) | Assetveld-ID in TOPdesk die BlueDolphin gebruikt om te controleren of er al een asset bestaat voor een bepaalde objecttitel. Moet ingesteld zijn op de waarde “name”.
Voeg geen integratiemapping toe die een BlueDolphin-veld koppelt aan “Asset Name” behalve “object_title” |
Voor de koppeling van TOPdesk naar BlueDolphin, zie het artikel TOPdesk Configuratie.