# Выгрузка контекстных переменных чатов
В Платформа реализована возможность получения на email файла (.csv) с Контекстная переменная всех Чатов, соответствующих условиям установленных фильтров аналитики.
## Запрос и получение файла
Запрос файла с Контекстная переменная производится на Вкладка Аналитики.
1. Установите в фильтрах Аналитики необходимые значения.
2. Необходимо нажать кнопку Chat context на панели EXPORT.\
3. По нажатию кнопки появляется модальное окно с фильтрами отчета.\
4. 1. Фильтр All user-defined variables отвечает за Пользовательские контекстные переменные;
2. Фильтр All channel variables отвечает за Канальные переменные;
3. Фильтр All system variables отвечает за Системная контекстная переменная;
4. Фильтр Specific variables отвечает за конкретные Контекстная переменная.
5. 1. При активации тумблера Specific variables ниже появится поле для ввода.
2. Для включения Контекстная переменная в отчет необходимо указать их в поле через запятую.
3. Лимит на количество выгружаемых конкретных Контекстная переменная — 40 штук. При указании в поле более 40 переменных в отчет будут включены только первые 40 переменных из указанных в поле.
5. Выберите необходимые фильтры и нажмите кнопку GET REPORT. После этого запрос на выгрузку отправится в Платформа, где будет ожидать обработки в общей очереди запросов на выгрузку.
6. Вы получите уведомление о том, что отчет будет выслан на адрес электронной почты, на который зарегистрирован ваш аккаунт в Платформа.\
7. Если в фильтрах аналитики был выбран один Агент, после выполнения запроса системой на email Аккаунт пользователя поступает письмо со ссылкой на скачивание файла. Ссылка действительна в течение 24 часов.
8. Если в фильтрах аналитики было выбрано несколько Агентов, придет несколько писем, по одному для каждого Агента.
9. 1. Если по одному или нескольким выбранным Агентам не будет Общение в указанный период, то по данным Агентам придут пустые отчеты.
10. Максимальный срок задержки между постановкой запроса в очередь и отправкой файла на почту составляет 24 часа.
> Важно: поскольку формирование файла занимает некоторое время, в него войдут те данные, которые были в системе на момент, когда подошла очередь обработки данного запроса и он начал выполняться. То есть данные, имеющиеся в аналитике на момент нажатия кнопки выгрузки и данные в файле, могут отличаться.
>
> Важно: в данный момент не реализовано ограничение на количество отправленных запросов, поэтому, при отправке повторных запросов возможны задержки в получении файлов, а также массовое поступление писем на почту.
## Файл отчета
1. Имя файла: Chat context for agent <НАЗВАНИЕ АГЕНТА> <начало> - <окончание датывремени создания диалога из фильтров, если установлены>.csv;
2. Файл имеет расширение .csv. Разделитель строк — запятая;
3. Кодировка файла: UTF-8;
4. Файл имеет табличную структуру;
5. Файл может быть открыт текстовыми редакторами;
6. Файл может быть открыт редакторами электронных таблиц: Google Sheets, Open Office, Pages, MS Excel. Не рекомендуется использовать MS Excel, так как в файле в одной ячейке могут быть значения с переносами строк (например, текст бота в несколько абзацев), MS Excel может некорректно обработать такие переносы, и структура таблицы будет нарушена\
7. Столбцы таблицы и их содержимое:
8. 1. Информация о Чате — первые 7 колонок (A-H)
2. 1. CHAT\_ID — идентификатор Чата
2. AGENT — имя Агента
3. CHAT CREATED (колонка отсутствует в отчете Chat context (new)) — дата и время создания Чата, т.е. дата и время начала первого Диалога в этом Чате. Формат ЧЧ:ММ:СС ДД.ММ.ГГГГ (UTC).
4. TOTAL ACTIVE DIALOGS — количество активных в периоде Диалогов в каждом Чате.
5. LAST DIALOG STARTED — дата и время начала последнего Диалога в этом Чате. Формат ЧЧ:ММ:СС ДД.ММ.ГГГГ (UTC)
6. LAST MESSAGE TIME (колонка отсутствует в отчете Chat context (new)) — дата и время последнего сообщения в Чате, т.е. дата и время последнего сообщения в последнем закрытом Диалоге данного Чата. Формат ЧЧ:ММ:СС ДД.ММ.ГГГГ (UTC)
7. LAST MESSAGE AUTHOR (колонка отсутствует в отчете Chat context (new)) — автор последнего сообщения в Чате.
8. * agent — автор сообщения — Агент
* user — автор сообщения — Собеседник
9. LAST MESSAGE (колонка отсутствует в отчете Chat context (new)) — текст последнего сообщение в Чате или текст кнопки, если была нажата кнопка
3. Контекстные переменные чата — начиная с 9 колонки (J)
4. 1. Выгружаются как Системная контекстная переменная, так и Канальные переменные и Пользовательские контекстные переменные, выбранные в фильтрах при выгрузке.
2. Заголовки колонок со значениями Контекстная переменная имеют формат: CONTEXT\_<имя переменной>, например, CONTEXT\_channel\_chat\_id, и упорядочены по алфавиту
3. Одна колонка в файле (переменная) может содержать как пустые, так и непустые значения. Если колонка содержит пустое значение, значит, данная переменная отсутствует в Контекст Чата или содержит пустое значение.
Пример файла:
{% file src="/files/PjQgObsPRHAoc2BsXPnO" %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://chatme-ai-4.gitbook.io/docs/kak-proveryat-analitiku-obsheniya-agenta/vygruzka-kontekstnykh-peremennykh-chatov.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.