Chatspark
K
K

Intercom

Enable your AI agent to create conversations, get user information, add notes to profiles, and seamlessly hand off to live Intercom agents.

6 min read

Updated February 2026

Overview

The Intercom integration connects your AI agent to your Intercom workspace. Your chatbot can access user information, create and manage conversations, add notes to user profiles, and transfer to live agents when needed.

Perfect for teams using Intercom for customer communication who want AI to handle initial interactions while maintaining context in Intercom.

Available Actions

ActionDescription
Get ConversationRetrieve conversation history for context
Create ConversationStart a new conversation with support
Get UserLook up user information by email or ID
Add NoteAdd a note to a user's profile
Live Agent HandoffTransfer conversation to a live Intercom agent with full context

Prerequisites

Before setting up the Intercom integration, you'll need:

  • An Intercom account with API access
  • Admin access to create access tokens

Setup Instructions

Step 1: Create an Access Token

  1. Log in to your Intercom account
  2. Go to SettingsIntegrationsDeveloper Hub
  3. Click New app or select an existing app
  4. Go to Authentication
  5. Generate or copy your Access Token
Token Permissions
Ensure your access token has the necessary scopes: read/write conversations, read/write users, and read/write notes.

Step 2: Enable in ChatSpark

  1. In ChatSpark, go to AI Actions
  2. Find Intercom in the Library and click Enable
  3. Select the chatbot(s) that should have access
  4. Enter your Access Token
  5. Click Save

Configuration Fields

FieldDescriptionExample
Access TokenYour Intercom access tokendG9rOjxxxxxxx...

Testing Your Integration

After setup, test the integration:

  1. Open your chatbot widget
  2. Try asking: “I need to talk to a real person”
  3. The AI should initiate a handoff to Intercom

Other test queries:

  • “Look up my account information”
  • “Start a conversation with support”
  • “Connect me to an agent”

Troubleshooting

Invalid access token

Regenerate your access token in Intercom if it's expired or invalid. Make sure to copy the full token.

Permission denied

Check that your token has the required scopes. You may need to create a new app with broader permissions.

User not found

The user lookup requires an email address that exists in Intercom. If the user is new, they may need to be created first.

Need Help?
If you're having trouble with the Intercom integration, contact our support team and we'll help you troubleshoot.

Previous

HubSpot

Next

PayPal