Что такое MaxBotStat

MaxBotStat — это аналитика и автоматизация для Telegram- и Max-ботов. Платформа работает в режиме прозрачного зеркала API: вы оставляете весь код бота как есть и меняете в нём только один параметр — базовый адрес API. Запросы вашего бота идут не сразу в Telegram, а через наш домен, который пересылает их дальше и попутно сохраняет аналитику.

api.telegram.org      →  api-tg.app.maxbotstat.ru
platform-api.max.ru   →  api-max.app.maxbotstat.ru

В отличие от закрытых конструкторов, MaxBotStat ничего не переписывает в логике вашего бота. Он по-прежнему сам обрабатывает входящие сообщения — на Node.js, Python, Go, PHP, через getUpdates или вызов на ваш сервер. Мы только посередине между ботом и Telegram.

Что вы получаете

• хранилище контактов с метаданными Telegram/Max и изображениями профиля;
• историю сообщений и диалогов в реальном времени;
• разметку трафика по UTM (параметр utm_source в команде /start);
• воронки и автоматическую категоризацию сообщений (намерения);
• массовые рассылки с медиа и сегментацией;
• открытый API для интеграции с CRM и BI;
• подписки на события message.created, message.outbound, contact.created.

Кому подойдёт

Сценарий	Что даёт MaxBotStat
Маркетинговый бот в Telegram	разметка UTM, воронки, рассылки, выгрузка контактов
Бот поддержки на Python	история диалогов, метки намерений, ответы из веб-кабинета
Несколько ботов компании	единое хранилище контактов и аналитика по каждому из них
Интеграция с CRM или BI	открытый API + подписки на события
Замена закрытому облачному сервису	собственное хранилище данных, выгрузка, прозрачное зеркало

Быстрый старт за две минуты

1. Регистрация

Откройте app.maxbotstat.ru, создайте аккаунт и подтвердите почту шестизначным кодом из письма.

2. Привязка бота

В кабинете нажмите Добавить бота, выберите платформу (Telegram или Max) и введите токен:

• Telegram-токен берётся в @BotFather после команды /newbot.
• Max-токен — в кабинете Max Business.

3. Замена адреса API в коде бота

В коде своего бота замените базовый адрес API на наш домен:

- https://api.telegram.org
+ https://api-tg.app.maxbotstat.ru

Большинство популярных библиотек поддерживают этот параметр напрямую. Например, для Telegraf:

import { Telegraf } from 'telegraf'

const bot = new Telegraf(process.env.BOT_TOKEN, {
  telegram: { apiRoot: 'https://api-tg.app.maxbotstat.ru' },
})

bot.start((ctx) => ctx.reply('Привет!'))
bot.launch()

Полные примеры для aiogram, python-telegram-bot, grammy, pyTelegramBotAPI, go-telegram-bot-api и другие — в разделе Замена адреса API в коде бота.

Что дальше

• Регистрация и вход — что подтверждает почта, как восстанавливается доступ.
• Привязка бота — где взять токен Telegram, как привязать Max-бота.
• Замена адреса API в коде бота — примеры на популярных библиотеках.
• Открытый API — для интеграции с CRM и BI.

Поддержка

Вопросы — в раздел «Поддержка» в кабинете или на адрес команды. Сообщения видны и нам, и вам в одной ленте.