Skip to main content

​
Intro

Intercom is a platform used to integrate customer messaging apps for sales, marketing and support connected on one platform. To learn more about the Intercom API, visit their page (https://developers.intercom.com/inte…ence/reference ). You connect to your Intercom account in the Data Center. This topic discusses the fields and menus that are specific to the Intercom connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in a DataSet Using a Data Connector.

​
Prerequisites

To connect to your Intercom account and create a DataSet, you must have an Intercom access token. For information about obtaining an access token, see https://developers.intercom.com/docs…-access-tokens. Note that some reports require your access token to have “extended scope.”

​
Connecting to Your Intercom Account

This section enumerates the options in the Credentials and Details panes in the Intercom Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.

​
Credentials Pane

This pane contains fields for entering credentials to connect to your Intercom account. The following table describes what is needed for each field:

Field

Description

Access Token

Enter your Intercom access token. For more information, see “Prerequisites,” above.

Once you have entered valid Intercom credentials, you can use the same account any time you go to create a new Intercom DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.

​
Details Pane

This pane contains a primary Reports menu, along with various other menus which may or may not appear depending on the report type you select.

Menu

Description

Report

Select the Intercom report you want to run. The following reports are available:

Report Name

Description

Admins

Returns a list of admins for this connector.

Attached Companies

Returns a list of companies that are associated with a contact.

Attached Contacts

Returns a list of all the contacts that are associated with a company.

Attached Tags

Returns a list of all the tags that are associated with a contact.

Companies

Returns a list of companies.

Contacts

Returns a list of all the contacts.

Contact by Contact Id

Returns the details of a specific contact.

Conversations

Returns a list of all the conversations.

Conversations by Conversation Id

Returns the details of a single conversation.

Counts

Returns the count of your application.

Notes

Returns a list of notes that are associated with a contact.

Notes by Notes Id

Returns the details of a single note.

Segments Returns a list of all the segments.
Tags Returns a list of all the tags.
Teams Returns a list of all the available teams.

AI content import sources

Returns a list of all content import sources for a workspace.

AI external pages

Returns a list of all external pages for a workspace.

Event Type

Select whether to pull user or lead events.

Conversation Admin Type

Select the type of conversation admin to pull data for.

All

Retrieves all conversations for both assigned and unassigned users.

Specific

Retrieves all conversations for a given admin. Note that when querying conversations for a given user, Intercom carries out message matching for the user and your existing auto messages. This will happen at most once every 15 minutes.

Unassigned

Retrieves unassigned conversations.

Company

Select the company you want to retrieve data for.

Segments

Select the segments you want to retrieve data for.

Tags

Select the tags you want to retrieve data for.

Users

Select the users you want to retrieve data for.

Leads

Select the leads you want to retrieve data for.

Email ID

Enter the lead you want to retrieve data for.

Admin

Select the admin you want to retrieve data for.

Option to Expand

Select the column you want to expand.

Skip Failed Conversations

When you check this box, if Intercom fails to return details for a conversation, it will be excluded from the DataSet, and Domo will continue processing instead of failing the run. This may result in missing data.

Conversation Status

Select the conversation status you want to filter your report by.

Order

Select whether you want to sort your data by created or last updated date.

​
Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see a DataSet Using a Data Connector.

​
FAQs

DataSets can be updated as often as once an hour, though this should be decreased if rate limits are encountered.
Intercom allows 83 calls per 10 seconds or roughly 500 per minute.
Intercom requires an access token to authenticate. Be aware that some reports require that your access token include “extended access” to work. If you receive an authentication error and your key is valid, check with your Intercom administrator to get “extended access” added to your API key.