# Instantly when receiving a message, image, video or file — Telegram Bot

Botize method — `telegrambot.webhook_txtimgdoc` (trigger).

It is triggered every the bot receives a text message, image, video or file to the bot.

This is a trigger: it starts the task. A task has exactly one.

## Fields you set

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

- `chat_source` *(string, one of: "any" = Task runs when receiving images from anyone; "target" = Task runs when receiving images from a specific user, group or channel, default: "any")*
- `chat_id` *(string)*
- `mb_outputvars_switch` *(boolean)* — Customize tags

## 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
- `{{message_thread_id}}` *(int)* — Message Thread Id. Thread ID if the message comes from a group with various topics.
- `{{from_name}}` *(text)* — From Username
- `{{chat_id}}` *(text)* — From Chat Id
- `{{text}}` *(text)* — User message
- `{{reply_to_message_username}}` *(text)* — Reply to message Username
- `{{reply_to_message_text}}` *(text)* — Reply to message Text
- `{{file_id}}` *(text)* — File Id. Id of the image included in the response. Use the 'Get the URL of a file' option to convert the file Id to a URL
- `{{forward_from_id}}` *(int)* — Forwarded from chat Id. ID of the chat from which this message was forwarded
- `{{media}}` *(array)* — Media. Array containing information about the images attached to the post
- `{{story_id}}` *(int)* — Story Id. Filled in only when the message is a shared Telegram story. Telegram does not give bots the content of a story, only the channel that published it and this id.
- `{{story_chat_id}}` *(text)* — Story channel Id. Id of the channel that published the story
- `{{story_chat_title}}` *(text)* — Story channel name. Title of the channel that published the story
- `{{story_chat_username}}` *(text)* — Story channel username. Username of the channel that published the story
- `{{story_url}}` *(text)* — Story URL. Public link to the story. Empty if the channel has no username

## 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/webhook_txtimgdoc