Глоссарий

Секретный код (токен) от Telegram-бота, выдаваемый "@BotFather". Позволяет настроить связь с ботом вне клиента Telegram — например, подключить его к сервису PuzzleBot через это поле в личном кабинете.

Не путать: API ключ бота (из BotFather) и API токен для входящих запросов PuzzleBot (генерируется отдельно в "Настройки → Интеграции → Входящие запросы").

Предварительный черновик (требует проверки): Системный Telegram-бот "@BotFather", через который в Telegram создаются и настраиваются все пользовательские боты. В PuzzleBot через него получают API ключ, меняют имя/описание/картинку/юзернейм бота, передают права собственности и управляют Инлайн-мод. Владелец бота в Telegram — это тот, кто создал его в @BotFather.

Сервис-конструктор для создания Telegram-ботов без программирования. Позволяет собирать команды, настраивать магазин, интеграции, рассылки, формы ввода и многое другое через визуальный интерфейс личного кабинета.

Повторяющееся автоматическое списание с карты клиента. В PuzzleBot настраивается на странице "Настройки бота → Рекуррентные платежи" и доступно только для ряда платёжных систем (Альфа-Банк, Kaspi, Prodamus, Robokassa, Т-Банк, ЮKassa).

Сущность раздела Магазин — скидка или промокод. Скидка активируется автоматически при выполнении условий, промокод — при вводе фразы-кода.

Группа пользователей бота, объединённая для массовой рассылки постов. Отличается от Категории тем, что формируется динамически под рассылку (по фильтрам), а не через ручное назначение. Используется во вкладке Постинг для целевых рассылок.

Предварительный черновик (требует проверки): Обязательный блок Формы ввода, содержащий текст вопроса или запроса, который отправляется пользователю перед ожиданием его ответа. Без заполненного Блока Вопрос систему не даст опубликовать форму.

⚠ Определение нужно дописать. Выше — мой предварительный вариант на основе цитат из статей, сверь и подправь. Ниже — сами цитаты для удобства.

Найдено в статьях:

[Форма ввода] «Блок Форма ввода состоит из двух обязательных блоков: Вопрос — обязательный блок. Настройки — обязательный блок, содержит настройки ответа…»

[Форма ввода] «При активации функции Заменить вопрос, тогда блок Вопрос будет заменен на блок реакции или удалён, если за…»

[Не работает Форма ввода или частые ошибки] «Снимите флажок с опции Удалить блок Вопрос после ответа в Дополнительных настройках…»

Предварительный черновик (требует проверки): Необязательный блок Формы ввода, который автоматически отправляется, когда у пользователя истёк таймаут на ответ. Активируется только если в настройках формы включён Таймаут (минимум 5 секунд).

⚠ Определение нужно дописать. Выше — мой предварительный вариант на основе цитат из статей, сверь и подправь. Ниже — сами цитаты для удобства.

Найдено в статьях:

[Форма ввода] «По таймауту будет отправлен специальный блок Время вышло. Рассмотрим особенности каждого типа ввода…»

[Не работает Форма ввода или частые ошибки] «При активации Таймаута (минимум 5 сек) заполните связующий блок Время вышло (реакция на окончание времени)…»

Предварительный черновик (требует проверки): Блок, определяющий клавиатуру команды — набор кнопок, который пользователь видит под сообщением. Может быть типа Обычная, Инлайн или Фиксированная (последняя — только в контексте Мини-приложений).

⚠ Определение нужно дописать. Выше — мой предварительный вариант на основе цитат из статей, сверь и подправь. Ниже — сами цитаты для удобства.

Найдено в статьях:

[Мини-приложения] «В Мини-приложении автоматически добавляется блок Клавиатуры с типом Фиксированная…»

[Мини-приложения] «Если в Мини-приложении уже есть блок Клавиатуры с типом Фиксированная, то он будет заменён…»

Предварительный черновик (требует проверки): Обязательный блок Формы ввода, содержащий параметры обработки ответа: название для статистики, куда отправлять уведомление, опцию «Повторное прохождение», настройки реакции на пропуск и другие.

⚠ Определение нужно дописать. Выше — мой предварительный вариант на основе цитат из статей, сверь и подправь. Ниже — сами цитаты для удобства.

Найдено в статьях:

[Форма ввода] «Из двух обязательных блоков: Вопрос — обязательный блок. Настройки — обязательный блок, содержит настройки ответа…»

[Форма ввода] «Кнопка добавления реакции находится под блоком Настройки. Реакция на пропуск — отправляет сообщение…»

Предварительный черновик (требует проверки): Обязательный блок Формы ввода для типов «Отправка сообщения», «Запрос геопозиции» и «Запрос контакта». Отправляется пользователю, когда он прислал данные неправильного формата (например, текст вместо геопозиции).

⚠ Определение нужно дописать. Выше — мой предварительный вариант на основе цитат из статей, сверь и подправь. Ниже — сами цитаты для удобства.

Найдено в статьях:

[Не работает Форма ввода или частые ошибки] «Пропущен блок Ошибка (для типов ввода: Отправка сообщение, Запрос геопозиции и Запрос контакта)…»

Предварительный черновик (требует проверки): Необязательный блок Формы ввода типа Тестирование, который отправляется пользователю, если его ответ не совпал с правильным. Используется для подсказок перед повторной попыткой ответа.

⚠ Определение нужно дописать. Выше — мой предварительный вариант на основе цитат из статей, сверь и подправь. Ниже — сами цитаты для удобства.

Найдено в статьях:

[Форма ввода] «Подсказка — добавляет блок Подсказка, который отправляется в случае, если пользователь ответил с ошибкой…»

[Форма ввода] «Если ответ верный, то будет отправлен следующий блок. Подсказка — добавляет блок Подсказка…»

Предварительный черновик (требует проверки): Необязательный блок Формы ввода, который отправляется пользователю после того, как он прислал ответ. Используется для подтверждения приёма данных, благодарности или перехода к следующему шагу сценария.

⚠ Определение нужно дописать. Выше — мой предварительный вариант на основе цитат из статей, сверь и подправь. Ниже — сами цитаты для удобства.

Найдено в статьях:

[Форма ввода] «Необязательные блоки: Реакция на ответ — отправляет сообщение после ответа на форму…»

[Не работает Форма ввода или частые ошибки] «Если задан тип клавиатуры Обычная и блок Реакция на ответ не добавлен, то предыдущая обычная клавиатура…»

Блок, подсчитывающий количество правильных ответов на Форму ввода типа «Тестирование» и переводящий пользователя к нужной команде исходя из условий. Переменная с количеством верных ответов генерируется автоматически.

Блок, создающий переменную, которая при каждом вызове подставляет один элемент из заданного списка (например, промокод из набора). Сам по себе ничего не отправляет — работает в связке с командой, содержащей эту переменную.

Блок, отображающий товары магазина внутри команды Конструктора. Настраиваются расположение (вертикально/горизонтально), количество в ряду, поиск и фильтры по характеристикам.

Механизм оповещения системы о событиях: когда происходит событие, сервис отправляет POST-запрос на указанный адрес с JSON-данными. Альтернатива постоянному опросу сервера — быстрее и эффективнее.

Запросы, которые принимает PuzzleBot от стороннего сервиса через открытое REST API. Используют формат "https://api.puzzlebot.top/?token=ТОКЕН&method=МЕТОД". Для работы нужно сгенерировать API токен в "Настройки → Интеграции → Входящие запросы".

Функция Конструктора для объединения команд — упрощает работу и позволяет ограничить доступ к набору команд для определённых категорий пользователей (приватные команды).

Объединение нескольких товаров в одну карточку с вариантами выбора (например, размер, цвет). Группа создаётся на вкладке Список товаров в разделе Магазин. При покупке пользователь выбирает один конкретный вариант из группы. Отдельно существует Категория товаров — логическая рубрика, к которой можно привязать несколько товаров или групп

Тип реакции бота на произошедшее событие или нажатие кнопки. В конструкторе действия настраиваются на инлайн-кнопках, в условиях и в разделе События — они определяют, что именно должен сделать бот: отправить сообщение, вызвать команду, добавить пользователя в категорию, сделать HTTP-запрос и так далее.

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

Раздел личного кабинета для общения с пользователями от имени бота. Позволяет просматривать переписки, отвечать, вызывать команды, отправлять файлы и удалять сообщения — как в личных чатах, так и в группах.

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

Вид команды, состоящий из 1 блока и образующий цепочку самозаменяющихся команд — без отправки нового сообщения в чат. Поддерживает только инлайн- клавиатуру, замена возможна между инлайн-командами с одинаковым типом блока.

Функция Telegram, позволяющая вызывать бота из любого чата через ввод его юзернейма (например, "@puzzlebot что-то"). В PuzzleBot инлайн-мод настраивается отдельно для инлайн-команд и групп команд в Конструкторе, а также для товаров и категорий в Магазине.

Вид переменной, значение которой вычисляется в момент использования путём HTTP-запроса к внешнему сервису или обращения к подключённой Google-таблице. Позволяет подтягивать актуальные данные (курсы, цены, данные из CRM) без ручного обновления.

Запросы, которые сам PuzzleBot отправляет на сторонние сервисы. Три способа: дублирование всех запросов Telegram Bot API на свой сервер, произвольный запрос как действие в команде, и запросы при конкретных событиях (Подписки на события).

Группа пользователей, созданная для применения к ним действий: рассылки, изменение прав в ресурсах, ограничение доступа к командам. Пользователь может состоять в нескольких категориях. Категории меняются вручную через раздел Модерация или автоматически через действие «Добавление в категорию».

Главный раздел PuzzleBot для создания команд, блоков и клавиатур бота — сердце логики бота. Здесь создаются команды, настраиваются действия на кнопках, задаются синонимы, объединяются команды в группы.

Раздел для создания полноценного интернет-магазина внутри Telegram-бота. Позволяет добавлять товары, настраивать способы оплаты и доставки, принимать заказы — в том числе через мини-приложение.

Элемент Telegram, представляющий собой веб-страницу, которая открывается внутри клиента Telegram и использует расширенные возможности Mini App API. В PuzzleBot через мини-приложение можно оформлять Магазин, отправлять команды или просто открывать произвольные страницы.

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

Раздел личного кабинета PuzzleBot для управления аудиторией бота. Здесь хранится список пользователей, задаются категории, настраиваются права и разрешения — как для отдельных подписчиков, так и для целых категорий.

Во вкладке Модерация можно вручную назначать пользователей в категории, выделять группы пользователей для массовых действий, а также менять их права в подключённых ресурсах (группах и каналах).

Возможность отправить один пост сразу в несколько мест одновременно — в бота и в подключённые ресурсы (группы, каналы).

Уведомления о действиях, которые отображаются в модальном окне личного кабинета (колокольчик в интерфейсе). Настраиваются через "Настройки бота → Уведомления". Не путать с Уведомлениями — более общей системой.

Интерфейс управления ботом через Telegram без входа в личный кабинет PuzzleBot. Вызывается командой "/cp" в личке с ботом или в подключённой группе управления. Позволяет загружать файлы, просматривать активные диалоги, выполнять быстрые действия над ботом и ресурсами.

Система бонусов PuzzleBot: 7 дней Креативного тарифа новым пользователям, зарегистрировавшимся по реферальной ссылке партнёра, и 20% от суммы их покупок партнёру. Учёт в условных единицах, 1 у.е. = 1 ₽.

Функция, позволяющая подставлять значения индивидуально под каждого пользователя или для всех. Записываются в двойных фигурных скобках: "{{NAME}}". Бывают пользовательские (созданные в разделе Переменные) и системные ("FIRST_NAME", "USER_ID" и другие).

Функция интеграции, позволяющая настроить отправку запросов на сторонний сервис при определённых событиях в боте (вызов команды, ответ на форму и т.д.). Фактически — исходящий вебхук по событиям.

Действие инлайн-кнопки, показывающее окно с уведомлением. Два вида: без кнопки (шторкой сверху) и с кнопкой (по центру). Может проверять подписку на ресурс и показывать разный текст в зависимости от её наличия — это называется «Скрытое продолжение».

Механизм ограничения доступа к команде или группе команд по наличию подписки пользователя на указанный канал или чат. Настраивается через группу команд в Конструкторе.

Тип ссылки в разделе Вход для отслеживания переходов из конкретных источников трафика. Для каждой промо-ссылки собирается отдельная статистика переходов.

Общее название для элементов Telegram, в которых может работать бот: канал, группа, форум, бизнес-аккаунт. Чтобы бот работал с ресурсом, ресурс нужно подключить к сервису PuzzleBot и выдать боту права администратора.

Функция раздела Вход, позволяющая отслеживать приглашения пользователей другими пользователями. В реферальной системе доступны специальные переменные ("INVITED_*"), которые работают в команде, указанной как уведомление о новом реферале.

Расширенная функция команды, позволяющая задавать альтернативные фразы или условия для её вызова. Например, команда "/start" может срабатывать также на слово «Привет». Внутри синонима можно задать несколько групп условий с разными типами совпадения (полное, частичное и т.д.).

Возникновение определённой ситуации при взаимодействии с ботом: подключение бота к ресурсу, вступление пользователя в группу, вызов неизвестной команды и т.д. На событие можно настроить действие — автоматическую реакцию бота. События бота и ресурса отличаются.

Последовательная отправка постов по личному расписанию каждого пользователя, отсчитываемому от даты запуска сценария. Запуск — вызов команды, переход по ссылке или срабатывание триггера. Отличается от Постинга тем, что у каждого пользователя своё расписание.

Тематическая подгруппа внутри Telegram-форума — отдельный чат для определённой темы. Когда форум подключён к PuzzleBot как ресурс, посты можно отправлять не в общий канал, а в конкретный топик.

Сущность для групп и бизнес-аккаунтов: задаёт слово, фразу или условие, при выполнении которых бот автоматически выполняет действие (отправить сообщение, вызвать команду, удалить из чата и т.п.).

Общая система уведомлений бота, настраиваемая в "Настройки → Уведомления". В отличие от Оповещений, охватывает не только личный кабинет, но и отправку в группу, на почту и администраторам (последнее — только на платных тарифах).

Отдельная сущность наравне с командами, состоящая из правил (проверки + действия). При вызове условия всегда выполняется ровно одно из правил. Обычное условие можно вызвать как команду; Кнопка-условие определяет настройки инлайн-кнопки и вызывается только действием на этой кнопке.

Блок Конструктора, принимающий любую отправленную пользователем информацию или файлы и сохраняющий их в таблицу. Состоит из обязательного блока «Вопрос» и дополнительных полей. Поддерживает типы ввода: текст, файл, тестирование и другие.

Синтаксис для вычисления значения Переменной. Поддерживает арифметические операции, строковые функции, обращение к другим переменным. Формулы в тексте записываются как {{=выражение=}} и вычисляются прямо при отправке сообщения, без создания отдельного действия. Например: "{{=100-45=}}".

Вид товара в Магазине, который при покупке автоматически отправляет пользователю один элемент из заранее заданного списка — например, промокод из набора. Используется для цифровых продуктов с уникальными выдачами.

Служебный вспомогательный бот PuzzleBot, который добавляется в подключённые к сервису ресурсы (группы/каналы) наряду с основным ботом для выполнения некоторых технических действий — например, выборки списка участников. Добавляется автоматически при подключении ресурса к сервису; требует от основного бота права «Выбор администраторов».