/job-offer-bot

The final bot to cross post your job offer in different telegram communities

Primary LanguageTypeScriptMIT LicenseMIT

Job Offer Bot

All Contributors

Job Offer Bot allows you to post your job offers via simple and intuitive messages via Telegram.

You'll have the ability to send your job offer to a single group or in multiple ones, the chose is yours!

Why this bot exist

The bot is and idea of the Lavoro Digitale Italia communities manager and leadership.

The wanted something useful for them to easily post job offers in telegram communities simplifying the way of writing the messages following different templates.

They wanted to keep the bot open source, to follow the spirit of the tech communities and the work every of us is doing.

Contents

  1. Usage of the bot
  2. How it works
  3. Run the project
  4. Contributing
  5. Support
  6. License

Usage of the bot

In order to be able to use the bot, you just have to add it to your group with admin rights.

Then you just have to send the /start command, and you're done!

You'll have the abilities to use different commands, you can have more info using /commands and /help.

How it works

The idea is pretty simple, every time the bot is initialized inside a group, it will store the data required to send messages inside that group, such as the topic id and the language of the message (defaults to Italian).

Everything else is just stored on the fly, called session in grammY framework.

IMPORTANT

The job offers you're sending, are not stored anywhere, that means that once it was sent to a group or groups, you'll not able to edit it.

Run the project

In order to run this project, you just have to follow only some small steps:

  • Fork the project and install the dependencies via
$ yarn install 
  • Copy the .env.example file and fill it with your data.
$ cp .env.example .env
  • Run the project with
$ yarn dev

Contributing

Any contributions and/or suggestions about how to improve the bot are welcome!

Just be sure to follow our contributing guidelines, following our code of conduct

The repo is based on telegram-bot-template

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Guido Porcaro
Guido Porcaro

💻 📖 📣
scriptswhisper
scriptswhisper

💻
Add your contributions

This project follows the all-contributors specification. Contributions of any kind welcome!

Support

If you want to support my work, but mostly this bot, you can just leave a star, share the project, but mostly important, you can support it donating via the sponsorship page via the dedicated option.

This will allow to not have heavy costs to keep the bot up and running and supporting the development of new features.

License

This project is licensed under the MIT License