# Ask user — Telegram Bot

Botize method — `telegrambot.ask` (action).

Send a query (usually a question) that may include an image/video/file to a chat and wait for the user's response before continuing.

- The following tags are currently supported in the messages: b, strong , i, em, u, ins, s, strike, del, a, code, pre.
- You can include URL Buttons and Callback Buttons in posts.

This is an action: it runs as a step of a task. Several can be chained.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `mb_switch` *(boolean)* — Rules
- `text` *(string)* — Question
- `photo` *(string)* — Photo, Video or file URL
- `send_as_attachment` *(boolean)* — Send as attachment
- `reply_type` *(string, one of: "text" = The user must reply by sending a text message; "image" = The user must reply by sending an image file; "textorimage" = The user must reply by sending a text message or image file; "imageordocument" = The user must reply by sending an image or document file; "video" = The user must reply by sending a video file; "document" = The user must reply by sending a document file; "button" = The user must reply by pressing one of the buttons offered; "webapp" = The user must interact with the displayed Web App)* — Buttons
- `specific_chat` *(boolean)* — Send the question to a different chat
- `chat_id` *(string)*
- `message_thread_id` *(string)* — Post within a specific Thread (Topic) ID
- `disable_link_preview` *(boolean)* — Disable link preview
- `mb_outputvars_switch` *(boolean)* — Customize tags

It also accepts repeatable field groups, with these prefixes: `mb_filters_*`, `button_text_*`, `button_type_*`, `button_value_*`, `button_size_*`, `keyboard_type_*`, `keyboard_value_*`. These are composite components (buttons, filters, keyboards); the trailing number is set by the user as they are added.

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{from_id}}` *(int)* — From User ID
- `{{message_id}}` *(int)* — Message ID
- `{{from_name}}` *(text)* — From Name. First name of the user who sent the message.
- `{{from_username}}` *(text)* — From Username. Username of the user who sent the message. By default, Telegram users don't have a username, so only people who have their phone number can send them messages. If a user has a username, anyone can send them messages through the link https://t.me/username, and they will appear in Telegram search with their username.
- `{{chat_id}}` *(text)* — From Chat ID
- `{{text}}` *(text)* — User message
- `{{file_id}}` *(text)* — File ID. Id of the image or file included in the response. Use the 'Get the URL of a file' option to convert the file Id to a URL
- `{{type}}` *(text)* — Type of message
- `{{callback_data}}` *(text)* — Callback data
- `{{file_ids}}` *(array)* — File IDs
- `{{language_code}}` *(text)* — Language code. IETF language tag of the user's Telegram client ('es', 'en-GB', 'pt-BR'). Optional: Telegram only sends it when the user has a language set, so it may arrive empty.

## Account

Needs a connected Telegram Bot account in Botize: https://botize.com/en/app/telegrambot/authenticate

## This app

Every trigger and action for Telegram Bot: https://botize.com/en/app/telegrambot.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/telegrambot/ask