botnest
Documentation
Guide

Logic and timing

Conditions, loops, pauses, components and reminders.

Choosing a path

A condition selects a branch, a loop repeats steps for a list, and a component groups part of a flow. None of these replaces sending a message: connect the required action afterwards.

Pause is a short wait in the current run. A reminder is a separate future task. A schedule starts a new flow run at a chosen time.

Execution order → · Scheduled starts →

Condition

Compares values and chooses the Yes or No output.

  1. For each check, set the left value, operator and right value. Both values can be entered or connected independently.
  2. Combine checks with AND / OR. They are evaluated from top to bottom, without AND taking priority over OR. For example: (A OR B) AND C.
  3. Contains by lemma includes word forms. Open the small button beside the operator to inspect them. Use equals for an exact match.

Pause

Pauses the current run briefly before the next step.

  1. Enter the duration in seconds and connect the next block to the output.
  2. For a notification on a specific date, use Schedule reminder instead of a long pause.

Branch by messenger

Routes events from different messengers into separate branches.

  1. Choose the messengers and connect their outputs to the appropriate actions.
  2. Connect Telegram-only actions to the Telegram branch. This block selects a route; it does not connect a new messenger.

For each item

Runs the same branch for every item in a list.

  1. Supply a list, such as ${table_result.rows}, and name the current item, for example item. Use ${item.name} inside the loop.
  2. The Loop output leads to actions for one item; Done continues after all items. Do not connect the end of the branch back to the loop input.

Component

Groups part of a flow into a component with named inputs, outputs and parameters.

  1. Open its internal flow using the corner button. Configure the internal steps and the component's external connections.
  2. Connect only the required parameters and outputs from outside. Use the same button to return to the main flow; the internal steps stay inside the component.

Schedule reminder

Stores a one-off reminder and sends it at the chosen time without keeping the flow waiting.

  1. Set the date, time zone, text and destination chat. Keep the reminder ID if you may need to cancel it.
  2. Set a deduplication key to avoid creating the same reminder on repeated runs. Use Pause for a brief wait.

List reminders

Lists pending reminders.

  1. Name the result. With an event author, it lists that user's reminders; without an author, the source chat's reminders. With neither, it lists reminders for the whole bot.
  2. Build text to show the list or use an ID to cancel one task. Do not expose a bot-wide list to a user without checking access.

Cancel reminder

Cancels one previously created reminder.

  1. Supply its ID from the creation result or reminder list.
  2. Use the operation result to confirm cancellation. A message ID is not a reminder ID.

Cancel all reminders

Cancels pending reminders in the current run's context.

  1. With an event author, it cancels that user's reminders; without an author, the source chat's reminders. With neither, it affects all the bot's reminders.
  2. This is a bulk cancellation: check context and ask for confirmation. Use Cancel reminder with an ID for one task.