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 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, 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. The setup process requires performing a series of tasks:
If you need to disconnect your integration, see Disconnecting the integration.
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 on the cog in the upper right pane, and 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
The Admin Center is where you set up and configure your integration including the integration location. It is recommended to test the integration with your Zendesk sandbox account and Salesforce sandbox account first.
To connect Zendesk to Salesforce
- In your Zendesk Admin Center, click the Integrations icon () in the left sidebar.
- Click Connect next to the Salesforce integration.
- Select the Salesforce instance to set up the integration.
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 a Lightning component and Visualforce component which is 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.
- 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 on the cog () in the upper right pane, and click Setup.
- In the left navigation pane under Platform Tools, select Manage Connected Apps and 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, and click the Salesforce Integration for Zendesk app.
- Under Profiles, select Manage Profiles.
- Select the user profiles in Salesforce which 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:
Disconnecting 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 are setting up the integration again, you will need to enable syncing and activate the Salesforce trigger again.
- Go to your Zendesk Admin Center and click the Integrations icon () in the left sidebar.
- In Salesforce integration, click Configure.
- Click Disconnect in the upper right. Confirmation of the disconnection is displayed.