Intercom

Intercom logo

Intercom

This connector enables AI agents and RAG systems to retrieve context from Intercom through Airweave’s unified search layer.

Configuration

Intercom source connector.

Syncs conversations, conversation messages (parts), and tickets from Intercom to enhance support and CX queries.

Authentication

This connector uses OAuth 2.0 authentication. You can connect through the Airweave UI or API using the OAuth flow.

Supported authentication methods:

  • OAuth Browser Flow (recommended for UI)
  • OAuth Token (for programmatic access)
  • Auth Provider (enterprise SSO)

Configuration Options

This connector does not have any additional configuration options.

Data Models

The following data models are available for this connector:

Schema for Intercom conversation entities.

A conversation is a thread of messages between contacts and teammates.

FieldTypeDescription
conversation_idstrUnique identifier of the conversation
subjectstrSubject or first message preview of the conversation
created_at_valueOptional[datetime]When the conversation was created
updated_at_valueOptional[datetime]When the conversation was last updated
web_url_valueOptional[str]URL to view the conversation in Intercom
stateOptional[str]Conversation state (open, closed, snoozed)
priorityOptional[str]Priority level
assignee_nameOptional[str]Name of the teammate assigned
assignee_emailOptional[str]Email of the teammate assigned
contact_idsList[str]IDs of contacts in the conversation
custom_attributesDict[str, Any]Custom attributes on the conversation
tagsList[str]Tag names applied to the conversation
source_bodyOptional[str]Body of the first message (source)

Schema for a single message (conversation part) within an Intercom conversation.

FieldTypeDescription
message_idstrUnique identifier of the conversation part
conversation_idstrID of the parent conversation
conversation_subjectstrSubject of the parent conversation
bodystrMessage body (plain text or HTML)
created_at_valueOptional[datetime]When the message was created
web_url_valueOptional[str]URL to view the conversation (and message) in Intercom
part_typeOptional[str]Type of part (comment, assignment, etc.)
author_idOptional[str]ID of the author
author_typeOptional[str]Author type (admin, user, lead, bot)
author_nameOptional[str]Display name of the author
author_emailOptional[str]Email of the author

Schema for Intercom ticket entities.

Tickets are used for structured support workflows.

FieldTypeDescription
ticket_idstrUnique identifier of the ticket
namestrTicket name/title
descriptionOptional[str]Ticket description
created_at_valueOptional[datetime]When the ticket was created
updated_at_valueOptional[datetime]When the ticket was last updated
web_url_valueOptional[str]URL to view the ticket in Intercom
stateOptional[str]Ticket state (open, closed, etc.)
priorityOptional[str]Priority level
assignee_idOptional[str]ID of the assignee
assignee_nameOptional[str]Name of the assignee
contact_idOptional[str]ID of the contact
ticket_type_idOptional[str]Ticket type ID
ticket_type_nameOptional[str]Ticket type name
ticket_parts_textOptional[str]Concatenated body text of ticket parts (replies, comments, notes) for search