A charismatic ruby client for Telegram's Bot API.
Write your own Telegram Bot using Ruby! Yay!
Currently under heavy development. Please collaborate with your questions, ideas or problems!
Add this line to your application's Gemfile (currently under development):
gem 'telegram_bot'
And then execute:
$ bundle
Here's an example:
require 'telegram_bot'
bot = TelegramBot.new(token: '[YOUR TELEGRAM BOT TOKEN GOES HERE]')
bot.get_updates(fail_silently: true) do |message|
puts "@#{message.from.username}: #{message.text}"
command = message.get_command_for(bot)
message.reply do |reply|
case command
when /greet/i
reply.text = "Hello, #{message.from.first_name}!"
else
reply.text = "#{message.from.first_name}, have no idea what #{command.inspect} means."
end
puts "sending #{reply.text.inspect} to @#{message.from.username}"
reply.send_with(bot)
end
end
Here's a sample output:
$ bundle exec ruby bot.rb
@eljojo: greet
sending "Hello, José!" to @eljojo
@eljojo: heeeeeeeeya!
sending "José, have no idea what \"heeeeeeeeya!\" means." to @eljojo
Talk to the @BotFather. You can find more info here.
you can pass options to the bot initializer:
bot = TelegramBot.new(token: 'abc', logger: Logger.new(STDOUT), offset: 123, timeout: 20)
if you don't want to start the loop, don't pass a block to #get_updates
and you'll get an array with the latest messages:
messages = bot.get_updates(timeout: 30, offset: 123)
Because things can go wrong sometimes with the API, there's a fail_silently
option that you can pass to #get_updates
like this:
bot.get_updates(fail_silently: true) do |message|
puts message.text
end
A message has several attributes:
message = bot.get_updates.last
# message data
message.text # "hello moto"
message.date # Wed, 01 Jul 2015 09:52:54 +0200 (DateTime)
# reading user
message.from # TelegramBot::User
message.from.first_name # "Homer"
message.from.last_name # "Simpson"
message.from.username # "mr_x"
# channel
message.channel.id # 123123123 (telegram's id)
# reply
message.reply do |reply|
reply.text = "homer please clean the garage"
reply.send_with(bot)
end
# or
reply = message.reply
reply.text = "i'll do it after going to moe's"
bot.send_message(reply)
Bug reports and pull requests are welcome on GitHub at https://github.com/eljojo/telegram_bot. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
The gem is available as open source under the terms of the MIT License.