Синонимы: настройка вызова команд по фразам и словам

В данной статье мы разберем как настраивать Синонимы и для чего они нужны.

Синонимы: настройка вызова команд по фразам и словам

В ботах пользователи редко пишут команды через слеш (/start, /help, /catalog). Чаще всего они обращаются к боту естественным языком («Привет», «Сколько стоит», «Связь с менеджером»)

Синонимы в puzzlebot — это инструмент, позволяющий запускать команды по ключевым словам, фразам и текстовым шаблонам без ввода символа /.

Где настраиваются синонимы

1. В личном кабинете откройте вкладку Конструктор в вашем проекте..

2. Выберите или создайте нужную команду (например, команду /catalog).

3. На вкладке «Настройки» в подразделе «Синонимы» и нажмите «Изменить».

Например: настроить Синоним с фразой-условием «Прив», «Привет», «Хай» для срабатывания команды /start.

Все фразы внутри одной карточки (например: Прив, Здрав, Хай, hello) работают по правилу «ИЛИ»: пользователю достаточно написать хотя бы одну из них, чтобы условие сработало.

Если нажать кнопку «Добавить условие», между блоками появится союз «И». В этом случае синоним сработает, только если сообщение подойдёт под требования обоих условий одновременно.

Типы условий:

1. Полное совпадение

Сообщение пользователя должно на 100% совпадать с указанной фразой — без единого лишнего слова, пробела или знака препинания.

• Задана фраза: Прайс

• Сработает: Прайс

• Не сработает: Скиньте прайс, Прайс пожалуйста, прайс-лист

2. Сообщение содержит

Указанная фраза или корень слова ищутся в любой части сообщения.

• Задана фраза: Прайс

• Сработает: Где посмотреть прайс?, Прайс, прайс-лист на услуги

• Не сработает: Сколько стоят услуги?

3. Сообщение начинается

Заданная фраза обязательно должна стоять в самом начале сообщения пользователя.

• Задана фраза: Заказ

• Сработает: Заказ №105, Заказ на завтра

• Не сработает: Мой заказ №105, Где заказ?

4. Сообщение заканчивается

Заданная фраза обязательно должна стоять в самом конце сообщения пользователя.

• Задана фраза: Менеджер

• Сработает: Срочно нужен менеджер, Позови менеджер

• Не сработает: Менеджер, ответь, Менеджер не перезвонил

5. Регулярное выражение (RegEx)

Проверяет сообщение по специальному шаблону/маске символов. Используется для валидации структурированных данных.

• Пример шаблона для номера телефона: ^((8|\+7)[\- ]?)?(\(?\d{3}\)?[\- ]?)?[\d\- ]{7,10}$

• Сработает: +79991234567, 8 (999) 123-45-67

• Не сработает: обычный текст без номера.

6. Длина сообщения меньше

Условие выполняется, если количество символов в сообщении меньше указанного числа. Подходит для фильтрации кратких ответов («Да», «Ок»).

7. Длина сообщения больше

Условие выполняется, если количество символов в сообщении больше указанного числа. Позволяет отсекать пустые строки, случайные нажатия или односимвольные сообщения.

Настройки внутри блока условия

• Ввод фраз и удаление тегов:

Введите текст в строку и нажмите кнопку «Добавить». Фраза превратится в цветной тег. Чтобы удалить фразу, нажмите на крестик [✖] внутри тега.

• Чекбокс «Чувствительность к регистру»:

Выключен (по умолчанию): puzzlebot игнорирует регистр букв. Слова Привет, привет и ПРИВЕТ работают абсолютно одинаково.

Включён: бот требует точного соответствия заглавных и строчных букв. Это необходимо для ввода паролей, промокодов или аббревиатур (например, PROMO10 сработает, а promo10 — нет).

• Удаление условия:

Серый крестик [✖] в верхнем правом углу карточки удаляет весь блок условия.

Операторы

Для уточнения условия, по которому будет вызвана команда, можно добавить специальные операторы. Операторы состоят из специального символа, который необходимо поставить вначале фразы.

Виды операторов:

Оператор - (Минус-фраза)

Запрещает срабатывание синонима, если в сообщении встречается указанное слово.

• Пример: добавлено слово Ремонт и минус-фраза -гарантия.

• ✅ Сработает: Нужен ремонт телефона, Сколько стоит ремонт?

• ❌ Не сработает: Ремонт по гарантии (из-за минус-слова бот проигнорирует запрос).

Оператор ! (Точная фраза)

Заставляет конкретное слово проверяться на точное совпадение даже внутри условия «Содержит», защищая от ложных срабатываний по похожим корням.

• Пример: !Кот

• ✅ Сработает: У меня есть кот

• ❌ Не сработает: У меня есть котик или Это коты

Экранирование спецсимволов (--, !!, ---)

Если вам нужно использовать фразы, которые сами по себе начинаются с дефиса или восклицательного знака:

• Чтобы добавить фразу -Привет как обычный текст (не как минус-слово) — укажите --Привет.

• Чтобы сделать минус-фразой слово, которое начинается с дефиса — укажите три дефиса: ---Привет.

• !help — воспримется как оператор точной фразы для слова «help».

• !!help — экранирование: бот будет искать текст, который буквально начинается с !help.

• !!!help — точная фраза, которая сама по себе пишется с восклицательным знаком.

Общие параметры синонима

• Шанс срабатывания (%):
  Вероятность срабатывания команды при совпадении условий (от 1% до 100%). Если установить значение ниже 100%, бот будет отвечать не на каждое сообщение, а случайным образом. Это полезно для пасхалок, игровых ботов или непредсказуемых реакций.

• Кнопка «Сохранить изменения»:
  Применяет настроенные синонимы к выбранной команде.

• Кнопка «Отменить»:
  Закрывает окно настроек без сохранения изменений.