Connector Comparison
Help Center & Support Platforms
Wiki & Documentation Platforms
Data & File-Based Sources
Available Knowledge Connectors
AGO supports 19 connector types for importing documentation from various sources.Help Center Connectors
Zendesk Integration
Import knowledge base articles from Zendesk Help Center with multi-language support and category filtering.
Intercom Integration
Synchronize help center articles from Intercom, including collections, sections, and multi-language content.
HelpScout Integration
Import knowledge base articles and categories from HelpScout Docs.
Crisp Integration
Import help center content from Crisp with hierarchical category and section filtering.
Smart Tribune Integration
Import FAQ and knowledge base content from Smart Tribune with thematic filtering.
HubSpot Knowledge Base Integration
Import articles from HubSpot Service Hub Knowledge Base with state filtering and category organization.
Wiki & Documentation Connectors
Notion Integration
Import Notion workspace pages and databases with OAuth authentication and property-based filtering.
Confluence Integration
Connect to Atlassian Confluence for enterprise wiki import with hierarchical structure and attachments.
Paligo Integration
Import topic-based technical documentation from Paligo CCMS with multi-language support.
README Integration
Import developer documentation, API references, and changelogs from README.io.
Mintlify Integration
Import documentation from Mintlify-powered sites via web scraping with automatic hierarchy detection.
Data & File-Based Connectors
Airtable Integration
Import structured data from Airtable bases with custom field mapping and linked field support.
JSON Integration
Import documents from JSON files with custom title, content, and ID field mapping.
Qualios Integration
Import quality management documentation from Qualios with status filtering.
OpenAPI Integration
Generate API reference documentation from OpenAPI specifications automatically.
MadCap Integration
Import technical documentation from MadCap Flare projects with table of contents support.
Media Connectors
YouTube Playlist Integration
Import content from YouTube playlists as knowledge documents, one per video.
XML Import Integration
Import and convert XML feeds into structured knowledge documents with configurable field mapping.
Special Source Types
Manual/AGO Source
Create and manage documents directly in AGO with PDF upload support — no external import needed.
Folder Source
Organize multiple sources into logical groups for navigation — container only, no direct content.
How Knowledge Connectors Work
- Configuration: Set up credentials and specify what content to import
- Fetch: Connector retrieves content from the external platform’s API
- Convert: HTML and rich text are converted to Markdown
- Store: Documents are saved with metadata and hierarchy
- Index: Content is vectorized for semantic search
- Sync: Scheduled updates keep content fresh
Choosing a Connector
Authentication Methods
Getting Started
- Choose connector: Select based on your documentation platform
- Gather credentials: Obtain API keys or set up OAuth
- Create source: Navigate to Knowledge → Sources → Create
- Configure settings: Set source ID, filters, and options
- Test sync: Run a manual sync to verify import
- Schedule: Configure auto-sync for regular updates
Best Practices
Content Organization
- Start with a subset of content before full import
- Use restricted keywords to filter sensitive content
- Organize sources into folders for large knowledge bases
Sync Strategy
- Set appropriate sync frequency based on content update rate
- Use daily sync for stable documentation
- Use more frequent sync for rapidly changing content
Quality Assurance
- Review imported documents for formatting issues
- Test search to verify documents are findable
- Monitor sync history for errors
Troubleshooting
Authentication Errors
Authentication Errors
API Token Invalid
- Verify the token hasn’t expired
- Check token has required permissions/scopes
- Regenerate token if needed
- Re-authorize the connection
- Ensure workspace permissions are granted
- Check integration has access to target pages
Sync Issues
Sync Issues
Sync Stuck in Progress
- Reset sync status in admin panel
- Check for rate limiting from external service
- Verify network connectivity
- Check restricted keywords aren’t filtering content
- Verify source ID/page ID is correct
- Ensure connector has access to the content
- Check for empty or draft documents being skipped
- Trigger manual sync to force refresh
- Check last_sync_at timestamp
- Verify auto-sync is enabled and scheduled
Content Quality
Content Quality
Formatting Issues
- HTML conversion may lose some formatting
- Complex tables may need manual adjustment
- Code blocks should preserve syntax
- Some connectors don’t import images
- Check attachment settings for the connector
- External images may need accessible URLs
Related
Knowledge Source Management
Managing sources
Knowledge Overview
Feature overview
Set Up Your Knowledge Base
Setup tutorial
