The Zendesk app of EZOfficeInventory is used to manage tickets and incidents regarding equipment.
1. Why integrate with Zendesk?
2. Common workflows
3. Installation guide
3.1. Installing Zendesk from EZOfficeInventory
3.2. Installing EZOfficeInventory from Zendesk
4. How does the integration work?
4.1. The basics
4.2. Choosing attributes to display in Zendesk
4.3. Choosing item tags to display in Zendesk
Why integrate with Zendesk?
Imagine being able to get all the information you need to resolve a service ticket without even having to switch browser windows! At the same time, you can also track all tickets and ticket creators linked to a specific item from the Item Details page itself.
Integrating EZOfficeInventory with Zendesk can enable teams to quickly identify what needs to be worked on, what issues have previously been associated with an item and other details such as Location and AINs.
This can iron out operational workflows, too. Teams can clock equipment details or check-out replacement items to requesters a lot quicker, and the requesters can, in turn, keep tabs on the status of their tickets directly from EZOfficeInventory!
Zendesk integration also generates more contextualized information about assets. Think of it as the bridge between long-term asset lifecycle management and the day-to-day issues relating to them. Better information is great for business. For instance, it can reinforce user accountability by making a Requester’s ticketing history so much more accessible.
Creating linkages such as this, therefore, has many benefits. It can cut down on repair times, promote efficiency, and improve the accuracy of information members have access to.
Some common workflows
Some typical uses of Zendesk EZOfficeInventory Integration are:
- An employee filing a ticket regarding their broken computer that needs to be fixed. EZOfficeInventory tracking asset related details while Zendesk tracking the ticket workflow.
- A person in the field requiring help on using a drill machine, and an agent in Zendesk following up, with specific details about the assigned machine.
- A customer requesting memory extension for their Macbook. The IT Helpdesk looking up details on the Macbook checked out and based on the model determining the type of upgrade required. The details and past work on the MacBook being visible through the Zendesk app for EZOfficeInventory.
- Agents looking up details of any asset in the organization via EZOfficeInventory for outstanding Zendesk tickets. Users creating Zendesk tickets from EZOfficeInventory.
- Logging EZOfficeInventory services and maintenance events in Zendesk to be assigned to the maintenance team.
The installation works both ways, that is if you install EZOfficeInventory from Zendesk or vice versa. However, we recommend installing Zendesk from your EZOfficeInventory account, as it eliminates the risk of human error.
Installing Zendesk from EZOfficeInventory:
You need both a Zendesk and an EZOfficeInventory account for this. Sign into both these accounts, and then:
1) In EZOfficeInventory, go to Settings → Add Ons → Zendesk Integration and tap the Get App On Zendesk button
2) You’ll be asked your Zendesk subdomain
3) Once you’ve entered the subdomain here, press the Connect button. We’ll take care of the rest.
Installing EZOfficeInventory from Zendesk:
There are two cases where you would install EZOfficeInventory from Zendesk:
- You want to install the EZO app from the Zendesk marketplace, and then connect the two accounts.
- You connected the two accounts from EZO and then uninstalled EZO from Zendesk. This means that Zendesk is still connected from the EZO end, but the EZO app needs to be re-installed on the Zendesk end.
In both cases, you will be asked for the following information in order to install the app:
- Access Token: You can get this by going into your EZOfficeInventory account, and then to Settings → Add Ons → API Integration to generate a new token.
- EZOfficeInventory Subdomain: You would add your full EZOffficeInventory subdomain and host, such as ‘business.ezofficeinventory.com’.
- Owner’s Email Address: You would provide the email address of the EZOfficeInventory account owner.
In essence, this is the screen you will see if you try installing the app:
For the integration to work, your role on Zendesk must be set as an ‘Admin’. Similarly, Zendesk can only be disconnected from EZOfficeInventory by the person who first integrated the two systems together. This individual would need to be an admin on Zendesk at the time of disconnecting.
How does the integration work?
Open any Zendesk ticket and look for the EZOfficeInventory app on the right. If the Apps Pane is collapsed, tap the Apps button on the top right to view connected apps. With every ticket, you will see:
– A link to that person’s EZOfficeInventory profile
– Overall details of checkouts and reservations
– Item details
All of the Requester’s Checked Out items will populate the pane on the right. Based on the description in the ticket, the support agent can scroll through the list and link the relevant items to it.
You can also link other items (that is, items not assigned to the Requester), by scrolling to the bottom of the list and clicking on ‘Link Other Assets to this Ticket‘. You will then be brought to a search bar, where you can look up assets and link them to the ticket just like you did previously:
Here you can look up assets by name, group, location, and member:
All assets on this right-side pane are clickable. Clicking on asset name in Zendesk will open a tab in EZOfficeInventory – the asset’s detail page.
All linked assets can be viewed just under the Requester’s profile:
You can see the ticket reference in EZOfficeInventory. For example, here’s what a Macbook’s detail page would look like if it’s been linked to a ticket in Zendesk.
The Zendesk Tab has all the necessary details pertaining to the linked Zendesk tickets.
Update: You can now coordinate maintenance events across departments from a centralized location. For example, some of the VR headgear gets damaged at a CES exhibition. The booth operators create a service ticket in EZOfficeInventory for a repair/replacement. A ticket automatically gets created in the company’s Zendesk account operated by the IT department, which is immediately notified and takes reparative actions. You can also send multiple items for servicing via mass action and create a ticket in Zendesk via EZOfficeInventory.
Learn More on Service and Maintenance Management in EZOfficeInventory
Choosing attributes to display in Zendesk
From your EZOfficeInventory account, go to Settings → Add-Ons → Integrate Zendesk → Item Attributes.
Here, click on ‘Configure Attributes’.
This feature allows you to display any three attributes of your choice on Zendesk. Use the dropdown menus to make your selections. Now, head to your Zendesk account and add an item to a ticket. The attributes displayed for all assets will be the ones configured via your EZOfficeInventory account.
Choosing item tags to display in Zendesk
Item tags in Zendesk will be defined based on the settings in your EZOfficeInventory account, with the pathway: Settings → Company Settings → Advanced Settings → AIN Options.
The enabled option here will be the mode of identification for assets tagged with a ticket. Choose between the Item Number and the Asset Identification Number and save the change. You can now head to your Zendesk account and link an item to a ticket.
Tag: EZOfficeInventory Item Number
Tag: Asset Identification Number
1. Getting the error message when integrating with Zendesk, ‘The Requester <your email> doesn’t exist under Members in EZOfficeInventory …’
Solution: The requester must exist in EZOfficeinventoy and Zendesk with the same email address.
2. Zendesk users not being recognized in EZOfficeInventory
Solution: For EZOfficeInventory to recognize users of your Zendesk account, you need to add them (by matching their email addresses in both systems). We currently do not support auto-importing users from Zendesk to EZOfficeInventory, but if you’re interested in having us implement this, please let us know by reaching out to us.
3. Getting the error message in Zendesk “There was a problem accessing the data ….”
Solution: This generally happens when the subdomain for the account is changed in EZO or a custom domain is added. To fix, simply disconnect Zendesk from Settings –> Add Ons and then reconnect.
Note: Existing data will NOT be impacted by the resetting of the connection.
4. Zendesk stops syncing with EZOfficeInventory
Solution: This happens when the account owner that originally set up the integration from EZOfficeInventory has either had a change in member role or has had their email address updated in Zendesk. To reconnect, simply go to Settings –> Add Ons and integrate with Zendesk from the current owner’s account.
Note: Prior data is not impacted during resetting of the connection.
5. Getting the alert message while disconnecting Zendesk from EZOfficeInventory: “Zendesk Add On has been disabled but we were unable to uninstall the EZOfficeInventory App from your Zendesk account…”.
Solution: While you might’ve disconnected Zendesk from EZOfficeInventory, the EZOfficeInventory App might not uninstall from Zendesk. These are the possible reasons:
- Your Zendesk trial account has suspended;
- The Admin’s email address has been updated in Zendesk;
- The role of Admin has been changed to that of a Staff User in Zendesk OR;
- The Admin has revoked EZOfficeInventory’s authorization from the connected Zendesk account.
To fix, head to your Zendesk Account and uninstall the EZOfficeInventory App manually. Go to Settings –> Apps –> Manage to uninstall the App.