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

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

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

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

Колонки:

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

Фильтры

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

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

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

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

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

Экспорт

Сейчас экспорт сообщений делается через REST API:

bash

curl "https://capybara.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 (ISO 8601 или YYYY-MM-DD);
userId — фильтр по конкретному пользователю;
limit — до 1000 за запрос (используйте пагинацию).

Связь с raw_json

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

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

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

Фильтры ​

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

Экспорт ​