Use EZOfficeInventory’s Zendesk app to manage tickets and incidents regarding all your equipment.
1. 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 helps 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.
2. 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.
3. Installation guide
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 this eliminates the risk of human error.
3.1. Installing Zendesk from EZOfficeInventory
You need both Zendesk and EZOfficeInventory accounts for this. Sign into both of these, and then:
1) In EZOfficeInventory, go to Settings → Add Ons → Zendesk Integration and tap the ‘Get the app at Zendesk’ button.
2) Provide your Zendesk subdomain.
3) Once you’ve entered the subdomain here, press the Connect button. We’ll take care of the rest.
3.2. Installing EZOfficeInventory from Zendesk
There are two cases where you would install EZOfficeInventory from Zendesk:
- You want to install the EZOfficeInventory app from the Zendesk marketplace, and then connect the two accounts.
- You connected the two accounts from EZOfficeInventory and then uninstalled EZOfficeInventory from Zendesk. This means that Zendesk is still connected from the EZOfficeInventory end, but the EZOfficeInventory app needs to be re-installed from 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: 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 user that first integrated the two systems together. This user will have to be an admin on Zendesk at the time of disconnecting.
- Enable the Auto-sync when configuring the two apps. This ensure that whenever a ticket gets resolved in Zendesk, it is automatically updated in EZOfficeInventory as well.
4. How does the integration work?
4.1. The Basics
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 Item Details Page looks like for a Macbook if it’s been linked to a ticket in Zendesk.
The Zendesk Tab has all the necessary details pertaining to the linked Zendesk tickets, including information on Ticket #, Summary, Requester, Created On, Status and Assignee Agent.
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
4.2. 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.
4.3. 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
4.4. Creating Zendesk service ticket from EZOfficeInventory mobile app
While checking in an asset for service, users can also create a service ticket in Zendesk directly from the mobile application.
5. Zendesk Sunshine
We have integrated with Zendesk Sunshine Custom Objects! This development populates the asset data of Zendesk users on their Zendesk workspace so all asset-related customer tickets can be managed seamlessly.
To enable Zendesk Sunshine Custom Objects in your account, follow these steps:
- Make sure you are on the Zendesk Enterprise plan.
- You must have the role of an Administrator. If not, ask an Adminsitrator to do it for you.
- Go to Zendesk Support Settings → Manage → Custom Objects.
Click on ‘Activate Custom Objects’ and you’re good to go.
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 EZOfficeinventory 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 can happens for two reasons:
- While installing the EZOfficeInventory app from Zendesk, you’ve provided an invalid Access Token or EZOfficeInventory subdomain. To troubleshoot, configure your app settings again from Zendesk or simply disconnect Zendesk from Settings –> Add Ons and then reconnect.
- When the subdomain for the account is changed in EZOfficeInventory 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.