Перейти к содержимому
ChatterfyСправочный центр
ГлавнаяGeneralCRMAI ManagerTrackerПлатформыFAQUpdate log
Главное
Bot Settings
Automation & AI
CRM defaults
Flow Settings
AI Settings
Steps
Communication
Changes
Terms
Tracking
Additional
Messenger
Client card
Chat data
Chat data
Manual
Custom Data
User Information
Tracker Data
Show Events
Actions
Events
Users
Mailings
Analytics
  1. CRM
  2. Chat data
  3. User Information — базовые данные лида

User Information — базовые данные лида

User Information: read-only данные из Telegram (ID, username, имя) для поддержки, поиска и интеграций.

Обновлено 30 августа 2026 г.4 мин
БлокUser Informationв Chat data — read-only данные лида, которые приходят от Telegram. Поменять их нельзя (Telegram управляет ими сам), но они нужны для интеграций, поддержки и поиска. Это «ID-карточка» лида в системе.
Когда сюда заходить
Нужен Chat ID для исходящего webhook — копируем отсюда. Лид написал в support («ничего не работает»), нужно найти его у себя — скопировал Telegram ID и нашёл по фильтру в Users. Отлаживаем flow, нужно знать на каком шаге лид — Step ID. Хочется проверить как давно лид с нами — дата начала диалога.
User Information блок
User Information в Chat data




Что отображается

Поле
Что показывает
Когда нужно
Username
@-имя в Telegram (или пусто, если лид не указал)
Найти лида в Telegram, упомянуть в support
Telegram ID
Уникальный ID юзера в Telegram
Уникальная привязка лида, поиск через фильтр
Chat ID
Уникальный ID диалога
Webhook, ручная отправка через API, support
Step ID
ID текущего шага flow
Отладка flow, ручная маршрутизация
Дата начала диалога
Когда лид впервые написал боту
Понять «свежесть» лида, фильтр по Created At



Username vs Telegram ID vs Chat ID — разница

Часто эти три понятия путают. Вот что есть что:
Username—публичное @-имяпользователя в Telegram. Может меняться (юзер сменил handle), может отсутствовать (юзер не назначил username).
Telegram ID—уникальный пожизненныйID юзера. Не меняется. Если username пуст или меняется — Telegram ID остаётся.
Chat ID—уникальный ID диалогамежду этим юзером и вашим ботом. У одного юзера будет разный Chat ID для разных ваших ботов. Используется в API.
Какой ID использовать
Для поиска юзера среди ваших данных — Telegram ID (стабильный). Для отправки сообщения через Telegram Bot API или webhook — Chat ID. Username — для упоминания в обычном тексте, но НЕ для технической идентификации (может смениться).




Step ID

Step ID — внутренний идентификатор текущего шага в flow. Обычно нужен только для отладки или интеграций. В Manual вы видите имя шага человеческим языком. здесь — техническое имя (UUID или slug).



Дата начала диалога

Когда впервые состоялсяContact— лид прислал боту первое сообщение. Используется в фильтрах Фильтрация пользователей — 11 параметров(параметрCreated At), для сегментации «новые лиды за 7 дней».
Не путать с Subscribe
Дата начала диалога — это первый Contact (юзер написал боту). Subscribe — это первое подписание на канал/запуск бота — может быть раньше, и в Tracker считается отдельно.



Примеры использования

Сценарий 1 — webhook интеграция:
Хочется отправлять Chatterfy chat в внешнюю CRM при определённом событии.
Webhook step → передаём Chat ID + кастомные данные.
Внешняя CRM ищет / создаёт запись по Chat ID — ChatID становится первичным ключом.
Сценарий 2 — поддержка ищет конкретного лида:
Лид написал в support «У меня не работает».
Поддержка просит «Скиньте свой Telegram username, либо ID».
Лид: «@vasya123».
Оператор открывает Users→ Search → @vasya123 → находит чат → видит User Information.
Сценарий 3 — отладка flow с support:
AI не отвечает у конкретного лида.
Оператор копирует Step ID + Chat ID и шлёт в support-чат с описанием проблемы.
Support использует ID для воспроизведения и диагностики.



Что важно учесть

Username может смениться
Telegram-юзер может в любой момент сменить или удалить @username. После этого старый username не работает — поиск по нему не найдёт лида. Если нужна стабильная идентификация — храните и ищите по Telegram ID, не по username.



Частые вопросы

Поле Telegram ID и есть Telegram User ID. Это уникальный пожизненный идентификатор юзера. Если поле пустое — необычно (баг или специфика подключения), напишите в support.

Telegram ID — на юзера (один на Telegram-аккаунт). Chat ID — на диалог конкретного юзера с конкретным ботом (разный для разных ваших ботов). Для API отправки сообщений через Bot API нужен Chat ID, не Telegram ID.

Нет. Telegram ID стабилен и не меняется никогда. Username — может меняться. Если хотите всегда находить лида — ищите по Telegram ID или Chat ID.

Аватар отображается в карточке клиента сверху и в списке чатов в Messenger. В User Information он не дублируется как отдельное поле. Если нужен URL аватара для интеграции — пока такого endpoint нет, обращайтесь в support.

Автоматически при следующем сообщении лида. Telegram передаёт текущий username с каждым сообщением, бот обновляет его. Принудительно обновить из UI — нельзя.

В шаге Webhook — отправка данных наружу добавьте подстановку {chatId} в URL или body. Webhook отправит запрос с актуальным Chat ID лида, на котором сработал шаг.



Связанное

Chat data — основная вкладка карточки
Chat data — главная вкладка карточки клиента: переписка, данные лида, события, Custom Data и Tracker Data.
Webhooks & API — приём данных извне
Webhooks & API — приём данных извне: как Chatterfy принимает события от партнёрок и внешних систем.
Webhook — отправка данных наружу
Шаг Webhook — отправляет HTTP-запрос на внешний URL с данными лида. Это исходящий webhook, в отличие от , где описывается приём данных от внешних систем. Используется для интеграций с внешним миром: п
Фильтрация пользователей — 11 параметров
Фильтры в Users — отбор лидов по 11 параметрам: тегу, статусу, шагу, дате, депозиту и кастомным полям.

Эта статья была полезна?

НазадCustom Data — ручное заполнение кастомных полейДалееTracker Data — данные источника трафика

На этой странице

  • Что отображается
  • Username vs Telegram ID vs Chat ID — разница
  • Step ID
  • Дата начала диалога
  • Примеры использования
  • Что важно учесть
  • Частые вопросы
  • Связанное