Действие «Проверка тегов»
«Проверка тегов» — действие в сценарии действий, которое проверяет, есть ли у текущего подписчика определённые теги (или есть ли они среди ранее удалённых). Возвращает 1 или 0 для ветвления в блоке.
Теги — это метки клиентов: новичок, купил, vip, неактив, подписан-на-канал. Они расставляются вручную, через цепочки, после действий в боте. Проверка тегов — основной способ узнать «кто сейчас перед нами».
Когда использовать
- Ветвление по статусу клиента: VIP / обычный / новичок.
- Условия акций: «скидка только тем, у кого тег
купил». - Проверка завершённости квизов: тег
прошёл-опрос. - Сегментация в рассылках: проверить тег перед отправкой.
- Гейтинг контента: «доступ к статье только с тегом
подписчик».
Часть 1. Как добавить
В сценарии действий → «Добавить действие» → «Проверка тегов».
Скриншот 1. Настройка проверки.
Часть 2. Параметры
| Поле | Значение |
|---|---|
| Теги подписчика | Один или несколько тегов из автодополнения (новые теги можно создавать вводом + Enter) |
| Удалённые | Галочка — искать в тегах, которые были когда-то у клиента, но потом сняты |
| Хотя бы один | Галочка — найти любой из указанных тегов (ИЛИ). Без галочки — должны быть все (И) |
| Имя переменной | Куда сохранить результат: 1 — найдено, 0 — нет |
Скриншот 2. Настройка тегов и опций.
Часть 3. Логика поиска
Все теги (по умолчанию)
Без галочки «хотя бы один» — все теги должны быть одновременно у клиента.
Пример: теги vip + pro → результат 1, только если у клиента оба тега.
Хотя бы один
С галочкой «хотя бы один» — достаточно одного из перечисленных.
Пример: теги vip + pro + legend → 1, если у клиента любой из них.
Удалённые
С галочкой «удалённые» — ищет в истории клиента: были ли когда-то эти теги, даже если сейчас сняты.
Пример: тег купил + удалённые → 1, если клиент когда-либо покупал, даже если сейчас этот тег снят.
Часть 4. Типовые сценарии
Сценарий 1. Ветвление по статусу
Блок «Приветствие»
Сценарий действий «До»:
- Проверка тегов: vip → переменная #{is_vip}
Условие #{is_vip} = 1 → блок «VIP-приветствие со скидкой»
Условие #{is_vip} = 0 → блок «Обычное приветствие»
Сценарий 2. Гейтинг — доступ к контенту
Блок «Премиум статья»
Сценарий действий «До»:
- Проверка тегов: подписка-pro → #{has_pro}
Условие #{has_pro} = 1 → блок «Статья»
Условие #{has_pro} = 0 → блок «Купите подписку»
Сценарий 3. Сегментная рассылка
Цепочка «Рассылка для активных»
Триггер: рассылка по расписанию
Сценарий действий «До»:
- Проверка тегов: активный, заинтересован, новичок (хотя бы один)
→ переменная #{should_send}
Условие #{should_send} = 1 → отправить
Условие #{should_send} = 0 → не отправлять (пропустить)
Сценарий 4. Бывший клиент (удалённые теги)
Блок «Возвращение клиента»
Сценарий действий «До»:
- Проверка тегов: купил + удалённые → #{was_buyer}
Условие #{was_buyer} = 1 → блок «С возвращением! Промокод для бывших клиентов»
Условие #{was_buyer} = 0 → блок «Стандартное предложение»
Сценарий 5. Множественные условия с разной логикой
Блок «Расширенная проверка»
Сценарий действий «До»:
- Операция 1: проверка тегов vip + pro (без хотя бы одного — оба) → #{vip_pro}
- Операция 2: проверка тегов banned, neактив (с хотя бы одним) → #{is_bad}
Условие #{vip_pro} = 1 AND #{is_bad} = 0 → «Премиум-обслуживание»
Иначе → «Стандарт»
Часть 5. Сравнение с условиями в блоках
В Квесче проверять теги можно двумя способами:
| Действие «Проверка тегов» | Условие перехода в блоке | |
|---|---|---|
| Что даёт | Переменная 0/1 | Прямой переход по условию |
| Можно проверить «удалённые» | ✓ | ✗ |
| Можно «хотя бы один» | ✓ | Только через И/ИЛИ |
| Передаётся в следующие действия | ✓ (через переменную) | ✗ |
| Когда выбрать | Сложные условия, ветвление и логика | Простое «если есть тег — туда» |
Простой переход «есть тег vip → блок А» лучше делать в условиях перехода. Сложные с несколькими тегами и «удалёнными» — через «Проверку тегов».
Часть 6. Архитектура тегов
Принцип 1. Система тегов — единая
Не плодите 30 тегов с похожими названиями (active, активный, actively). Соберите команду и составьте словарь: купил, новичок, vip, неактив. Не больше 20-30 на весь бот.
Принцип 2. Жизненный цикл тегов
| Стадия клиента | Тег |
|---|---|
| Только подписался | новичок (автоматом при подписке) |
| Активный диалог | + активный |
| Купил | + купил, снять новичок |
| VIP по сумме | + vip |
| Молчит 30 дней | + неактив |
| Отписался | + отписан, снять активный |
Принцип 3. Теги и цепочки — связь «событие-действие»
Тег ставится → запускается соответствующая цепочка. Тег снимается → клиент выходит из цепочки. Это основа архитектуры.
Принцип 4. Не перегружайте
5-7 ключевых тегов на бот достаточно для большинства задач. Усложняйте только при росте бизнеса.
Принцип 5. Документируйте теги
Создайте список в админке или в глобальной переменной g_tags_dictionary с описанием каждого тега и кто его ставит.
Часть 7. Где ставятся теги
Теги расставляются:
- Автоматически по триггеру — в цепочке при подписке/действии;
- В блоке — есть настройка «Добавить тег» / «Снять тег»;
- Менеджером — вручную через раздел подписчиков;
- Из CRM-события — через действие CRM;
- Из HTTP-вебхука — через действие HTTP.
Частые ошибки
resultvar = 0, хотя тег есть — опечатка в названии тега. Регистр критичен:Vip≠vip.- «Хотя бы один» не работает как ожидаешь — без галочки требуется И (все теги одновременно). Включите галочку для ИЛИ.
- Удалённые теги не находятся — забыли поставить галочку «удалённые».
- Список тегов разросся до 100+ — пора провести ревизию: что объединить, что удалить.
- Теги не ставятся автоматически — проверьте, что в цепочке/блоке настроено добавление тега.
- Конфликт похожих тегов —
активный,актив,active. Сделайте один, разошлите команде.