База знаний GetMyBot

Люди (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 доступна только после её включения в регионе; одного подключения канала недостаточно.

Что дальше

Динамические сегменты

В разделе Сегменты задайте аудиторию условиями с объединением И или ИЛИ. Проверьте определение в предпросмотре перед сохранением. После изменений пересчитайте участников и проверьте готовность сегмента перед выбором в рассылке: сохранение определения само по себе не подтверждает актуальность числа участников.