Intercom

Sonora connects to Intercom to sync your conversations and customer data, providing insights from customer support interactions.

Prerequisites

• Intercom admin access
• Ability to create Developer Apps

Setup Steps

1. Create a Developer App

1. Go to developers.intercom.com
2. Sign in with your Intercom account
3. Click New app
4. Enter app name (e.g., “Sonora Integration”)
5. Select your workspace
6. Click Create app

2. Configure Permissions

In your app settings, configure these permissions:

Read Permissions:

• Read conversations - Access conversation history
• Read users and contacts - Access customer data
• Read admins - Access team member info
• Read tags - Access conversation tags

3. Generate Access Token

1. Go to Authentication in your app settings
2. Copy the Access Token

4. Connect in Sonora

1. Go to Settings → Integrations in Sonora
2. Click Add Integration → Intercom
3. Enter your credentials:
   • Access Token
4. Click Connect

Data Synced

Sonora syncs the following from Intercom:

• Conversations
• Conversation parts (messages)
• Contacts (users and leads)
• Companies
• Admins (team members)
• Tags

Permissions

The access token provides read-only access. Sonora does not send messages or modify any data in your Intercom workspace.

Troubleshooting

Authentication Errors

• Verify the Access Token is correct
• Ensure the Developer App is still active
• Check that required permissions are enabled

Missing Conversations

• Verify the app has conversation read permissions
• Check if conversations are in an inbox the app can access
• Ensure conversations aren’t archived or deleted