Docs

История релизов

НАЧАЛО РАБОТЫ С ПЛАТФОРМОЙ

ПЕРЕД СОЗДАНИЕМ АГЕНТА

КОНСТРУКТОР СЦЕНАРИЯ АГЕНТА

СОЗДАНИЕ АГЕНТА НА ПЛАТФОРМЕ

ОБУЧЕНИЕ И ТЕСТИРОВАНИЕ АГЕНТА

РАЗМЕЩЕНИЕ АГЕНТА В КАНАЛАХ

ЭКСПЛУАТАЦИЯ АГЕНТА

АНАЛИТИКА ОБЩЕНИЯ АГЕНТА

Explore

АНАЛИТИКА ОБЩЕНИЯ АГЕНТА

Выгрузка истории диалогов

@Платформа⁠

реализована возможность получения на email файла (.csv) с историей

@Диалог⁠

ов, соответствующих условиям установленных фильтров аналитики.

Запрос и получение файла

Запрос файла с историей сообщений производится на

@Вкладка Аналитики⁠

Установите в фильтрах Аналитики необходимые значения.

Нажмите кнопку Chat history на панели EXPORT.

⁠

По нажатию кнопки появляется модальное окно с фильтрами отчета.

⁠

Фильтр NLU requests отвечает за сообщения

@Собеседник⁠

а, прошедшие через

@Слот⁠

@NLU⁠

Фильтр All messages and buttons отвечает за все сообщения

@Собеседник⁠

а и

@Агент⁠

а (в том числе сообщения

@Собеседник⁠

а, прошедшие через

@Слот⁠

@NLU⁠

, кнопки, отправка

@Attachment⁠

);

При включении фильтра All messages and buttons фильтр NLU requests активируется автоматически .

Фильтр NLU requests невозможно выключить, если включен фильтр All messages and buttons.

После выключения фильтра All messages and buttons фильтр NLU requests становится доступен для переключения.

⁠

Фильтр External requests отвечает за

@Внешний запрос⁠

;

Фильтр Incoming Requests отвечает за

@Входящий запрос⁠

;

Фильтр Notifications отвечает за

@Слот⁠

@Notification⁠

;

Фильтр Timers отвечает за

@Слот⁠

@Timer⁠

Выберите необходимые фильтры и нажмите кнопку GET REPORT. После этого запрос на выгрузку отправится в

@Платформа⁠

, где будет ожидать обработки в общей очереди запросов на выгрузку.

Вы получите уведомление о том, что отчет будет выслан на адрес электронной почты, на который зарегистрирован ваш аккаунт в

@Платформа⁠

⁠

Если в фильтрах аналитики был выбран один

@Агент⁠

, после выполнения запроса системой на email

@Аккаунт пользователя⁠

поступает письмо со ссылкой на скачивание файла. Ссылка действительна в течение 24 часов.

Если в фильтрах аналитики было выбрано несколько

@Агент⁠

ов, придет несколько писем, по одному для каждого

@Агент⁠

а.

Максимальный срок задержки между постановкой запроса в очередь и отправкой файла на почту составляет 24 часа.

Важно: поскольку формирование файла занимает некоторое время, в него войдут те данные, которые были в системе на момент, когда подошла очередь обработки запроса. То есть данные, имеющиеся в аналитике на момент отправки запроса и данные в файле могут отличаться.

Важно: в данный момент не реализовано ограничение на количество отправленных запросов, поэтому, при отправке повторных запросов возможны задержки в получении файлов, а также массовое поступление писем на почту.

Файл отчета

Имя файла: Chat history for agent <НАЗВАНИЕ АГЕНТА> <начало> - <окончание датывремени создания диалога из фильтров, если установлены>.csv;

Файл имеет расширение .csv. Разделитель строк — запятая;

Кодировка файла: UTF-8;

Файл имеет табличную структуру;

Файл может быть открыт текстовыми редакторами;

Файл может быть открыт редакторами электронных таблиц: Google Sheets, Open Office, Pages, MS Excel. Не рекомендуется использовать MS Excel, так как в файле в одной ячейке могут быть значения с переносами строк (например, текст бота в несколько абзацев), MS Excel может некорректно обработать такие переносы, и структура таблицы будет нарушена

⁠

Столбцы таблицы и их содержимое:

AGENT — имя

@Агент⁠

CHANNEL — имя (тип)

@Конечный канал⁠

(Dialog360, Webim, Telegram, Jivosite и пр.)

CHANNEL_ID — ID конкретного канала

CHAT_ID — идентификатор

@Чат⁠

CHAT CREATED — дата и время создания

@Чат⁠

а, т.е. дата и время начала первого

@Диалог⁠

а в этом

@Чат⁠

е. Формат ЧЧ:ММ:СС ДД.ММ.ГГГГ (UTC).

VISITOR_ID — параметр, получаемый из

@Конечный канал⁠

а, в котором состоялся данный

@Диалог⁠

⁠

DIALOG_ID — идентификатор

@Диалог⁠

а, которому принадлежит сообщение MESSAGE в данной строке

DIALOG STARTED — дата и время начала данного диалога. Формат ЧЧ:ММ:СС ДД.ММ.ГГГГ (UTC)

DIALOG DURATION — длительность данного диалога. Формат ЧЧ:ММ:СС

MESSAGE AUTHOR — автор сообщения MESSAGE в данной строке

agent — автор

@Агент⁠

⁠

user — автор

@Собеседник⁠

⁠

system — для MESSAGE TYPE timer, incoming request, external request, notification task, notification request, notification delivered, notification failed, notification no account

MESSAGE TYPE — тип сообщения

text — текст

timer — срабатывание

@Timer⁠

incoming request — запуск

@Входящий запрос⁠

button list — список кнопок

@button⁠

external request — отправка

@Внешний запрос⁠

ER response — ответ от внешней системы на

@Внешний запрос⁠

attachment — отправка

@Attachment⁠

⁠

notification task — успешный запуск рассылки через слот

@Notification⁠

notification request — приходит, если задача на запуск обработана без ошибок и система отправила запрос к API мессенджера

notification delivered — приходит, если рассылка была доставлена

notification failed — приходит, если аккаунта WhattsApp на указанный номер не существует

notification no account — приходит, если не удалось отправить рассылку

MESSAGE DATE TIME — дата и время регистрации данного сообщения в базе данных Платформы. Формат ЧЧ:ММ:СС ДД.ММ.ГГГГ (UTC)

INTENT:

intent — название распознанного

@Интент⁠

confidence-threshold показывает значения

@Threshold⁠

⁠

для обработанной

@Реплика⁠

. Первое число показывает значение

⁠

, с которым был распознан

@Интент⁠

. Второе число показывает значение

@Threshold⁠

, которое было установлено для

@Слот⁠

@NLU⁠

в момент распознавания этой

@Реплика⁠

request —

@Реплика⁠

@Собеседник⁠

⁠

message_history (2) - Google Таблицы - Google Chro.png

⁠

MESSAGE — контент сообщения, для каждого типа контента предусмотрен свой формат:

“text”: неформатированный текст сообщения

@Собеседник⁠

а или

@Агент⁠

а.

Пример:
⁠
⁠

“timer”: пустая строка;

"incoming request": текст со спецсловом “BODY: “, после которого следует тело запроса.

Пример: BODY: {"raw_request": "{\r\n \"chat_id\": \"03313eaf4970c4de1aab4aa7afad4fa2f71c59aa\",\r\n \"is_urgent\": true,\r\n \"var1\": \"value\"\r\n}", "attributes": "{\"name\": \"name\"}", "data_type": "json"}

⁠
⁠
⁠

“button list”: перечисленные через запятую по порядку вывода лейблы кнопок, взятые в кавычки.

Пример:

⁠
⁠
⁠

“external request”: параметры отправленного

@Внешний запрос⁠

в формате:

ER name: <имя

@Внешний запрос⁠

<тип

@Внешний запрос⁠

> <URL>

headers: { <заголовки

@Внешний запрос⁠

> }

body: {

<тело

@Внешний запрос⁠

Пример:
⁠
⁠

“ER response”: код ответа и тело полученного ответа соответственно в формате:

code: <код ответа в числовом формате>

body: { <тело ответа> }

Пример:
⁠
⁠

"attachment": тип отправленного файла и ссылка на файл в формате: type: <URL>

Пример:
⁠
⁠

“notification task”: запрос, который

@Платформа⁠

получает при запуске рассылки, и ответ на него в формате: Request: <запрос> Response: code: <код ответа> body: {<тело ответа>}

Пример:
⁠
⁠

“notification request”: статус рассылки, запрос который

@Платформа⁠

отправляет к API мессенджера (или омниканалки) для запуска рассылки и ответ на него в формате: Notification status: <статус> Request:<запрос> Response: code: <код ответа> body: {<тело ответа>}