---
metadata:
  - name: generator
    content: Diplodoc Platform v5.48.2
alternate:
  - https://yandex.com.tr/dev/metrika/en/management/openapi/chats/upload_chats.md
  - https://yandex.com.tr/dev/metrika/ru/management/openapi/chats/upload_chats.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/metrika/ru/llms.txt

# Загрузка информации о чатах

Загружает файл с чат-конверсиями (тип `CHATS`).

Обработка файла занимает до двух часов. Возвращает объект загрузки со статусом 200.

Сформируйте CSV-файл с информацией и передайте его с помощью этого метода. Укажите во входных данных OAuth-токен и номер счетчика.

Также рекомендуем генерировать запросы к API в автоматическом режиме с помощью модулей языка программирования.

1. Формат файла — CSV.

2. Ограничение на размер файла — 1 Гб.

3. Кодировка файла — UTF-8.

## Request {#request}

```
POST https://api-metrika.yandex.net/management/v1/counter/{counterId}/offline_conversions/upload?type=CHATS
```

### Path parameters {#path-parameters}

#|
||**Name** | **Description**||
|| counterId[*](*star) | **Type:** `integer<int32>`

Идентификатор счетчика, для которого нужно загрузить чат-конверсии.

Example: `2215573` ||
|#

### Query parameters {#query-parameters}

#|
||**Name** | **Description**||
|| comment | **Type:** string

Комментарий. Максимальная длина — 255 символов. Допустимы цифры, латинские и кириллические буквы. ||
|#

### Body {#body-request}

{% cut "multipart/form-data" %}

```json
{
    "file": null
}
```

{% endcut %}

#|
||**Name** | **Description**||
|| file | **Type:** `string<binary>`

Чат-конверсии, которые вы хотите загрузить, передаваемые как multipart/form-data. Ограничение на размер файла — 1 Гб.Кодировка файла — UTF-8.||

|#

## Responses {#responses}

## 200 OK {#200ok}

OK

### Body {#body-response}

{% cut "application/json" %}

```json
{
    "uploadings": [
        {
            "id": 0,
            "create_time": "2022-12-29T18:02:01Z",
            "source_quantity": 0,
            "line_quantity": 0,
            "comment": "string",
            "type": "string",
            "client_id_type": "USER_ID",
            "status": "string"
        }
    ]
}
```

{% endcut %}

#|
||**Name** | **Description**||
|| uploading[*](*star) | **Type:** [OfflineConversionUploading](#OfflineConversionUploading)[]

Информация о загрузке чат-конверсий. ||
|#

### OfflineConversionUploading {#OfflineConversionUploading}

Информация о загрузке чат-конверсий.

#|
||**Name** | **Description**||
|| client_id_type | **Type:** string

Тип идентификаторов посетителей. Возможные значения:

- `USER_ID` — идентификатор посетителя сайта, назначенный владельцем сайта.

- `CLIENT_ID` — идентификатор посетителя сайта, назначенный Яндекс Метрикой.

- `YCLID` — идентификатор клика по рекламному объявлению Яндекс Директа, назначенный Яндекс Директом.

Example: `USER_ID`||

|| comment | **Type:** string

Произвольный комментарий. Количество символов не должно превышать 255.

Min length: `0`

Max length: `255`||
|| create_time | **Type:** `string<date-time>`

Время загрузки.||
|| id | **Type:** integer<int64>

Идентификатор загрузки.||
|| line_quantity | **Type:** `integer<int32>`

Количество строк, прошедших валидацию при загрузке.||
|| source_quantity | **Type:** `integer<int32>`

Количество строк в исходном файле.||
|| status | **Type:** string

Статус загрузки:

- `PREPARED` — загрузка подготовлена.

- `UPLOADED` — загрузка завершена.

- `EXPORTED` — загрузка экспортирована.

- `MATCHED` — произведено сопоставление идентификаторов событий.

- `PROCESSED` — загрузка успешно обработана.

- `LINKAGE_FAILURE` — не удалось сопоставить ни один идентификатор посетителя. Если передана информация о статических звонках, они не будут привязаны к визитам в Яндекс Метрике, но будут доступны в отчетах по звонкам.||
|| string | **Type:** string ||
|#

[*star]: обязательный параметр