Setting up Zendesk with Ferndesk
This guide shows you how to configure Ferndesk to open the Zendesk Web Widget when visitors click the contact button in your widget.
Before you begin: You must have the Zendesk Web Widget installed on your site with the launcher hidden. If you haven't done this yet, follow the steps below before configuring Ferndesk.
Step 1: Install and hide the Zendesk launcher
First, make sure the Zendesk Web Widget is installed on your site. You can find your installation code in Zendesk under Admin > Channels > Widget.
Add the following to hide the default launcher:
<script>
zE('webWidget', 'hide');
</script>This hides the Zendesk widget by default. Ferndesk will open it when visitors click your contact button.
Need help installing the Zendesk Web Widget? See Zendesk's Web Widget installation guide.
Step 2: Open widget settings
In your Ferndesk dashboard, go to the Widget page and click the Customize button on your widget.
Step 3: Navigate to Contact settings
In the sidebar, click Contact to open the contact configuration options.
Step 4: Select the Integration tab
Click the Integration tab to see available chat platforms.
Step 5: Choose Zendesk
Click the Zendesk card to select it as your integration platform.
Step 6: Test the integration
Visit your site where the Ferndesk widget and Zendesk are installed, then click the contact button in the widget. The Zendesk Web Widget should open, letting visitors start a conversation or submit a ticket.
If Zendesk doesn't open, verify that the Zendesk Web Widget is installed on the same page as your Ferndesk widget and that you've added the hide code.