Conversations

List conversations

Returns your project’s conversations, newest activity first, cursor-paginated.

{
  "results": [
    {
      "id": "3f2b1c9a-7d4e-4b21-9c33-0a1b2c3d4e5f",
      "status": "PROCESSING",
      "channel_type": "TELEGRAM",
      "ticket_number": 1042,
      "message_count": 7,
      "contact": { "id": "7c4e9b02-1a55-4e88-b0d1-2f3a4b5c6d7e", "display_name": "Jane Doe" },
      "updated_at": "2026-07-01T10:40:00+00:00"
    }
  ],
  "next_cursor": "MjAyNi0wNy0wMVQxMDo0MDowMHwzZjJi",
  "has_more": true
}

Query parameters

• status — filter by status: NEW, ESCALATING, PROCESSING, WAITING, RESOLVED, CLOSED.
• channel_id — UUID of a channel to filter by.
• updated_since — ISO-8601 timestamp; only conversations updated at or after this time.
• cursor — opaque pagination cursor from a previous response’s next_cursor.
• limit — page size, default 50, max 100.

See Errors, rate limits & pagination for how cursor pagination works.

Get a conversation

{
  "id": "3f2b1c9a-7d4e-4b21-9c33-0a1b2c3d4e5f",
  "status": "PROCESSING",
  "priority": "HIGH",
  "subject": "Refund request",
  "source": "CHANNEL",
  "channel_id": "9a1c5f30-2b6d-4c71-8e42-1a2b3c4d5e6f",
  "channel_type": "TELEGRAM",
  "ticket_number": 1042,
  "detected_language": "en",
  "message_count": 7,
  "contact": { "id": "7c4e9b02-1a55-4e88-b0d1-2f3a4b5c6d7e", "display_name": "Jane Doe" },
  "created_at": "2026-07-01T10:12:00+00:00",
  "updated_at": "2026-07-01T10:40:00+00:00",
  "last_message_at": "2026-07-01T10:40:00+00:00"
}

{ "detail": "conversation_not_found" }

The conversation object

• id — UUID.
• status — one of the six states above.
• priority — LOW / MEDIUM / HIGH / URGENT, or null.
• subject, source (CHANNEL/PORTAL/OPERATOR), ticket_number, detected_language, message_count.
• channel_id, channel_type (TELEGRAM, WEB, EMAIL, HELPDESK, …).
• contact — { id, display_name }.
• created_at, updated_at, last_message_at — ISO-8601.

Conversation statuses

• NEW — handled by AI, no operator yet.
• ESCALATING — flagged for a human; operators notified.
• PROCESSING — an operator has taken over.
• WAITING — operator is waiting on the customer.
• RESOLVED — resolved; a customer reply can reopen it.
• CLOSED — closed.