The Outlook integration allows Outlook users with or without a Zendesk account to copy email contents to a new ticket in Zendesk without leaving the Outlook application.
This article covers the following topics:
- Requirements for setting up the integration
- Installing and configuring the integration
- Deleting the integration
- Frequently asked questions
Requirements for setting up the integration
The integration setup should be done in the Exchange Center admin by the administrator of your Microsoft organization to ensure that any tickets created are sent to the correct Zendesk subdomain for your organization. Additionally, to set up the integration, you must:
- Have Microsoft 365
- Have permissions to install Outlook add-ins
- Be a Zendesk administrator
- *If you are using an on-premise exchange server, please consult with Microsoft support to configure the server to ensure that the add-in will work
Installing and configuring the integration
Before you can use the Outlook integration, you must perform the following tasks:
- Install the Zendesk add-in to Outlook
- Configure the Zendesk add-in
- Set up the integration
To install the Zendesk add-in
- Open Microsoft 365, and click on the Admin panel.
- In the left sidebar menu, select Admin and click Exchange.
- In the Organization section, click on add-ins.
- Click on the plus symbol and select Add from the Office Store.
- Click on Zendesk to select the add-in, then click Add.
- Return to the add-in list and double-click Zendesk Add-in.
This installs the Zendesk add-in from the Microsoft Store.
To configure the Zendesk add-in
- Open Outlook and select an email.
- Click the Zendesk add-in.
- Make sure the following options are selected:
- Make this add-in available to users in your organization
- Mandatory, always enabled. Users can't disable this add-in
- Go to your Outlook desktop application and click the Zendesk button on the upper-right part of the screen.
- Click Create Ticket.
You should see an error message with a link to set up the integration.
To set up the integration
- In the error message described above, click the Set Up Now link. You are redirected to the integration setup page.
- Enter your subdomain, then click Authorize.
- Complete the setup and return to Outlook.
- Close the add-in and reopen it again.
- Complete the ticket information in the right pane, then click the Create Ticket button.
You receive a confirmation message that the ticket was successfully created in Zendesk.
Deleting the integration
Go to https://outlook.zendesk-integrations.com/account, enter your Zendesk subdomain, and click delete.
Frequently Asked Questions
I successfully completed the integration setup, but it still shows "Set Up Now" in the add-in window.
Close the add-in window by clicking on the add-in and reopen it by clicking it again. This will refresh the add-in and enable you to create a ticket successfully.
The add-in is integrated with the wrong Zendesk subdomain. How can I change it?
Go to https://outlook.zendesk-integrations.com/account, enter your Zendesk subdomain, and click delete. Once deleted, you can set up the integration again with the new subdomain.
When I click "View in Zendesk" I’m asked to log in, but I don’t have credentials. How can I view the ticket in Zendesk?
Only employees in your organization with a Zendesk account can view tickets inside Zendesk. Request a Zendesk account from your organization’s Zendesk admin to view the ticket inside Zendesk.
Why aren't images from my email visible in the Zendesk ticket?
This integration copies body text from your email message into the Zendesk ticket. Inline images do not copy over. However, if you have images attached to your email, they are copied as attachments to the Zendesk ticket.
How many Zendesk accounts can be connected to Outlook?
There is a 1:1 limitation for this integration.
If I have CCs on my email in Outlook, are they added to the Zendesk ticket?
CCs are not supported. The integration does not add CCs from the Outlook email to the Zendesk ticket.
Can I change the ticket fields that appear in the Zendesk add-in?
You cannot change or add ticket fields to the Zendesk add-in.