The Zendesk for Salesforce integration connects your Salesforce accounts to Zendesk accounts. It allows Zendesk tickets to be viewed in Salesforce from an Account, Contact, Lead, or Opportunity page. You can also create and edit Zendesk tickets, and sync Salesforce accounts to Zendesk organization data. For more information about the benefits and the limitations of the Zendesk for Salesforce integration, see Guide to integrating Zendesk and Salesforce.
The Zendesk for Salesforce integration is available if you are using Salesforce edition: Performance, Unlimited, Enterprise, or Developer Edition (or other editions with Salesforce API rights, such as Professional with the API add-on).
You must be a Zendesk Support administrator and Salesforce administrator to set up your integration. You cannot use an API-only Salesforce user to connect the integration.
The setup process requires performing a series of tasks:
If you need to disconnect your integration, see Disconnecting and reconnecting the integration.
Related information:
Checking your Salesforce session settings
The integration requires your Salesforce session settings to be not set to a locked IP address. If your session settings remain locked, your integration will be disconnected once a session expires.
To disable Salesforce sessions being locked to an IP address
- Log in to your Salesforce account.
- Click the cog (
) in the upper right pane, then click Setup.
- In the left navigation pane under SETTINGS > Security, select Session Settings.
- Review and ensure the Lock sessions to the IP address from which they
originated checkbox is not selected.
Connecting Zendesk to Salesforce
Admin Center is where you set up and configure your integration, including the integration location. You should test the integration with your Zendesk sandbox account and Salesforce sandbox account first.
To connect Zendesk to Salesforce
- In Admin Center, click
Apps and integrations in the sidebar, then select Integrations > Integrations.
- On the Integrations page, click Salesforce.
- Select the Salesforce instance to set up the integration: Salesforce
Production or Salesforce Sandbox.Note: You can only connect one Salesforce account to one Zendesk account. So if you test the integration on a sandbox account, you need to disconnect the integration and reconnect to your production account.
- Click Install managed package. This opens Salesforce in a new web
browser tab. The package installs Lightning and Visualforce components,
which are used for the Ticket View feature. You will be
asked to log in to Salesforce if you are not already logged in. Do this in a
private web browser window to ensure that there is only one active
Salesforce session. Note: We recommend selecting Install for All Users. Users who are not granted access cannot view Zendesk tickets in Salesforce.
- Click Install.
- When the package has finished installing, click Done.
You are returned to the Salesforce integration setup page in Admin Center.
- Accept the Built by Zendesk Terms of Use, then click Connect.
- On the Allow Access? screen, click Allow.
Setting up user access to Zendesk tickets in Salesforce
After setting up your connection between Zendesk and Salesforce, you need to define which user profiles in Salesforce can view Zendesk tickets.
To select user profiles to view Zendesk tickets
- In Salesforce, click the cog (
) in the upper right pane, then click Setup.
- In the left navigation pane under PLATFORM TOOLS, select Apps > Connected Apps > Manage Connected Apps.
- Click the Salesforce Integration for Zendesk app.
- Click Edit Policies.
- Under OAuth Policies, set Permitted Users to Admin
approved users are pre-authorized and click Save. This is a
required setting.
- Return to the Manage Connected Apps page, then click the Salesforce Integration for Zendesk app.
- Under Profiles, select Manage Profiles.
- Select the user profiles in Salesforce that can view Zendesk tickets. You
must select the System Administrator profile. User profiles that
are not selected will not be able to view Zendesk tickets.
- Click Save.
Your setup is now complete. Next, you can continue with the following:
Disconnecting and reconnecting the integration
The Zendesk for Salesforce integration can be disconnected in the Admin Center. Once disconnected, your configuration settings are still retained if you decide to set it up again. If you're reconnecting the integration, you'll need to enable syncing and activate the Salesforce trigger again.
- In Admin Center, click
Apps and integrations in the sidebar, then select Integrations > Integrations.
- On the Integrations page, click Salesforce.
- Click Disconnect in the upper right. Confirmation of the disconnection is displayed.
To reconnect the integration
- In Admin Center, click
Apps and integrations in the sidebar, then select Integrations > Integrations.
- On the Integrations page, click Salesforce.
- Click Connect.
- On the Salesforce integration setup page, click Connect.
- Re-enable syncing for the following settings:
- Activate your Salesforce trigger again.
84 comments
Dan Greaves
I'm investigating an automated way of taking Posts data from the Gather platform and pushing it into Salesforce and associating it with contact/account records. Is that something that sounds possible using the Help Center API?
0
Dwight Bussman
Dan -
If you're willing to have those posts create tickets within Zendesk, you could leverage the native Ticket Sync feature - Setting up Ticket Sync from Zendesk to Salesforce - to pass that over to SFDC. We have some built-in logic to associate the cases this feature creates with SFDC Accounts/Contacts based on the organization/requester of the ticket.
0
Dan Greaves
Ok, that's a good call and definitely something we can explore. If we decided that we didn't want to automatically have a Zendesk ticket created for all community posts, would the Help Center API provide endpoints for us to programmatically grab community posts data and pull it into Salesforce? Understanding, of course, that we would need to do some custom dev work on our side in SFDC.
0
Nick Sauvé
Hey all! If I set this up while logged into my account in our company Zendesk instance, and I leave the company and my account in Zendesk is deactivated, will that break the oauth connection between Salesforce and Zendesk?
0
Dwight Bussman
HeyO Nick -
Yes: if your Zendesk user was the one who connected the integration, downgrading them will break the connection. Here's the passage in the above article that addresses this:
One of the admins who's not leaving can preemptively disconnect & reconnect the integration within admin center. All of the settings will be preserved, but the various features (ticket view, data sync, ticket sync) will have to be re-enabled following that re-connection.
1
Nick Sauvé
Gah, thanks Dwight! Can't believe I overlooked that but I appreciate the quick response!
1
Hoa Chiang
Hi, a lot of the Salesforce integration documentation revolves around ticket creation and support. We'd like to use it for Help Center (Guide) authentication. We'd like to limit our help center to only our clients being able to access the content. Is this possible and is there any documentation specific to this? Or is it implied that setting up the integration also inherently controls Help Center access? Thanks!
0
Dwight Bussman
Hoa-
The only point of overlap that I see between the Salesforce Integration and Help Center access would be the Account/Contact Sync being able to sync users into organizations or add tags. Once that information has been synced over, it would be possible to control access to specific Help Center content through the User Segments feature.
Similarly, it's possible to write custom-code that would restrict various portions of the Help Center such as ticket-submission based on a user's organization membership. This is documented in the following article: Hide ticket forms based on user's organization
Hopefully these help to answer your question. If not, please feel free to contact our support team for more assistance.
0
Jen Ma
Is it possible to map Zendesk tickets to custom objects in Salesforce using the Zendesk Saleforce native app?
0
Dwight Bussman
HeyO Jen -
The Salesforce sidebar app (which is one part of this integration) can pull information about custom objects assuming one of the following is true:
or
1
Jen Ma
Thank you Dwight! Thank you for the quick response! I reviewed the article and also the syncing data from Zendesk to Saleforce. I noticed that the article only talks about how to sync Zendesk data to Case Custom objects. Is there a way to sync it to Saleforce custom objects? Our other vendor doesn't use Case Saleforce custom objects.
0
Dwight Bussman
Our sync from ZD > SFDC goes into Cases alone. That said, it should be possible to make a custom workflow within Salesforce to take that Case information and carry it over to a custom object. This sort of custom coding isn't done natively by our integration, but I've definitely seen customers who're doing similar things in the past.
0
The Original DKNY
Has Bi-Directional Sync for Users and Orgs created in Zendesk to be created in Salesforce been delivered yet? This feature is still absent as far as I am aware.
0
Dwight Bussman
The ability to sync user/org changes from Zendesk to update existing SFDC contacts/accounts has not yet been delivered.
0
Ben Harrison
For an integration with Salesforce, is it possible for a ZenDesk support ticket to not only appear on the Contact record associated with the external "requestor", but to aggregate all of the Contact's tickets on an Account. For example: Contact A, Contact B and Contact C all work at Account 1. Contact A has 2 tickets, Contact B has 2 tickets and Contact C has 6 tickets. Is there a way for all 10 ZenDesk support tickets to appear on Account 1?
0
Dave Dyson
Hi Ben,
If Contact A, B, and C, user profiles in Zendesk are all associated with the same Organization, and the Organization's name in Zendesk matches their Account name in Salesforce, then yes, you should be able to set up Ticket View in Salesforce so to that it will show all tickets from those users (and I think that may in fact be the default setting). Take a look at the "Ticket View" video here (forward to about 2:06) and you'll be able to see what the settings for that should look like – under Field Matching, make sure it says "Find account tickets by: Organization name, Using Salesforce field: Account Name": Salesforce integration video guides
Hope that helps!
1
Paul Wickes
Hi,
Is there native support in the sync for the Salesforce 'Asset' object?
0
Dwight Bussman
HeyO Paul Wickes
Our syncing can act on the following objects:
SFDC > ZD
ZD > SFDC
Any interaction between the Asset object and one of the aforementioned 5 objects would require custom logic to be created within SFDC as our native integration does not interact with it directly.
0
Victor Carreon
Will the Zendesk -> Salesforce integration be affected by the shift from targets to webhooks? If so, is there a resource to help us update the auto-generated "Sync tickets to Salesforce" automation?
0
Dwight Bussman
HeyO Victor Carreon
I have heard that there is a plan to have those targets auto-migrate to Webhooks at some point, so there shouldn't be any need for action on your part.
I'll try to get additional detail and share here if I learn more that's worth sharing.
0
Victor Carreon
Hi Dwight Bussman,
Thanks for the prompt reply! I'll keep an eye on this thread for more info.
0
Dwight Bussman
HeyO Victor - the developers that own this migration process just came online and mentioned that the migration of integration-created Targets to Webhooks is actively being worked on and should be coming quite soon.
They confirmed my belief that you won't need to take any action - it will happen automatically and they are doing lots of work to insure that no integrations are broken by the migration process.
Sorry I can't provide a more specific timeframe, but hopefully that helps to put your mind more at ease on this matter. I recommend following our Announcements page to stay up to speed on the latest releases.
0
Marlise Briedenhann
Hi there,
We have setup Salesforce Zendesk Integration and have added the ticket viewer component to our Account, Contact and Opportunity record pages.
We have a custom object which is a precursor to an Account being created which contains an email address. I was wondering is it possible to configure the ticket viewer for custom objects, specifying the zendesk requester email to match the Salesforce custom object's email field?
Regards,
0
Dwight Bussman
Hi Marlise Briedenhann
At the moment, the ticket view can only be embedded on 5 objects:
For more on the configuration options available, please see: https://support.zendesk.com/hc/en-us/articles/4408834115738
0
Allen Lai | Head of CX at Otter.ai
In the Salesforce lead, a salesperson will click on the new "Zendesk" tab that will show any Zendesk tickets associated with that lead. But the "New Ticket" button is greyed out for them, but it's available for me. Is this because the salesperson's Salesforce email is not linked to a Zendesk agent license?
0
Dwight Bussman
Allen Lai | Head of CX at Otter.ai
That's correct - they'll need to link a Zendesk user as documented here: https://support.zendesk.com/hc/en-us/articles/4408828317082-Using-Ticket-View-in-Salesforce#topic_nd4_c1r_pjb
0
Hans Lohmann
Hey there,
we're setting up the Salesforce App in Zendesk at the moment. We do the lookup via a custom ticket field which contains the Salesforce Account ID. We're able to display informations from the Account, related Opportunities.
But for example on Contacts, it shows only those who are direct contacts for the specific account. Our expectation would be that all related contacts are shown, regardless if they're direct or not
Besides that we're wondering how to make use of Contact Relationships in a meaningful way, so that for example we can display the Role of the contact in the Account
Thanks
Hans
2
Scott H
In the step
0
Dwight Bussman
Hi Scott H
That indicates that your integration has already been connected at some point.
0
Scott H
How can I check that? I uninstalled the app in zendesk and re installed. I do not see any instance of it in Salesforce.
0