Recurring Messages (@cron_telebot) is a Telegram bot that schedules recurring Telegram messages. ✨
Refer to our user guide for usage instructions.
- main.py — telegram bot, to add/delete/view the recurring jobs
- api.py — fast api app, ping the endpoint to trigger check and send all required messages
- config.py — all the configurations you need to change for the bot
- mongo.py — handles interaction with the mongo database
- Telegram bot created with @botfather
- Existing MongoDB
Note: The latest version does not support Google Sheets as a database anymore. Please refer to the gsheets branch (no longer maintained) if you would like to use Google Sheets for your database.
-
Configure environment variables. See config.py for the required environment variables and how you can get them.
-
Install Python and pip and set up virtual environment.
virtualenv venv source venv/bin/activate pip install -r requirements.txt
-
Start services. Run
python main.py
to start the telegram bot. On another terminal, runpython api.py
to initialize the FastAPI endpoints (base path is/api
).
- Configure environment variables. See config.py for the required environment variables and how you can get them.
- Remember to set the ENV environment variable to any value of your choice (e.g.
dev
,uat
,prod
)
- Remember to set the ENV environment variable to any value of your choice (e.g.
- Entrypoint is
gunicorn main:app -k uvicorn.workers.UvicornWorker --timeout 60
. No need to run bot and api separately.
If you're looking for a way to contribute, you can scan through our existing issues for something to work on. See the contributing guide for detailed instructions on how to get started with our project.
The project is licensed under a GNU GENERAL PUBLIC LICENSE license.