> For the complete documentation index, see [llms.txt](https://docs.fstrk.io/knowledge_base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fstrk.io/knowledge_base/api/obshaya-informaciya/informaciya-o-sessiyakh.md).

# Информация о сессиях

#### GET /api/partners/sessions/{uuid}/

🔒 *bot-key или OAuth*

**Кратко:** Получить информацию о чат-сессии по UUID.

**Параметры пути:**

* `uuid` (string, обязательный) — UUID сессии

**Возвращает:** `200 OK` — объект `SessionDetails`: `uuid`, `chat_uuid`, `status`, `is_automatic`, `created_at`, `closed_at`.

<details>

<summary>Пример ответа:</summary>

{% code overflow="wrap" %}

```json
{
  "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "chat_uuid": "7ab1c234-5678-4def-a012-3456789bcdef",
  "status": "open",
  "is_automatic": false,
  "created_at": "2024-06-01T10:00:00Z",
  "closed_at": null
}
```

{% endcode %}

</details>

**Статусы сессии:**

* `open` — открыта
* `nps` — ожидает оценки качества обслуживания
* `closed` — закрыта

**Ошибки:** 401 — ошибка авторизации; 404 — сессия не найдена.

**Пример запроса:**

```bash
curl -X GET https://dashboard.fstrk.io/api/partners/sessions/3fa85f64-5717-4562-b3fc-2c963f66afa6/ \
  -H "bot-key: your_bot_key"
```

***

#### GET /api/partners/sessions/{uuid}/interactions/

🔒 *bot-key или OAuth*

**Кратко:** Получить историю сообщений (взаимодействий) сессии по её UUID.

**Параметры пути:**

* `uuid` (string, обязательный) — UUID сессии

**Параметры запроса:**

* `limit` (integer, опциональный) — кол-во элементов на странице
* `offset` (integer, опциональный) — кол-во элементов для пропуска

**Возвращает:** `200 OK` — постраничный список объектов `SessionInteractions`: `uuid`, `status`, `direction`, `content`, `created_at`.

<details>

<summary>Пример ответа:</summary>

{% code overflow="wrap" %}

```json
{
  "count": 5,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "delivered",
      "direction": "incoming",
      "content": {
        "type": "text",
        "text": "Здравствуйте, нужна помощь!"
      },
      "created_at": "2024-06-01T10:01:00Z"
    },
    {
      "uuid": "9bc2d345-6789-4abc-b123-456789cdef01",
      "status": "delivered",
      "direction": "outgoing",
      "content": {
        "type": "text",
        "text": "Добрый день! Чем могу помочь?"
      },
      "created_at": "2024-06-01T10:02:30Z"
    }
  ]
}
```

{% endcode %}

</details>

**Ошибки:** 401 — ошибка авторизации; 404 — сессия не найдена.

**Пример запроса:**

```bash
curl -X GET "https://dashboard.fstrk.io/api/partners/sessions/3fa85f64-5717-4562-b3fc-2c963f66afa6/interactions/?limit=50" \
  -H "bot-key: your_bot_key"
```
