Автоматически

Самый быстрый способ начать использовать 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 хранится последний снимок — более новые данные перезаписывают старые.

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

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

Что дальше?

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

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

---

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