Экспорт сообщений из Пачки

Экспорт сообщений — это архив c файлами в формате JSON, где собраны все сообщения из всех чатов, которые были созданы в вашем пространстве. Доступен только на тарифе «Корпорация».

Его можно сделать в настройках пространства, но эта функция доступна исключительно Владельцу компании в Пачке.

В экспорте вам будут доступны все сообщения из открытых, закрытых и архивных чатов, в том числе треды. У каждого сообщения будет указан автор, время отправки, текст, список реакций на это сообщение.

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

Настройки и ограничения

При запросе экспорта можно настроить период, за который вы хотите получить данные, но не более 45 дней. И можете добавить ID-чатов, из которых вы хотите получить экспорт. Если вам нужны данные за период дольше 45 дней, то по завершении одной выгрузки, можно запросить следующую с новым диапазоном дат.

При запросе экспорта важно учитывать следующие ограничения:

• выгружаются все чаты, в том числе архивные и личные без контента сообщений
• не выгружаются треды в личных сообщениях
• не учитываются вложения
• не отражаются пересланные сообщения
• максимальный период одной выгрузки: 45 дней

Экспорт выполняется ассинхронно, то есть после запроса вы можете продолжать работу в Пачке, а по готовности на почту владельца компании придет письмо с ссылкой на скачивание архива.

Формат экспорта сообщений‍

Файл разделен на папки, где каждая папка соответствует чату в вашем пространстве. Название папки состоит из имени чата и его ID, например: Design_12925828. Внутри папки будут json-файлы, которые соответствуют дате переписки. Каждый день — отдельный файл.

Структура данных в json-файлах.

id                integer          Идентификатор сообщения

created_at        string           Дата и время создания сообщения (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ

content           string           Текст сообщения

reactions         array of objects Массив списка реакций
 user_id          integer          Идентификатор пользователя, который добавил реакцию
 created_at       string           Дата и время добавления реакции (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
 code             string           Emoji символ реакции

user              object           Информация о авторе сообщения
 id               integer          Идентификатор пользователя
 role             string           Тип: member (пользователь), bot (бот)
 name             string           Имя
 last_name        string           Фамилия
 email            string           Электронная почта
 tags             array of strings Массив тегов, привязанных к автору

chat              object           Информация о чате, в котором было написано сообщение
 id               integer          Идентификатор чата, в котором находится сообщение
 name             string           Название чата
 owner            object           Информация о создателе чата
  id              integer          Идентификатор пользователя
  role            string           Тип: member (пользователь), bot (бот)
  name            string           Имя
  last_name       string           Фамилия
  email           string           Электронная почта
  tags            array of strings Массив тегов, привязанных к сотруднику
 tags             array of strings Массив тегов, привязанных к чату

thread            object или null Тред сообщения. Возвращается как null, если у сообщения нет комментариев.
 message_id       integer          Идентификатор сообщения под, которым был начат тред
 message_chat_id  integer          Идентификатор чата, в котром был начат тред

На основе выгрузки можно замерять количество сообщений и реакций в общих чатах. Так можно рассчитать Engagment Rate и улучшать корп. культуру/коммуникацию среди сотрудников. Ещё можно подсчитывать количество активных чатов и смотреть, насколько много в компании ведется обсуждений.