chatme.ai
Search…
Создание Агента на платформе
ДЛЯ РАЗРАБОТЧИКОВ
Выгрузка истории диалогов
В Платформе реализована возможность получения на email файла (.csv) с историей Диалогов, соответствующих условиям установленных фильтров аналитики.

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

Запрос файла с историей сообщений производится на вкладке Аналитики.
  1. 1.
    Установите в фильтрах Аналитики необходимые значения, как описано в статье Применимые фильтры
  2. 2.
    Нажмите на кнопку EXPORT.
  3. 3.
    В выпадающем списке нажмите кнопку Message history. После этого запрос на выгрузку отправится в Платформу, где будет ожидать обработки в общей очереди запросов на выгрузку.
  4. 4.
    Вы получите уведомление о том, что отчет будет выслан на адрес электронной почты, на который зарегистрирован ваш аккаунт в Платформе.
  5. 5.
    В течение некоторого времени (зависит от количества данных в отчете и от его места в очереди на выгрузку) на вашу почту придет письмо. Максимальный срок задержки между постановкой запроса в очередь и отправкой файла на почту составляет 24 часа. Письмо содержит ссылку на скачивание отчета. Ссылка действительна в течение 24 часов.

Содержание файла

  1. 1.
    Файл с историей Диалогов имеет расширение .csv. Разделитель строк — запятая;
  2. 2.
    Кодировка файла: UTF-8;
  3. 3.
    Файл может быть открыт текстовыми редакторами;
  4. 4.
    Файл может быть открыт редакторами электронных таблиц: Google Sheets, Open Office, Pages, MS Excel. Не рекомендуется использовать MS Excel, так как в файле в одной ячейке могут быть значения с переносами строк (например, текст бота в несколько абзацев), MS Excel может некорректно обработать такие переносы, и структура таблицы будет нарушена.
Столбцы таблицы и их содержимое:
  1. 1.
    AGENT — имя Агента
  2. 2.
    CHANNEL — название Канала Агента
  3. 3.
    CHANNEL_ID — ID конкретного канала — объекта в Базе Данных, например, у Агента может быть два канала Telegram, у каждого свой ID
  4. 4.
    CHAT_ID — идентификатор Чата
  5. 5.
    CHAT CREATED — дата и время создания Чата, т.е. дата и время начала первого Диалога в этом Чате. Формат ЧЧ:ММ:СС ДД.ММ.ГГГГ (UTC).
  6. 6.
    VISITOR_ID — параметр, получаемый из Конечного канала, в котором состоялся данный Диалог
  7. 7.
    DIALOG_ID — идентификатор Диалога, которому принадлежит сообщение MESSAGE в данной строке
  8. 8.
    DIALOG STARTED — дата и время начала данного диалога. Формат ЧЧ:ММ:СС ДД.ММ.ГГГГ (UTC)
  9. 9.
    DIALOG DURATION — длительность данного диалога. Формат ЧЧ:ММ:СС
  10. 10.
    MESSAGE AUTHOR — автор сообщения MESSAGE в данной строке
    1. 1.
      agent — автор сообщения — Агент
    2. 2.
      user — автор сообщения — Собеседник
    3. 3.
      system — сообщение Системы (когда MESSAGE TYPE timer, incoming request, external request)
  11. 11.
    MESSAGE TYPE — тип сообщения
    1. 1.
      text — текст
    2. 2.
      timer — срабатывание Timer
    3. 3.
      incoming request — запуск Incoming Request
    4. 4.
      button list — список кнопок Button Menu
    5. 5.
      external request — отправка Внешнего запроса
    6. 6.
      ER response — ответ от внешней системы на Внешний запрос
  12. 12.
    MESSAGE DATE TIME — дата и время регистрации данного сообщения в базе данных Платформы. Формат ЧЧ:ММ:СС ДД.ММ.ГГГГ (МСК)
  13. 13.
    INTENT:
    1. 1.
      intent — название распознанного Интента
    2. 2.
      confidence-threshold показывает значения confidence и Threshold для обработанной Реплики. Первое число показывает значение confidence, с которым был распознан Интент. Второе число показывает значение Threshold, которое было установлено для слота NLU в момент распознавания этой Реплики.
    3. 3.
      request — Реплика Собеседника
  14. 14.
    MESSAGE — контент сообщения, для каждого типа контента предусмотрен свой формат:
    1. 1.
      text”: неформатированный текст сообщения Агента или Собеседника. Пример:
    2. 2.
      timer”: пустая строка;
    3. 3.
      "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"} Пример:
    4. 4.
      button list”: перечисленные через запятую по порядку вывода лейблы кнопок, взятые в кавычки. Пример:
    5. 5.
      external request”: параметры отправленного Внешнего запроса в формате: ER name: <имя Внешний запрос><тип Внешний запрос> headers: { <заголовки Внешний запрос> }body: {<тело Внешний запрос>}
    6. 6.
      ER response”: код ответа и тело полученного ответа соответственно в формате: code: <код ответа в числовом формате>body: { <тело ответа> }
Copy link
On this page
Запрос и получение файла
Содержание файла