Conversations

Updated September 7, 2026

The conversation is the central entity: client, channel, status, assignee, tags, rating and messages. The list supports cursor pagination, the card returns the full thread.

GET /conversations — list

Parameter	Type	Description
status	query	new, open, closed or all (default all)
channel	query	site, telegram, max, whatsapp, vk, avito, email
assignee	query	Operator ID; unassigned — no assignee
department	query	Department ID
limit	query	1–100, default 50
cursor	query	next page cursor from the nextCursor field

Response 200

{
  "items": [
    {
      "id": "cv_018f3a",
      "client": "Kira Meshcheryakova",
      "channel": "telegram",
      "status": "new",
      "unread": 2,
      "assignee": null,
      "department": "dp_sales",
      "tags": ["delivery"],
      "rating": null,
      "lastMessage": {"from": "client", "text": "Hello!", "createdAt": "2026-09-07T11:58:00Z"},
      "createdAt": "2026-09-07T11:58:00Z",
      "updatedAt": "2026-09-07T12:01:00Z"
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjUwfQ"
}

GET /conversations/{id} — conversation card

Returns the conversation with all messages in chronological order. Use it for a full thread backup or to show history in your own system.

Response 200 (fragment)

{
  "id": "cv_018f3a",
  "client": "Kira Meshcheryakova",
  "channel": "telegram",
  "status": "open",
  "messages": [
    {"id": "m_5521", "from": "client", "author": null, "text": "Hello!", "createdAt": "2026-09-07T11:58:00Z"},
    {"id": "m_5522", "from": "operator", "author": "Anna Sorokina", "text": "Good afternoon! How can I help?", "createdAt": "2026-09-07T11:59:10Z"},
    {"id": "m_5523", "from": "note", "author": "Anna Sorokina", "text": "Client from Instagram, hand to a manager", "createdAt": "2026-09-07T11:59:40Z"}
  ]
}

Messages of type note are internal team notes — the client does not see them.

← Keys and authorization →Messages