Overview
The Intercom integration allows Alysio to securely connect to an organization’s Intercom workspace to retrieve customer communication data and support team activity. Once connected, Alysio can access contacts, companies, segments, teams, events, and conversations stored in Intercom. Users can retrieve customer data, explore engagement history, search conversations, and analyze user events directly through Alysio’s conversational interface. This integration enables teams to combine Intercom customer interaction data with other connected systems, providing a unified operational view across customer support, revenue, and product teams. All data access is controlled through OAuth authorization, ensuring Alysio only performs actions permitted by the authenticated Intercom user.Supported Data and Capabilities
The Intercom integration supports access to several key objects within the Intercom workspace.Contacts
Retrieve information about individual contacts in Intercom. Supported operations include: Listing contacts with paginationRetrieving contact details by ID Contact identifiers can also be used to retrieve events associated with that user.
Companies
Retrieve company records associated with Intercom contacts. Supported operations include: Listing companiesRetrieving company details by ID
Retrieving contacts attached to a company This allows teams to understand the relationship between companies and their users.
Segments
Retrieve user segments configured within Intercom. Segments allow teams to group contacts based on attributes, behavior, or lifecycle stage. Segment lists can optionally include counts of contacts within each segment.Teams
Retrieve information about support teams within the Intercom workspace. This allows organizations to view team structures and route conversation data accordingly.Events
Retrieve user event activity for Intercom contacts. Events may include product usage events, lifecycle actions, or custom application events tracked within Intercom. Events are retrieved using the contact’s external ID, which represents the user identifier within Intercom.Conversations
Retrieve customer conversations from Intercom. Supported operations include: Listing conversationsRetrieving conversation details by ID
Searching conversations using text queries These capabilities allow support and revenue teams to quickly locate customer discussions and review conversation history.
Authentication
The Intercom integration uses OAuth 2.0 authentication. Users connect their Intercom account through the Alysio Settings → Integrations panel. During the authorization process, the user grants Alysio permission to access Intercom data through the Intercom OAuth flow. Once authorized, Alysio receives an OAuth access token that allows it to communicate with the Intercom REST API on behalf of the user.Credential Handling
OAuth credentials are securely stored and refreshed automatically. Each user or tenant maintains their own Intercom credential connection, ensuring that API requests remain isolated to the authorized workspace. If the integration is disconnected or the OAuth authorization is revoked, Intercom functionality will no longer be available until the user reconnects the integration.Supported Capabilities and Scope Usage
| Capability | Purpose |
|---|---|
| Contacts | Retrieve contact lists and individual contact details |
| Companies | Retrieve company records and company-associated contacts |
| Segments | Retrieve segments and segment counts |
| Teams | Retrieve workspace teams |
| Events | Retrieve user events associated with contacts |
| Conversations | Retrieve and search customer conversations |
MCP Tools
The Intercom MCP exposes the following tools that allow Alysio to retrieve and analyze Intercom data through natural language.intercom_list_all_contacts
Retrieves a list of contacts in the Intercom workspace. Example prompts List Intercom contactsShow the first 50 contacts
intercom_get_contact_by_id
Retrieves detailed information about a specific contact. Example prompts Show contact details for ID 123Get this Intercom contact
intercom_list_companies
Lists companies stored in the Intercom workspace. Example prompts Show Intercom companiesList all companies
intercom_get_company_by_id
Retrieves detailed information about a company. Example prompts Get company details for ID 456Show this company record
intercom_list_attach_contacts_to_company
Retrieves contacts associated with a specific company. Example prompts Show contacts at this companyWho is attached to company X
intercom_list_segments
Lists segments configured in Intercom. Example prompts List all Intercom segmentsShow segments with contact counts
intercom_list_all_teams
Retrieves teams configured within the Intercom workspace. Example prompts Show Intercom teamsList support teams
intercom_list_events
Retrieves events associated with a contact. Example prompts Show events for this contactList user activity events The request requires the contact’s external ID as the user identifier.
intercom_list_conversations
Lists recent conversations from the Intercom workspace. Example prompts Show recent customer conversationsList support conversations
intercom_get_conversation_by_id
Retrieves detailed information about a specific conversation. Example prompts Show conversation 789Get this conversation thread
intercom_search_conversations
Searches conversations using a text query. Example prompts Find conversations about billingSearch conversations mentioning refunds
App Behavior
Alysio retrieves Intercom data on demand when users request information related to contacts, companies, segments, teams, events, or conversations. There is no background synchronization between Alysio and Intercom. Instead, API calls are executed in real time using the stored OAuth credential. All requests are restricted to the permissions granted during the OAuth authorization process.Example Workflow
User asks List contacts at Acme Corp and show their recent events Alysio routes the request to the Intercom MCP. The MCP retrieves companies using intercom_list_companies and identifies the company ID for Acme Corp. The MCP retrieves contacts associated with that company using intercom_list_attach_contacts_to_company. For each contact, the MCP retrieves events using intercom_list_events with the contact’s external ID. The Intercom API returns the data. Alysio presents the contact and event activity within the conversation interface.Troubleshooting
Intercom Not Connected
The integration has not been authorized. SolutionNavigate to Settings → Integrations and reconnect Intercom using OAuth.
Authentication Error
The OAuth token may be invalid or expired. SolutionReconnect the Intercom integration through the integrations settings.
Insufficient Permissions
The OAuth authorization may not include the required scopes. SolutionVerify the Intercom OAuth app has permissions for contacts, companies, segments, teams, events, and conversations.
Events Query Requires User ID
Event retrieval requires a contact’s external ID. SolutionUse intercom_list_all_contacts to retrieve the contact’s external ID and pass it as the user_id parameter.
Company Contact Retrieval
Retrieving contacts attached to a company requires a company_id. SolutionUse intercom_list_companies to retrieve the company ID before requesting company contacts.
Conversation Limitations
Conversation lists return up to 500 recent conversations. SolutionUse intercom_search_conversations to locate older conversations or apply pagination to retrieve additional results.