The 2GIS connector enables seamless integration with 2GIS for knowledge base synchronization. Document records are converted to plain-text format for full-text search and AI-powered retrieval.
Authentication
API Key — Requires a valid API key for authentication
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| Authentication | API Key | Yes | Authorization credentials |
| Sync Interval | Input | No | Schedule for automatic syncing (in hours) |
| Max Documents | Input | No | Limit the number of synced documents |
How It Works
- Connection Setup — Authenticate and authorize the connector
- Document Listing — Retrieves all available documents from 2GIS
- Content Conversion — Documents are converted to plain-text format
- Metadata Extraction — Relevant metadata is preserved as tags
- Incremental Sync — Only new or modified documents are synced on refresh
Sync Behavior
- Initial Sync: All accessible documents are imported
- Incremental: Only new and updated documents since last sync
- Scheduling: Configure sync interval (default: 24 hours)
- Error Handling: Failed syncs are logged; retried automatically
Metadata Tags
Document metadata is preserved as tags for filtering and organization:
| Tag | Type | Description |
|---|---|---|
| Source | String | 2GIS |
| Created | Date | Document creation date |
| Modified | Date | Last modification date |
| Category | String | Document category or type |
Limitations
- Document size must be under 10 MB
- Supports text-based formats (PDF, DOCX, TXT, etc.)
- Rate limiting applies per 2GIS API terms
- Real-time sync not available; use scheduled intervals instead
Troubleshooting
Sync fails with authentication error: Verify API credentials and refresh the authorization.
Documents not appearing: Check that documents are accessible with your account permissions and that sync is enabled.

