✈️ Ruby Telegram boilerplate for creating awesome bots. Check out best tools from the world of bots - https://github.com/BotCube/awesome-bots
Switch branches/tags
Nothing to show
Clone or download
Latest commit 01abf19 Aug 8, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Add executable for bot Dec 21, 2015
config Add config files Dec 21, 2015
db/migrate Fix error in migration file Aug 8, 2017
lib ✂️ Apr 23, 2016
models Add all the library files Dec 21, 2015
.gitignore Add .gitignore Dec 21, 2015
Gemfile Update gems and update readme Apr 21, 2016
Gemfile.lock Update gems and update readme Apr 21, 2016
README.md Update README.md Mar 10, 2017
Rakefile Fix migrations Dec 21, 2015


Ruby Telegram Bot boilerplate

Ruby and Telegram

UPD (20.06.2016)

I've created an awesome list of resources related to bots (from tutorials and SDKs to the events and people). Be sure to check it out!

Awesome bots list

If you want to use Webhooks API instead of long-polling, be able to save state and create more scalable and powerful bot read the article below.

Full guide on creating statefull Telegram bot


  • Ability to save some data to a local database (Postgres by default)
  • Automatic logging of received and sent message
  • Easy internationalization using i18n gem
  • Already created class for creating custom keyboards
  • Database logging
  • Separate classes for all the functional, so it's very easy to customize something


Defining responses

Use the on method in message_responder.rb like in the example below:

def respond
  on /^\/start/ do

  on /^\/command (.+)/ do |arg| #supports up to two arguments but it is easily extendable
    # do your stuff

Running the bot

For the first you need to install gems required to start a bot:

bundle install

Then you need to create secrets.yml where your bot unique token will be stored and database.yml where database credentials will be stored. I've already created samples for you, so you can easily do:

cp config/database.yml.sample config/database.yml
cp config/secrets.yml.sample config/secrets.yml

Then you need to fill your Telegram bot unique token to the secrets.yml file and your database credentials to database.yml.

After this you need to create and migrate your database:

rake db:create db:migrate

Great! Now you can easily start your bot just by running this command:


Directory layout


└── ruby-telegram-bot-boilerplate
    ├── bin                              # executables folder
    │   └── bot                          # main executable file
    ├── config                           # folder with configs
    │   ├── database.yml.sample          # sample database configuration
    │   ├── secrets.yml.sample           # sample credentials file
    │   └── locales.yml                  # file with i18n locales
    ├── db                               # database related stuff
    │   └── migrate                      # migrations
    │       └── 001_create_users.rb      # migration for creating table 'users'
    ├── lib                              # helper libs folder
    │   ├── app_configurator.rb          # class for application configuration
    │   ├── database_connector.rb        # class for connecting to database
    │   ├── message_responder.rb         # main class for responding to message
    │   ├── message_sender.rb            # simple class just for message sending
    │   └── reply_markup_formatter.rb    # class for creating custom keyboards
    ├── models                           # database models folder
    │   └── user.rb                      # active record User model
    ├── Gemfile                          # Gemfile
    ├── Gemfile.lock                     # Gemfile.lock
    ├── README.md                        # Readme file
    └── Rakefile                         # Rakefile with tasks for database management

Some more specific info you can also find here.


If you have some proposals how to improve this boilerplate feel free to open issues and send pull requests!

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request