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

Экспорт сообщений — это архив 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 и улучшать корп. культуру/коммуникацию среди сотрудников. Ещё можно подсчитывать количество активных чатов и смотреть, насколько много в компании ведется обсуждений.