Skip to main content
All CollectionsIntegrationsIntercom
Setting up the Intercom integration
Setting up the Intercom integration

Everything you need to know about Planhat's Intercom integration

Christian Dreyer avatar
Written by Christian Dreyer
Updated over 8 months ago

Summary

  • Data you can sync

    • Sync Intercom chats into Planhat; labels and fields can be included

    • You can also send Intercom messages from within Planhat

  • Sync direction

    • Main sync of chats: Intercom to Planhat

    • Intercom messages can also be sent from Planhat

  • Sync frequency

    • New/updated chats are automatically synced into Planhat in near real time

    • Manual fetch to sync in historical chats

    • Sending Intercom messages: you can configure if/when you would like these to trigger automatically

  • Data mapping

    • Intercom chats are mapped to the Conversation model - type "chat" - in Planhat

Who is this article for?

  • All Planhat users

  • It's particularly relevant to those setting up the Intercom integration

Series

Intercom integration:


Article contents


Introduction

Planhat's Intercom integration makes it really easy to sync your chats into Planhat. After an initial manual sync of historical chats, new/updated chats will automatically sync.

Within Planhat, you can view your chats alongside other conversations, such as emails and meetings. It's simple to filter your view (e.g. see the highest priority chats), and to tag in colleagues to collaborate.

You can also visualise and analyse time-series chat data, meaning you can track trends over time, and identify spikes and outliers. With Planhat, you can act automatically in response to data, e.g. automatically applying Workflows or sending notifications in response to positive or negative indicators. You can even combine chat data with other data types (e.g. revenue data), allowing analysis such as who are the most expensive customers to support.

πŸš€ Tip: The Intercom integration also enables you to send Intercom messages to your End Users from Planhat. If you would like to know more about this, check out this article.

πŸ“Œ Important to note: The integration does not sync usage data from Intercom. For this, you can use Planhat's API, tracking script or product analytics integrations.


How does the sync work?

Mapping chats to customers

Chats are synced into Planhat if they can be mapped to End Users, via their email address (e.g. bob@pendo.com).

If a chat is received by Planhat and the End User already exists in your Planhat tenant, then the chat will be synced in and mapped to them.

If the End User doesn't yet exist in your Planhat tenant, but the Company does (e.g. Pendo in this case, as identified by the email domain), Planhat can automatically create the End User on that Company, and then sync in the chat. It's your choice whether you would like Planhat to create End Users from external conversations like this - it's configured per tenant. You can view your current setting under "Automatic Detection of New Contacts" within "General Settings"; speak to your CSM if you would like to enable or disable this.

Manual sync for historical chats

There is a button in the integration to manually "Fetch All". This is typically used when you first set up the integration, in order to sync past chats into Planhat.

It may also be used later on, if new End Users are added to Planhat using a different method than the Intercom integration, and then you want to sync in their historical chats. In addition, it's possible to manually sync Intercom chats for an individual Company, by going to their Company Profile, clicking the icon of three vertical dots in the top right, and selecting "Sync Intercom Conversations".

The default setting is that a manual sync goes back 60 days, which is suitable for most cases, but it's possible to change this to a shorter or longer time period on request (up to 360 days, although that's not recommended). Speak to your CSM if you would like to change this - it's set in "Chat Initial Sync Period" in the "Admin Settings" of your tenant, which is accessible to Planhat staff.

Ongoing sync for new/updated chats

Going forward, chats that are new or updated in Intercom will automatically sync into Planhat, in near real time.

Remember that chats can only sync in if they can be associated with an End User via the email address (as described above).


Setting up the integration

To set up Planhat's Intercom integration, follow these steps:

  1. Navigate to the Operations Module on the left bar, ensure the "Integrate" tab is selected, and click on the Intercom integration
    ​

  2. You will see a toggle button at the top of the page which will be set to "NO"; click on the toggle button and it will turn blue and show "YES"
    ​

  3. Click on the button that says "Connect with Intercom" and connect your account

  4. Within the "Fetch All" section:

    1. With the toggle switch at the top, choose whether to include chat labels (tags). If enabled, the Intercom labels will be created in Planhat

    2. Optionally, set up field mapping for chats. You can map Intercom system fields to Planhat fields on the Conversation model. (Currently, you cannot sync custom Intercom fields to Planhat)

    3. Press the "Fetch All" button to sync in historical chats (described earlier in this article)


Chats within Planhat

Intercom chats are saved in Planhat on the Conversation model, type "chat".

You can view the chats themselves on the Company and End User Profiles, as well as in the Conversations Module. It's easy to apply filters; for example, to specifically show Intercom chats (just filter by type is equal to "chat"), or to look for chats with a particular tag (e.g. "high priority" or "bug"). In the Conversations Module, you can even build more advanced filters based on chat fields you are syncing in, such as chat ratings, remarks or status. You can comment on chats in Planhat, e.g. to tag in other colleagues (typically to bring an issue to the attention of a team that doesn't use Intercom). It's even possible to reply to customers' chat conversations from within Planhat.

In addition, within the "Metrics" tab of the Data Module, chat volumes can be saved as time-series data (under the "Conversations" category). You can build on this raw time-series data with Calculated Metrics - for example, tracking trends over time, or comparing a Company's number of chats with the amount of money they are spending with you. In Pages (in the Customer Intelligence Module), you can create graphs to analyse and visualise chat data, including chat field data.


Further reading

This article has focused on syncing Intercom chats into Planhat. If you would like to learn about sending Intercom messages from Planhat, see here.

Did this answer your question?