In Klaus you can search for specific conversations using your help desk's conversations IDs. Until now, this required you to log into Klaus, search for the ID and then start reviewing. Wouldn't it be nice if you could click through to the correct conversation right from your help desk setup?

Well, now you can - either by incorporating the query link into your help desk setup, or by using a Bookmarklet in your browser.

How to add a "Open in Klaus"-button to your help desk setup?

Klaus can open up a specific conversation if you add your help desk's conversation ID to the URL's query parameter labeled externalTicketId. An example URL would be https://kibbles.klausapp.com/conversations?externalTicketId=25338.

Your help desk admin will know how to use this information :)

How to use a Bookmarklet in your browser to open a conversation in Klaus?

You can automate the generation of this URL with a Bookmarklet. Below are some examples for those help desks that Klaus integrates with already. Feel free to modify these examples to redirect virtually any URL to Klaus, even when using the Klaus' API or the browser extension. Automation is your friend 🤖

Overview of the "Open-In-Klaus" bookmarklet

The bookmarklet consists of 2 general parts:

We provide some general feedback to the user if they're not on a valid conversation URL (e.g. for Zendesk that would be <domain>.zendesk.com/agent/tickets/<id>
Once we've confirmed the URL is valid, we redirect the user to Klaus with the aforementioned externalTicketId parameter.

As promised, here's a collection of bookmarklets for each of our integrations. To add the bookmarklet, go and find your help desk and just drag the "Review on Klaus" button to your bookmark bar!

Example

javascript: (() => {
  if (!location.hostname.endsWith('zendesk.com')) return alert('To be used on Zendesk only')
  const path = location.pathname.substring(1).split('/');
  if (path[0] !== 'agent' || path[1] !=== 'tickets' || isNaN(parseInt(path[2], 10))) return alert('Not a Zendesk ticket URL');
  location.href=`https://kibbles.klausapp.com/conversations?externalTicketId=${path[2]}`;
})();