Люди (CRM)
Где найти клиента, посмотреть переписку, добавить метку и сохранить телефон или другие сведения. Карточки, фильтры и выгрузка.
На этой странице
В разделе Люди собраны клиенты, которые написали боту. Откройте карточку, чтобы увидеть переписку, файлы и сохранённые сведения: например, телефон, интересующий курс или статус оплаты. Карточки создаются и обновляются автоматически по событиям.
Такую базу клиентов называют CRM. Метки помогают быстро выделить группу, например «Оплатил», а параметры хранят конкретные значения, например phone или order_id.
Список пользователей
Таблица показывает имя, Telegram-ID, метки и активность (когда человек заходил последний раз или заблокировал бота). Можно искать по имени или ID и выбирать кнопки фильтра Все, VIP, Оплатил, Новый, Отписка. Рядом с каждой кнопкой показано число людей. Нажмите строку, чтобы открыть диалог.
Кнопка Заблокировали показывает только тех, кто заблокировал бота; дата блокировки видна в карточке. Выгрузить CSV скачивает найденный список с учётом поиска и фильтров, не более 10 000 строк. CSV можно открыть в электронной таблице. Технический состав файла: колонки tg_user_id, name, username, platform, is_blocked, blocked_at, first_seen, last_seen, labels; метки разделены ;, даты записаны в формате RFC3339. Текстовые ячейки защищены от выполнения как формулы в табличном редакторе. Если достигнут лимит строк, API возвращает заголовок X-Export-Truncated: true. Через API: GET /api/bots/{botID}/users?is_blocked=true&format=csv. Параметр is_blocked=true|false работает и для обычного JSON-списка; у заблокировавших в ответе есть поле blocked_at.
Что хранится о пользователе
Карточка пользователя содержит: аватар, имя, @username, ссылку «Открыть в Telegram», счётчики (сообщений, первый и последний диалог), метки и глобальные параметры. Также отмечается, если пользователь заблокировал бота или ожидает ответа оператора.
Источник подписчика показывает, по какой ссылке человек впервые пришёл к боту. Например, отдельная ссылка для весенней рекламы позволяет отличить её посетителей от остальных. Значения, указывающие рекламный источник, называются UTM-метками. В Telegram дополнительная часть ссылки после start= называется payload, или меткой запуска.
Примеры форматов:
- Telegram:
t.me/<bot>?start=utm_source-vk__utm_medium-cpc__utm_campaign-spring. Telegram допускает в payload только буквы, цифры,_и-: пары разделяются__, ключ и значение первым-. - VK:
vk.me/<group>?ref=utm_source=vk&utm_medium=post. - Реферальная ссылка:
t.me/<bot>?start=ref_<его ID>. В карточке и подстановке{{referrals.count}}видно, сколько людей пригласил подписчик. Формыref=<ID>иref_<ID>разбираются отдельно от UTM.
Сохраняются пять полей: utm_source, utm_medium, utm_campaign, utm_content, utm_term. Для каждого берётся первое непустое значение. Они доступны в подстановках и сегментах как attribution.utm_source … utm_term.
Источник фиксируется по первой ссылке запуска с непустой меткой. Этот принцип называется first-touch, или «первое касание». Повторный /start не меняет источник и не добавляет UTM из новой ссылки. Если первая метка была произвольной или реферальной, UTM останутся пустыми. Ссылка без метки не фиксирует источник.
В сегментах UTM из ссылки важнее одноимённых меток посещения сайта. Отсутствующие в ссылке поля берутся из веб-данных. Ссылка совсем без UTM их не стирает. Источник относится к каналу первого старта и попадает в сегмент после пересчёта только для подписчика с тем же идентификатором в этом канале.
Метки
Метка помогает выделить группу подписчиков: например, «VIP», «Оплатил», «Новый» или «Отписка». Можно создавать свои метки и выбирать для них цвет. Добавьте метку вручную или действием «Изменить метки». Затем используйте её в условиях («С метками») и для выбора аудитории рассылки.
Метка может действовать постоянно или ограниченное число дней. Когда срок заканчивается, она снимается автоматически, а бот получает событие «Метка истекла». Для работы через API используйте POST /api/bots/{botID}/users/{tgUserID}/labels с каноническим UUID label_id и необязательным ttl_days от 0 до 106751. Значение ttl_days: 0 означает постоянную метку; срок временной метки возвращается в поле label_expires_at списка людей.
Параметры
Параметры хранят произвольные значения, привязанные к пользователю (имя, email, сумма, статус заказа, баллы). Их наполняют действия «Изменить параметры», «Сохранить сообщение» и шаги диалога. Затем значения используют подстановки ({{param.ключ}}) и условия («С параметрами»). Так бот ведёт мини-профиль каждого клиента без внешней базы.
Диалоги
В диалоге видны сообщения, фотографии, видео, голосовые, документы, кнопки и отметки доставки. Отправленные реакции показаны отдельными карточками. Внизу можно написать ответ, прикрепить файл или отправить реакцию, выбрав её из списка.
Вложения
Кнопка Вложения открывает галерею всех файлов диалога с фильтрами Фото, Файлы, Голосовые, Ссылки и кнопкой Скачать всё.
История диалога и импорт
В диалоге хранится вся переписка с пользователем. Старые сообщения подгружаются при прокрутке вверх, поэтому длинная история открывается без ожидания полной загрузки. Новые сообщения появляются в открытом диалоге сразу, как и в очереди операторов.
Если вы переносите бота из sambot, история диалогов импортируется вместе с пользователями: после импорта в карточке сразу видна прошлая переписка и вложения. См. Импорт из sambot.
Карточка клиента и массовые действия
Карточка объединяет профиль, историю событий (timeline), сегменты, диалог и заметки оператора. История подгружается порциями; её можно отфильтровать по типу, источнику и периоду. После изменения свойств и меток нажмите сохранение: правки попадут в журнал действий и запустят обновление сегментов.
В списке можно выбрать клиентов и применить свойство массово. Операция использует сохранённый снимок выбранной аудитории, ограничена 5 000 людьми и безопасна при повторной отправке. CSV-выгрузка создаёт отдельную сохранённую операцию; её можно отменить до скачивания. Уже применённое массовое изменение не откатывается частично.
Объединение профилей
Владелец проекта может отметить в списке двух людей на одной странице и нажать «Объединить профили». Проверьте контакты и каналы, выберите основной профиль и подтвердите действие. История и данные объединятся; при конфликте параметров приоритет у основного профиля. Объединение нельзя отменить.
При незавершённой синхронизации CRM или операции Озмы повторите объединение после её завершения или проверки. Противоречащие контактные данные и разные связи с записями CRM необходимо сначала согласовать.
Совпадение email само по себе не объединяет профили GetMyBot. Для автоматической связи с авторизованным пользователем сайта используется подписанный identify; подтверждённая привязка Telegram доступна только после её включения в регионе; одного подключения канала недостаточно.
Что дальше
- Чаты и операторы: очередь операторов и передача диалога.
- Условия и чаты: фильтры по меткам и параметрам.
- Рассылки: сегментированные рассылки по подписчикам.
- Импорт из sambot: перенос истории диалогов.
Динамические сегменты
В разделе Сегменты задайте аудиторию условиями с объединением И или ИЛИ. Проверьте определение в предпросмотре перед сохранением. После изменений пересчитайте участников и проверьте готовность сегмента перед выбором в рассылке: сохранение определения само по себе не подтверждает актуальность числа участников.