You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
**With the Device42 - Zendesk integration, you'll benefit from the ability to:**
9
+
Device42 discovery keeps your infrastructure documentation up-to-date, and with the Zendesk connector, your help desk can access IT infrastructure information via support tickets.
10
+
11
+
## Benefits of the Device42-Zendesk Integration
12
+
13
+
With the Device42-Zendesk integration, you'll benefit from the ability to:
9
14
10
-
- Attach any part of your auto-discovered IT infrastructure within Device42 - including devices, racks, parts, and PDUs - directly to your Zendesk tickets
11
-
- View details like device type, device service level, and serial numbers stored within Device42 directly within Zendesk
12
15
- Click links integrated into Zendesk that jump you directly to the relevant IT infrastructure CI details page in Device42
13
-
- Customize ZenDesk by adding your autodiscovered Device42 infrastructure items as columns in your ZenDesk custom views!
16
+
- Attach any part of your discovered IT infrastructure in Device42, including devices, racks, parts, and PDUs, directly to your Zendesk tickets
17
+
- View details like device type, device service level, and serial numbers stored in Device42 directly within Zendesk
18
+
- Customize Zendesk by adding your discovered Device42 infrastructure items as columns in your Zendesk custom views
19
+
20
+
## Set up the Integration
21
+
22
+
Before creating an External Integration in Device42 and installing the integration plugin in Zendesk, you need to create a Zendesk API Token.
23
+
24
+
As a prerequisite, ensure your [Device42 Cloud Connector](integration/external-integrations/device42-cloud-connector-overview.mdx) is configured (under **Tools > Integrations > Cloud Services**) to allow communication between Device42 and Zendesk.
25
+
26
+
### Create a Zendesk API Token
27
+
28
+
- To begin, open Zendesk and click the **gear icon** on the left sidebar of the Zendesk interface. Then navigate to **Apps and integrations > API configuration** to enable API token access if it's not already enabled.
29
+
30
+
31
+
32
+
- Go to **Apps and integrations > API tokens** and generate a new API access token using the **Add API Token** button.
33
+
34
+
35
+
36
+
- Name the new API token `Device42 Integration`, or something similar, and then copy the token value and save it in a safe and retrievable location.
37
+
38
+
39
+
40
+
### Add a Device42 External Integration
41
+
42
+
Next, enable the Zendesk integration from Device42.
43
+
44
+
- Head to **Tools > Integrations > External Integrations** and click the **Create** button.
- In the **Token** field, use the **plus icon** and create a new Secret. Enter your Zendesk username followed by `/token` in the **Username** field (for example, `[email protected]/token`). Then paste the Zendesk API token into the **Password** field.
To begin installing the Device42-Zendesk integration, head to the [Zendesk marketplace](https://www.zendesk.com/marketplace/apps/). If you have trouble with the link, check that you are signed in to your Zendesk account.
87
+
88
+
- Search for `Device42 Connector` to locate the integration add-on.
### Pre-Requisite: Configure Device42 for ZenDesk integration
92
+
- Click the Zendesk marketplace **Install** button, choose the name of your account from the dropdown, and click **Install** to continue the installation.
- To begin, open ZenDesk and head to "Settings" via the "Gear" icon on the left side of the ZenDesk interface, and then choose the "API" item from the list on the left. Enable "Token Access" via the slider if it's not already enabled, and generate a new API access token via the "+" button, and name it "Device42 Integration". Copy this token value and save it! Note per ZenDesk instructions, when authenticating with Toekn Access, add `/token` to the end of your username! 
22
-
- Next, enable the ZenDesk integration from within Device42. Log in to your Device42 instance and from the Device42 main menu, head to _Tools -> Integrations -> External Integrations_. Add a new integration for type: "ZenDesk", and paste in the token you copied from the previous step: 
23
-
- Save the new ZenDesk integration settings & write down the "Verification token" Device42 generates:  Head to the "Installing the ZenDesk add-on section" below to continue installing the ZenDesk connector.
96
+
- Name your integration. We used `Device42 connector for Zendesk` in this example.
24
97
25
-
98
+
- For the **Token** field, provide the **Verification Token** you saved from the Device42 External Integration setup steps above.
To begin installing the Device42-Zendesk integration, head to the [ZenDesk marketplace](https://www.zendesk.com/marketplace/apps/). 
102
+
- Enable role and group restrictions if desired. (In the example, we left them disabled at this stage.)
103
+
- Click **Install** to complete the integration installation.
30
104
31
-
If you are having trouble with the link, You might need to sign in to your Zendesk account \[if you aren't already signed in\]. Next, click the gear icon (lower left), then click the “Marketplace” link. Search for “Device42 for Zendesk” to locate the integration add-on.
105
+
## Use the Zendesk Connector
32
106
33
-
107
+
Once the plugin is installed, you can associate CIs (Configuration Items) from Device42 with tickets.
34
108
35
-
- Click the ZenDesk marketplace "Install" button _(pictured above)_ & follow the the on-screen instructions; Choose the name of \*your\* account from the dropdown, and click "Install" to continue installation: 
36
-
- For "Title", Name your integration. We used "Device42 connector for ZenDesk" in this example.
37
-
- For the "Token", provide the 'Verification Token' you saved from the Device42 setup steps above: 
38
-
- Set up role / group restrictions if desired; we'll leave them disabled for now. Click "Install" to continue.
39
-
- You're all set!
109
+
- In Device42, head to any device, building, room, or CI of your choice, and find the **Zendesk** section:
Once the plugin is installed, it's simple to associate CIs from Device42 with tickets. In Device42, head to any Device, Building, Room, etc. CI of your choice, and scroll all the way to the bottom: 
130
+
- Click **Submit**.
48
131
49
-
Click "Add ZenDesk Ticket" to add a new ticket, or "Link to ZenDesk ticket" to link an existing ticket: 
132
+
You'll receive email confirmation that the ticket was created. You can now also see your new ticket listed as an attachment:
50
133
51
-
Click Submit, and you'll get confirmation that the ticket was created (or attached). You'll now also see the your new ticket you just created listed as an attachement, as well: 
You'll also be able to see any tickets you've created within ZenDesk: 
142
+
You'll see any tickets you've created in Zendesk with a link to the associated CI in Device42:
54
143
55
-
Having accurate IT infrastructure information available is vital to any successful IT project and key for the continued success of just about any organization. Device42's auto-discovery keeps your infrastructure documentation up-to-date, and with the Zendesk connector, your helpdesk can now directly leverage this accurate IT infrastructure information. _With the Device42 - ZenDesk integration, everything your IT staff needs is now right at their fingertips!_
144
+
0 commit comments