Статистика диалогов
Платформа для анализа статистики диалогов предоставляет доступ к ежедневным логам. Пользователь самостоятельно может скачать логи со всего аккаунта за предыдущий день. Логи предоставляются в формате файла .csv.
Как скачать логи диалогов?
-
Администратор аккаунта должен обратиться в техническую поддержку с запросом на активацию опции скачивания логов диалогов. Если вы используете один из бизнес-тарифов (JAICP Business Standard, JAICP Business Pro, JAICP Business Pro+, JAICP Business Ultra, JAICP Business Enterprise), то опция была автоматически подключена при переходе на этот тариф.
-
Затем администратор аккаунта добавляет роль RAWLOGS_ANALYTIC тем пользователям, которые должны иметь возможность скачивать файлы логов диалогов.
-
Пользователь с ролью 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 |
метки к фразе | банкоматы |