Intercom

Import help center articles from Intercom into AGO

Import help center articles from Intercom into AGO. The connector supports two modes: authenticated API access (for private or owned content) and public help center scraping (no API credentials needed).

Feature	Details
Authentication	API Token (Mode 1) or None (Mode 2 - public scraping)
Content type	Help center articles
Multi-language	Yes
Hierarchy	Yes (collections > sections > articles)
Attachments	Yes (embedded images)

Prerequisites

For API Access Mode:

• Intercom workspace with Developer Hub access
• API access token with help center permissions
• Help center with published articles

For Public Scraping Mode:

• A publicly accessible Intercom help center URL
• No credentials required

Setup Steps

Mode 1: API Access

1. In Intercom, go to Settings > Developers > Developer Hub
2. Create a new app or use an existing one
3. Go to Configure > Authentication and copy your Access Token
4. In AGO, navigate to Knowledge > Sources > Create
5. Select Intercom as the connector type
6. Enter your Access Token
7. Optionally specify a Help Center ID (auto-detected if not provided)
8. Save and run a manual sync

Mode 2: Public Scraping

1. In AGO, navigate to Knowledge > Sources > Create
2. Select Intercom as the connector type
3. Leave the API key field empty
4. Enter the help center subdomain (e.g., your-company for intercom.help/your-company)
5. Enter the locale code (e.g., en, fr)
6. Save and run a manual sync

Configuration

Setting	Required	Default	Description
API key	Mode 1	—	Intercom API access token
Subdomain	Mode 2	—	Help center subdomain
Locale	Mode 2	—	Language code for public scraping
Help center ID	No	Auto-detected	Specific help center to import
Collection filter	No	All	List of collection IDs to import
Section filter	No	All	List of section IDs to import
Import collections	No	Yes	Whether to import collection-level documents
Import sections	No	Yes	Whether to import section-level documents
Import articles	No	Yes	Whether to import article documents

Finding Collection and Section IDs

1. Navigate to your Intercom Help Center in the Intercom app
2. Open a collection or section
3. The ID is in the URL: https://app.intercom.com/a/apps/{app_id}/articles/collections/{collection_id}

What Gets Imported

The connector imports three levels of content:

• Collections: Top-level containers (can be nested)
• Sections: Organizational units within collections
• Articles: The actual help content, converted from HTML to Markdown

Best Practices

• Start with a collection filter to import a subset, then expand
• Schedule regular syncs to keep content fresh
• Only published articles are imported — drafts are skipped

Troubleshooting

Authentication failed

• Verify your access token is valid and not expired
• Check the token has help center read permissions
• Regenerate the token in Developer Hub

No content imported

• Verify your help center has published articles (drafts are skipped)
• Check collection/section filters aren’t excluding all content
• For public mode, verify the subdomain and locale are correct

Missing images

• Verify network access to Intercom’s image CDN
• Re-sync to refresh image references

---

Related

• Knowledge Connectors — All available connectors
• Knowledge Source Management — Managing sources