Contenido del curso
Cómo capturar mensajes de Telegram en Python
Conectar un bot de Telegram con Python implica entender cómo viaja la información desde el chat hasta tu consola. Aquí verás cómo capturar mensajes de Telegram en Python usando la API de getUpdates, identificar al usuario y procesar el texto en tiempo real, ideal para quienes construyen bots conversacionales con OpenAI.
¿Cómo funciona la URL de getUpdates en Telegram?
La API de Telegram expone un endpoint que devuelve en formato JSON todos los mensajes recientes enviados a tu bot. Esa URL es la puerta de entrada para inspeccionar qué está llegando antes de programar la lógica en Python.
Para usarla, copias la URL desde tu código y reemplazas la sección del token por el que generó BotFather al crear tu bot. Al pegarla en el navegador, obtendrás una vista con todos los mensajes registrados.
¿Qué es getUpdates en Telegram? Es un método de la API que devuelve los mensajes recientes recibidos por tu bot en formato JSON. Lo consultas pegando la URL con tu token en el navegador o desde código.
¿Qué información devuelve Telegram sobre cada mensaje?
Cuando envías un Hola desde el chat y refrescas la página del navegador, Telegram entrega un bloque de datos detallado por cada mensaje. Esto te permite saber exactamente quién escribió y qué dijo.
Esta estructura es la que tu script en Python debe leer y filtrar para quedarse solo con lo relevante.
¿Cómo captura Python los mensajes del bot?
En el editor, el código accede a la respuesta JSON y extrae los campos clave. La idea es traducir esa información cruda del navegador en variables que puedas usar dentro de tu lógica.
Al ejecutar el script y enviar Soy Carly desde Telegram, la consola imprime tres datos: el primer nombre del usuario, el ID asociado y el contenido del mensaje. Esa terna es suficiente para personalizar respuestas o registrar conversaciones.
¿Qué datos extrae Python de un mensaje de Telegram? Captura el first_name, el id del usuario y el text del mensaje. Con esos tres campos puedes identificar quién escribe y qué necesita.
¿Por qué se usa time.sleep en el bot?
La función time.sleep pausa el script un segundo antes de volver a consultar la API. Telegram no empuja los mensajes hacia tu código, así que tú debes preguntarle de forma constante si hay algo nuevo.
Este patrón se llama polling y evita saturar el servidor con peticiones inmediatas. Cada segundo, Python pregunta a Telegram qué mensajes han llegado y los procesa uno a uno. Cuando envías Nunca pares de aprender, el bot lo recibe en el siguiente ciclo de consulta.
¿Qué sigue después de capturar el mensaje?
Una vez que el script identifica al usuario y lee el texto, el siguiente paso es conectar esa entrada con la función main del programa y enviarla a OpenAI. Ahí es donde tu bot deja de ser un simple eco y empieza a generar respuestas inteligentes.
La secuencia lógica queda así:
Con esta base ya tienes el flujo de entrada resuelto. ¿Cómo conectarías esta captura con tu propio caso de uso? Cuéntame en los comentarios qué tipo de bot estás construyendo.
Paolo Joaquin Pinto Perez
Estudiante
Kevin Henriquez
Estudiante
Facundo Salade
Estudiante
Leonardo Zadyt Molina Renteria
Estudiante
Marco Alonso Quiriz Franquiz
Estudiante
Percy Tejada
Estudiante
Percy Soria Del Castillo
Estudiante
Marlon Edmundo Marroquin Valenzuela
Estudiante
PEDRO ANTONIO MARTINEZ MARADIAGA
Estudiante
Alvaro Lozano Rodríguez
Estudiante
Arístides Pérez Hernández
EstudianteArístides Pérez Hernández
EstudianteArístides Pérez Hernández
Estudiante
Luis Miguel Rodríguez
Estudiante
Joseph Corona
EstudiantePercy Soria Del Castillo
Estudiante
Martin Mendez
EstudianteUn hack para hacer la division en el print de lineas
print("-"*20)
En lugar de:
print("---")
Gracias Paolo!
Estuve teniendo problemas con la variable del entorno. Después de buscar un rato, encontré que es necesario añadir este código para que Python interactúe de manera correcta con la variable:
import os
token = os.environ.get('nombre_de_la_variable')
Aquí ya corrigieron la línea message = update['result'] por message = update['message']
Cuando entro a: https://api.telegram.org/bot{token}/getUpdates  (con mi token) me da error 404 {"ok":false,"error_code":404,"description":"Not Found"}
Hola Verifica que no estes ingresando un \ después de la palabra bot.
https://api.telegram.org/bot\<token>/METHOD_NAME
En METHOD_NAME prueba con getMe o getUpdates como en el curso
tu reemplazo debe incluir los corchetes {token}
Nunca paren de actualizar los cursos
Gracias por la información
Saludos. 19/03/2026 Quien puede decirme ppor que no me funciona este codigo, lo estoy usando con colap, tambien lo use en vscode y no responde exitosamente. Error en la petición: 404
import requests
import time
def get_updates(token, offset=None):
url = f"https://api.telegram.org/bot{token}/getUpdates"
params = {"offset": offset} if offset else {}
response = requests.get(url, params=params)
if response.status_code != 200:
print("Error en la petición:", response.status_code)
return {}
return response.json()
def print_new_messages(token):
offset = None
while True:
updates = get_updates(token, offset)
if "result" in updates:
for update in updates["result"]:
message = update.get("message")
if not message:
offset = update["update_id"] + 1
continue
user_id = message["from"]["id"]
username = message["from"].get("first_name", "Sin nombre")
text = message.get("text", "(sin texto)")
print(f"Usuario: {username} ({user_id})")
print(f"Mensaje: {text}")
print("-" * 20)
offset = update["update_id"] + 1
time.sleep(2)
token = "aqui token"
print_new_messages(token)
¿Qué pasa si el bot recibe muchos mensajes?
Si tu aplicación escala y recibe decenas de mensajes por segundo, el método de consultar manualmente con un ciclo y pausas creará un cuello de botella al procesarlos uno por uno. En escenarios de alta demanda, la estrategia profesional es cambiar a Webhooks, donde le das a Telegram una URL de tu servidor para que te envíe los datos automáticamente solo cuando alguien escriba. Sin embargo, para la etapa de desarrollo local, el método de sondeo actual es la forma más rápida y efectiva de validar tu lógica.
¿Es posible leer mensajes sin usar el navegador?
Absolutamente, el navegador web es solo una herramienta visual inicial para que los humanos podamos entender cómo se estructura la información que envía la plataforma. En un entorno real, tu código de Python hace exactamente el mismo trabajo de forma invisible usando librerías como requests para descargar y procesar el paquete de datos en la memoria. Una vez que dominas la estructura de los mensajes, tu terminal se encarga de todo el ciclo de recepción y respuesta de manera 100% automatizada sin requerir interfaces gráficas.
¿Puedo usar esto para enviar archivos multimedia?
La misma lógica de conexión sirve para manejar cualquier tipo de contenido, ya que cuando un usuario envía una foto o un audio, la API registra ese evento exactamente en la misma URL. La única diferencia es que tu código en Python deberá buscar llaves como photo o voice en lugar de text, las cuales contendrán un identificador único del archivo. Con ese identificador, puedes programar a tu bot para descargar la imagen, procesarla e incluso responder enviando sus propios archivos multimedia de vuelta al usuario.
Hola! Hice el mismo codigo y solo obtengo lo siguiente: Respuesta completa de la API: {'ok': True, 'result': []}
Alguien me ayuda?
Está correcto, ahora escribe algo en tu bot y refresca tu prueba.
Por las dudas.
Si estoy con el python abierto desde VS code el link: https://api.telegram.org/bot{toke}/getUpdates no funciona. Si corto el script de python empieza a cargar.
Osea que si está corriendo el script que tenemos de ejemplo la url no va a responder.
Solamente tira esto:
{
"ok": true,
"result": [
]
}
Espero sirva
Abrazoooo
