Глоссарий

API ключ

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

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

Подробнее в статьях: Как подключить Telegram бота к сервису puzzlebot, Как узнать или где найти API ключ бота, Входящие запросы (API)

BotFather — @BotFather, BotFather-а, ботфазер

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

Подробнее в статьях: Как создать нового бота в Telegram, Как подключить Telegram бота к сервису puzzlebot, Как узнать или где найти API ключ бота, Как изменить имя бота, Как изменить юзернейм бота, Как изменить описание бота, Как изменить картинку бота, Как изменить информацию о боте, Как передать права на бота другому пользователю в Telegram

puzzlebot

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

Автоплатёж (Рекуррентный платёж) — автоматический платёж, рекуррентные списания

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

Подробнее в статьях: Автоплатеж, Рекуррентные платежи (Автоплатёж)

Акция

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

Подробнее в статьях: Акции

Аудитория — аудитории, аудиторию, аудиторией

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

Подробнее в статьях: Как отправить пост категории или аудитории пользователей

Блок Вопрос — Блок Вопроса, блока Вопроса, блоку Вопроса, блоком Вопроса, блоке Вопрос

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

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

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

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

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

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

Подробнее в статьях: Форма ввода, Не работает Форма ввода или частые ошибки

Блок Время — Время вышло, блок Время вышло, блока Время, блоку Время

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

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

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

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

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

Подробнее в статьях: Форма ввода, Не работает Форма ввода или частые ошибки

Блок Клавиатуры — блока Клавиатуры, блоку Клавиатуры, блоком Клавиатуры

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

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

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

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

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

Подробнее в статьях: Мини-приложения

Блок Настройки — блока Настройки, блоку Настройки, блоком Настройки, блоке Настройки

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

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

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

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

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

Подробнее в статьях: Форма ввода

Блок Ошибка — блока Ошибка, блоку Ошибка, блоком Ошибка, блоке Ошибка, Ошибка

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

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

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

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

Подробнее в статьях: Форма ввода, Не работает Форма ввода или частые ошибки

Блок Подсказка — блока Подсказка, блоку Подсказка, блоком Подсказка, Подсказка

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

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

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

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

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

Подробнее в статьях: Форма ввода

Блок Реакция — Реакция на ответ, блока Реакция, блоку Реакция, блоком Реакция

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

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

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

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

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

Подробнее в статьях: Форма ввода, Не работает Форма ввода или частые ошибки

Блок Результат

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

Подробнее в статьях: Блок Результат

Блок Список

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

Подробнее в статьях: Блок Список

Блок Товар

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

Подробнее в статьях: Блок Товар

Вебхук (Webhook)

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

Подробнее в статьях: Что такое вебхук (webhook) и как его подключить

Входящие запросы (API)

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

Подробнее в статьях: Входящие запросы (API)

Группа команд

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

Подробнее в статьях: Группа команд, Как ограничить доступ к группе команд (приватные команды)

Группа товаров — группы товаров, группе товаров, группой товаров, группу товаров

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

Подробнее в статьях: Список товаров, создание товара, группы товаров и категорий, Блок Товар, Обзор раздела Магазин

Действия — Действие, Действии, Действием

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

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

Подробнее в статьях: Обзор раздела События

Диалоги

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

Подробнее в статьях: Обзор раздела Диалоги

Доступ администраторов

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

Подробнее в статьях: Доступ администраторов

Инлайн-команда

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

Подробнее в статьях: Инлайн команда

Инлайн-мод

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

Подробнее в статьях: Инлайн-мод для инлайн-команд и групп команд в Конструкторе, Инлайн-мод для товаров и категорий товаров в Магазине

Интегрированная переменная

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

Подробнее в статьях: Интегрированные переменные

Исходящие запросы (API)

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

Подробнее в статьях: Исходящие запросы (API)

Категория (пользователей) — Категория, Категории, Категорию, Категорией, Категорий

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

Подробнее в статьях: Что такое категории, как создать и добавить в них пользователей

Конструктор

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

Подробнее в статьях: Обзор раздела Конструктор

Магазин

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

Подробнее в статьях: Обзор раздела Магазин

Мини-приложение (Web App, веб-бот) — WebApp, веб-бот, Мини-приложение, Мини-приложения, Web App

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

Подробнее в статьях: Подключение мини-приложения для кнопки в боте (веб-бот), Магазин в виде мини-приложения (веб-бота), Мини-приложения

Многоразовая ссылка

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

Подробнее в статьях: Многоразовые ссылки

Модерация — Модерации, Модерацию

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

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

Подробнее в статьях: Обзор раздела Модерация

Мультипостинг

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

Подробнее в статьях: Как отправить пост в бота и в ресурсы (мультпостинг)

Оповещения

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

Подробнее в статьях: Оповещения

Панель управления — /cp, панели управления, панель управления ботом, cp

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

Подробнее в статьях: Панель управления ботом через Telegram, Общение через Telegram бота — Активные диалоги, Загрузка файлов через Telegram бота, Доступ администраторов

Партнёрская программа

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

Подробнее в статьях: Партнерская программа

Переменная

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

Подробнее в статьях: Обзор раздела Переменные

Подписки на события

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

Подробнее в статьях: Подписки на события

Попап — Попап, Попапа, Попапу, Скрытое продолжение

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

Подробнее в статьях: Действие Попап или Скрытое продолжение

Проверка подписки

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

Подробнее в статьях: Проверка подписки

Промо ссылка

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

Подробнее в статьях: Промо ссылки, Обзор раздела Статистика

Ресурс

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

Подробнее в статьях: Как подключить ресурс (канал, группу или форум) к сервису puzzlebot ://

Реферальная система

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

Подробнее в статьях: Реферальная система

Синонимы (команды)

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

Подробнее в статьях: Синонимы

Событие

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

Подробнее в статьях: Обзор раздела События

Сценарий (Автопостинг) — Автопостинг, Сценарий, Сценария, Сценарию, Сценариев, Сценарии

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

Подробнее в статьях: Обзор раздела Сценарии

Топик — топика, топику, топиком, топики, тема форума, темы форума

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

Подробнее в статьях: Как отправить пост в топик (тему) форума

Триггер

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

Подробнее в статьях: Обзор раздела Триггеры

Уведомления

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

Подробнее в статьях: Уведомления и оповещения

Условие (Обычное условие и Кнопка-условие) — Условие, Условия, Условию, Кнопка-условие

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

Подробнее в статьях: Условия (обычное условие и кнопка-условие)

Форма ввода

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

Подробнее в статьях: Форма ввода

Формула — формулы, формуле, формулой, выражение, выражения

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

Подробнее в статьях: Правила написания выражения или формулы для изменения Переменной, Создание переменной для расчёта суммы криптовалюты TON по текущему курсу

Электронный товар

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

Подробнее в статьях: Электронный товар

Юзербот — юзербота, юзерботу, юзерботом

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

Подробнее в статьях: Не получается подключить ресурс (группу или канал)