Intercom

Overview

The Intercom connector allows you to sync data from Intercom into Graffo, 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.

Source Code: View on GitHub

Authentication

This connector uses OAuth 2.0 authentication flow.

Entities

The following data models are available for this connector:

IntercomContactEntity

Schema for Intercom contact entities.

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

Field	Type	Description
role	Optional[str]	The type of contact - either 'user' or 'lead'
external_id	Optional[str]	A unique identifier for the contact provided by your application
email	Optional[str]	The contact's email address
phone	Optional[str]	The contact's phone number
name	Optional[str]	The contact's full name
avatar	Optional[str]	URL to the contact's avatar or profile image
created_at	Optional[datetime]	Creation time of the contact, represented as UTC Unix timestamp
updated_at	Optional[datetime]	Last updated time of the contact, represented as UTC Unix timestamp
archived	bool	Indicates whether the contact has been archived

IntercomCompanyEntity

Schema for Intercom company entities.

Companies in Intercom represent organizations that your contacts belong to.

Field	Type	Description
name	Optional[str]	The company's name
company_id	Optional[str]	A unique identifier for the company
plan	Optional[str]	The plan or subscription level of the company
monthly_spend	Optional[float]	The monthly spend or revenue associated with this company
session_count	Optional[int]	The number of sessions associated with the company
user_count	Optional[int]	The number of users associated with the company
website	Optional[str]	The company's website URL
created_at	Optional[datetime]	Creation time of the company, represented as UTC Unix timestamp
updated_at	Optional[datetime]	Last updated time of the company, represented as UTC Unix timestamp
archived	bool	Indicates whether the company has been archived

IntercomConversationEntity

Schema for Intercom conversation entities.

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

Field	Type	Description
conversation_id	str	The unique identifier for the conversation in Intercom
title	Optional[str]	The title or subject of the conversation
state	Optional[str]	The current state of the conversation (e.g., 'open', 'closed')
created_at	Optional[datetime]	The time the conversation was created, represented as UTC Unix timestamp
updated_at	Optional[datetime]	The time the conversation was last updated, represented as UTC Unix timestamp
archived	bool	Indicates whether the conversation has been archived

IntercomTicketEntity

Schema for Intercom ticket entities.

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

Field	Type	Description
subject	Optional[str]	The subject or title of the ticket
description	Optional[str]	The detailed description of the ticket
state	Optional[str]	The current state of the ticket (e.g., 'open', 'closed')
contact_id	Optional[str]	The ID of the contact associated with this ticket
company_id	Optional[str]	The ID of the company associated with this ticket
created_at	Optional[datetime]	The time the ticket was created, represented as UTC Unix timestamp
updated_at	Optional[datetime]	The time the ticket was last updated, represented as UTC Unix timestamp
archived	bool	Indicates whether the ticket has been archived