Jeenee UI Builder icon

Jeenee UI Builder

Build Telegram bot UI components using Jeenee DSL
Join our community

Overview

This node, named Jeenee UI Builder, is designed to build Telegram bot UI components using the Jeenee DSL. It allows users to create and customize interactive message components such as buttons, select menus, text inputs, file uploads, rich choices, image choices, checkboxes, notes, progress indicators, and images. The node supports sending a new message or editing an existing one, identified by a unique session ID. This is useful for Telegram bot developers who want to dynamically generate complex UI elements in their bot messages.

Use Case Examples

  1. Creating a Telegram message with interactive buttons for user responses.
  2. Sending a message with a select menu allowing single or multiple selections.
  3. Editing an existing message to update its text and components.
  4. Adding file upload components to a Telegram bot message for user submissions.

Properties

Name Meaning
Session ID Unique session identifier for the Telegram bot interaction.
Message Main message text to display in the Telegram message.
Update Mode Determines whether to edit the current message or send a new one.
Components Collection of UI components to include in the message, such as buttons, select menus, text inputs, file uploads, rich choices, image choices, checkboxes, notes, progress indicators, and images.
Metadata Optional metadata including flow ID, step ID, and version for tracking or contextual purposes.

Output

JSON

  • session_id - Unique session identifier for the Telegram interaction.
  • message - The main message text to display.
  • update - Mode indicating whether to edit the existing message or send a new one.
  • components - Array of UI components included in the message, each with a kind and relevant properties.
  • metadata
    • flow_id - Optional flow ID metadata.
    • step_id - Optional step ID metadata.
    • version - Optional version metadata.

Troubleshooting

  • Ensure the session ID is correctly provided and matches an active Telegram session to avoid message update failures.
  • Verify that required fields like message text and component custom IDs are not empty to prevent errors.
  • When using URL buttons, ensure the URL is valid and properly formatted.
  • If editing an existing message, confirm the message exists and the bot has permission to edit it.

Discussion