> ## Documentation Index > Fetch the complete documentation index at: https://docs.alysio.ai/llms.txt > Use this file to discover all available pages before exploring further. # Intercom > Connect Alysio to Intercom using OAuth 2.0 ## 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 pagination\ Retrieving 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 companies\ Retrieving 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 conversations\ Retrieving 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 | These capabilities allow Alysio to retrieve customer support and engagement data while respecting Intercom’s authorization model. *** ## 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 contacts\ Show the first 50 contacts *** ### intercom\_get\_contact\_by\_id Retrieves detailed information about a specific contact. Example prompts Show contact details for ID 123\ Get this Intercom contact *** ### intercom\_list\_companies Lists companies stored in the Intercom workspace. Example prompts Show Intercom companies\ List all companies *** ### intercom\_get\_company\_by\_id Retrieves detailed information about a company. Example prompts Get company details for ID 456\ Show this company record *** ### intercom\_list\_attach\_contacts\_to\_company Retrieves contacts associated with a specific company. Example prompts Show contacts at this company\ Who is attached to company X *** ### intercom\_list\_segments Lists segments configured in Intercom. Example prompts List all Intercom segments\ Show segments with contact counts *** ### intercom\_list\_all\_teams Retrieves teams configured within the Intercom workspace. Example prompts Show Intercom teams\ List support teams *** ### intercom\_list\_events Retrieves events associated with a contact. Example prompts Show events for this contact\ List 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 conversations\ List support conversations *** ### intercom\_get\_conversation\_by\_id Retrieves detailed information about a specific conversation. Example prompts Show conversation 789\ Get this conversation thread *** ### intercom\_search\_conversations Searches conversations using a text query. Example prompts Find conversations about billing\ Search 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. Solution\ Navigate to Settings → Integrations and reconnect Intercom using OAuth. *** ### Authentication Error The OAuth token may be invalid or expired. Solution\ Reconnect the Intercom integration through the integrations settings. *** ### Insufficient Permissions The OAuth authorization may not include the required scopes. Solution\ Verify 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. Solution\ Use 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. Solution\ Use intercom\_list\_companies to retrieve the company ID before requesting company contacts. *** ### Conversation Limitations Conversation lists return up to 500 recent conversations. Solution\ Use intercom\_search\_conversations to locate older conversations or apply pagination to retrieve additional results. *** ## Support For assistance configuring or troubleshooting the Intercom integration, contact [support@alysio.ai](mailto:support@alysio.ai) For Intercom API reference documentation, consult the Intercom REST API documentation.