🤖 Discord Bet Tracker Bot (Google Sheets Integration)

Python automation tool that monitors Discord chats in real-time and automatically logs bets/signals into a Google Sheets spreadsheet.

🚀 Features

• Real-Time Monitoring: Listens to Discord channels 24/7.
• Smart Filter: Ignores common conversations and captures only messages with specific keywords (e.g., !bet, U$, Green).
• Cloud Integration: Connects to the Google Sheets API to save data instantly.
• Structured Log: Logs Date, User, Message, and Channel.

    flowchart TD
            A[👤 Discord User] -->|Sends Message| B(🤖 Python Bot / Discord.py)
            B --> C{Contains Keyword?}
            C -- No --> D[❌ Ignore Message]
            C -- Yes --> E[📝 Extract Data]
            E --> F[🔌 Google Sheets API]
            F --> G[(📊 Google Sheet)]
            
            subgraph Bot Logic
            B
            C
            D
            E
            end
            
            style A fill:#5865F2,stroke:#333,stroke-width:2px,color:white
            style G fill:#0F9D58,stroke:#333,stroke-width:2px,color:white
            style B fill:#FFD700,stroke:#333,stroke-width:2px,color:black

Loading

🛠️ Tech Stack

• Python 3.12
• Discord.py (Async)
• Google Sheets API (gspread)

🔒 Security

This repository contains the source code logic. API keys (creds.json and Tokens) were not included for security reasons.

⚙️ Installation & Setup

Prerequisites

• Python 3.12+
• A Google Cloud Platform account (for Sheets API)
• A Bot created in the Discord Developer Portal

Step-by-Step

1. Clone the repository

    git clone gh repo clone armando-desouza/botDiscord-Python
    cd botDiscord-Python

2. Run

    python bot_discord.py

👨‍💻 Author

Francisco A. de Souza Python Developer & Data Scientist | Data Specialist