Role: Admin, Account Manager
In this article, we'll look into sending information about different interactions on Intercom into Klaus. This includes elements like someone adding a tag, snoozing a conversation, etc.
By the end, you'll be able to see those events in your conversations on Klaus:
First, we'll need your Klaus connection ID. To find the unique connection ID, navigate to Settings > Connections
, find your connection and open up that connection's Settings modal via the cogwheel icon (โ๏ธ). You will need Admin permissions to do this.
The connection ID is listed right under the title:
Then we'll head over to Intercom's Developer Hub. You can find a link to it in your Settings > Developers
menu.
Once in the Developer Hub, click on New app, add a descriptive name and make sure it's marked as an Internal integration. Click Create app to proceed - you're doing great!
We now have an app that can be notified by Intercom of any events for our conversation in real-time. Let's head over to the app's Webhooks settings page and configure a few topics that interest us. Currently, Klaus expects the following topics:
conversation_part.tag.created
conversation_part.redacted
conversation.admin.snoozed
conversation.admin.unsnoozed
conversation.admin.opened
conversation.admin.closed
conversation.admin.assigned
Once you've selected the topics you're interested in, the last thing to do is use the connection ID that we found at the start and insert it into your request endpoint URL. The URL should have the following format:
https://events.pub.klausapp.com/capture/integration/intercom/token/<connection-ID>
With our test ID from before, the URL would look like this:
https://events.pub.klausapp.com/capture/integration/intercom/token/1000099
But make sure to swap out the <connection-ID>
for your own connection ID.
With all that done, we can click Save.
With the Webhook set up, Klaus will be notified of your conversation events and will automatically know to display them in the conversation body.