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

В Платформа реализована возможность получения на email файла (.csv) с историей событий в Чате, соответствующих условиям установленных фильтров аналитики.

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

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

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

2. Необходимо нажать кнопку Chat history на панели EXPORT.

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

4. 1. Фильтр NLU requests отвечает за сообщения Собеседника, прошедшие через Слот NLU.

   2. Фильтр All messages and buttons отвечает за все сообщения Собеседника и Агента (в том числе сообщения Собеседника, прошедшие через Слот NLU, кнопки, отправка Attachment);

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

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

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

   4. Фильтр External requests отвечает за Внешний запрос;

   5. Фильтр Incoming Requests отвечает за Входящий запрос;

   6. Фильтр Notifications отвечает за Слоты Notification;

   7. Фильтр Timers отвечает за Слоты Timer.

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

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

7. Если в фильтрах аналитики был выбран один Агент, после выполнения запроса системой на email Аккаунт пользователя поступает письмо со ссылкой на скачивание файла. Ссылка действительна в течение 24 часов.

8. Если в фильтрах аналитики было выбрано несколько Агентов, придет несколько писем, по одному для каждого Агента.

9. 1. Если по одному или нескольким выбранным Агентам не будет Общение в указанный период, то по данным Агентам придут пустые отчеты.

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

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

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

Файл отчета

1. Имя файла: Chat history 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. AGENT — имя Агента

   2. CHANNEL — имя (тип) Конечный канал (Dialog360, Webim, Telegram, Jivosite и пр.)

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

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

   5. CHAT CREATED — дата и время создания Чата, т.е. дата и время начала первого Диалога в этом Чате. Формат ЧЧ:ММ:СС ДД.ММ.ГГГГ (UTC).

   6. VISITOR_ID — параметр, получаемый из Конечный канала, в котором состоялся данный Диалог

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

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

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

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

   11. 1. agent — автор Агент

       2. user — автор Собеседник

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

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

   13. 1. text — текст

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

       3. incoming request — запуск Входящий запрос

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

       5. external request — отправка Внешний запрос

       6. ER response — ответ от внешней системы на Внешний запрос

       7. attachment — отправка Attachment

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

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

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

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

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

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

   15. INTENT:

   16. 1. intent — название распознанного Интента

       2. confidence-threshold показывает значения Threshold и confidence для обработанной Реплика. Первое число показывает значение confidence, с которым был распознан Интент. Второе число показывает значение Threshold, которое было установлено для Слота NLU в момент распознавания этой Реплика

       3. request — Реплика Собеседника

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

   19. 1. “text”: неформатированный текст сообщения Собеседника или Агента.

       2. Пример:

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

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

       5. Пример: 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"}

       6. 

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

       8. Пример:

       9. 

       10. “external request”: параметры отправленного Внешний запрос в формате:

       11. ER name: <имя Внешний запрос><тип Внешний запрос> <URL>headers: { <заголовки Внешний запрос> }body: {<тело Внешний запрос>

       12. Пример:

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

       14. code: <код ответа в числовом формате>body: { <тело ответа> }

       15. Пример:

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

       17. Пример:

       18. “notification task”: запрос, который Платформа получает при запуске рассылки, и ответ на него в формате: Request: <запрос> Response: code: <код ответа> body: {<тело ответа>}

       19. Пример:

       20. “notification request”: запрос, который Платформа отправляет к API мессенджера (или омниканалки) для запуска рассылки и ответ на него в формате: Request:<запрос> Response: code: <код ответа> body: {<тело ответа>}

       21. Пример:

       22. “notification delivered”: запрос, который отправляет мессенджер/омниканальная платформа к Платформа со статусом доставки рассылки в формате: Request: <запрос>

       23. Пример:

       24. “notification failed”: запрос, который отправляет мессенджер/омниканальная платформа к Платформа со статусом доставки рассылки в формате: Request: <запрос>

       25. Пример:

       26. “notification no account”: запрос, который отправляет мессенджер/омниканальная платформа к Платформа со статусом доставки рассылки в формате: Request: <запрос>

       27. Пример:

Пример файла:

15KB

Message history for agent HISTORY 2022-12-13 00_00_00 .csv