Setting up Intercom with Ferndesk

This guide shows you how to configure Ferndesk to open the Intercom Messenger when visitors click the contact button in your widget.

Step 1: Install and hide the Intercom launcher

First, make sure the Intercom Messenger SDK is installed and initialized on your site. Follow Intercom's installation guide to enable Messenger for Web in your Intercom settings panel, then choose an installation method to get your installation code.

Optionally, in your Intercom installation code, add hide_default_launcher: true to your window.intercomSettings object:

<script>
  window.intercomSettings = {
    api_base: "https://api-iam.intercom.io",
    app_id: "YOUR_APP_ID",
    hide_default_launcher: true,
  };
</script>

This hides the Intercom launcher by default. Ferndesk will open it when visitors click your contact button.

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 Chat tab

Click the Chat tab to see available chat platforms.

Step 5: Choose Intercom

Select the Intercom option under Choose a chat widget, then click Save changes to persist your configuration.

Step 6: Test the integration

Visit your site where the Ferndesk widget and Interco is installed. Click the contact button in the widget. The Intercom Messenger should open, letting visitors start a conversation with your team.