How to create a Telegram bot

Telegram bots are pretty cool. They can do lots of things! Like automate tasks, talk to users, and even work with other services. Want to make a simple notification bot? Or maybe a complicated game bot? The Telegram Bot API has you covered. Let's walk through making a Telegram bot using Python.

Why Make a Telegram Bot?

Telegram bots can do tons of stuff. For example:

• Automation: They can do boring tasks for you. Like sending reminders.
• Customer Service: They can answer questions right away.
• Entertainment: Games and quizzes? Easy!
• E-commerce: Selling stuff? Bots can help.
• Information Delivery: News, weather, stock prices… you name it.

The sky's the limit! Plus, the Telegram Bot API is easy to use. Great for beginners and experts alike.

What You Need

Before we start, make sure you have these things:

• Python 3.6 or newer: Get it from the official website.
• A Telegram Account: You'll need it to use your bot.
• Basic Python Skills: Know the basics of Python.
• A Code Editor: Use something like VS Code.

Step 1: Get Your Workspace Ready

Let's get your workspace ready. We'll make a folder and install the stuff we need.

1. Make a Folder: Pick a spot on your computer. Make a new folder for your bot. Name it "my_telegram_bot" or something.
2. Make a Virtual Environment (Optional, but Good): This keeps your project separate. Open your computer's terminal in your project folder. Then, type this:

python -m venv venv

To turn it on, do this:

• On Windows:

venv\Scripts\activate

• On macOS and Linux:

source venv/bin/activate

3. Install the python-telegram-bot Library: This helps you talk to the Telegram Bot API. Use this command:

pip install python-telegram-bot --upgrade

This will download and install the library.

Step 2: Talk to BotFather

Next, we need to create our bot using BotFather on Telegram. BotFather is like the bot maker bot!

1. Find BotFather: Open Telegram and search for "BotFather". Make sure it has the verified badge.
2. Make a New Bot: Send the command /newbot to BotFather.
3. Name Your Bot: BotFather will ask for a name. This is what people will see. Like "My Awesome Bot".
4. Pick a Username: Now pick a username. It has to be unique and end with "bot". Like "MyAwesomeBot".
5. Get Your API Token: BotFather will give you an API token. This is like a password for your bot. Keep it safe!

Important: Keep your API token secret. Don't share it! If you think someone stole it, tell BotFather to make a new one.

Step 3: Write the Bot's Code

Time to write the Python code. This code will handle messages and send replies.

1. Make a Python File: Create a new file named bot.py in your project folder.
2. Import the Libraries: Add these lines to the top of your file:

from telegram import Update from telegram.ext import ApplicationBuilder, CommandHandler, ContextTypes

3. Tell it the Token: Replace YOUR_API_TOKEN with the token you got from BotFather.

TOKEN = "YOUR_API_TOKEN" app = ApplicationBuilder().token(TOKEN).build()

4. Make a /start Command: This is what new users will see.

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE): await context.bot.send_message(chat_id=update.effective_chat.id, text="I'm a bot, please talk to me!")

This code tells the bot what to do when someone types /start.

5. Make a /help Command: This tells people how to use your bot.

async def help_command(update: Update, context: ContextTypes.DEFAULT_TYPE): await context.bot.send_message(chat_id=update.effective_chat.id, text="This is a simple bot. Use /start to begin.")

6. Tell the Bot About the Commands: Connect the commands to the bot.

start_handler = CommandHandler('start', start) help_handler = CommandHandler('help', help_command) app.add_handler(start_handler) app.add_handler(help_handler)

7. Start the Bot: This keeps the bot running and listening for messages.

app.run_polling()

Here's all the code together:

from telegram import Update from telegram.ext import ApplicationBuilder, CommandHandler, ContextTypes TOKEN = "YOUR_API_TOKEN" async def start(update: Update, context: ContextTypes.DEFAULT_TYPE): await context.bot.send_message(chat_id=update.effective_chat.id, text="I'm a bot, please talk to me!") async def help_command(update: Update, context: ContextTypes.DEFAULT_TYPE): await context.bot.send_message(chat_id=update.effective_chat.id, text="This is a simple bot. Use /start to begin.") app = ApplicationBuilder().token(TOKEN).build() start_handler = CommandHandler('start', start) help_handler = CommandHandler('help', help_command) app.add_handler(start_handler) app.add_handler(help_handler) app.run_polling()

Step 4: Run the Bot!

To run your bot, open your computer's terminal in your project folder. Then, type this:

python bot.py

Your bot should be running now! Find your bot on Telegram and send it the /start command. You should see the "I'm a bot, please talk to me!" message.

Step 5: Add More Stuff

Now that you have a basic bot, you can add more things. Here are some ideas:

• Echo Bot: Repeat what the user says.
• Calculator Bot: Do simple math.
• Weather Bot: Tell you the weather.

To add more stuff, you need to create more handlers. To make an echo bot, use this code:

from telegram import Update from telegram.ext import ApplicationBuilder, CommandHandler, MessageHandler, ContextTypes, filters TOKEN = "YOUR_API_TOKEN" async def start(update: Update, context: ContextTypes.DEFAULT_TYPE): await context.bot.send_message(chat_id=update.effective_chat.id, text="I'm a bot, please talk to me!") async def help_command(update: Update, context: ContextTypes.DEFAULT_TYPE): await context.bot.send_message(chat_id=update.effective_chat.id, text="This is a simple bot. Use /start to begin.\nTo start, use /start") async def echo(update: Update, context: ContextTypes.DEFAULT_TYPE): await context.bot.send_message(chat_id=update.effective_chat.id, text=update.message.text) app = ApplicationBuilder().token(TOKEN).build() start_handler = CommandHandler('start', start) help_handler = CommandHandler('help', help_command) echo_handler = MessageHandler(filters.TEXT & (~filters.COMMAND), echo) app.add_handler(start_handler) app.add_handler(help_handler) app.add_handler(echo_handler) app.run_polling()

This code makes the bot repeat anything you say.

More Advanced Things

Cool Buttons!

You can add buttons to your messages. This is good for menus or saying "yes" or "no".

from telegram import InlineKeyboardButton, InlineKeyboardMarkup, Update from telegram.ext import ApplicationBuilder, CommandHandler, CallbackQueryHandler, ContextTypes TOKEN = "YOUR_API_TOKEN" async def start(update: Update, context: ContextTypes.DEFAULT_TYPE): keyboard = [ [InlineKeyboardButton("Option 1", callback_data='1'), InlineKeyboardButton("Option 2", callback_data='2')], [InlineKeyboardButton("Option 3", callback_data='3')] ] reply_markup = InlineKeyboardMarkup(keyboard) await update.message.reply_text('Please choose:', reply_markup=reply_markup) async def button(update: Update, context: ContextTypes.DEFAULT_TYPE): query = update.callback_query await query.answer() await query.edit_message_text(text=f"Selected option: {query.data}") async def help_command(update: Update, context: ContextTypes.DEFAULT_TYPE): await context.bot.send_message(chat_id=update.effective_chat.id, text="This is a simple bot. Use /start to begin.\nTo start, use /start") app = ApplicationBuilder().token(TOKEN).build() start_handler = CommandHandler('start', start) help_handler = CommandHandler('help', help_command) app.add_handler(start_handler) app.add_handler(help_handler) app.add_handler(CallbackQueryHandler(button)) app.run_polling()

This code makes buttons that say "Option 1", "Option 2", and "Option 3".

Remembering Things

If your bot needs to remember things, like scores or settings, you can use a database or a file. For small things, you can use context.user_data.

In Conclusion

Making a Telegram bot with Python isn't too hard. You learned how to set up your workspace, create a bot, write code, and add more stuff. Now you can make your own bots to do all sorts of things! Don't be afraid to try new things. Making telegram bots with Python and the Telegram Bot API is powerful. Bots are more important than ever these days!

The trick is to practice. Start with simple projects and make them more complicated. Have fun building!