Тема
Are you an LLM? You can read better optimized documentation at /guide\getting-started.md for this page in Markdown format
Что такое MaxBotStat
MaxBotStat — это аналитика и автоматизация для Telegram- и Max-ботов. Платформа работает в режиме прозрачного прокси: ваш бот отдаёт webhook не сразу на свой backend, а на наш URL. Мы фиксируем апдейт (контакт, текст, медиа, источник) и пробрасываем его дальше — на ваш собственный сервер.
Telegram / Max → MaxBotStat → ваш бот
↑ ↓
└────── ответ ──────────┘В отличие от закрытых конструкторов, MaxBotStat ничего не переписывает в логике вашего бота. Вы продолжаете обрабатывать апдейты на своей стороне — Node.js, Python, Go, PHP, серверлес — а мы предоставляем:
- хранилище контактов с метаданными Telegram/Max и аватарками;
- историю сообщений и диалогов в реальном времени;
- разметку трафика по UTM (
utm_sourceв/start-параметре); - воронки и автокатегоризацию сообщений (intents);
- массовые рассылки с медиа и сегментацией;
- REST API v1 для интеграции с CRM/BI;
- исходящие webhook-подписки на события
message.created,message.outbound,contact.created.
Кому подойдёт
| Сценарий | Что даёт MaxBotStat |
|---|---|
| Маркетинговый бот в Telegram | UTM-разметка, воронки, рассылки, экспорт контактов |
| Бот поддержки на Python | История диалогов, теги intents, ответы из веб-кабинета |
| Несколько ботов компании | Единое хранилище контактов и аналитика по каждому из них |
| Интеграция с CRM или BI | REST API v1 + webhook-подписки на события |
| Замена закрытому SaaS | Самостоятельное хранилище данных, экспорт, белый прокси |
Быстрый старт за 2 минуты
- Откройте capybara.maxbotstat.ru, нажмите Регистрация, введите email и пароль (минимум 6 символов).
- Подтвердите email шестизначным кодом из письма.
- На главной нажмите Добавить бота → выберите провайдера (Telegram/Max) → введите токен бота.
- Скопируйте проксированный webhook-URL вида:
https://capybara.maxbotstat.ru/proxy/<botId>/<secret> - Установите этот URL как webhook бота. Для Telegram:bash
curl -X POST "https://api.telegram.org/bot<TOKEN>/setWebhook" \ -d "url=https://capybara.maxbotstat.ru/proxy/<botId>/<secret>" - Откройте раздел Контакты — первое сообщение от пользователя появится в реальном времени.
Что дальше
- Регистрация и вход — что подтверждает email, как восстанавливается доступ.
- Добавление бота — где взять токен Telegram, как подключить Max-бота.
- Как работает прокси — детали внутренней работы.
- REST API v1 — для интеграций.
Поддержка
Вопросы — в раздел «Поддержка» в кабинете или на email команды. Сообщения видны и админу, и вам.