# Instantáneamente cuando se recibe un mensaje de texto — Telegram Bot

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

Se acciona cada vez que un usuario envía un mensaje de texto al bot o a un grupo/canal en el que se encuentre el bot.

- Puedes elegir que la tarea se active ante cualquier mensaje recibido o bien solo ante mensajes que vengan precedidos de un comando (una palabra) específico.

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.

- `type` *(string, one of: "any" = La tarea se ejecuta al recibir cualquier mensaje; "command" = Solo se ejecuta al recibir mensajes que empiecen con esta palabra, default: "any")*
- `command` *(string)*
- `chat_source` *(string, one of: "any" = La tarea se ejecuta al recibir mensajes de cualquier chat; "target" = Solo se ejecuta al recibir mensajes 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. ID del usuario que envió el mensaje.
- `{{message_id}}` *(int)* — Id del mensaje. ID del mensaje.
- `{{message_thread_id}}` *(int)* — Id del grupo. ID del tema si el mensaje proviene de un grupo con distintos temas.
- `{{from_name}}` *(text)* — Nombre del usuario. Nombre del usuario que envió el mensaje.
- `{{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. ID del chat donde se envió el mensaje.
- `{{text}}` *(text)* — Mensaje del usuario. Texto del mensaje.
- `{{reply_to_message_username}}` *(text)* — Nombre del usuario mencionado. Nombre de usuario del mensaje al que se está respondiendo.
- `{{reply_to_message_text}}` *(text)* — Texto del usuario mencionado. Texto del mensaje al que se está respondiendo.
- `{{type}}` *(text)* — Tipo de mensaje. Tipo de mensaje.
- `{{forward_from_id}}` *(int)* — Chat Id desde donde se reenvió. Id del chat desde el cual este mensaje haya sido reenviado
- `{{story_id}}` *(int)* — Id de la historia. Sólo viene relleno cuando el mensaje es una historia de Telegram compartida. Telegram no da a los bots el contenido de una historia, sólo el canal que la publicó y este id.
- `{{story_chat_id}}` *(text)* — Id del canal de la historia. Id del canal que publicó la historia
- `{{story_chat_title}}` *(text)* — Nombre del canal de la historia. Nombre del canal que publicó la historia
- `{{story_chat_username}}` *(text)* — Alias del canal de la historia. Alias del canal que publicó la historia
- `{{story_url}}` *(text)* — URL de la historia. Enlace público a la historia. Vacío si el canal no tiene alias
- `{{language_code}}` *(text)* — Código de idioma. Etiqueta IETF del idioma del cliente de Telegram del usuario ('es', 'en-GB', 'pt-BR'). Es opcional: Telegram sólo la envía si el usuario tiene idioma configurado, así que puede llegar vacía.

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