Полный гайд: как сделать клавиатуру telebot в Python

from telebot import types

markup = types.ReplyKeyboardMarkup(resize_keyboard=True)
btn1 = types.KeyboardButton('Купить')
btn2 = types.KeyboardButton('О компании')
markup.add(btn1, btn2)

bot.send_message(chat_id, 'Выберите действие:', reply_markup=markup)

Реализация Inline-клавиатуры для интерактивных меню

Inline-клавиатуры требуют использования класса types.InlineKeyboardMarkup и InlineKeyboardButton. В отличие от Reply-варианта, здесь каждая кнопка должна иметь уникальный callback_data, который будет отправляться серверу Telegram при клике. Этот параметр работает как идентификатор действия, который ваш обработчик сообщений сможет распознать.Структура Inline-меню более гибкая: вы можете разместить кнопки в несколько рядов, создавая сложную сетку взаимодействия. Для добавления кнопок в ряд используется метод row(), который позволяет группировать элементы визуально. Если вам нужно добавить прямую ссылку вместо действия, используйте параметр url, а не callback_data.Код создания сложного меню с разделением на блоки выглядит следующим образом:

inline_kb = types.InlineKeyboardMarkup()
btn1 = types.InlineKeyboardButton('Цена', callback_data='price_info')
btn2 = types.InlineKeyboardButton('Доставка', callback_data='delivery_info')
inline_kb.row(btn1, btn2)

btn3 = types.InlineKeyboardButton('Оформить', callback_data='order_submit')
inline_kb.add(btn3)

bot.send_message(chat_id, 'Детали заказа:', reply_markup=inline_kb)

Обратите внимание, что длина строки callback_data ограничена 64 символами в протоколе Telegram, поэтому для передачи сложных параметров используйте JSON-кодирование или сокращенные идентификаторы.

Обработка нажатий и логика работы бота

После создания визуальной части необходимо написать код, который будет реагировать на действия пользователя. Для Reply-клавиатуры достаточно использовать стандартный хендлер сообщений @bot.message_handler, так как нажатие кнопки просто отправляет текст сообщения. Однако для Inline-клавиатур требуется отдельный обработчик типа CallbackQuery, который перехватывает событие нажатия до того, как текст будет отправлен в чат. Если вы не вызовете метод answer_callback_query, пользователь увидит «вращающийся» индикатор загрузки, а действие не выполнится. Это частая ошибка новичков, приводящая к ощущению, что бот «завис».

⚠️ Внимание: Никогда не используйте reply_markup с Inline-клавиатурой внутри обычного хендлера сообщений без предварительной обработки, так как это может вызвать конфликт типов данных и ошибку 400 Bad Request.

Динамическое управление клавиатурой

В реальных сценариях кнопки часто должны меняться в зависимости от состояния пользователя или данных из базы данных. Вы можете удалять клавиатуру, отправляя сообщение с параметром reply_markup=types.ForceRemove() или reply_markup=types.ReplyKeyboardRemove(). Это полезно, когда пользователь завершил выбор или перешел в другой режим работы.Для обновления существующего сообщения с новой клавиатурой используйте метод edit_message_text или edit_message_reply_markup. Это позволяет обновлять интерфейс без дублирования сообщений в чате, сохраняя чистоту истории переписки. Данный подход особенно актуален для ботов-магазинов, где нужно менять доступные товары в зависимости от наличия на складе.