Order Receiver 0.0.1

1. What is Order Receiver ?

This a simple telegram bot that automates the hustle of regestering orders manualy by showing available items and letting user register their orders by giving them a series of prompots. Even though the prompots are specific to the items that I was selling at the time I built this project you can tweak it a little to make it meat your needs. Don't hesatet to do so because it's well documented and organized. Checkout the dive deep into the inner working of the bot.

2. Installtion

First Clone the repo using this command.

git clone https://github.com/mikias-abiy/order_receiver.git
              

Then, Navigate to the directory you cloned.

cd order_receiver
              

Then create a python virtual enviroment. It's recommended to use virtual enviroment to not mess with the version of other projects dependencies (but keep in mind this optional)

python3 -m venv .venv
              

Then activate the virtual enviroment by executing this command (assuming you are using linux) you can look the documentation for venv here.

. .venv/bin/activate
              

Then, install all the necessary third party libraries by executing the following command.

pip install -r requirements.txt
              

Then, set the your bot's token in the config.py file ot the BOT_API_TOKEN variable. If you don't have or don't know how to generate Telegram bot API token take a look at there documentation here

Then, run the bot by executing the following command

python3 main.py
              

3. How It Works

Coming soon

4. List of Commands

4.1. User Commands

Command	Description
Items	Sends items with there pictures and prices.
Order	Starts the chain of methods that prompot the user to enter the information about their order.
My Order	Sends the details of order the user ordered if they have one previously.
About	Sends information about the bot and the developer of the bot.
Language	Lets the user choose language currenty the only available languages are Amharich and English.

4.2. Admin Commands

Command	Description
/all	Sends all the registered orderes to the admin.