Skip to main content

Manejo Del Teclado En Línea De Aiogram: Configuración Y Ejemplos De Uso

  • Olegario Cayetano Roldán Contreras
  • Artículos

En el mundo de los bots, el procesamiento de la entrada del usuario es una de las tareas m s importantes. La plataforma Telegram ofrece a los desarrolladores la posibilidad de crear bots a trav s de una variedad de herramientas y bibliotecas. Una de las bibliotecas populares para crear bots en Telegram es aiogram.

Una de las caracter sticas importantes de aiogram es el uso del teclado en l nea, un tipo especial de teclado que permite al usuario seleccionar opciones sin tener que escribir texto manualmente. El teclado en l nea se muestra como botones debajo del texto del mensaje y puede contener botones de texto e im genes.

Configurar y usar un teclado en l nea con aiogram es bastante simple. Para empezar, debe crear un objeto InlineKeyboardMarkup y agregarle botones utilizando el m todo add (). Cada bot n es un objeto InlineKeyboardButton que acepta el texto del bot n y el par metro opcional callback_data: los datos que se pasar n al bot cuando se haga clic en el bot n.

Despu s de crear un teclado en l nea, puede agregarlo al mensaje utilizando el m todo reply_markup del objeto SendMessage o EditMessageText. Al hacer clic en el bot n Telegram enviar un mensaje de vuelta con los datos que se han pasado en el par metro callback_data del bot n. Esto permite al desarrollador procesar las acciones del usuario y realizar las operaciones deseadas.

  1. Procesamiento de teclado en l nea aiogram
  2. Configuraci n del bot y creaci n de teclado en l nea
  3. Manejo de pulsaciones de teclado en l nea
  4. Ejemplos de uso del teclado en l nea

Procesamiento de teclado en l nea aiogram

La biblioteca aiogram proporciona herramientas simples y f ciles de usar para crear, configurar y procesar teclados en l nea. Para comenzar con el teclado en l nea, necesitar el objeto InlineKeyboardMarkup. .

:

from aiogram import types

inline_keyboard = types.InlineKeyboardMarkup(row_width=2)

button1 = types.InlineKeyboardButton(" 1", callback_data="button1")

button2 = types.InlineKeyboardButton("  2", callback_data="button2")

button3 = types.InlineKeyboardButton(" 3", callback_data="button3")

inline_keyboard.add(button1, button2, button3)

En el ejemplo anterior, se crea un teclado en l nea con tres botones. Cada bot n tiene un texto y un identificador nico que se pasa al controlador cuando se hace clic en el bot n.

A continuaci n, debe crear un controlador para el teclado en l nea:

from aiogram import types

@dp.callback_query_handler(text="button1")

async def process_button1(callback_query: types.CallbackQuery):

# Tu c digo

pass

En el controlador, puede realizar cualquier acci n que se requiera en su bot al hacer clic en un bot n espec fico. Por ejemplo, enviar mensajes o procesar los datos recibidos.

Para una f cil operaci n con el teclado en l nea, aiogram tambi n ofrece la posibilidad de cambiar y actualizar el teclado, as como recibir los datos que el usuario envi al hacer clic en el bot n.

Utilice el teclado en l nea en su bot para crear una experiencia de usuario c moda e intuitiva.

Configuraci n del bot y creaci n de teclado en l nea

Configuraci n del bot

Antes de crear y utilizar el teclado en l nea, debe configurar el bot. Para hacer esto, necesitar el token de su bot, que se puede obtener de @BotFather en Telegram.

Cree un nuevo proyecto utilizando el marco aiogram e instale aiogram si a n no est instalado:

pip install aiogram

Importe los m dulos necesarios:

from aiogram import Bot, Dispatcher, types

Crea una instancia del bot pasando el token de tu bot al constructor:

bot = Bot(token= YOUR_BOT_TOKEN )

Inicializar el despachador:

dp = Dispatcher(bot)

Ahora tu bot est listo para usar.

Crear un teclado en l nea

Un teclado en l nea es un conjunto de botones que aparecen en un mensaje y permiten al usuario realizar ciertas acciones. En aiogram, la creaci n de un teclado en l nea se realiza mediante la clase InlineKeyboardMarkup.

Cree una lista de los botones que desea Mostrar en el teclado:

buttons = [types.InlineKeyboardButton(text= Button 1 , callback_data= button1 ),

types.InlineKeyboardButton(text= Button 2 , callback_data= button2 )

, InlineKeyboardMarkup:

keyboard = types.InlineKeyboardMarkup(row_width=2)

add:

keyboard.add(*buttons)

Ahora tiene un teclado en l nea listo para enviar al usuario con el m todo send_message:

await bot.send_message(chat_id=user_id, text= Choose an action: , reply_markup=keyboard)

Al hacer clic en el bot n, el usuario recibir  un callback_data que se puede utilizar para manejar la acci n:

@dp.callback_query_handler(lambda query: query.data == button1 )

Se llamar al controlador cuando se haga clic en el"bot n 1".

Por lo tanto, puede configurar el bot y crear un teclado en l nea para la interacci n del usuario.

  1. Manejo de pulsaciones de teclado en l nea
  2.            :

    from aiogram.types import InlineKeyboardMarkup, InlineKeyboardButton

  3. from aiogram import Bot, Dispatcher, types
  4. @dp.callback_query_handler(lambda callback_query: True)

    async def process_callback_button(callback_query: types.CallbackQuery):

  5. if callback_query.data == "button1":
  6. await bot.send_message(callback_query.from_user.id, "        2")

    process_callback_button , . callback_query.data , , .

  7. InlineKeyboardMarkup add aiogram.types. :
  8. bot = Bot(token="YOUR_TOKEN")

    dp = Dispatcher(bot)

def generate_keyboard():