eztelegramapi 1.0.2

Simple Telegram helper

EzTelegramAPI

The simplest way to send Telegram messages from Python.
Four functions. One class. Zero boilerplate. Just send.
Not a bot framework — no receiving, no handlers, no polling.

---

🔗 GitHub: https://github.com/EmptyOverlord/EzTelegramAPI

📦 PyPI: https://pypi.org/project/eztelegramapi/

---

Installation

pip install EzTelegramAPI

---

Two ways to use it

1. Functions — quick and direct

No setup, just call and go. Perfect for one-off scripts and alerts.

from eztelegramapi import send_message, edit_message, delete_message, forward_message

TOKEN   = "123456789:AABBCCDDEEFFaabbccddeeff-1234567890"
CHAT_ID = 987654321

msg_id = send_message(TOKEN, CHAT_ID, "Hello from EzTelegramAPI! 🚀")
edit_message(TOKEN, CHAT_ID, msg_id, "Updated message ✏️")
delete_message(TOKEN, CHAT_ID, msg_id)
forward_message(TOKEN, from_chat_id=CHAT_ID, to_chat_id=987654322, message_id=msg_id)

2. Class — no repetition

Set your token and chat_id once — every method uses them automatically.
Pass chat_id= to any method to override for that call only.

from eztelegramapi import EzTelegramBot

bot = EzTelegramBot(token="123456789:AABBCCDDEEFFaabbccddeeff-1234567890", chat_id=987654321)

msg_id = bot.send_message("Hello from EzTelegramAPI! 🚀")  # → sends to 987654321
bot.edit_message(msg_id, "Updated message ✏️")
bot.delete_message(msg_id)

# forward_message uses bot.chat_id as to_chat_id by default
bot.forward_message(from_chat_id=987654322, message_id=msg_id)  # → forwards to 987654321

# override chat_id for a single call
bot.send_message("Alert!", chat_id=OTHER_CHAT_ID)

That's it. Seriously.

---

Why EzTelegramAPI?

	EzTelegramAPI	Other libraries
Setup	None	Config, classes, handlers...
Lines to send a message	1	5–20+
Dependencies	requests	Multiple
Learning curve	Minutes	Hours

---

API Reference

Functions

send_message(token, chat_id, text, *, return_message_id=True)

Parameter	Type	Description
token	str	Your bot token from @BotFather
chat_id	int	Target chat or user ID
text	str	Message text (supports emoji ✅)
return_message_id	bool	True (default) → returns message_id; False → returns raw requests.Response

Returns: int (message_id) or requests.Response

---

edit_message(token, chat_id, message_id, text)

Parameter	Type	Description
token	str	Your bot token from @BotFather
chat_id	int	Target chat or user ID
message_id	int	ID of the message to edit
text	str	New message text

Returns: requests.Response

---

delete_message(token, chat_id, message_id)

Parameter	Type	Description
token	str	Your bot token from @BotFather
chat_id	int	Target chat or user ID
message_id	int	ID of the message to delete

Returns: requests.Response

---

forward_message(token, from_chat_id, to_chat_id, message_id)

Parameter	Type	Description
token	str	Your bot token from @BotFather
from_chat_id	int	Chat to forward the message from
to_chat_id	int	Chat to forward the message to
message_id	int	ID of the message to forward

Returns: int (message_id of the forwarded message)

---

Class

EzTelegramBot(token, chat_id=None)

Parameter	Type	Description
token	str	Your bot token from @BotFather
chat_id	int | None	Default chat ID used by all methods — pass chat_id= to any method to override for that call

All methods mirror the functions above but without token.

---

Examples

Live progress update:

import time

msg_id = bot.send_message("⏳ Job started...")
time.sleep(5)
bot.edit_message(msg_id, "✅ Job finished!")

Clean up after yourself:

msg_id = bot.send_message("⏳ Processing...")
do_work()
bot.delete_message(msg_id)

Alert on error:

try:
    risky_operation()
except Exception as e:
    bot.send_message(f"🔴 Error: {e}")

Cron job notification:

from datetime import datetime

now = datetime.now().strftime("%Y-%m-%d %H:%M")
bot.send_message(f"✅ Backup finished at {now}")

---

How to get your Chat ID

1. Start a chat with @userinfobot
2. Send /start
3. It replies with your numeric ID — use that as chat_id

---

License

MIT