Выгрузка логов диалогов
JAICP предоставляет доступ к ежедневным логам для анализа статистики диалогов. Вы можете скачать логи за нужный день в формате CSV или XLSX.
Скачать логи из интерфейса
Чтобы скачать логи из интерфейса JAICP в XLSX:
- Зайдите в нужный подраздел раздела Аналитика: Диалоги или Клиенты.
- Примените необходимые фильтры.
- Нажмите Лог сессий в разделе Диалоги или Скачать отчет в разделе Клиенты.
- Отслеживайте в реальном времени процесс формирования логов в списке задач. Там же вы можете досрочно отменить эту задачу, если нужно.
- Скачайте отчет в виде таблицы XLSX.
предупреждение
Результат сформированных логов зависит от примененных фильтров.
Чтобы скачать полный отчет, сбросьте фильтры.
Выгружаемые данные
В разделе Диалоги
| Колонка | Описание | Пример |
|---|---|---|
| Проект | Название проекта. | test-1234567-ABC |
| Тип канала | telegram | |
| Идентификатор канала | 1234567-test-1234567-ABC-987654 | |
| Идентификатор клиента | 098765432 | |
| Имя клиента | Имя пользователя, которое он указал в канале. | Alex |
| Сессия | Идентификатор сессии. | telegram-1234567-test-1234567-ABC-987654-449950996.38ea0050-b792-4c52-9021-104dd322ab08 |
| Начало сессии | Дата и время начала сессии отображаются согласно часовому поясу, установленному в профиле пользователя. | 03.03.2023 10:53:07 |
| Конец сессии | Дата и время окончания сессии. | 03.03.2023 13:02:47 |
| Первая фраза | Первая фраза пользователя в этой сессии. | привет |
| Последняя фраза | Последняя фраза пользователя в этой сессии. | пока |
| Длительность | Продолжительность сессии. | 02:09:39 |
| Число фраз | Количество сообщений от пользователя в этой сессии. | 9 |
| Метка сессии | Метки задаются вручную в разделе Аналитика или в коде сценария. | Запрос удовлетворен |
| Результат сессии | Результат задается в коде сценария или через метки стейтов в J‑Graph. | Отказ от прохож дения опроса |
| Переключение на оператора | Пользователь был переведен на оператора или нет. | Да или Нет |
| Направление вызова | Входящий или исходящий вызов (только для телефонных ботов). | Исходящий |
| Идентификатор обзвона | 1234567890 |
В разделе Клиенты
| Колонка | Описание | Пример |
|---|---|---|
| Идентификатор клиента | 098765432 | |
| Имя клиента | Имя пользователя, которое он указал в канале. | Alex |
| Тип канала | telegram | |
| Дата добавления | Дата и время начала диалога. Отображаются согласно часовому поясу, установленному в профиле пользователя. | 03.03.2023 10:53:07 |
| Дата последней активности | Дата и время последнего обращения пользователя к боту. | 13.03.2023 17:00:00 |
| Идентификатор канала | 1234567-test-1234567-ABC-987654 | |
| Активен | Если пользователь заблокирован, то он не активен. | Да или Нет |
Скачать логи по GET-запросу
Чтобы скачать логи по GET-запросу в CSV:
- Владелец аккаунта обращается в техническую поддержку с запросом на включение опции «Скачивание логов диалогов в CSV».
подсказка
Если у вас подключен тариф Enterprise, то вы уже можете скачивать логи диалогов таким спосо бом.
Эта опция автоматически подключается при переходе на платный тариф.
-
Затем владелец аккаунта добавляет роль RAWLOGS_ANALYTIC тем пользователям, которые будут скачивать логи диалогов.
-
Пользователь с ролью RAWLOGS_ANALYTIC авторизуется на платформе и скачивает логи диалогов по адресу:
http(s)://{'<hostname>'}/restapi/rawlogs/dd-mm-yyyy.csv
Где:
hostname— имя хоста, где размещена платформа, напримерapp.jaicp.com.dd,mmиyyyy— день, месяц и год соответственно.
предупреждение
Если вы отправляете запрос не из браузера, используйте basic-аутентификацию:
curl -H 'Authorization: Basic {'<...>'} http(s)://{'<hostname>'}/restapi/rawlogs/dd-mm-yyyy.csvВыгружаемые данные
В выгружаемом CSV-файле представлены следующие колонки.
Разделитель между колонками — ;.
| Колонка | Описание | Пример |
|---|---|---|
session_id | Идентификатор сессии. | 20a8444a-e1dd-5865-5ee7-b03fcb65e19b.732196de-2de6-455f-b751-e2c9a4700c62 |
session_start_time | Время начала сессии. | 28.01.2019 17:18:45 |
session_end_time | Время окончания сессии. | 28.01.2019 21:18:45 |
session_questions_count | Количество всех фраз в сессии. | 14 |
session_tag | Метка сессии. | Запрос удовлетворен |
channel_type | Тип канала. | Telegram |
channel_name | Название канала. | demo_bot |
client_id | Идентификатор пользователя. | telegram-118460129-demobot-118460129-XLA-160021967-294227430 |
client_name | Имя пользователя. | John |
project_name | Название проекта. | Demobot |
msg_rt | Время, когда сервер записал фразу. | 13.02.2019 13:41:12 |
msg_question | Запрос от пользователя. | Найди ближайший банкомат |
msg_answer | Ответ бота. | Ближайший банкомат на станции метро Чкаловская |
state_before | Стейт до обработки запроса. | /Menu |
state_after | Стейт после обработки запроса. | /CatchAll/Switch/NoOperatorsOnline |
msg_switched | Если true, то пользователь был переведен на оператора после зап роса. Если false, то перевода на оператора не было. | true |
msg_operator | Если true, то на запрос ответил оператор. Если false, то ответил бот. | false |
msg_comment | Комментарий к фразе. | поиск банкомата |
msg_tags | Метки к фразе. | банкоматы |
Когда начнут формироваться логи?
Логи для выгрузки начинают формироваться с момента подключения опции. Более ранние логи диалогов скачать не получится.
Ежедневные логи записываются в файл за предыдущий день.
По умолчанию логи формируются в 00:01 по часовому поясу UTC−0.
При формировании логов за один и тот же день предыдущий файл будет перезаписан.
предупреждение
В CSV-файле время отображается в
UTC–0,
независимо от времени, которое указано в профиле пользователя.Как повторно сгенерировать отчет?
Владелец аккаунта или пользователь с ролью RAWLOGS_ANALYTIC может отправить GET-запрос с параметром force=true, чтобы еще раз сгенерировать отчет:
http(s)://{'<hostname>'}/restapi/rawlogs/run/{'accountId'}/dd-MM-yyyy?force=true
подсказка
Новый отчет будет доступен через 10 минут по прежнему адресу.
Удаление логов
Если проекта активна опция «Удаление диалогов», то логи старше указанной даты будут полностью удалены.