realslimshanky/just-jobs-bot

Just Jobs Bot is a telegram bot which gathers detail of job opening from employer and post on the Just Jobs Channel.

Just-Jobs-Bot

Current Version - 0.6 (see change logs)

Just Jobs Bot is a telegram bot which gathers detail of job opening from employer and post on the Just Jobs Channel.

How To Use

To use the bot you simply have to send below mentioned commands as text message.

/start - initial command to begin talking to the bot

/help - to get help, report bug and contribute

/submit - to submit job opening in your company

The sole purpose of this bot is to get following details from the employer about the job opening.

• Company Name - This is the full name of the company
• Job Designation - Position for which this job opening is all about
• Job Description - Little detail about the job which can be also a link to document
• Joining Date - Date from when the employee's term starts
• Last Date to Apply - Date upto which a person can apply for this job
• Salary Offered - Expected salary, can also be a range.
• Contact Person - Person whom one should contact if interested
• Email ID - Email of the contact person
• Phone Number (optional, can be 'skip'ped) - Phone number of the contact person

How To Deploy Your Instance Of This Bot

You need Python 3 (recommended version 3.9+) and PIP installed for this to work

• Fork the repo to your profile
• git clone link-to-repo.git - Clone your copy of this repo to your local machine
• cd Just-Jobs-Bot - Move to the repo folder
• Create a virtual environment using python -m venv venv
• Activate virtual environment using source venv/bin/activate
• pip install -r requirements-dev.txt - install dependencies
• Create a new bot using Botfather
• Replace Telegram-Bot-Token with the token you get from Botfather in config.json file
• Create a channel and make it public to get the username e.g. @mychannel
• We need unique ID of this channel, to get that first add your bot as administrator to the channel you just created
• Run python getid.py and send test to the channel
• The channel ID will be logged onto the terminal
• Replace this unique ID with Channel-Id in config.json file
• Now run python justjobs.py
• You can now use commands mentioned above in How To Use section

How To Contribute

• Create an issue in case you find one with the bot. Please mention how you got to that issue in brief.
• Fork this repo and create a feature/bug branch and make your changes to that.
• Create PR from feature/bug branch to master of this repo.

just-jobs-bot's Issues

API changed and Filters missing, ADD from telegram.ext import Filters

In getid.py "Filters" in missing in "from telegram.ext import Updater, CommandHandler, MessageHandler, Filters"
and
This has been updated from str(update.message.chat.id) to str(update.channel_post.chat_id)

Allow landline numbers in phone number question

Phone numbers are accepted only when they are mobile number and not landline. This feature can be added with regex.

Add buttons for job verification

We can have a message with the entire job info posted to a private telegram group with buttons for sending the message to channel after it's verified or reject the job request and send a message back to the original poster with feedback.

educational qualification and experience needed for applying

This is an opinion that employer should specify the educational qualification that is needed for the employees to apply for the job.

Use SQLite instead of job data dictionary

Change 'Your Designation' to something with additional context

It might be confusing to the person entering job detail on the bot and they might enter their designation by mistake. It's better to ask 'Job Designation' or something better.

Use dotenv to store config instead of JSON

Need a button 'Only Mail' when asking for the phone no

Many a time employer only want interested candidates to contact over email. The current implementation makes it mandatory to input a 10 digit phone number. On top of that, a button should be placed with the question Their 10 Digit Phone No (e.g. 0123456789) to skip it.