Configuração do Telegram

Para controlar o seu bot e receber notificações em tempo real, precisa de configurar um bot privado no Telegram. Isso garante que apenas você tem acesso aos seus dados de trading e controlos.

1. Criar um Bot via BotFather

BotFather é o bot oficial do Telegram para gerir outros bots. Abra o Telegram, inicie um chat com o BotFather e siga os passos para criar o seu novo assistente de trading.

Abrir @BotFather ↗

2. Adicionar Token do Bot à Configuração

Quando o BotFather lhe der o token da API HTTP, precisa de o adicionar à configuração do seu bot. Este token atua como uma senha segura para o seu bot.

Caminho do ficheiro:

Code

byninja-trading-bot/src/telegram/config/config_telegram.py

Substitua o seguinte campo pelo seu token:

Code

TELEGRAM_BOT_TOKEN = "your_telegram_bot_token"

3. Proteger o Seu Bot (Encontrar o ID do Chat)

Para segurança absoluta, o seu bot só deve responder a SI. Conseguimos isso ligando-o ao seu ID de Chat pessoal do Telegram. Ninguém mais poderá executar comandos.

Primeiro, navegue até ao diretório fonte:

Code

cd byninja-trading-bot/src

Em seguida, ative o seu ambiente virtual Python. Se ainda não configurou isto, consulte o guia de Início Rápido.

Code

source ../env/bin/activate

Ver Guia de Configuração do Ambiente ↗

Finalmente, execute o script de configuração do Telegram:

Code

python3 -c "from telegram.setup import main; main()"

O script de configuração está agora à espera que você envie uma mensagem ao bot a partir da sua conta pessoal do Telegram.

Code

⚠️  Telegram Bot Setup - Find Your Chat ID

🔍 Checking Telegram API connection...
TelegramBot - INFO - Telegram connected | Bot: @Bot

🎯 Finding Chat ID...
============================================================
🔍 Waiting for message from you...
IMPORTANT: First find the bot in Telegram and send it ANY message
1. Open Telegram
2. Find @Bot
3. Press START or send any message
4. Wait 10 seconds...
⏹️ To stop press Ctrl+C

🔍 Checking updates... status: 200
📭 No messages found. Send bot a message in Telegram...
🔍 Checking updates... status: 200
📭 No messages found. Send bot a message in Telegram...
🔍 Checking updates... status: 200

Assim que enviar uma mensagem, o bot irá reconhecê-lo instantaneamente e fornecer o seu ID de Chat seguro.

Code

✅ Found new message!
👤 From: User
📩 Text: &#039;hi&#039;
🆔 Your Chat ID: 449933911
💡 Add to config.py: TELEGRAM_CHAT_ID = &#039;449933911&#039;

✅ Chat ID obtained successfully!
🆔 Your Chat ID: 449933911

💾 Add this to config_telegram.py:
TELEGRAM_CHAT_ID = "449933911"

🧪 Testing message sending capability...
🎉 Test message sent! Check Telegram.

Copie o seu ID de Chat único e adicione-o ao mesmo ficheiro de configuração:

Code

TELEGRAM_CHAT_ID = "your_private_telegram_chat_id"

Dica Profissional: Use um Editor de Código

Para uma experiência muito melhor ao editar ficheiros de configuração, recomendamos usar um editor de código profissional como o Visual Studio Code.

Download VS Code ↗

Próximo Passo: Configuração do Bot →