Автоматическое подключение по токену

Самый быстрый способ начать использовать Metriox — подключитесь автоматически, указав токен вашего Telegram-бота.

Что это дает?

При подключении токена Metriox автоматически:

• Отслеживает всех пользователей, использующих бота
• Собирает получаемые и отправляемые сообщения и прочие события
• Сохраняет историю взаимодействия
• Позволяет начать анализировать данные прямо сейчас без кодовой интеграции

Как подключить?

Шаг 1: Получите токен бота

Если у вас уже есть Telegram-бот, вы знаете токен. Если нет:

1. Напишите @BotFather в Telegram
2. Выполните команду /newbot
3. Следуйте инструкциям
4. Скопируйте токен (выглядит так: 123456789:ABCdefGHIjklmnoPQRstuvWXYz)

Шаг 2: Добавьте бота в Metriox

1. Откройте приложение Metriox
2. Перейдите в Настройки → Боты
3. Нажмите + Добавить бота
4. Перейдите в Настройки бота (значок шестеренки)
5. Укажите интеграцию Telegram, вставьте токен
6. Установите переключатель Включить автоматический сбор во включенное положение

Безопасность

Не публикуйте и не делитесь своим токеном бота с кем-либо. Кто угодно со знанием токена может управлять вашим ботом. Мы храним токен в зашифрованном виде и используем его только с вашего разрешения.

Шаг 3: Начните использовать

Все! Metriox теперь отслеживает события вашего бота. Откройте дашборд и начните анализировать.

Автоматически захватываемые свойства пользователей

При каждом взаимодействии с ботом Metriox сохраняет профиль пользователя из Telegram. Эти свойства доступны на странице Пользователи и могут использоваться в фильтрах.

Свойства профиля ($tg.*)

Свойство	Тип	Описание
$tg.first_name	string	Имя пользователя
$tg.last_name	string	Фамилия (если заполнена)
$tg.username	string	Username в Telegram (если задан)
$tg.lang	string	Языковой код ("ru", "en", и т.д.)
$tg.is_bot	boolean	Является ли аккаунт ботом
$tg.is_premium	boolean	Premium статус (если сообщён Telegram)

Параметр /start

Если пользователь запустил бота через диплинк с параметром (например, t.me/YourBot?start=ref_abc), Metriox сохраняет:

Свойство	Тип	Описание
$tg.start_raw	string	Параметр /start в исходном виде
$tg.start.<ключ>	string	Разобранные пары ключ=значение из параметра

Пример: диплинк t.me/YourBot?start=ref_123%26utm_campaign%3Dpromo создаёт:

$tg.start_raw           = "ref_123&utm_campaign=promo"
$tg.start.ref           = "123"
$tg.start.utm_campaign  = "promo"

Обновление профиля

Профиль пользователя обновляется при каждом взаимодействии. В ClickHouse хранится последний снимок — более новые данные перезаписывают старые.

Выбор захватываемых событий

Не каждому боту нужно всё. В настройках интеграции Telegram можно указать, какие категории обновлений записывать — простому боту достаточно сообщений и нажатий кнопок, а боту с каналами и супергруппами пригодятся посты и участники:

Категория	Что записывает	По умолчанию
Сообщения	сообщения и их изменения	включено
Нажатия кнопок	callback от inline-кнопок	включено
Inline-запросы	inline-режим бота	включено
Реакции	реакции на сообщения	включено
Опросы	опросы и голоса	включено
Платежи	этапы оплаты	включено
Business-сообщения	Telegram Business	включено
Посты каналов и супергрупп	публикации и их изменения	выключено
Удаления	удалённые сообщения	выключено
Входы, выходы, блокировки	участники чатов, заявки, блокировка бота	выключено

Изменения применяются без перезапуска — они подхватываются при следующем обновлении конфигурации.

Три последние категории выключены намеренно: в активном канале или большой супергруппе это поток событий, который редко нужен целиком, и включать его стоит осознанно.

Личные переписки приходят не отсюда

Подключение по токену получает обновления по протоколу MTProto. Он даёт каналы, супергруппы и реакции, но не передаёт личные переписки (DM) бота — их приносит только SDK поверх Bot API. Поэтому включённая категория «Сообщения» сама по себе не покажет диалоги один-на-один: для полной картины подключите SDK.

Дополнительные события

Кроме автоматических событий, вы можете отправлять свои события через API или SDK.

Что дальше?

После подключения токена:

1. Проверьте данные — откройте дашборд и смотрите события в реальном времени
2. Создайте виджеты — анализируйте данные с помощью дашборда
3. Добавьте кастомные события — используйте SDK или API для отправки собственных событий

---

Обратная связь? Если у вас есть вопросы, свяжитесь с поддержкой.