Ferndesk
3rd-party chat widgets

Setting up Crisp with Ferndesk

This guide shows you how to configure Ferndesk to open Crisp Live Chat when visitors click the contact button in your widget.

Before you begin: You must have the Crisp widget installed on your site with the launcher disabled. If you haven't done this yet, follow the steps below before configuring Ferndesk.

Step 1: Install and hide the Crisp launcher

First, make sure Crisp is installed on your site. You'll need to disable the default Crisp launcher so it doesn't show alongside your Ferndesk widget.

Add this code right after your Crisp installation snippet:

$crisp.push(['do', 'chat:hide']);

This hides the Crisp chatbox by default. Ferndesk will show it when visitors click your contact button.

Need help installing Crisp? See Crisp's Web SDK documentation.

Step 2: Open widget settings

In your Ferndesk dashboard, go to the Widget page and click the Customize button on your widget.

Ferndesk dashboard showing the Customize button on the widget card

Step 3: Navigate to Contact settings

In the sidebar, click Contact to open the contact configuration options.

Widget customization sidebar with Contact option highlighted

Step 4: Select the Integration tab

Click the Integration tab to see available chat platforms.

Contact settings showing the Integration tab with plug socket icon

Step 5: Choose Crisp

Click the Crisp card to select it as your integration platform.

Platform selection showing Crisp among available integrations

Step 6: Test the integration

Visit your site where the Ferndesk widget and Crisp are installed, then click the contact button in the widget. The Crisp chat should open, letting visitors start a conversation with your team.

If Crisp doesn't open, verify that the Crisp widget is installed on the same page as your Ferndesk widget and that you added the chat:hide code.

Was this helpful?