puzzlebot glossary. Terms in total: 55.
API key — API keys, bot API key, bot token
The secret code (token) of a Telegram bot, issued by "@BotFather". It lets you work with the bot outside the Telegram client — for example, connect it to puzzlebot by entering it in this field in your puzzlebot account.
Do not confuse: the bot's API key (from BotFather) and the API token for puzzlebot incoming requests (generated separately in "Settings → Integrations → Incoming requests").
Read more: How to connect a Telegram bot to puzzlebot, How to find your bot's API key, Incoming requests (API)
Actions — action
A type of bot reaction to an event or a button press. In the Constructor, actions are set up on inline buttons, in conditions and in the Events section — they define what exactly the bot should do: send a message, call a command, add the user to a category, make an HTTP request and so on.
A single node can contain several actions that run one after another. Action types differ depending on the context: a button has one set, an event or a trigger has another.
Read more: Events section overview
Administrator access — admin access
A feature that lets you add other users to manage the bot, channel and chat from the puzzlebot account. Available only on paid plans; the number of admins depends on the plan.
Read more: Administrator access
Affiliate program — affiliate programs
The puzzlebot bonus system: 7 days of the Creative plan for new users who sign up through a partner's referral link, and 20% of their purchases for the partner. Bonuses are counted in conventional units, 1 unit = 1 ₽.
Read more: Affiliate program
Alerts — alert
Notifications about actions that are shown in a modal window of the puzzlebot account (the bell icon in the interface). They are set up in "Bot settings → Notifications". Not to be confused with Notifications — the more general system.
Read more: Alerts
Audience — audiences
A group of bot users brought together for a mass broadcast of posts. It differs from a Category in that it is built dynamically for a broadcast (by filters) rather than through manual assignment. It is used on the Posting tab for targeted broadcasts.
Read more: How to send a post to a user category or audience
Autopayment (recurring payment) — autopayment, autopayments, recurring payment, recurring payments
A repeated automatic charge to a customer's card. In puzzlebot it is set up on the "Bot settings → Recurring payments" page and is available only for some payment systems (Alfa-Bank, Kaspi, Prodamus, Robokassa, T-Bank, YooKassa).
Read more: Autopayment, Recurring payments (autopayment)
BotFather — @BotFather
Preliminary draft (needs review): The system Telegram bot "@BotFather", through which all user bots in Telegram are created and configured. For puzzlebot, it is used to get the API key, change the bot's name/description/picture/username, transfer ownership and manage inline mode. The owner of a bot in Telegram is whoever created it in @BotFather.
Read more: How to create a new Telegram bot, How to connect a Telegram bot to puzzlebot, How to find your bot's API key, How to change a bot's name, How to change a bot's username, How to change a bot's description, How to change a bot's picture, How to change your bot's information, How to transfer bot ownership to another user in Telegram
Category (of users) — category, categories, user category, user categories
A group of users created so that actions can be applied to them: broadcasts, changing rights in resources, restricting access to commands. A user can belong to several categories. Categories are changed manually in the Moderation section or automatically with the "Adding to a category" action.
Read more: What categories are and how to create them and add users to them
Command group — command groups, group of commands, groups of commands
A Constructor feature for combining commands. It makes work easier and lets you restrict access to a set of commands to certain user categories (private commands).
Read more: Command group, How to restrict access to a command group (private commands)
Command synonyms — command synonym, synonyms, synonym
An advanced command feature that lets you define alternative phrases or conditions for calling it. For example, the "/start" command can also be triggered by the word "Hello". Inside a synonym you can define several condition groups with different match types (full, partial and so on).
Read more: Command synonyms
Condition (regular condition and condition button) — condition, conditions, condition button, condition buttons
A separate entity on a par with commands, made up of rules (checks + actions). When a condition is called, exactly one of its rules is always executed. A regular condition can be called like a command; a condition button defines the settings of an inline button and is called only by the action on that button.
Read more: Conditions (regular condition and condition button)
Constructor
The main section of puzzlebot for creating the bot's commands, blocks and keyboards — the heart of the bot's logic. Here you create commands, set up button actions, define synonyms and combine commands into groups.
Read more: Constructor section overview
Control panel — /cp, control panels, bot control panel
An interface for managing the bot through Telegram without logging in to the puzzlebot account. It is opened with the "/cp" command in the private chat with the bot or in a connected management group. It lets you upload files, view active dialogs, and perform quick actions on the bot and resources.
Read more: Bot control panel in Telegram, Chatting through the Telegram bot — Active dialogs, Uploading files through the Telegram bot, Administrator access
Dialogs — Dialogs section
A section of the puzzlebot account for talking to users on behalf of the bot. It lets you view conversations, reply, call commands, send files and delete messages — both in private chats and in groups.
Read more: Dialogs section overview
Digital product — digital products
A kind of product in the Store that, when purchased, automatically sends the user one item from a predefined list — for example, a promo code from a set. It is used for digital goods where each buyer receives a unique item.
Read more: Digital product
Error block — Error blocks
Preliminary draft (needs review): A required block of an input form for the "Sending a message", "Location request" and "Contact request" types. It is sent to the user when they send data in the wrong format (for example, text instead of a location).
⚠ The definition needs to be completed. Above is my preliminary version based on quotes from the articles — check it and correct it. The quotes themselves are below for convenience.
Found in articles:
[Input form is not working: common mistakes] "The Error block is missing (for the input types Sending a message, Location request and Contact request)…"
Read more: Input form, Input form is not working: common mistakes
Event — events
A particular situation that occurs during interaction with the bot: the bot is connected to a resource, a user joins a group, an unknown command is called and so on. You can assign an action to an event — an automatic reaction of the bot. Bot events and resource events are different.
Read more: Events section overview
Event subscriptions — event subscription
An integration feature that lets you send requests to a third-party service on certain events in the bot (a command call, a form answer and so on). In effect, an outgoing webhook triggered by events.
Read more: Event subscriptions
Formula — formulas, expression, expressions
The syntax for calculating the value of a Variable. It supports arithmetic operations, string functions and references to other variables. In text, formulas are written as {{=expression=}} and are calculated right when the message is sent, without creating a separate action. For example: "{{=100-45=}}".
Read more: How to write an expression or formula to change a variable, Creating a variable to calculate an amount in TON at the current exchange rate
Hint block — Hint blocks, hint
Preliminary draft (needs review): An optional block of an input form of the Quiz type that is sent to the user if their answer did not match the correct one. It is used to give hints before the user tries to answer again.
⚠ The definition needs to be completed. Above is my preliminary version based on quotes from the articles — check it and correct it. The quotes themselves are below for convenience.
Found in articles:
[Input form] "Hint — adds a Hint block, which is sent if the user answered incorrectly…"
[Input form] "If the answer is correct, the next block is sent. Hint — adds a Hint block…"
Read more: Input form
Incoming requests (API) — incoming requests, incoming request
Requests that puzzlebot receives from a third-party service through its open REST API. They use the format "https://api.puzzlebot.top/?token=TOKEN&method=METHOD". To use them, generate an API token in "Settings → Integrations → Incoming requests".
Read more: Incoming requests (API)
Inline command — inline commands
A kind of command that consists of 1 block and forms a chain of commands that replace one another — without sending a new message to the chat. It supports only an inline keyboard, and replacement is possible only between inline commands with the same block type.
Read more: Inline command
Inline mode — inline modes
A Telegram feature that lets you call a bot from any chat by typing its username (for example, "@puzzlebot something"). In puzzlebot, inline mode is set up separately for inline commands and command groups in the Constructor, and for products and categories in the Store.
Read more: Inline mode for inline commands and command groups in the Constructor, Inline mode for products and product categories in the Store
Input form — input forms
A Constructor block that accepts any information or files sent by the user and saves them to a table. It consists of the required "Question" block and additional fields. It supports input types such as text, file, quiz and others.
Read more: Input form
Integrated variable — integrated variables
A kind of variable whose value is calculated at the moment of use, through an HTTP request to an external service or a lookup in a connected Google Sheets spreadsheet. It lets you pull in up-to-date data (exchange rates, prices, CRM data) without manual updates.
Read more: Integrated variables
Keyboards block — Keyboards blocks
Preliminary draft (needs review): A block that defines the keyboard of a command — the set of buttons the user sees under the message. It can be of the Regular, Inline or Fixed type (the last one only in the context of mini apps).
⚠ The definition needs to be completed. Above is my preliminary version based on quotes from the articles — check it and correct it. The quotes themselves are below for convenience.
Found in articles:
[Mini apps] "A Keyboards block with the Fixed type is automatically added to the mini app…"
[Mini apps] "If the mini app already has a Keyboards block with the Fixed type, it is replaced…"
Read more: Mini apps
List block — List blocks
A block that creates a variable which returns one item from a given list each time it is called (for example, a promo code from a set). It sends nothing on its own — it works together with a command that contains this variable.
Read more: List block
Mini app (Web App, web bot) — mini app, mini apps, Web App, WebApp, web bot
A Telegram element: a web page that opens inside the Telegram client and uses the extended capabilities of the Mini App API. In puzzlebot, a mini app can be used to present the Store, send commands, or simply open arbitrary pages.
Read more: Connecting a mini app to a bot button (web bot), Store as a mini app (web bot), Mini apps
Moderation — Moderation section, Moderation tab
A section of the puzzlebot account for managing the bot's audience. It stores the list of users and lets you define categories and set rights and permissions — both for individual subscribers and for whole categories.
On the Moderation tab you can manually assign users to categories, select groups of users for bulk actions, and change their rights in connected resources (groups and channels).
Read more: Moderation section overview
Multi-use link — multi-use links
A link in the Entry section that many users can follow an unlimited number of times. It is used for traffic sources that need to be told apart.
Read more: Multi-use links
Multiposting
The ability to send one post to several places at once — to the bot and to connected resources (groups, channels).
Read more: How to send a post to a bot and to resources (multiposting)
Notifications — notification
The bot's general notification system, set up in "Settings → Notifications". Unlike Alerts, it covers not only the puzzlebot account but also sending to a group, to email and to administrators (the last one is available only on paid plans).
Read more: Notifications and alerts
Outgoing requests (API) — outgoing requests, outgoing request
Requests that puzzlebot itself sends to third-party services. There are three ways: duplicating all Telegram Bot API requests to your own server, a custom request as an action in a command, and requests on specific events (Event subscriptions).
Read more: Outgoing requests (API)
Popup — popups, hidden continuation
An inline button action that shows a window with a notification. There are two kinds: without a button (a banner sliding down from the top) and with a button (in the center). It can check the subscription to a resource and show different text depending on whether the user is subscribed — this is called "Hidden continuation".
Read more: Popup action, or Hidden continuation
Product block — Product blocks
A block that shows Store products inside a Constructor command. You can set the layout (vertical/horizontal), the number of products per row, search, and filters by attributes.
Read more: Product block
Product group — product groups, group of products, groups of products
Several products combined into one card with options to choose from (for example, size or color). A group is created on the Product list tab in the Store section. When buying, the user picks one specific option from the group. There is also a separate entity, the Product category — a logical heading to which several products or groups can be linked.
Read more: Product list: creating products, product groups, and categories, Product block, Store section overview
Promo link — promo links
A type of link in the Entry section for tracking visits from specific traffic sources. Separate visit statistics are collected for each promo link.
Read more: Promo links, Statistics section overview
Promotion — promotions
An entity of the Store section: a discount or a promo code. A discount is applied automatically when its conditions are met; a promo code is applied when the user enters the code phrase.
Read more: Promotions
Question block — Question blocks
Preliminary draft (needs review): A required block of an input form that contains the text of the question or request sent to the user before the bot waits for their answer. The system will not let you publish the form unless the Question block is filled in.
⚠ The definition needs to be completed. Above is my preliminary version based on quotes from the articles — check it and correct it. The quotes themselves are below for convenience.
Found in articles:
[Input form] "The Input form block consists of two required blocks: Question — a required block. Settings — a required block, contains the answer settings…"
[Input form] "When the Replace question option is turned on, the Question block will be replaced with the reaction block, or deleted if…"
[Input form is not working: common mistakes] "Clear the Delete the Question block after the answer checkbox in Additional settings…"
Read more: Input form, Input form is not working: common mistakes
Reaction block — Reaction blocks, reaction to an answer
Preliminary draft (needs review): An optional block of an input form that is sent to the user after they have sent their answer. It is used to confirm that the data was received, to say thanks, or to move on to the next step of the flow.
⚠ The definition needs to be completed. Above is my preliminary version based on quotes from the articles — check it and correct it. The quotes themselves are below for convenience.
Found in articles:
[Input form] "Optional blocks: Reaction to an answer — sends a message after the form is answered…"
[Input form is not working: common mistakes] "If the keyboard type is set to Regular and the Reaction to an answer block is not added, the previous regular keyboard…"
Read more: Input form, Input form is not working: common mistakes
Referral system — referral systems
A feature of the Entry section that lets you track users invited by other users. The referral system has special variables ("INVITED_*") that work in the command set as the new referral notification.
Read more: Referral system
Resource — resources
The general name for the Telegram elements a bot can work in: a channel, group, forum or business account. For the bot to work with a resource, the resource must be connected to puzzlebot and the bot must be given administrator rights.
Read more: How to connect a resource (channel, group or forum) to puzzlebot ://
Result block — Result blocks
A block that counts the correct answers to an input form of the "Quiz" type and sends the user to the right command based on conditions. The variable with the number of correct answers is generated automatically.
Read more: Result block
Scenario (autoposting) — scenario, scenarios, autoposting
Sending posts in sequence on each user's personal schedule, counted from the date the scenario was started. A scenario is started by a command call, a link visit or a trigger. It differs from Posting in that every user has their own schedule.
Read more: Scenarios section overview
Settings block — Settings blocks
Preliminary draft (needs review): A required block of an input form that contains the answer processing parameters: the name for statistics, where to send the notification, the "Repeat submission" option, the settings for the reaction to a skip, and others.
⚠ The definition needs to be completed. Above is my preliminary version based on quotes from the articles — check it and correct it. The quotes themselves are below for convenience.
Found in articles:
[Input form] "Of two required blocks: Question — a required block. Settings — a required block, contains the answer settings…"
[Input form] "The button for adding a reaction is located under the Settings block. Reaction to a skip — sends a message…"
Read more: Input form
Store — Store section
A section for building a full online store inside a Telegram bot. It lets you add products, set up payment and delivery methods, and accept orders — including through a mini app.
Read more: Store section overview
Subscription check — subscription checks
A mechanism that restricts access to a command or a command group depending on whether the user is subscribed to a specified channel or chat. It is set up through a command group in the Constructor.
Read more: Subscription check
Time block — Time blocks, Time is up, Time is up block
Preliminary draft (needs review): An optional block of an input form that is sent automatically when the user's answer timeout has expired. It is active only if Timeout is turned on in the form settings (5 seconds minimum).
⚠ The definition needs to be completed. Above is my preliminary version based on quotes from the articles — check it and correct it. The quotes themselves are below for convenience.
Found in articles:
[Input form] "On timeout, the special Time is up block is sent. Let's look at the specifics of each input type…"
[Input form is not working: common mistakes] "When you turn on Timeout (5 sec minimum), fill in the linked Time is up block (the reaction to time running out)…"
Read more: Input form, Input form is not working: common mistakes
Topic — topics, forum topic, forum topics
A thematic subgroup inside a Telegram forum — a separate chat for a particular subject. When a forum is connected to puzzlebot as a resource, posts can be sent to a specific topic instead of the general channel.
Read more: How to send a post to a forum topic
Trigger — triggers
An entity for groups and business accounts: it defines a word, phrase or condition that, when met, makes the bot perform an action automatically (send a message, call a command, remove a user from the chat and the like).
Read more: Triggers section overview
Userbot — userbots
A helper service bot of puzzlebot that is added to the resources connected to the service (groups/channels) alongside the main bot to perform certain technical actions — for example, fetching the list of members. It is added automatically when a resource is connected to the service, and requires the main bot to have the "Add new admins" right.
Read more: Can't connect a resource (group or channel)
Variable — variables
A feature that lets you insert values individually for each user or for everyone. Variables are written in double curly braces: "{{NAME}}". They can be custom (created in the Variables section) or system ("FIRST_NAME", "USER_ID" and others).
Read more: Variables section overview
Webhook — webhooks
A mechanism for notifying a system about events: when an event occurs, the service sends a POST request with JSON data to the specified address. An alternative to constantly polling the server — faster and more efficient.
Read more: What a webhook is and how to connect one
puzzlebot
A no-code builder service for creating Telegram bots. It lets you build commands and set up a store, integrations, broadcasts, input forms and much more through the visual interface of the puzzlebot account.