# Buscar mensajes para una palabra clave — Telegram User

Método de Botize — `telegram_users.search_message` (acción).

Busca los mensajes más recientes que contengan una determinada palabra clave.

Es una acción: ocurre como paso de una tarea. Se pueden encadenar varias.

## Campos que se configuran

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

- `chat_id` *(string)* — Id del chat
- `query` *(string)* — Término de búsqueda
- `limit` *(number)* — Número máximo de mensajes a extraer (hasta un máximo de 100)

Además admite grupos de campos repetibles, con estos prefijos: `filter_*`. Son componentes compuestos (botones, filtros, teclados); el número final lo pone el usuario al añadirlos.

## Variables de salida

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

- `{{total_count}}` *(int)* — Total de mensajes encontrados. Número de total de mensajes encontrados con para el término de búsqueda indicado. Antes de aplicar cualquier filtro
- `{{messages}}` *(array)* — Messages. Lista de mensajes encontrados
- `{{messages.0.post_id}}` *(int)* — Id de la publicación. Identificador técnico estable del mensaje (único en el contexto de la API).
- `{{messages.0.post_number}}` *(int)* — Número de publicación. Número secuencial legible dentro del canal/tema (usado en enlaces permanentes; no es único globalmente).
- `{{messages.0.chat_id}}` *(int)* — Id del chat. Identificador único del chat en el que se publicó el post
- `{{messages.0.message_thread_id}}` *(int)* — Id del tema. Identificador único del tema del chat en el que se publicó el post
- `{{messages.0.url_message}}` *(text)* — URL del mensaje. Dirección URL del mensaje publicado
- `{{messages.0.message}}` *(text)* — Mensaje. Contenido del mensaje publicado
- `{{messages.0.message_html}}` *(text)* — Mensaje HTML. Mensaje en formato HTML si el mensaje incluye etiquetas HTML. En caso contrario el contenido de esta etiqueta es idéntico al de la etiqueta {{message}}
- `{{messages.0.post_datetime}}` *(text)* — Fecha-hora de publicación. Fecha y hora en la que se publicó el post
- `{{messages.0.image_url}}` *(text)* — URL imagen/vídeo/archivo. Dirección URL de la imagen relacionada con el post, vídeo o archivo del post
- `{{messages.0.user_id}}` *(int)* — Id de usuario. Identificador único para el usuario que publicó el post
- `{{messages.0.first_name}}` *(text)* — Nombre de usuario. Nombre del usuario que publicó el post
- `{{messages.0.username}}` *(text)* — Cuenta de usuario. Nombre de usuario del usuario que publicó el post
- `{{messages.0.reply_to_msg_id}}` *(int)* — En respuesta a la publicación Id. Identificador del mensaje al que el post está respondiendo (si corresponde)
- `{{messages.0.buttons}}` *(array)* — Botones. Array que contiene información sobre los botones adjuntos al post
- `{{messages.0.media}}` *(array)* — Media. Array que contiene información sobre las imágenes adjuntas al post
- `{{messages.0.media.0}}` *(text)* — Media 1. URL de la primera imagen adjuntada al post (si corresponde). Esta URL coincide con la indicada en la etiqueta {{image_url}}
- `{{messages.0.media.1}}` *(text)* — Media 2. URL de la imagen número 2 adjuntada al post (si corresponde)
- `{{messages.0.media.2}}` *(text)* — Media 3. URL de la imagen número 3 adjuntada al post (si corresponde)
- `{{messages.0.media.3}}` *(text)* — Media 4. URL de la imagen número 4 adjuntada al post (si corresponde)
- `{{messages.0.media.4}}` *(text)* — Media 5. URL de la imagen número 5 adjuntada al post (si corresponde)
- `{{messages.0.media.5}}` *(text)* — Media 6. URL de la imagen número 6 adjuntada al post (si corresponde)
- `{{messages.0.media.6}}` *(text)* — Media 7. URL de la imagen número 7 adjuntada al post (si corresponde)
- `{{messages.0.media.7}}` *(text)* — Media 8. URL de la imagen número 8 adjuntada al post (si corresponde)
- `{{messages.0.media.8}}` *(text)* — Media 9. URL de la imagen número 9 adjuntada al post (si corresponde)
- `{{messages.0.media.9}}` *(text)* — Media 10. URL de la imagen número 10 adjuntada al post (si corresponde)

## Cuenta

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

## Esta app

Todos los disparadores y acciones de Telegram User: https://botize.com/es/app/telegram_users.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/telegram_users/search_message