> For the complete documentation index, see [llms.txt](https://chatme-ai-4.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chatme-ai-4.gitbook.io/docs/kak-proveryat-analitiku-obsheniya-agenta/vygruzka-kontekstnykh-peremennykh-chatov.md).
# Выгрузка контекстных переменных чатов
В Платформа реализована возможность получения на 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" %}