Intercom

Intercom logo

Intercom

Connect your Intercom data to Airweave

Overview

The Intercom connector allows you to sync data from Intercom into Airweave, making it available for search and retrieval by your agents.

Configuration

IntercomSource

Intercom source implementation.

This connector retrieves data from Intercom objects such as Contacts, Companies, Conversations, and Tickets, then yields them as entities using their respective Intercom entity schemas.

Authentication

This connector uses OAuth 2.0 authentication flow.

You can connect through the Airweave UI, which will guide you through the OAuth flow.

Entities

The following data models are available for this connector:

Schema for Intercom contact entities.

Contacts in Intercom can be either users or leads with associated profile data.

FieldTypeDescription
roleOptional[str]The type of contact - either ‘user’ or ‘lead’
external_idOptional[str]A unique identifier for the contact provided by your application
emailOptional[str]The contact’s email address
phoneOptional[str]The contact’s phone number
nameOptional[str]The contact’s full name
avatarOptional[str]URL to the contact’s avatar or profile image
created_atOptional[datetime]Creation time of the contact, represented as UTC Unix timestamp
updated_atOptional[datetime]Last updated time of the contact, represented as UTC Unix timestamp
archivedboolIndicates whether the contact has been archived

Schema for Intercom company entities.

Companies in Intercom represent organizations that your contacts belong to.

FieldTypeDescription
nameOptional[str]The company’s name
company_idOptional[str]A unique identifier for the company
planOptional[str]The plan or subscription level of the company
monthly_spendOptional[float]The monthly spend or revenue associated with this company
session_countOptional[int]The number of sessions associated with the company
user_countOptional[int]The number of users associated with the company
websiteOptional[str]The company’s website URL
created_atOptional[datetime]Creation time of the company, represented as UTC Unix timestamp
updated_atOptional[datetime]Last updated time of the company, represented as UTC Unix timestamp
archivedboolIndicates whether the company has been archived

Schema for Intercom conversation entities.

Conversations in Intercom represent message threads between contacts and your team.

FieldTypeDescription
conversation_idstrThe unique identifier for the conversation in Intercom
titleOptional[str]The title or subject of the conversation
stateOptional[str]The current state of the conversation (e.g., ‘open’, ‘closed’)
created_atOptional[datetime]The time the conversation was created, represented as UTC Unix timestamp
updated_atOptional[datetime]The time the conversation was last updated, represented as UTC Unix timestamp
archivedboolIndicates whether the conversation has been archived

Schema for Intercom ticket entities.

Tickets in Intercom represent structured support requests that can be tracked and managed.

FieldTypeDescription
subjectOptional[str]The subject or title of the ticket
descriptionOptional[str]The detailed description of the ticket
stateOptional[str]The current state of the ticket (e.g., ‘open’, ‘closed’)
contact_idOptional[str]The ID of the contact associated with this ticket
company_idOptional[str]The ID of the company associated with this ticket
created_atOptional[datetime]The time the ticket was created, represented as UTC Unix timestamp
updated_atOptional[datetime]The time the ticket was last updated, represented as UTC Unix timestamp
archivedboolIndicates whether the ticket has been archived