Skip to content

Latest commit

 

History

History
117 lines (86 loc) · 3.16 KB

quick-start.md

File metadata and controls

117 lines (86 loc) · 3.16 KB

Quick Start Guide

Get up and running with Telegram Multi-Account Message Sender in minutes!

Prerequisites

  • Python 3.10 or higher
  • Internet connection
  • Telegram API credentials (API ID and API Hash)

Installation

Option 1: Using pip (Recommended)

pip install telegram-multi-account-sender

Option 2: From source

git clone https://github.com/VoxHash/Telegram-Multi-Account-Message-Sender.git
cd Telegram-Multi-Account-Message-Sender
pip install -r requirements.txt

Option 3: Using Docker

docker build -t telegram-sender .
docker run -it --rm \
  -v $(pwd)/app_data:/app/app_data \
  -v $(pwd)/.env:/app/.env \
  telegram-sender

Quick Setup

  1. Get Telegram API credentials:

    • Visit my.telegram.org
    • Log in with your phone number
    • Go to "API development tools"
    • Create a new application
    • Copy your API ID and API Hash

  2. Configure environment variables:

    # Copy the example environment file
cp example_files/env_template.txt .env

# Edit .env and add your credentials
# ⚠️ SENSITIVE: TELEGRAM_API_ID and TELEGRAM_API_HASH must be kept secret

  3. Launch the application:

    python main.py

    Or if installed via pip:

    python -m app.cli

  4. Configure settings:

    • Open the Settings tab
    • Enter your API credentials (or they'll be loaded from .env)
    • Set your preferred theme and language
    • Save settings

  5. Add your first account:

    • Go to the Accounts tab
    • Click "Add Account"
    • Enter your phone number
    • Complete the authorization process

Basic Usage

  1. Start the application: Run python main.py or use the installed executable

  2. Add accounts: Use the Accounts tab to add and authorize your Telegram accounts

  3. Create templates: Use the Templates tab to create message templates with spintax support

  4. Manage recipients: Use the Recipients tab to organize your recipient lists

  5. Create campaigns: Use the Campaigns tab to create and manage message campaigns

  6. Test messages: Use the Testing tab to test your messages before sending

  7. Monitor logs: Use the Logs tab to monitor application and send logs

Example: Send a Test Message

  1. Go to the Testing tab
  2. Select an account
  3. Select a recipient
  4. Choose or enter a message
  5. Click "Send Test Message"

Spintax Example

Create message variations using spintax syntax:

Hello {John|Jane|Alex}, welcome to {our|my} {amazing|fantastic|great} service!

This will generate variations like:

  • "Hello John, welcome to our amazing service!"
  • "Hello Jane, welcome to my fantastic service!"
  • "Hello Alex, welcome to our great service!"

Next Steps