A message such as "Ferndesk: intercom is not installed on this page." means Ferndesk found no chat tool there. Install it on the same page as the widget.
Use the widget with another chat tool
If your team already answers chats in another tool, the widget can open it when a customer needs a person. Customers see the Ferndesk widget and your AI agent first, and reach your chat tool only when they need your team.
Owners and admins can change this. A developer installs your chat tool on the same pages as the widget.
Set it up
Pick your chat tool
In Your agent > Customize > Handoff, set Where handoffs go to Chat and choose your tool. This covers your help center and every widget that follows your main handoff settings.
Install the tool next to the widget
Add your chat tool's own install code to the pages where the widget runs. Ferndesk hides the tool's button and opens it only when a customer asks for your team. Chatwoot is the exception: Ferndesk loads it for you.
Test it
Open a page with both, ask for a person in the Ferndesk widget, and check that your chat tool opens.
With Draft a handoff summary on, your chat tool opens with a short summary of the conversation typed in, so the customer doesn't have to explain again. The customer sends it.
Which tools work
Tool | What you add to your site |
|---|---|
Intercom | The Intercom Messenger. Add hide_default_launcher: true to window.intercomSettings so its button never flashes before Ferndesk hides it. |
Help Scout | The Beacon. You don't need to hide its button. |
Zendesk | The Zendesk Messaging Web Widget. |
Crisp | The Crisp chatbox. |
Pylon | The Pylon chat widget. |
Plain | Plain's chat, started with Plain.init. Ferndesk hides Plain's launcher, and opens the chat again when your team replies while it is closed. |
Chatwoot | Nothing. Enter your Chatwoot address and website token in Ferndesk. A self-hosted Chatwoot needs a paid Ferndesk plan. Chatwoot Cloud also works during a trial. |
For any other tool, set Where handoffs go to Link and point it at your contact page.
If the chat tool does not open
The console says the tool is not installed on this page
Nothing happens when I ask for a person right after the page loads
Ferndesk waits up to 30 seconds for your chat tool to load. For Intercom, the full Messenger has to load, not only Intercom's placeholder script. Wait a moment and try again.
My site blocks Chatwoot
If your site sends a Content Security Policy, allow your Chatwoot address in script-src, frame-src and style-src.