Bot de alerta no Telegram com Python: monitore seu bot.

Your bot runs 24/5 on a VPS, but you don't stare at the screen all day. How to know it executed an order, hit the target, or — importantly — crashed with an error? The elegant answer: a Telegram bot that alerts you on your phone for each event. Simple to build, free, and transforms Telegram into a real tool (very different from signal groups). Let's get to the code.

01Criar o bot no BotFather

Telegram has an official bot to create bots — BotFather. The process takes 1 minute:

02Pegar o seu chat ID

The bot needs to know where to send. You need your chat ID. The simple way: send any message to your bot, then query:

# pegar_chat_id.py — rode uma vez
import requests, os

TOKEN = os.getenv("TELEGRAM_TOKEN")
url = f"https://api.telegram.org/bot{TOKEN}/getUpdates"
resp = requests.get(url).json()

# envie uma msg for the bot ANTES de rodar isto
for r in resp.get("result", []):
    chat = r["message"]["chat"]
    print(f"Chat ID: {chat['id']} ({chat.get('first_name')})")

Note the number that appears — that's your chat ID, which also goes in the .env.

03Enviar mensagem (a função-base)

The heart of everything — a function that sends a message. Two ways: with requests (simpler, no dependency) or with the python-telegram-bot library (more complete). For alerts, requests is enough:

# telegram_alerta.py
import requests, os

TOKEN = os.getenv("TELEGRAM_TOKEN")
CHAT_ID = os.getenv("TELEGRAM_CHAT_ID")

def enviar_alerta(mensagem: str):
    url = f"https://api.telegram.org/bot{TOKEN}/sendMessage"
    dados = {
        "chat_id": CHAT_ID,
        "text": mensagem,
        "parse_mode": "HTML",   # permite negrito etc.
    }
    try:
        requests.post(url, data=dados, timeout=10)
    except Exception as e:
        print(f"Falha ao enviar Telegram: {e}")

# teste
enviar_alerta("✅ Bot de alerta conectado!")

04Integrar ao seu bot

Now the good part: calling send_alert() on your bot's important events. Taking the loop from our bot MT5 ou Binance:

from telegram_alerta import enviar_alerta

while True:
    try:
        df = puxar_candles(...)
        sinal = calcular_sinal(df)

        if sinal == "COMPRA" and not tem_posicao():
            resultado = comprar(...)
            enviar_alerta(f"🟢 COMPRA executada\n"
                          f"Ativo: WIN | Preço: {resultado.price}\n"
                          f"Stop: {stop} | Alvo: {alvo}")

        time.sleep(60)
    except Exception as e:
        # alerta de ERRO — o mais importante de todos
        enviar_alerta(f"🔴 ERRO no bot!\n{str(e)}")
        time.sleep(30)

05Indo além: comandos (com cuidado)

The bot can go beyond just alerting — it can receive commands from you (e.g., /status to check positions, /stop to shut down the bot). This uses the python-telegram-bot library and update reading logic. But here comes a serious caution:

06Preguntas frecuentes