Сообщения и активность

Лента сообщений

Раздел Сообщения показывает все обновления, прошедшие через наш домен:

direction: in — пользователь → бот;
direction: out — бот → пользователь (отправка из кабинета, рассылка или вызов открытого API).

Колонки:

Колонка	Что показывает
Время	`created_at` (UTC)
Контакт	`username` или имя и фамилия, кликабельно — открывает диалог
Текст	первые 200 символов сообщения
Источник	значение UTM контакта
Бот	если ботов несколько и фильтр выключен

Фильтры

Период: за сегодня, 7 / 30 / 90 дней или произвольный диапазон.
Бот: один бот или все.
Направление: входящие / исходящие / оба.
Пользователь: по external_user_id или username.

График активности

Вкладка Активность показывает графики:

сообщения по дням (входящие и исходящие);
новые контакты;
активные пользователи (минимум одно сообщение за период).

Источник данных — метод GET /api/v1/bots/<botId>/stats/timeline. См. API → Статистика.

Выгрузка

Сейчас выгрузка сообщений делается через открытый API:

bash

curl "https://app.maxbotstat.ru/api/v1/bots/<botId>/messages?from=2025-01-01&to=2025-12-31&limit=1000" \
     -H "X-API-Key: mbs_..." \
     -o messages.json

Параметры:

from, to — границы по created_at (формат YYYY-MM-DD или ISO 8601);
userId — фильтр по конкретному пользователю;
limit — до 1000 за один запрос (используйте постраничную выборку).

Связь с исходным обновлением

Каждое сообщение в базе хранит исходное обновление Telegram/Max в поле raw_json. Через открытый API оно не возвращается (для экономии трафика), но видно в режиме отладки и используется при ручном разборе случаев.

Сообщения и активность ​

Лента сообщений ​

Фильтры ​

График активности ​

Выгрузка ​