# Instantáneamente cuando se recibe un documento — Telegram Bot

Método de Botize — `telegrambot.webhook_document` (disparador).

Se acciona cada vez que el bot recibe un documento.

Es un disparador: inicia la tarea. Una tarea tiene exactamente uno.

## Campos que se configuran

Nombre interno del campo, tipo y valores admitidos. En estos campos se pueden insertar etiquetas `{{...}}` de pasos anteriores.

- `chat_source` *(string, one of: "any" = La tarea se ejecuta al recibir documentos de cualquier chat; "target" = Solo se ejecuta al recibir documentos de un usuario, grupo o canal concreto, default: "any")*
- `chat_id` *(string)*
- `mb_outputvars_switch` *(boolean)* — Personalizar etiquetas

## Variables de salida

Datos que este paso deja disponibles. Se referencian en pasos posteriores con la etiqueta entre dobles llaves.

- `{{from_id}}` *(int)* — Id del usuario
- `{{message_id}}` *(int)* — Id del mensaje
- `{{from_name}}` *(text)* — Nombre del usuario
- `{{from_username}}` *(text)* — Nombre de la cuenta. Nombre de usuario del usuario que envió el mensaje. Por defecto los usuarios en Telegram no tienen nombre de usuario, por lo que solo las personas que tienen su número de teléfono pueden enviarle mensajes. Si un usuario tiene nombre de usuario, cualquiera puede enviarle mensajes a través del enlace https://t.me/nombredeusuario y aparecerá en la búsqueda de Telegram con el nombre de usuario.
- `{{chat_id}}` *(text)* — Id del chat
- `{{text}}` *(text)* — Mensaje del usuario
- `{{reply_to_message_username}}` *(text)* — Nombre del usuario mencionado
- `{{reply_to_message_text}}` *(text)* — Texto del usuario mencionado
- `{{file_id}}` *(text)* — Id del documento. Id del documento incluido en la respuesta. Utiliza la opción 'Obtener la URL de un fichero' para convertir el Id del fichero en una URL
- `{{file_name}}` *(text)* — Nombre del fichero
- `{{file_extension}}` *(text)* — Extensión del fichero
- `{{document_url}}` *(text)* — URL del documento

## Cuenta

Necesita una cuenta de Telegram Bot conectada en Botize: https://botize.com/es/app/telegrambot/authenticate

## Esta app

Todos los disparadores y acciones de Telegram Bot: https://botize.com/es/app/telegrambot.md

## Cómo montar esto

Un asistente de IA (Claude, ChatGPT, Cursor…) puede crear y editar estas tareas en la cuenta del usuario a través del conector MCP de Botize, incluido en todos los planes:

    https://webhook.botize.es/mcp

- Guía de conexión: https://botize.com/es/mcp
- Mapa para agentes: https://botize.com/llms.txt
- Cuenta nueva: https://botize.com/es/join (500 operaciones gratis, sin tarjeta)

---
Resumen legible por máquinas para asistentes de IA. Versión para personas: https://botize.com/es/method/telegrambot/webhook_document