lib/telegrammer/bot.rb
module Telegrammer
# Wrapper for the Telegram's Bots API
class Bot
API_ENDPOINT = 'https://api.telegram.org'
attr_reader :me
# Returns a new instance of Telegrammer::Bot
#
# @param [String] api_token API Token
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
#
# @raise [Telegrammer::Errors::BadRequestError] if something goes wrong obtaining data about your bot
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
def initialize(api_token)
@api_token = api_token
@offset = 0
@timeout = 60
@fail_silently = false
@connection = HTTPClient.new
@me = get_me
end
# Get incoming updates using long polling
#
# @param [Hash] opts Options when getting updates
# @option params [Integer] :fail_silently Optional. Ignore every Connection Error. Default: false
# @option params [Integer] :offset Optional. Sequential number of the first photo to be returned. By default, all photos are returned.
# @option params [Integer] :timeout Optional. Timeout in minutes. 0 for short polling, Default: 60.
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
#
# bot.get_updates do |update|
# if update.is_a?(Telegrammer::DataTypes::Message)
# puts "In chat #{update.chat.id}, @#{update.from.username} said: #{update.text}"
# bot.send_message(chat_id: update.chat.id, text: "You said: #{update.text}")
# end
#
# # Here you can also process message text to detect user commands
# # To learn more about commands, see https://core.telegram.org/bots#commands
# end
#
# bot.get_updates({fail_silently:true, timeout:20}) do |message|
# if update.is_a?(Telegrammer::DataTypes::Message)
# puts "In chat #{message.chat.id}, @#{message.from.username} said: #{update.text}"
# bot.send_message(chat_id: message.chat.id, text: "You said: #{update.text}")
# end
#
# # Here you can also process message text to detect user commands
# # To learn more about commands, see https://core.telegram.org/bots#commands
# end
#
# @raise [Telegrammer::Errors::BadRequestError] if something goes wrong in the Telegram API servers with the params received by the operation
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
# @raise [Telegrammer::Errors::TimeoutError] if HTTPClient connection goes timeout
def get_updates(opts={}, &_block)
loop do
if opts[:fail_silently]
@fail_silently = true
end
response = api_request('getUpdates', { offset: opts[:offset] || @offset, timeout: opts[:timeout] || @timeout }, nil)
response.result.each do |raw_update|
update = Telegrammer::DataTypes::Update.new(raw_update)
@offset = update.update_id + 1
yield (update.inline_query ? update.inline_query : update.message)
end
end
end
# Set a webhook where Telegram will send the messages received by your bot.
#
# @param [String] url
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
#
# # Set up a webhook
# bot.set_webhook("http://www.example.com/my/action")
#
# # Delete a webhook
# bot.set_webhook("")
#
# @raise [Telegrammer::Errors::BadRequestError] if something goes wrong in the Telegram API servers with the params received by the operation
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
#
# @see https://github.com/mayoral/telegrammer/wiki/Using-webhooks
# @return [Telegrammer::ApiResponse] Response from the API.
def set_webhook(url)
api_request('setWebhook', { url: url }, nil)
end
# Returns basic information about the bot in form of a User object. Used for testing your bot's auth token.
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
# bot_user = bot.get_me
#
# @raise [Telegrammer::Errors::BadRequestError] if something goes wrong in the Telegram API servers with the params received by the operation
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
#
# @return [Telegrammer::DataTypes::User] User object with info about the bot
def get_me
response = api_request('getMe', nil, nil)
Telegrammer::DataTypes::User.new(response.result)
end
# Send text messages to a user or group chat.
#
# @param [Hash] params hash of paramers to send to the sendMessage API operation.
# @option params [Integer,String] :chat_id Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername).
# @option params [String] :text Required. Text of the message to be sent
# @option params [String] :parse_mode Optional. Send Markdown, if you want Telegram apps to show bold, italic and inline URLs in your bot's message.
# @option params [Boolean] :disable_web_page_preview Optional. Disables link previews for links in this message
# @option params [Integer] :reply_to_message_id Optional. If the message is a reply, ID of the original message
# @option params [Telegrammer::DataTypes::ReplyKeyboardMarkup,Telegrammer::DataTypes::ReplyKeyboardHide,Telegrammer::DataTypes::ForceReply] :reply_markup Optional. Additional interface options. A JSON-serialized object for a custom reply keyboard, instructions to hide keyboard or to force a reply from the user.
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
#
# bot.send_message(
# chat_id: 123456789,
# text: "Hello World!"
# )
#
# @raise [Telegrammer::Errors::BadRequestError] if something goes wrong in the Telegram API servers with the params received by the operation
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
#
# @return [Telegrammer::DataTypes::Message] Message object sent to the user or group chat
def send_message(params)
extra_params_validation = {
text: { required: true, class: [String] },
parse_mode: { required: false, class: [String] },
disable_web_page_preview: { required: false, class: [TrueClass, FalseClass] }
}
send_something(:message, params, extra_params_validation)
end
# Forward message to a user or group chat.
#
# @param [Hash] params hash of paramers to send to the forwardMessage API operation.
# @option params [Integer,String] :chat_id Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername).
# @option params [Integer,String] :from_chat_id Required. Unique identifier for the chat where the original message was sent (or channel username in the format @channelusername).
# @option params [Integer] :message_id Required. Message id to be forwarded.
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
#
# bot.forward_message(
# chat_id: 123456789,
# from_chat_id: 987654321
# message_id: 111222333
# )
#
# @raise [Telegrammer::Errors::BadRequestError] if something goes wrong in the Telegram API servers with the params received by the operation
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
#
# @return [Telegrammer::DataTypes::Message] Message object sent to the user or group chat
def forward_message(params)
params_validation = {
chat_id: { required: true, class: [Fixnum] },
from_chat_id: { required: true, class: [String] },
message_id: { required: true, class: [Fixnum] }
}
response = api_request('forwardMessage', params, params_validation)
Telegrammer::DataTypes::Message.new(response.result)
end
# Sends a photo to a user or group chat.
#
# @param [Hash] params hash of paramers to send to the sendPhoto API operation.
# @option params [Integer,String] :chat_id Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername).
# @option params [File,String] :photo Required. Photo to send. You can either pass a file_id as String to resend a photo that is already on the Telegram servers, or upload a new photo using multipart/form-data.
# @option params [String] :caption Optional. Photo caption (may also be used when resending photos by file_id).
# @option params [Integer] :reply_to_message_id Optional. If the message is a reply, ID of the original message
# @option params [Telegrammer::DataTypes::ReplyKeyboardMarkup,Telegrammer::DataTypes::ReplyKeyboardHide,Telegrammer::DataTypes::ForceReply] :reply_markup Optional. Additional interface options. A JSON-serialized object for a custom reply keyboard, instructions to hide keyboard or to force a reply from the user.
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
# image_file = File.open("foo.jpg")
# bot.send_photo(chat_id: 123456789, photo: image_file)
#
# @raise [Telegrammer::Errors::BadRequestError] if something goes wrong in the Telegram API servers with the params received by the operation
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
#
# @see #send_document
# @return [Telegrammer::DataTypes::Message] Message object sent to the user or group chat
def send_photo(params)
extra_params_validation = {
photo: { required: true, class: [File, String] },
caption: { required: false, class: [String] }
}
send_something(:photo, params, extra_params_validation)
end
# Sends audio file to a user or group chat.
#
# At this moment, Telegram only allows Ogg files encoded with the OPUS codec. If you need to send another file format, you must use #send_document.
#
# @param [Hash] params hash of paramers to send to the sendAudio API operation.
# @option params [Integer,String] :chat_id Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername).
# @option params [File,String] audio Required. Audio file to send. You can either pass a file_id as String to resend an audio that is already on the Telegram servers, or upload a new audio file using multipart/form-data
# @option params [Integer] duration Optional. Duration of the audio in seconds.
# @option params [String] performer Optional. Performer.
# @option params [String] title Optional. Track name.
# @option params [Integer] :reply_to_message_id Optional. If the message is a reply, ID of the original message
# @option params [Telegrammer::DataTypes::ReplyKeyboardMarkup,Telegrammer::DataTypes::ReplyKeyboardHide,Telegrammer::DataTypes::ForceReply] :reply_markup Optional. Additional interface options. A JSON-serialized object for a custom reply keyboard, instructions to hide keyboard or to force a reply from the user.
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
# audio_file = File.open("foo.ogg")
# bot.send_audio(chat_id: 123456789, audio: audio_file)
#
# @raise [Telegrammer::Errors::BadRequestError] if something goes wrong in the Telegram API servers with the params received by the operation
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
#
# @see #send_document
# @return [Telegrammer::DataTypes::Message] Message object sent to the user or group chat
def send_audio(params)
extra_params_validation = {
audio: { required: true, class: [File, String] },
duration: { required: false, class: [Integer] },
performer: { required: false, class: [String] },
title: { required: false, class: [String] }
}
send_something(:audio, params, extra_params_validation)
end
# Sends audio files file to a user or group chat that the users will see as a playable voice message.
#
# At this moment, Telegram only allows Ogg files encoded with the OPUS codec. If you need to send another file format, you must use #send_document.
#
# @param [Hash] params hash of paramers to send to the sendAudio API operation.
# @option params [Integer,String] :chat_id Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername).
# @option params [File,String] voice Required. Audio file to send. You can either pass a file_id as String to resend an audio that is already on the Telegram servers, or upload a new audio file using multipart/form-data
# @option params [Integer] duration Optional. Duration of sent audio in seconds.
# @option params [Integer] :reply_to_message_id Optional. If the message is a reply, ID of the original message
# @option params [Telegrammer::DataTypes::ReplyKeyboardMarkup,Telegrammer::DataTypes::ReplyKeyboardHide,Telegrammer::DataTypes::ForceReply] :reply_markup Optional. Additional interface options. A JSON-serialized object for a custom reply keyboard, instructions to hide keyboard or to force a reply from the user.
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
# voice_file = File.open("foo.ogg")
# bot.send_voice(chat_id: 123456789, voice: audio_file)
#
# @raise [Telegrammer::Errors::BadRequestError] if something goes wrong in the Telegram API servers with the params received by the operation
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
#
# @see #send_document
# @return [Telegrammer::DataTypes::Message] Message object sent to the user or group chat
def send_voice(params)
extra_params_validation = {
voice: { required: true, class: [File, String] },
duration: { required: false, class: [Integer] }
}
send_something(:audio, params, extra_params_validation)
end
# Sends a document to a user or group chat.
#
# @param [Hash] params hash of paramers to send to the sendDocument API operation.
# @option params [Integer,String] :chat_id Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername).
# @option params [File,String] :document Required. File to send. You can either pass a file_id as String to resend a file that is already on the Telegram servers, or upload a new file using multipart/form-data.
# @option params [Integer] :reply_to_message_id Optional. If the message is a reply, ID of the original message
# @option params [Telegrammer::DataTypes::ReplyKeyboardMarkup,Telegrammer::DataTypes::ReplyKeyboardHide,Telegrammer::DataTypes::ForceReply] :reply_markup Optional. Additional interface options. A JSON-serialized object for a custom reply keyboard, instructions to hide keyboard or to force a reply from the user.
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
# my_secret_file = File.open("secrets.doc")
# bot.send_document(chat_id: 123456789, document: my_secret_file)
#
# @raise [Telegrammer::Errors::BadRequestError] if something goes wrong in the Telegram API servers with the params received by the operation
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
#
# @return [Telegrammer::DataTypes::Message] Message object sent to the user or group chat
def send_document(params)
extra_params_validation = {
document: { required: true, class: [File, String] }
}
send_something(:document, params, extra_params_validation)
end
# Send WebP images as stickers.
#
# @param [Hash] params hash of paramers to send to the sendSticker API operation.
# @option params [Integer,String] :chat_id Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername).
# @option params [File,String] :sticker Required. Sticker to send. You can either pass a file_id as String to resend a file that is already on the Telegram servers, or upload a new file using multipart/form-data.
# @option params [Integer] :reply_to_message_id Optional. If the message is a reply, ID of the original message
# @option params [Telegrammer::DataTypes::ReplyKeyboardMarkup,Telegrammer::DataTypes::ReplyKeyboardHide,Telegrammer::DataTypes::ForceReply] :reply_markup Optional. Additional interface options. A JSON-serialized object for a custom reply keyboard, instructions to hide keyboard or to force a reply from the user.
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
# sticker_file = File.open("my-sticker.webp")
# bot.send_sticker(chat_id: 123456789, sticker: sticker_file)
#
# @raise [Telegrammer::Errors::BadRequestError] if something goes wrong in the Telegram API servers with the params received by the operation
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
#
# @see #send_document
# @return [Telegrammer::DataTypes::Message] Message object sent to the user or group chat
def send_sticker(params)
extra_params_validation = {
sticker: { required: true, class: [File, String] }
}
send_something(:sticker, params, extra_params_validation)
end
# Sends a video file to a user or group chat.
#
# At this moment, Telegram only support mp4 videos. If you need to send other formats you must use #send_document.
#
# @param [Hash] params hash of paramers to send to the sendVideo API operation.
# @option params [Integer,String] :chat_id Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername).
# @option params [File,String] :video Required. Video to send. You can either pass a file_id as String to resend a video that is already on the Telegram servers, or upload a new video file.
# @option params [Integer] :duration Optional. Duration of sent video in seconds.
# @option params [String] :caption Optional. Video caption (may also be used when resending videos by file_id).
# @option params [Integer] :reply_to_message_id Optional. If the message is a reply, ID of the original message
# @option params [Telegrammer::DataTypes::ReplyKeyboardMarkup,Telegrammer::DataTypes::ReplyKeyboardHide,Telegrammer::DataTypes::ForceReply] :reply_markup Optional. Additional interface options. A JSON-serialized object for a custom reply keyboard, instructions to hide keyboard or to force a reply from the user.
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
# my_video = File.open("foo.mp4")
# bot.send_video(chat_id: 123456789, video: my_video)
#
# @raise [Telegrammer::Errors::BadRequestError] if something goes wrong in the Telegram API servers with the params received by the operation
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
#
# @see #send_document
# @return [Telegrammer::DataTypes::Message] Message object sent to the user or group chat
def send_video(params)
extra_params_validation = {
video: { required: true, class: [File, String] },
duration: { required: false, class: [Integer] },
caption: { required: false, class: [String] }
}
send_something(:video, params, extra_params_validation)
end
# Sends point on the map to a user or group chat.
#
# @param [Hash] params hash of paramers to send to the sendAudio API operation.
# @option params [Integer,String] :chat_id Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername).
# @option params [Float] :latitude Required. Latitude of location.
# @option params [Float] :longitude Required. Longitude of location.
# @option params [Integer] :reply_to_message_id Optional. If the message is a reply, ID of the original message.
# @option params [Telegrammer::DataTypes::ReplyKeyboardMarkup,Telegrammer::DataTypes::ReplyKeyboardHide,Telegrammer::DataTypes::ForceReply] :reply_markup Optional. Additional interface options. A JSON-serialized object for a custom reply keyboard, instructions to hide keyboard or to force a reply from the user.
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
# bot.send_location(chat_id: 123456789, latitude: 38.775539, longitude: -4.829988)
#
# @raise [Telegrammer::Errors::BadRequestError] if something goes wrong in the Telegram API servers with the params received by the operation
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
#
# @return [Telegrammer::DataTypes::Message] Message object sent to the user or group chat
def send_location(params)
extra_params_validation = {
latitude: { required: true, class: [Float] },
longitude: { required: true, class: [Float] }
}
send_something(:location, params, extra_params_validation)
end
# Sends a status action to a user or group chat.
#
# Used when you need to tell the user that something is happening on the bot's side. The status is set for 5 seconds or less (when a message arrives from your bot, Telegram clients clear its typing status).
#
# @param [Hash] params hash of paramers to send to the sendChatAction API operation.
# @option params [Integer,String] :chat_id Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername).
# @option params [String] :action Required. Type of action to broadcast. Choose one, depending on what the user is about to receive: "typing" for text messages, "upload_photo" for photos, "record_video" or "upload_video" for videos, "record_audio" or "upload_audio" for audio files, "upload_document" for general files, "find_location" for location data.
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
# bot.send_chat_action(chat_id: 123456789, action: "typing")
#
# @raise [Telegrammer::Errors::BadRequestError]
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
#
# @return [Telegrammer::ApiResponse] Response from the API.
def send_chat_action(params)
params_validation = {
chat_id: { required: true, class: [Fixnum, String] },
action: { required: true, class: [String] }
}
api_request('sendChatAction', params, params_validation)
end
# Get a list of profile pictures for a user.
#
# @param [Hash] params hash of paramers to send to the getUserProfilePhotos API operation.
# @option params [Integer] :user_id Required. Unique identifier of the target user.
# @option params [Integer] :offset Optional. Sequential number of the first photo to be returned. By default, all photos are returned.
# @option params [Integer] :limit Optional. Limits the number of photos to be retrieved. Values between 1—100 are accepted. Defaults to 100.
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
# bot.get_user_profile_photos(user_id: 123456789)
#
# @raise [Telegrammer::Errors::BadRequestError]
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
#
# @return [Telegrammer::DataTypes::UserProfilePhotos] Message object sent to the user or group chat
def get_user_profile_photos(params)
params_validation = {
user_id: { required: true, class: [Fixnum] },
offset: { required: false, class: [Fixnum] },
limit: { required: false, class: [Fixnum] }
}
response = api_request('getUserProfilePhotos', params, params_validation)
Telegrammer::DataTypes::UserProfilePhotos.new(response.result).to_h
end
# Get basic info about a file and prepare it for downloading.
#
# @param [Hash] params hash of paramers to send to the getFile API operation.
# @option params [String] :file_id Required. File identifier to get info about.
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
# bot.get_file(file_id: 123456789)
#
# @raise [Telegrammer::Errors::BadRequestError]
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
#
# @return [String] URL of the file (valid for one hour) or BadRequestError if the file_id is wrong
def get_file(params)
params_validation = {
file_id: { required: true, class: [String] }
}
response = api_request("getFile", params, params_validation)
file_object = Telegrammer::DataTypes::File.new(response.result)
"#{API_ENDPOINT}/file/bot#{@api_token}/#{file_object.file_path}"
end
# Answer an inline query. On success, True is returned. No more than 50 results per query are allowed.
#
# @param [Hash] params hash of paramers to send to the answerInlineQuery API operation.
# @option params [String] :inline_query_id Required. Unique identifier for the answered query
# @option params [Array] :results Required. An array of InlineQueryResults objects for the inline query
# @option params [Fixnum] :cache_time Optional. The maximum amount of time the result of the inline query may be cached on the server
# @option params [TrueClass,FalseClass] :is_personal Optional. Pass True, if results may be cached on the server side only for the user that sent the query. By default, results may be returned to any user who sends the same query
# @option params [String] :next_offset Optional. Pass the offset that a client should send in the next query with the same text to receive more results. Pass an empty string if there are no more results or if you don‘t support pagination. Offset length can’t exceed 64 bytes.
#
# @example
# bot = Telegrammer::Bot.new('[YOUR TELEGRAM TOKEN]')
#
# bot.get_updates do |update|
# if update.is_a?(Telegrammer::DataTypes::InlineQuery)
# inline_query = message.inline_query
#
# if inline_query
# results = the_search_in_my_app(inline_query.query)
#
# bot.answer_inline_query(
# inline_query_id: "my-internal-query-id",
# results: results
# )
# end
# end
# end
#
# @raise [Telegrammer::Errors::BadRequestError]
# @raise [Telegrammer::Errors::ServiceUnavailableError] if Telegram servers are down
#
# @return [TrueClass] True if all was OK
def answer_inline_query(params)
params_validation = {
inline_query_id: { required: true, class: [String] },
results: { required: true, class: [Array] },
cache_time: { required: false, class: [Fixnum] },
is_personal: { required: false, class: [TrueClass, FalseClass] },
next_offset: { required: false, class: [String] }
}
response = api_request("answerInlineQuery", params, params_validation)
end
private
def api_request(action, params, params_validation)
api_uri = "bot#{@api_token}/#{action}"
if params_validation.nil?
validated_params = params
else
# Delete params not accepted by the API
validated_params = params.delete_if { |k, _v| !params_validation.key?(k) }
# Check all required params by the action are present
params_validation.each do |key, _value|
if params_validation[key][:required] && !params.key?(key)
fail Telegrammer::Errors::MissingParamsError.new(key, action)
end
end
params.each do |key, value|
# Check param types
unless params_validation[key][:class].include?(value.class)
fail Telegrammer::Errors::InvalidParamTypeError.new(key, value.class, params_validation[key][:class])
end
# Prepare params for sending in Typhoeus post body request
params[key] = value.to_s if value.class == Fixnum
params[key] = value.to_h.to_json if [
Telegrammer::DataTypes::ReplyKeyboardMarkup,
Telegrammer::DataTypes::ReplyKeyboardHide,
Telegrammer::DataTypes::ForceReply
].include?(value.class)
end
end
begin
response = @connection.post(
"#{API_ENDPOINT}/#{api_uri}",
validated_params,
'User-Agent' => "Telegrammer/#{Telegrammer::VERSION}",
'Accept' => 'application/json'
)
ApiResponse.new(response,@fail_silently)
rescue HTTPClient::ReceiveTimeoutError => e
if !@fail_silently
fail Telegrammer::Errors::TimeoutError, e.to_s
end
end
end
def send_something(object_kind, params, extra_params_validation = {})
params_validation = {
chat_id: { required: true, class: [Fixnum, String] },
reply_to_message_id: { required: false, class: [String] },
reply_markup: { required: false, class: [
Telegrammer::DataTypes::ReplyKeyboardMarkup,
Telegrammer::DataTypes::ReplyKeyboardHide,
Telegrammer::DataTypes::ForceReply
] }
}
response = api_request("send#{object_kind.to_s.capitalize}", params, extra_params_validation.merge(params_validation))
Telegrammer::DataTypes::Message.new(response.result)
end
end
end