Автоматическое подключение по токену
Самый быстрый способ начать использовать Metriox — подключитесь автоматически, указав токен вашего Telegram-бота.
Что это дает?
При подключении токена Metriox автоматически:
- Отслеживает всех пользователей, использующих бота
- Собирает получаемые и отправляемые сообщения и прочие события
- Сохраняет историю взаимодействия
- Позволяет начать анализировать данные прямо сейчас без кодовой интеграции
Как подключить?
Шаг 1: Получите токен бота
Если у вас уже есть Telegram-бот, вы знаете токен. Если нет:
- Напишите @BotFather в Telegram
- Выполните команду
/newbot - Следуйте инструкциям
- Скопируйте токен (выглядит так:
123456789:ABCdefGHIjklmnoPQRstuvWXYz)
Шаг 2: Добавьте бота в Metriox
- Откройте приложение Metriox
- Перейдите в Настройки → Боты
- Нажмите + Добавить бота
- Перейдите в Настройки бота (значок шестеренки)
- Укажите интеграцию Telegram, вставьте токен
- Установите переключатель Включить автоматический сбор во включенное положение
Не публикуйте и не делитесь своим токеном бота с кем-либо. Кто угодно со знанием токена может управлять вашим ботом. Мы храним токен в зашифрованном виде и используем его только с вашего разрешения.
Шаг 3: Начните использовать
Все! Metriox теперь отслеживает события вашего бота. Откройте дашборд и начните анализировать.
Автоматически захватываемые свойства пользователей
При каждом взаимодействии с ботом Metriox сохраняет профиль пользователя из Telegram. Эти свойства доступны на странице Пользователи и могут использоваться в фильтрах.
Свойства профиля ($tg.*)
| Свойство | Тип | Описание |
|---|---|---|
$tg.telegram_user_id | number | Идентификатор пользователя в Telegram |
$tg.first_name | string | Имя пользователя |
$tg.last_name | string | Фамилия (если заполнена) |
$tg.username | string | Username в Telegram (если задан) |
$tg.language_code | string | Языковой код ("ru", "en" и т.д.) |
$tg.is_premium | boolean | Premium-статус |
Параметр /start
Если пользователь запустил бота через диплинк (например, t.me/YourBot?start=ref_abc), Metriox сохраняет параметр целиком в $tg.start_raw. Telegram пропускает в него только латинские буквы, цифры, _ и -, не длиннее 64 символов, поэтому пар ключ=значение в нём не бывает. Как работать с диплинками, описано на странице Пользователи. Если параметр записан метками вида source-tgads_campaign-june, метки дополнительно сохраняются в $tg.start_source, $tg.start_campaign и соседние поля.
Профиль обновляется, когда Telegram сообщает о пользователе что-то новое. Каждое свойство берётся из записи, где оно есть, поэтому более поздняя неполная запись не стирает уже известные данные.
Выбор захватываемых событий
Не каждому боту нужно всё. В настройках интеграции Telegram можно указать, какие категории обновлений записывать — простому боту достаточно сообщений и нажатий кнопок, а боту с каналами и супергруппами пригодятся посты и участники:
| Категория | Что записывает | По умолчанию |
|---|---|---|
| Сообщения | сообщения и их изменения | включено |
| Нажатия кнопок | callback от inline-кнопок | включено |
| Inline-запросы | inline-режим бота | включено |
| Реакции | реакции на сообщения | включено |
| Опросы | опросы и голоса | включено |
| Платежи | этапы оплаты | включено |
| Business-сообщения | Telegram Business | включено |
| Посты каналов и супергрупп | публикации и их изменения | выключено |
| Удаления | удалённые сообщения | выключено |
| Входы, выходы, блокировки | участники чатов, заявки, блокировка бота | выключено |
Изменения применяются без перезапуска — они подхватываются при следующем обновлении конфигурации.
Три последние категории выключены намеренно: в активном канале или большой супергруппе это поток событий, который редко нужен целиком, и включать его стоит осознанно.
Подключение по токену получает обновления по протоколу MTProto. Он даёт каналы, супергруппы и реакции, но не передаёт личные переписки (DM) бота — их приносит только SDK поверх Bot API. Поэтому включённая категория «Сообщения» сама по себе не покажет диалоги один-на-один: для полной картины подключите SDK.
Дополнительные события
Кроме автоматических событий, вы можете отправлять свои события через API или SDK.
Что дальше?
После подключения токена:
- Проверьте данные — откройте дашборд и смотрите события в реальном времени
- Создайте виджеты — анализируйте данные с помощью дашборда
- Добавьте кастомные события — используйте SDK или API для отправки собственных событий
Обратная связь? Если у вас есть вопросы, свяжитесь с поддержкой.