Bot de alerta no Telegram com Python: monitore seu robô.

Seu robô roda 24/5 numa VPS, mas você não fica olhando a tela o dia todo. Como saber que ele executou uma ordem, atingiu o alvo, ou — importante — travou com um erro? A resposta elegante: um bot do Telegram que te avisa no celular a cada evento. É simples de montar, gratuito, e transforma o Telegram numa ferramenta de verdade (bem diferente dos grupos de sinais). Vamos ao código.

01Criar o bot no BotFather

O Telegram tem um bot oficial pra criar bots — o BotFather. O processo leva 1 minuto:

02Pegar o seu chat ID

O bot precisa saber pra onde enviar. Você precisa do seu chat ID. O jeito simples: envie uma mensagem qualquer pro seu bot, e então consulte:

# 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 pro 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')})")

Anote o número que aparecer — é o seu chat ID, que também vai pro .env.

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

O coração de tudo — uma função que envia mensagem. Duas formas: com requests (mais simples, sem dependência) ou com a biblioteca python-telegram-bot (mais completa). Pra alertas, requests basta:

# 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 robô

Agora a parte boa: chamar enviar_alerta() nos eventos importantes do seu robô. Pegando o loop do nosso robô 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 robô!\n{str(e)}")
        time.sleep(30)

05Indo além: comandos (com cuidado)

O bot pode ir além de só avisar — pode receber comandos seus (ex: /status pra ver posições, /parar pra desligar o robô). Isso usa a biblioteca python-telegram-bot e a lógica de ler updates. Mas aqui entra um cuidado sério:

06Perguntas frequentes