This site is no longer updated.Go to new Conversational Cloud docs

Статистика диалогов


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


Как скачать логи диалогов?

  1. Администратор аккаунта должен обратиться в техническую поддержку с запросом на активацию опции скачивания логов диалогов. Если вы используете один из бизнес-тарифов (JAICP Business Standard, JAICP Business Pro, JAICP Business Pro+, JAICP Business Ultra, JAICP Business Enterprise), то опция была автоматически подключена при переходе на этот тариф.

  2. Затем администратор аккаунта добавляет роль RAWLOGS_ANALYTIC тем пользователям, которые должны иметь возможность скачивать файлы логов диалогов.

  3. Пользователь с ролью RAWLOGS_ANALYTIC авторизуется на платформе и скачивает логи диалогов по адресу:

http(s)://hostname/restapi/rawlogs/dd-mm-yyyy.csv   // hostname - адрес платформы, dd - день, mm - месяц, yyyy - год

Когда начнут формироваться логи?

Логи для выгрузки начинают формироваться с момента подключения опции. Логи диалогов, сформированные до подключения, недоступны для скачивания.

Ежедневные логи записываются в файл за предыдущий день от момента запуска задачи на генерацию. По умолчанию логи формируются в 00:01 UTC-0 за предыдущий день. При генерации диалогов за один и тот же день, предыдущий файл будет перезаписан.

Обратите внимание, что логи диалогов в разделе Диалоги отображаются согласно часовому поясу, установленному в профиле пользователя. Но при этом в выгружаемом файле — по UTC-0.


У меня включено удаление логов диалогов

Если для аккаунта или одного из проектов активна опция Удаление логов диалогов, то логи старше указанной даты будут удалены полностью для всего аккаунта независимо от проекта.


Есть другой способ скачать логи?

Файл также можно скачать по GET-запросу. Скачивание доступно только для аутентифицированного пользователя с ролью RAWLOGS_ANALYTIC. Для аутентификации вы можете использовать basic-аутентификацию. В Headers при этом укажите Product: botadmin.


Выгружаемые данные

Поле Описание Пример
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 имя клиента Jhon
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 метки к фразе банкоматы