Skip to content

Commit 4f700a4

Browse files
authored
Merge pull request #974 from ritza-co/edit-1130-zendesk-2
1130: Proofread, device42-zendesk-connector.mdx
2 parents 1f6f27f + c19c965 commit 4f700a4

File tree

1 file changed

+21
-13
lines changed

1 file changed

+21
-13
lines changed

docs/integration/external-integrations/device42-zendesk-connector.mdx

Lines changed: 21 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -12,10 +12,10 @@ Device42 discovery keeps your infrastructure documentation up-to-date, and with
1212

1313
With the Device42-Zendesk integration, you'll benefit from the ability to:
1414

15-
- Click links integrated into Zendesk that jump you directly to the relevant IT infrastructure CI details page in Device42.
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.
15+
- Click links integrated into Zendesk that jump you directly to the relevant IT infrastructure CI details page in Device42
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
1919

2020
## Set up the Integration
2121

@@ -33,14 +33,15 @@ As a prerequisite, ensure your [Device42 Cloud Connector](integration/external-i
3333

3434
![Zendesk add API token](/assets/images/zendesk-integration/zendesk-add-api-token.png)
3535

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.
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.
3737

3838
![Zendesk generate API token](/assets/images/zendesk-integration/zendesk-copy-token.png)
3939

4040
### Add a Device42 External Integration
4141

42-
Next, enable the Zendesk integration from Device42. Head to **Tools > Integrations > External Integrations** and click the **Create** button.
42+
Next, enable the Zendesk integration from Device42.
4343

44+
- Head to **Tools > Integrations > External Integrations** and click the **Create** button.
4445
- Under **Type** select **Zendesk**.
4546
- Enter the **URL** of your Zendesk instance.
4647

@@ -82,25 +83,30 @@ Now it's time to install the Zendesk add-on.
8283

8384
### Install the Device42 Add-On for Zendesk
8485

85-
To begin installing the Device42-Zendesk integration, head to the [Zendesk marketplace](https://www.zendesk.com/marketplace/apps/). 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.
86+
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.
8687

87-
- Search for Device42 Connector to locate the integration add-on.
88+
- Search for `Device42 Connector` to locate the integration add-on.
8889

8990
![Zendesk Marketplace D42 App](/assets/images/zendesk-integration/device42-connector-marketplace.png)
9091

91-
- Click the Zendesk marketplace **Install** button, choose the name of your account from the dropdown, and click **Install** to continue installation.
92+
- Click the Zendesk marketplace **Install** button, choose the name of your account from the dropdown, and click **Install** to continue the installation.
9293

9394
![Select account](/assets/images/zendesk-integration/select-account.png)
9495

95-
- Name your integration. We used "Device42 connector for Zendesk" in this example. For the **Token** field, provide the **Verification Token** you saved from the Device42 External Integration setup steps above.
96+
- Name your integration. We used `Device42 connector for Zendesk` in this example.
97+
98+
- For the **Token** field, provide the **Verification Token** you saved from the Device42 External Integration setup steps above.
9699

97100
![Plugin installation settings](/assets/images/zendesk-integration/connector-configure.png)
98101

99-
- Enable role and group restrictions if desired, but we'll leave them disabled for now. Click **Install** to complete the integration installation.
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.
100104

101105
## Use the Zendesk Connector
102106

103-
Once the plugin is installed, you can associate CIs (Configuration Items) from Device42 with tickets. In Device42, head to any Device, Building, Room, or CI of your choice, and find the **Zendesk** section:
107+
Once the plugin is installed, you can associate CIs (Configuration Items) from Device42 with tickets.
108+
109+
- In Device42, head to any device, building, room, or CI of your choice, and find the **Zendesk** section:
104110

105111
<ThemedImage
106112
alt="Add or link ticket"
@@ -121,7 +127,9 @@ Once the plugin is installed, you can associate CIs (Configuration Items) from D
121127
}}
122128
/>
123129

124-
- Click **Submit**, and you'll get email confirmation that the ticket was created. You'll now also see your new ticket listed as an attachment:
130+
- Click **Submit**.
131+
132+
You'll receive email confirmation that the ticket was created. You can now also see your new ticket listed as an attachment:
125133

126134
<ThemedImage
127135
alt="Ticket attached confirmation"

0 commit comments

Comments
 (0)