Раздел показывает всех пользователей, которые уже взаимодействовали с Telegram-ботами вашей организации. Здесь можно быстро найти человека, посмотреть дату первого запуска и последней активности, а также отфильтровать аудиторию по боту, активности и признакам профиля. Записи здесь не создаются и не редактируются вручную.
Быстрый старт
- Откройте Операторская работа → Клиенты и выберите карточку Telegram пользователи.
- Найдите пользователя по имени,
username, телефону или названию бота. - При необходимости отфильтруйте список по боту, дате регистрации, активности или признакам профиля.
- Чтобы посмотреть настройки бота, вручную откройте раздел Интеграции и выберите интеграцию из колонки Бот.
Список записей
Таблица работает как журнал Telegram-пользователей по всем ботам вашей организации.
- Пользователь — имя и фамилия из Telegram. Если их нет, показывается
username, а затем технический вариантUser #ID. - Username — ник в Telegram.
- Телефон — номер, если пользователь его передал через контакт.
- Бот — название связанной интеграции.
- Премиум — признак Telegram Premium.
- Тип — показывает, это бот или обычный пользователь.
- Первый запуск — когда запись появилась впервые.
- Последняя активность — время последнего сообщения или callback.
- Язык — скрыт по умолчанию и включается в настройках колонок, если нужно видеть код языка.
Поиск работает по имени, username, телефону и названию бота. Список по умолчанию отсортирован по Последняя активность от новых записей к старым.
В таблице нет действий по строкам и массовых операций. Этот раздел только для просмотра.
Фильтры
- Бот — оставляет пользователей выбранной Telegram-интеграции.
- Дата регистрации — поля С и По ограничивают список по дате первого запуска.
- Активность — показывает пользователей, активных сегодня, за неделю или за месяц. Значение Никогда оставляет записи без даты последней активности.
- Премиум — показывает только пользователей с признаком Telegram Premium.
- Только боты — показывает только Telegram-аккаунты с типом «Бот».
Фильтры применяются совместно. Например, можно выбрать конкретного бота и посмотреть только пользователей, которые впервые запустили его за указанный период.
Как появляются записи
Telegram-пользователь создается автоматически, когда бот получает первое обновление от этого человека. Система сохраняет:
- внутреннюю организацию;
- связанную интеграцию;
- Telegram ID пользователя;
- имя, фамилию и
username, если они доступны; - код языка;
- признаки Тип и Премиум;
- время первого запуска и последней активности.
Если пользователь пишет еще раз, обновляется Последняя активность. Телефон может появиться позже, если в сценарии Telegram запрашивается контакт и человек его отправляет.
Один и тот же Telegram ID в разных ботах хранится отдельными записями, поэтому список удобно читать по колонке Бот.
Связанные данные
Те же Telegram-пользователи доступны на странице конкретной Telegram-интеграции в списке связанных записей. Это полезно, когда нужен не общий журнал, а данные только по одному боту.
Из этого раздела вы не редактируете карточку пользователя. Изменения приходят автоматически из Telegram-обработчиков и сценариев бота.
Доступ к разделу
Отдельного тарифа для этого раздела нет. В меню его не видят операторы и руководители операторов.
Раздел рассчитан на просмотр администраторами и владельцами, которые работают с Telegram-интеграциями и клиентскими обращениями.
Если пользователь не отображается
- Проверьте, что Telegram-интеграция создана и активна.
- Убедитесь, что бот получил хотя бы одно сообщение или команду
/startот этого пользователя. - Если нужен телефон, попросите пользователя отправить контакт, а не просто текст.
- Откройте связанную Telegram-интеграцию и проверьте, появляется ли тот же пользователь там.
- Если пользователь пишет в другом боте, ищите его в соответствующей интеграции, а не в текущей.