This article describes setting up a view of Zendesk tickets for your users in Salesforce. This feature queries Zendesk Support in real-time from the Account, Contact, Lead, and Opportunity pages and does not store any Zendesk data in Salesforce.
Before creating a ticket view in Salesforce, you will need to Set up your Zendesk for Salesforce integration.
This article includes the following topics:
- Enabling and configuring Ticket View for Salesforce
- Adding a Lightning component or Visualforce page to your Salesforce page
- Checking if Ticket View has successfully installed
- Resolving ticket view errors
Related information:
Enabling and configuring Ticket View for Salesforce
The ticket view feature is a view of your Zendesk tickets in Salesforce. It is configured in your Admin Center.
To enable and configure Ticket View
- In your Zendesk Admin Center, select Integrations in the left navigation pane.
- Next to Salesforce, click Configure.
- If you installed the managed package when setting up your Zendesk to Salesforce connection, you can enable Ticket View. Continue to step 7.
- If you did not install the managed package during installation, click Install managed package. The package installs a Lightning component and Visualforce component in your Salesforce account that will be used for Ticket View. We recommend you select "Install for All Users". Users who are not granted access will not be able to view Zendesk tickets in Salesforce.
- Click Install.
- After installation of the package is complete, return to Admin Center and refresh the Ticket View page.
- Select the Enable Ticket View checkbox.
- In the Field Matching section, configure the matching criteria to filter which tickets are displayed in Salesforce.
The default criteria for how tickets are displayed on Salesforce pages are:
- Find account tickets by: Show tickets where the ticket requester's Zendesk organization name matches the Salesforce account name.
- Find contact tickets by: Show tickets where the requester email address matches the Salesforce contact email.
- Find opportunity tickets by: Show tickets where the ticket requester’s Zendesk organization name matches the Salesforce account name.
-
Find lead tickets by: Show tickets where the requester email address matches the Salesforce contact email.
You can also set the account-wide filtering and ticket sorting displayed in Salesforce. By default, all unclosed tickets, sorted by descending status are shown.
The field used for matching within Salesforce needs to be visible to Salesforce users looking at Ticket View. The minimum requirement is read-access only.
Each Salesforce user can set their personal default filtering and sorting by changing this in the Zendesk UI in Salesforce.
- After you’ve enabled and configured your Ticket View settings, click Save.
Adding a Lightning component or Visualforce page to your Salesforce page
After installing the managed package, you need to add the Lightning component or Visualforce page to your Salesforce Contact, Lead, or Opportunity pages to display Zendesk tickets. If you choose to add a Lightning component, you must have a Salesforce My Domain subdomain.
To add your Lightning component or Visualforce page to your Salesforce page
- In Salesforce, click on the App Launcher icon in the upper left, select View All, then click the link to an Accounts, Contacts, Leads, or Opportunities page.
- Select the Account, Contact, Lead, or Opportunity object.
- Navigate to edit page by clicking on the cog on the upper right, and select Edit Page.
- If you wish to use the Lightning component, find your Lightning component listed under "Custom" in the list of components on the left. Remember, this only works if you have My Domain enabled.
- Drag "Zendesk_Ticket_View" onto the page.
- If you wish to use the Visualforce page, find the Visualforce component listed under Standard on the left sidebar.
- Drag the Visualforce page onto the page layout and select the "Zendesk_Ticket_View_Account" on the right sidebar under the "Visualforce Page Name" menu. Repeat this step for the Contact, Lead and Opportunity pages.
- Click Save to update.
- Navigate to your Salesforce page, and a view of your Zendesk tickets appears, as shown in the example below.
Checking if Ticket View has successfully installed
The following procedure helps you check if Ticket View has successfully installed in Salesforce.
- Go to Salesforce > Setup > Deployment Status.
- Check the deployment time when you installed the package and see if the deployment was successful or failed. If deployment failed, Salesforce will provide you with detailed errors. Review the errors and resolve them. If you are unable to resolve them, contact Zendesk Support and provide a screenshot of the error.
- Check if the components were successfully created.
For the Lightning component, go to Salesforce > Setup > Lightning Components > Zendesk_Ticket_View
For the Visualforce page, go to Salesforce > Setup > Visualforce Pages > Zendesk_Ticket_View
- If steps 2 and 3 are successful, continue with setting up Ticket View.
Enabling profiles to view Ticket View
Profiles that require visibility of the Ticket View feature can be enabled in Visualforce pages.
To enable profiles to view Ticket View
- In Salesforce, go to Setup > Custom Code > Visualforce Pages.
- Next to the label which includes "Zendesk_Ticket_View_Contact", "Zendesk_Ticket_View_Lead", "Zendesk_Ticket_View_Opportunity", and "Zendesk_Ticket_View_Account", click Security under the Action column.
- Select Profiles from Available Profiles, add them to Enabled Profiles, then click Save,
Resolving ticket view errors
When you create or update the ticket view in Salesforce, any error messages you may see helps identify where the problem occurred. Use the following table to resolve errors in your ticket view configuration.
| Error message | Action required |
| Authentication between Salesforce and Zendesk is not complete. Please contact your administrator to complete setup in Zendesk Admin Center. | A Zendesk Admin can access the Admin Center and:
|
| Displaying Zendesk Tickets in Salesforce is not enabled. Please contact your administrator to enable this in Zendesk Admin Center. | A Zendesk Admin can access the Admin Center and:
|
| The connection between Salesforce and Zendesk was interrupted. Please contact your Administrator to re-authenticate in Zendesk Admin Center. | A Zendesk Admin can access the Admin Center and:
|
| The Zendesk user who setup the integration has changed or been removed. Please contact your Administrator to re-authenticate in Zendesk Admin Center. | A Zendesk Admin can access the Admin Center and:
|
39 Comments
Hi Gaylene,
Just to confirm, are you talking about sending tickets over into Salesforce as Case objects? If so, then the Ticket View offers a few options that the Case object wouldn't: most notably:
Hopefully this helps to answer your question!
Your instructions have been very good and accurate up to a particular point on this page, but then I've encountered multiple ambiguities that are leaving me stuck.
I successfully completed the "Enabling and configuring Ticket View for Salesforce". But it is not clear what is the next step. Your instructions say...
OK, but I was able to install the ticket view package, so I assume that means I can skip that step, right? OK, then what is the next step then?
Is it this ? ...
I never created a Lighting component or Visualforce page, but your instructions are very vague at this point on what I should do next, so I guess I'll go ahead and try this step. But, then I immediately run into a problem...
But I have no "Edit Page" in my "Setup" cog...
I do have "Edit Object", so let's take a wild stab at that....
Bzzzt, gong.... not at all the same screen you show in your instructions.
So, I'm kinda stuck here.
Also, another issue with your instructions on this page... the second to the last step on this page is...
I *can* successfully complete this step, but then at step 4, you say...
Ummm... but then the instructions end. Where is the "Setting up Ticket View" section? Wait, that's actually the main title of this web page... so now I'm really confused... this step is referring to a previous step? I don't get it.
Please help. Thank you!
Hi Eng,
Thanks for calling out the lack of clarity in our documentation. I'll try to explain here, but it may be easier to hop onto a screen-sharing session or cover this within a ticket.
You mention "I never created a Lighting component or Visualforce page", but you mentioned that you were able to install the ticket view package. Per our documentation:
The reason that you're not seeing an "Edit Page" option is that you're not in a specific account, you're looking at the list of accounts. If you click into one of them and then go to the Setup menu you should see that option.
I'm going to flag this article to add a step in between points 2 & 3 to clarify this:
Please let me know if this helps you to get things set up.
Thanks for the feedback
Hi Dwight Bussman,
We are using both the ticket sync to cases and the tickets view. Both working fine, but I was wondering if there is any way I can setup the ticket view component for the Cases. We would like to be able use the ticket view on the Case to review comments which are currently not synced with Salesforce. When added to accounts and contacts the ticket view displays the tickets list but when added to cases it doesn't show anything.
Thanks,
Nevena Imetska
Hi Nevena,
The ticket-view is only available on the following objects:
This is likely why you're not seeing any results on the Case object.
Could you please clarify the workflow that your Sales folks are using to pull up those cases? Rather than looking at the case objects themselves, could they just use the view on the Account/Contact area instead? The Case object is intended more for reporting/workflow purposes, whereas the ticket-view is meant to give that granular comment-level detail.
Update: We have released changes to the setup process for Ticket View, making it easier to start viewing tickets in Salesforce. This requires the installation of a Salesforce Managed package, which you can install during the setup process or on the Ticket View configuration page in Admin Center. Installing the Managed Package will automatically create the lightning component and visualforce page (VFP) in your Salesforce account.
What happens if you are already using the integration and Ticket View?
You can continue to use Ticket View without disruption. The next time you disconnect and reconnect, you will go through the new setup process and need to install the Managed Package. You'll then need to add the new lightning component or VFP to your Account, Contact, Lead and/or Opportunity pages and remove the old ones.
Don't worry, all your Ticket View configuration settings will be saved.
Please post any questions in the comments!
Any updates on allowing clients or users to modify the columns that is shown from the ticket view?
I think this is a huge gap with the current ticket view given that most clients create custom fields that are critical to the tickets being managed in Zendesk, and providing that option would allow clients to view those critical information from the get-go in the Ticket View component in Salesforce
We recently had to disconnect and reconnect our new integration and have the following issues:
1. I am getting these on my normal users, but the integration user that I used to make the connection shows current tickets.
2. How do I delete ALL other Zendesk integrations after this is setup?
HeyO Steven Aranaga
Both of these questions have a few possible causes/approaches, depending on your setup. I'd recommend raising a ticket with our Support folks to take a closer look into this on your behalf.
Please sign in to leave a comment.