Intercom as a data source

Bring data from Intercom to Nekt.

Intercom is a customer messaging platform that helps businesses communicate with their customers through live chat, email, and in-app messaging. It provides tools for customer support, lead generation, and user engagement, with features like automated messaging, customer data management, and integration with various business tools to enhance customer relationships and drive growth.

Configuring Intercom as a Source

In the Sources tab, click on the “Add source” button located on the top right of your screen. Then, select the Intercom option from the list of connectors.

Click Next and you’ll be prompted to add your access.

1. Add account access

You’ll need to authorize Nekt to access your Intercom data. Click on the Intercom Authorization button and log in with your Intercom account. Grant the necessary permissions for the data you want to extract.

The following configuration is available:

• Start Date: The earliest date from which records will be synced (e.g., 2010-01-01). Used for the first full sync and when no previous state exists.

Once you’re done, click Next.

2. Select streams

Choose which data streams you want to sync - you can select all streams or pick specific ones that matter most to you. The available streams include companies, contacts, tickets, ticket types, conversations, and conversation parts.

Tip: The stream can be found more easily by typing its name.

Select the streams and click Next.

3. Configure data streams

Customize how you want your data to appear in your catalog. Select a name for each table (which will contain the fetched data) and the type of sync.

• Table name: we suggest a name, but feel free to customize it. You have the option to add a prefix and make this process faster!

• Sync Type: you can choose between INCREMENTAL and FULL_TABLE.

  • Incremental: every time the extraction happens, we’ll get only the new data - which is good if, for example, you want to keep every record ever fetched.
  • Full table: every time the extraction happens, we’ll get the current state of the data - which is good if, for example, you don’t want to have deleted data in your catalog.

Once you are done configuring, click Next.

4. Configure data source

Describe your data source for easy identification within your organization, not exceeding 140 characters.

To define your Trigger, consider how often you want data to be extracted from this source. This decision usually depends on how frequently you need the new table data updated (every day, once a week, or only at specific times).

Optionally, you can determine when to execute a full sync. This will complement the incremental data extractions, ensuring that your data is completely synchronized with your source every once in a while.

Once you are ready, click Next to finalize the setup.

5. Check your new source

You can view your new source on the Sources page. If needed, manually trigger the source extraction by clicking on the arrow button. Once executed, your data will appear in your Catalog.

For you to be able to see it on your Catalog, you need at least one successful source run.

Streams and Fields

Below you’ll find all available data streams from Intercom and their corresponding fields:

Companies

Stream for managing company information within your Intercom workspace.

Field	Type	Description
id	String	Unique identifier for the company
company_id	String	Company ID from your system
name	String	Name of the company
created_at	Integer	When the company was created (Unix timestamp)
updated_at	Integer	When the company was last updated (Unix timestamp)
monthly_spend	Number	Monthly spend amount
session_count	Integer	Number of sessions
user_count	Integer	Number of users in the company
type	String	Object type identifier
app_id	String	ID of the application
tags	Object	Tags associated with the company
segments	Object	Segments the company belongs to
plan	Object	Plan information
custom_attributes	Array	Array of custom attributes

Contacts

Stream for managing contact information and their interactions with your business.

Field	Type	Description
id	String	Unique identifier for the contact
type	String	Object type identifier
workspace_id	String	ID of the workspace
external_id	String	External identifier from your system
role	String	Role of the contact (user, lead, visitor)
email	String	Email address
phone	String	Phone number
name	String	Full name of the contact
avatar	String	Avatar URL
owner_id	String	ID of the admin who owns this contact
created_at	Integer	When the contact was created (Unix timestamp)
updated_at	Integer	When the contact was last updated (Unix timestamp)
signed_up_at	Integer	When the contact signed up (Unix timestamp)
last_seen_at	Integer	Last time the contact was seen (Unix timestamp)
last_replied_at	Integer	Last time the contact replied (Unix timestamp)
last_contacted_at	Integer	Last time the contact was contacted (Unix timestamp)
last_email_opened_at	Integer	Last time the contact opened an email (Unix timestamp)
last_email_clicked_at	Integer	Last time the contact clicked an email link (Unix timestamp)
has_hard_bounced	Boolean	Whether emails have hard bounced
marked_email_as_spam	Boolean	Whether contact marked emails as spam
unsubscribed_from_emails	Boolean	Whether contact unsubscribed from emails
location	Object	Geographic location information
browser	String	Browser name
browser_version	String	Browser version
browser_language	String	Browser language
os	String	Operating system
language_override	String	Language override setting
android_app_name	String	Android app name
android_app_version	String	Android app version
android_device	String	Android device model
android_os_version	String	Android OS version
android_sdk_version	String	Android SDK version
android_last_seen_at	Integer	Last seen on Android (Unix timestamp)
ios_app_name	String	iOS app name
ios_app_version	String	iOS app version
ios_device	String	iOS device model
ios_os_version	String	iOS OS version
ios_sdk_version	String	iOS SDK version
ios_last_seen_at	Integer	Last seen on iOS (Unix timestamp)
social_profiles	Object	Social media profiles
utm_campaign	String	UTM campaign parameter
utm_content	String	UTM content parameter
utm_medium	String	UTM medium parameter
utm_source	String	UTM source parameter
utm_term	String	UTM term parameter
referrer	String	Referrer URL
sms_consent	Boolean	Whether contact consented to SMS
unsubscribed_from_sms	Boolean	Whether contact unsubscribed from SMS
enabled_push_messaging	Boolean	Push messaging enablement status
tags	Object	Tags associated with the contact
notes	Object	Notes about the contact
companies	Object	Companies the contact belongs to
custom_attributes	Array	Array of custom attributes

Ticket Types

Stream for managing the different types of tickets configured in your Intercom workspace.

Field	Type	Description
id	String	Unique identifier for the ticket type
type	String	Object type identifier
name	String	Name of the ticket type
description	String	Description of the ticket type
icon	String	Icon for the ticket type
workspace_id	String	ID of the workspace
category	String	Category of the ticket type
archived	Boolean	Whether the ticket type is archived
is_internal	Boolean	Whether the ticket type is internal only
created_at	Integer	When the ticket type was created (Unix timestamp)
updated_at	Integer	When the ticket type was last updated (Unix timestamp)
ticket_type_attributes	Object	Attributes defined for this ticket type
ticket_states	Object	States available for this ticket type

Tickets

Stream for managing support tickets and their details.

Field	Type	Description
id	String	Unique identifier for the ticket
type	String	Object type identifier
ticket_id	String	Human-readable ticket ID
company_id	String	ID of the associated company
created_at	Integer	When the ticket was created (Unix timestamp)
updated_at	Integer	When the ticket was last updated (Unix timestamp)
open	Boolean	Whether the ticket is open
category	String	Category of the ticket
is_shared	Boolean	Whether the ticket is shared
admin_assignee_id	String	ID of the admin assigned to the ticket
team_assignee_id	String	ID of the team assigned to the ticket
ticket_type	Object	Type of the ticket
ticket_state	Object	Current state of the ticket
ticket_attributes	Object	Attributes and custom fields of the ticket
contacts	Object	Contacts associated with the ticket
ticket_parts	Object	Parts (messages, notes, state changes) of the ticket
linked_objects	Object	Objects linked to this ticket

Conversations

Stream for managing conversations between your team and customers.

Field	Type	Description
id	String	Unique identifier for the conversation
type	String	Object type identifier
title	String	Title of the conversation
created_at	Integer	When the conversation was created (Unix timestamp)
updated_at	Integer	When the conversation was last updated (Unix timestamp)
open	Boolean	Whether the conversation is open
state	String	Current state of the conversation
read	Boolean	Whether the conversation has been read
priority	String	Priority of the conversation
waiting_since	Integer	Timestamp when the conversation started waiting (Unix timestamp)
snoozed_until	Integer	When the conversation is snoozed until (Unix timestamp)
admin_assignee_id	String	ID of the admin assigned
team_assignee_id	String	ID of the team assigned
company_id	String	ID of the associated company
tags	Object	Tags associated with the conversation
conversation_rating	Object	Rating given for this conversation
source	Object	Source of the conversation (email, chat, etc.)
contacts	Object	Contacts involved in the conversation
teammates	Object	Teammates involved in the conversation
custom_attributes	Array	Array of custom attributes
first_contact_reply	Object	First reply from the contact
sla_applied	Object	SLA information if applicable
statistics	Object	Detailed conversation statistics
linked_objects	Object	Objects linked to this conversation
ai_agent_participated	Boolean	Whether an AI agent participated
ai_agent	Object	AI agent details if applicable

Conversation Parts

Stream for parts that make up a conversation, including individual messages, notes, and events.

Field	Type	Description
type	String	Type classification of the record
id	String	Unique identifier of the record
conversation_id	String	Identifier of the parent conversation
part_type	String	Type of the conversation part
body	String	Body content of the conversation part
created_at	Integer	Timestamp when the record was created
updated_at	Integer	Timestamp when the record was last updated
notified_at	Integer	Timestamp when the part was notified
assigned_to	Object	Entity assigned to the conversation part
author	Object	Author of the conversation part
attachments	Array	Attachments included in the conversation part
external_id	String	External identifier for the conversation part
redacted	Boolean	Whether the conversation part content is redacted
email_message_metadata	Object	Email metadata associated with the conversation part
metadata	Object	Quick reply metadata for the conversation part
state	String	Current state of the conversation part
tags	Array	Tags associated with the conversation part
event_details	Object	Event details associated with the conversation part
app_package_code	String	Application package code for the conversation part

Data Model

The following diagram illustrates the relationships between the core data streams in Intercom. The arrows indicate the join keys that link the different entities.

Skills for agents

Download Intercom skills file

Intercom connector documentation as plain markdown, for use in AI agent contexts.