Usedesk Connector
Sync support tickets, companies, and customer data from Usedesk into your knowledge base
The Usedesk connector synchronizes support tickets, customer information, and company data from Usedesk into your knowledge base. Each ticket is converted to a document containing subject, status, messages, and customer details.
Authentication
OAuth 2.0 — requires:
tickets:read— Read tickets and commentscontacts:read— Read customer and company data
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| Company | Selector | Yes | Select Usedesk company account |
| Include Messages | Switch | No | Include full message threads in documents |
| Status Filter | Dropdown | No | Filter by ticket status (open/closed/pending) |
| Max Tickets | Input | No | Limit number of synced tickets |
How It Works
- Company Validation — Verifies OAuth access to the selected company
- Ticket Listing — Retrieves tickets with pagination (50 per page)
- Message Fetching — Optionally retrieves full conversation history
- Document Generation — Each ticket becomes a searchable document
Document Format
Ticket ID: #1234
Subject: Cannot log in
Customer: Jane Smith (jane@company.com)
Status: Open
Priority: High
Messages: 5Metadata Tags
| Tag | Type | Description |
|---|---|---|
| Ticket ID | Text | Usedesk ticket number |
| Ticket Status | Category | open, closed, or pending |
| Priority | Category | Low, Normal, High, Urgent |
Pagination
Uses ticket ID offset. Cursor format: offset:{ticket_id}.
Limitations
- Message sync limited to last 1000 characters per ticket
- Company must be accessible via OAuth token
- Archived tickets not included by default