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