chatme.ai
Search
K
Comment on page

Выгрузка контекстных переменных

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

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

Запрос файла с Контекстными переменными производится на вкладке Аналитики.
  1. 1.
    Установите в фильтрах Аналитики необходимые значения, как описано в статье Применимые фильтры
  2. 2.
    Нажмите кнопку Chat context на панели EXPORT.
  3. 3.
    По нажатию кнопки появится окно с фильтрами отчета. С помощью фильтров выберите те переменные, информацию по которым хотите видеть в отчете:
    image.png
    1. 1.
      Фильтр All user-defined variables отвечает за Пользовательские контекстные переменные;
    2. 2.
      Фильтр All channel variables отвечает за Канальные переменные;
    3. 3.
      Фильтр All system variables отвечает за Системные контекстные переменные;
    4. 4.
      Фильтр Specific variables отвечает за конкретные Контекстные переменные.
      1. 1.
        При активации тумблера Specific variables ниже появится поле для ввода.
      2. 2.
        Для включения Контекстных переменных в отчет необходимо указать их в поле через запятую.
      3. 3.
        Лимит на количество выгружаемых конкретных Контекстных переменных — 40 штук. При указании в поле более 40 переменных в отчет будут включены только первые 40 переменных из указанных в поле.
  4. 4.
    Выберите необходимые фильтры и нажмите кнопку GET REPORT. После этого запрос на выгрузку отправится в Платформу, где будет ожидать обработки в общей очереди запросов на выгрузку.
  5. 5.
    Вы получите уведомление о том, что отчет будет выслан на адрес электронной почты, на который зарегистрирован ваш аккаунт в Платформе.
    platform_analytics - Googl.png
  6. 6.
    Если в фильтрах аналитики был выбран один Агент, после выполнения запроса системой на email Аккаунт пользователя поступает письмо со ссылкой на скачивание файла. Ссылка действительна в течение 24 часов.
  7. 7.
    Максимальный срок задержки между постановкой запроса в очередь и отправкой файла на почту составляет 24 часа.
  8. 8.
    Если в фильтрах аналитики было выбрано несколько Агентов, придет несколько писем, по одному для каждого Агента.
Важно: поскольку формирование файла занимает некоторое время, в него войдут те данные, которые были в системе на момент, когда подошла очередь обработки запроса. То есть данные, имеющиеся в аналитике на момент отправки запроса и данные в файле могут отличаться.
Важно: в данный момент не реализовано ограничение на количество отправленных запросов, поэтому, при отправке повторных запросов возможны задержки в получении файлов, а также массовое поступление писем на почту.

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

  1. 1.
    Файл с Контекстными переменными Чатов имеет расширение .csv. Разделитель строк — запятая;
  2. 2.
    Кодировка файла: UTF-8;
  3. 3.
    Файл может быть открыт текстовыми редакторами;
  4. 4.
    Файл может быть открыт редакторами электронных таблиц: Google Sheets, Open Office, Pages, MS Excel. Не рекомендуется использовать MS Excel, так как в файле в одной ячейке могут быть значения с переносами строк (например, текст бота в несколько абзацев), MS Excel может некорректно обработать такие переносы, и структура таблицы будет нарушена.
Столбцы таблицы и их содержимое:
  1. 1.
    Информация о Чате — первые 7 колонок (A-H)
    1. 1.
      CHAT_ID — идентификатор Чата
    2. 2.
      AGENT — имя Агента
    3. 3.
      CHAT CREATED — дата и время создания Чата, т.е. дата и время начала первого Диалога в этом Чате. Формат ЧЧ:ММ:СС ДД.ММ.ГГГГ (UTC).
    4. 4.
      TOTAL ACTIVE DIALOGS — количество активных в периоде диалогов в каждом чате.
    5. 5.
      LAST DIALOG STARTED — дата и время начала последнего Диалога в этом Чате. Формат ЧЧ:ММ:СС ДД.ММ.ГГГГ (UTC)
    6. 6.
      LAST MESSAGE TIME — дата и время последнего сообщения в Чате, т.е. дата и время последнего сообщения в последнем закрытом Диалоге данного Чата. Формат ЧЧ:ММ:СС ДД.ММ.ГГГГ (UTC)
    7. 7.
      LAST MESSAGE AUTHOR — автор последнего сообщения в Чате.
      • agent — автор сообщения — Агент
      • user — автор сообщения — Собеседник
    8. 8.
      LAST MESSAGE — текст последнего сообщение в Чате или текст кнопки, если была нажата кнопка
  2. 2.
    Контекстные переменные чата — начиная с 9 колонки (J)
    1. 2.
      Заголовки колонок со значениями Контекстных переменных имеют формат: CONTEXT_<имя переменной>, например, CONTEXT_channel_chat_id, и упорядочены по алфавиту
    2. 3.
      Одна колонка в файле (переменная) может содержать как пустые, так и непустые значения. Если колонка содержит пустое значение, значит, данная переменная отсутствует в контексте данного Чата или содержит пустое значение.