Features

Prerequisites

Installation

nimble install telebot

Quick Start

Echo Bot Example

import telebot, asyncdispatch, logging, options, strutilsvar L= newConsoleLogger(fmtStr="$levelname, [$time]")addHandler(L)# Remember to strip your secret key to avoid HTTP errorsconst API_KEY= strip(slurp("secret.key"))proc updateHandler(bot: TeleBot, update: Update): Future[bool] {.async.}=ifnot update.message.isNil:let response= update.messageif response.text.len>0:let text= response.text      echo"Received message:"& text&" from:"& response.chat.id.stringdiscard await bot.sendMessage(response.chat.id,"Echo:"& text, parseMode="markdown", disableNotification=true, replyParameters= ReplyParameters(messageId: response.messageId))returntrueproc startCommandHandler(bot: TeleBot, command: Command): Future[bool] {.async.}=ifnot command.message.fromUser.isNil:let userName= command.message.fromUser.firstNamediscard await bot.sendMessage(command.message.chat.id,"Hello"& userName&"! Welcome to the Echo Bot.\\n\\nSend me any text and I will echo it back to you.", parseMode="markdown", disableNotification=true, replyParameters= ReplyParameters(messageId: command.message.messageId))returntruewhenisMainModule:when defined(local):let bot= newTeleBot(API_KEY,"http://127.0.0.1:8081")# For local API server testingelse:let bot= newTeleBot(API_KEY)  bot.setLogLevel(levelDebug)# Enable debug logging for development  bot.onUpdate(updateHandler)  bot.onCommand("start", startCommandHandler)# Register /start command handler  echo"Bot started. Polling for updates..."  bot.poll(timeout=300)

Advanced Usage

Sending Photos

import telebot, asyncdispatchconst API_KEY="YOUR_BOT_API_TOKEN"# Replace with your actual API keyproc photoHandler(bot: TeleBot, command: Command): Future[bool] {.async.}=discard await bot.sendPhoto(command.message.chat.id,"https://www.telegram-bot-api.com/logo.png", caption="Telegram Bot API Logo")returntruelet bot= newTeleBot(API_KEY)bot.onCommand("photo", photoHandler)bot.poll()

Inline Keyboard

import telebot, asyncdispatchconst API_KEY="YOUR_BOT_API_TOKEN"# Replace with your actual API keyproc inlineKeyboardHandler(bot: TeleBot, command: Command): Future[bool] {.async.}=let inlineKeyboard= newInlineKeyboardMarkup(    inlineKeyboardRows(      inlineKeyboardButtonRow(newInlineKeyboardButtonUrl("Go to Google","https://google.com"))    ))discard await bot.sendMessage(command.message.chat.id,"Click the button below:", replyMarkup= inlineKeyboard)returntruelet bot= newTeleBot(API_KEY)bot.onCommand("keyboard", inlineKeyboardHandler)bot.poll()

Handling Callback Queries

import telebot, asyncdispatchconst API_KEY="YOUR_BOT_API_TOKEN"# Replace with your actual API keyproc callbackQueryHandler(bot: TeleBot, callbackQuery: CallbackQuery): Future[bool] {.async.}=discard await bot.answerCallbackQuery(callbackQuery.id, text="Button clicked!")discard await bot.sendMessage(callbackQuery.message.chat.id,"Callback query data:"& callbackQuery.data)returntrueproc inlineKeyboardCallbackHandler(bot: TeleBot, command: Command): Future[bool] {.async.}=let inlineKeyboard= newInlineKeyboardMarkup(    inlineKeyboardRows(      inlineKeyboardButtonRow(newInlineKeyboardButtonCallbackData("Click me","button_clicked"))    ))discard await bot.sendMessage(command.message.chat.id,"Click the button below:", replyMarkup= inlineKeyboard)  bot.onCallbackQuery(callbackQueryHandler)# Register callback query handlerreturntruelet bot= newTeleBot(API_KEY)bot.onCommand("callback", inlineKeyboardCallbackHandler)bot.poll()

Configuration Options

let bot= newTeleBot(API_KEY,timeout=500,# timeout in secondsproxy="http://proxy.example.com:8080",parseMode="markdown")

Webhook Setup

# Configure webhookawait bot.setWebhook(url="https://your-domain.com/webhook",certificate="path/to/cert.pem"# Optional)# Start webhook serverbot.startWebhook(host="0.0.0.0",port=8443,certificate="path/to/cert.pem",privateKey="path/to/private.key")

Error Handling

try:discard await bot.sendMessage(chatId,"Hello!")except TelegramErroras e:error"Failed to send message:", e.messageexcept Exceptionas e:error"Unexpected error:", e.msg

Best Practices

Contributing

Version History

License

Resources

Support

Credits

Breaking Changes