# Instantly when receiving an audio file — Telegram Bot

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

It is triggered every time a user sends an audio 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 audio files from anyone; "target" = Task runs when receiving audio files 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)* — File Id. Id of the audio file included in the response. Use the 'Get the URL of a file' option to convert the file Id to a URL.
For example: abcABC0123456789
- `{{type}}` *(text)* — Type of message
- `{{file_name}}` *(text)* — File name. Name of the file associated with the audio file.
For example: file_0123.mp3
- `{{file_extension}}` *(text)* — File extension. The extension of the file indicating its format.
For example: mp3
- `{{file_url}}` *(text)* — File URL. Direct URL to access the audio file.
For example: https://tmp1d.s3.eu-west-3.amazonaws.com/file_0123.mp3

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