Telegram-Web Schedule Message Automation Bookmarklet

Table of Contents

1. Overview
2. Features
3. Getting Started
4. For Developers
5. Current Limitations
6. Future Features
7. Contributions
8. License

Overview

Problem

Manually entering messages and times for scheduling a bulk of similar messages daily is a boring and time-consuming task.

Solution

This project provides a bookmarklet for quickly automating the bulk scheduling of messages on Telegram Web.

• You can now create a JSON dataset for your messages and timings in the following format:

JSON file example.

[
  {"hh":"01", "mm":"00", "txt":"Good Morning, it is currently 1:00AM 🕐"},
  {"hh":"12", "mm":"00", "txt":"Good Afternoon, it is currently 12:00PM 🕛"},
  {"hh":"17", "mm":"00", "txt":"Good Evening, it is currently 5:00PM 🕔"},
  {"hh":"22", "mm":"00", "txt":"Good Night, it is currently 10:00PM 🕙"}
]

//... Add more accordingly

• Then use this dataset in the Auto Schedule Telegram bookmarklet. Follow the steps for Installation and Execution.

Features

• Automatically schedules messages based on the provided dataset.
• Press ALT+X to stop the execution at any time.
• Flexible time input options.
• Start scheduling from any given time/row (hh,mm) in your dataset.
• Edit message set before scheduling.

Getting Started

Preparation

1. Create a JSON file containing your message data set in the format shown above.
2. Minify the code in "dist/script.js" using any js minifier.

Installation

1. First prepare your code (follow steps given in preparation).
2. Create a new bookmark in your browser.
3. Edit the bookmark and replace the URL in the following format:

javascript:your_minified_code_here

4. Save the bookmark with any name of your choice.

Execution

1. Open scheduled messages section of any telegram web chat.
2. Click on your saved bookmark.
3. Upload your JSON file by selecting 'Upload new set' in 'Select message set'.
4. Adjust 'From' time input according to your needs.
5. Preview/Edit your dataset.
6. Click confirm.

• Press ALT+X to stop the execution at any time.

For Developers

1. Make sure you have node.js installed.
2. Install required dependencies:

   npm install

3. Run watch mode using:

   npm start

   or

   tsc -w

4. Now edit/write TypeScript code in "src" folder.
5. The JavaScript code can be found in "dist" folder.

Current limitations

• Only works for K version of telegram web.
• Only works for Desktops/Laptops.
• Code relies on a sleep function.
• Scheduling is limited by your Telegram account's scheduled message quota (default 100 messages per chat at a time).

Future features

• Scheduling messages for different dates.
• Remote dataset support.
• Spreadsheet dataset support.
• Handling current limitations.

Contributions

Contributions and bug reports are welcome! If you have suggestions for improvements or have found a bug, please create an issue or pull request on this repository.

License

This project is licensed under the MIT License.