This instruction describes the configurations to be implemented in TOPdesk to set up the BlueDolphin TOPdesk Connector for a single TOPdesk template to the BlueDolphin Object Definition Type connection.
Repeat this instruction for every BlueDolphin Object Definition Type you like to be sourced from TOPdesk.
NOTE: Integration does not support relationships and it is unidirectional flowing data from TOPdesk to BlueDolphin.
Pre-requisite:
- Integration URL - connector URL to be provided by ValueBlue (Webhook URL)
-
TOPdesk - TOPdesk Template to BlueDolphin Object Type connector
-
- Variable Settings
- TOPdesk API Key - TOPdesk credentials with appropriate access via TOPdesk API
- TOPdesk API User - TOPdesk credentials with appropriate access via TOPdesk API
Configuration to be added for the BlueDolphin
Section | Field | Description |
Flow Name | Template name | |
Webhook URL |
TOPdesk webhook endpoint |
|
General Configuration | Instance URL | Address URL from the TOPdesk API |
User Name | TOPdesk API account name | |
API Key | TOPdesk API Key | |
Asset type | Template from TOPdesk you want to connect to BlueDolphin | |
BlueDolphin ID Field (Optional) |
BlueDolphin ID fields created in TOPdesk. For example, bluedolphin-id. |
|
(Optional) |
In Topdesk 'name' refers to the Asset ID and it matches the title in BlueDolphin. This field must be filled with 'name' for the TOPdesk integration. |
|
API URL |
BlueDolphin API URL For US tenants: |
|
Tenant Name | Your tenant name can be found in the BlueDolphin URL behind "app/" or under Admin-> General field ->Database |
|
API Key | Create new API Key | |
Object Definition ID |
BlueDolphin Object Definition ID you want to connect. Admin-> Configuration-> Object Definition: Select the object definition you want to use and copy and paste the end part of the URL. |
|
Workspace ID |
BlueDolphin Workspace ID you want to connect. Admin-> Configuration-> Business Units Select the workspace you want to use and copy and paste the end part of the URL. NOTE: Tenants with no workspace should use the “get workspace” call from the public API to retrieve it. |
TOPdesk package: The configuration required for Topdesk is available in the attached .zip file.
Comments
0 comments
Please sign in to leave a comment.