Data Export

Convor provides several export endpoints for pulling data out of the system. Exports return files directly as downloads with proper content types and attachment headers. All export actions are rate-limited and logged in the audit trail.

OverviewCopy Anchor Link

Four export types are available:

• Conversations: export all conversations with their messages
• Analytics: export a summary of metrics for a time period
• Visitors: export the full visitor list
• Bulk conversations: export with advanced filtering by status, operator, or tags

All export endpoints are rate-limited to 5 requests per minute. Each export creates an audit log entry recording the format, record count, and the user who triggered it.

Exporting ConversationsCopy Anchor Link

Export all conversations within the organization, including their messages. Available in CSV and JSON formats:

GET /api/export/conversations?format=csv&date_from=2025-01-01T00:00:00Z&date_to=2025-03-01T00:00:00Z

Query ParametersCopy Anchor Link

The response includes conversation metadata (ID, status, visitor, operator) and all messages flattened into a single text field. Each message is prefixed with its sender type.

CSV columns: id, status, visitorId, assignedOperatorId, createdAt, updatedAt, messageCount, messages

Exporting AnalyticsCopy Anchor Link

Export an analytics summary as a CSV file. This produces a metric table rather than raw records:

GET /api/export/analytics?format=csv&date_from=2025-01-01T00:00:00Z&date_to=2025-03-01T00:00:00Z

Query ParametersCopy Anchor Link

The export produces rows for each metric:

CSV columns: metric, value, period_start, period_end

Exporting VisitorsCopy Anchor Link

Export the full visitor list as a CSV file:

GET /api/export/visitors?format=csv

Exported FieldsCopy Anchor Link

Results are ordered by lastSeenAt descending.

Bulk Export with FiltersCopy Anchor Link

For more targeted exports, the bulk endpoint accepts a POST body with advanced filtering:

POST /api/export/conversations/bulk

{
  "format": "csv",
  "dateFrom": "2025-01-01T00:00:00Z",
  "dateTo": "2025-03-01T00:00:00Z",
  "status": "closed",
  "operatorId": "op-uuid",
  "tags": ["refund", "priority"]
}

Request BodyCopy Anchor Link

The bulk export includes an additional operatorName column that resolves the operator UUID to a human-readable display name.

Response FormatCopy Anchor Link

All export endpoints set the Content-Disposition header to trigger a file download:

Content-Disposition: attachment; filename="conversations-export.csv"
Content-Type: text/csv; charset=utf-8

For JSON exports:

Content-Disposition: attachment; filename="conversations-export.json"
Content-Type: application/json; charset=utf-8

API ReferenceCopy Anchor Link

All endpoints require authentication and are rate-limited to 5 requests per minute.

RelatedCopy Anchor Link

• Audit Logs: track who exported data and when
• GDPR Compliance: data portability and erasure rights
• Conversation Search: search before exporting