# Instantly when receiving a document — Telegram Bot

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

It is triggered every time the bot receives a document.

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 documents from anyone; "target" = Task runs when receiving documents 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
- `{{from_name}}` *(text)* — From Username
- `{{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
- `{{reply_to_message_username}}` *(text)* — Reply to message Username
- `{{reply_to_message_text}}` *(text)* — Reply to message Text
- `{{file_id}}` *(text)* — Document Id. Id of the document included in the response. Use the 'Get the URL of a file' option to convert the file Id to a URL
- `{{file_name}}` *(text)* — Document filename
- `{{file_extension}}` *(text)* — Document extension
- `{{document_url}}` *(text)* — Document URL

## 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_document