Skip to main content

How Do I Set Up The Intercom Integration

Written by Alex Richards

How do I set up the Intercom integration?

Required Feature Flags

The following feature flags and permissions are required to use this feature:

Feature Flag

Technical Name

Description

Integrations

admin.integration.settings (contract-level)

Enables the Integrations menu and the Intercom integration tile

Required Permissions:

  • Manage Integrations (admin.integration.settings) β€” to authenticate, configure, and manage the Intercom integration

Setup

Go to Conversations > Integrations > Platforms tab > select the Intercom tile.

Intercom Integration Requirements

To set up the Intercom integration in evaluagent, the following is required:

  • A valid Intercom account with administrative privileges

  • Authorisation/permissions to install an Intercom app

Step 1: Authentication

Tick the Include notes? checkbox if you'd like to import your conversation notes from Intercom.

Use the Authenticate button to be redirected to Intercom to authenticate.

_Please note: you'll need to be logged into Intercom as an Intercom administrator/account owner to complete this step._

Step 2: Configure

Once you've completed authentication, you'll be directed to the configuration screen.

  • Part 1: Choose how much ticket information will be fetched into evaluagent. You have 2 options:

* Only fetch the ticket reference and any associated metadata (e.g. tags); or * In addition to this core data, fetch the full conversation thread. * By choosing the second option, you'll be able to access a copy of the full text of all interactions between customer and agent(s) as an integral part of the evaluation process.

  • Part 2: When evaluating tickets that contain multiple responses, you have 3 options:

* Split multi-response tickets so that each response can be evaluated separately. * Split multi-response tickets so that all responses from the same agent on the ticket are grouped together so that each agent's group of responses can be evaluated separately. * Don't split multi-response tickets and assign the _full_ ticket for evaluation to any one of the agents that have responded on the ticket. By default, evaluagent assigns the ticket and any resulting evaluation to the last responding agent but you may change this to any other agent who has responded on the ticket at the point of evaluation.

  • Part 3: Decide how long evaluated and non-evaluated tickets remain available in evaluagent. Any contacts older than your selection will be purged and permanently deleted from evaluagent in line with our secure data storage and deletion policies.

On clicking Save, evaluagent will start fetching tickets on a regular (typically hourly) cycle.

Did this answer your question?