Bot API 5.1

Author: ba0f3

examples/file_receive_bot/file_receive_bot.nim

@@ -6,6 +6,14 @@ from strutils import strip
 const API_KEY = slurp("../secret.key").strip()
 
 
+proc buildFile(file_id: string) =
+  let
+    metadata_url = fmt"https://api.telegram.org/bot{API_KEY}/getFile?file_id={file_id}"
+    body = await newAsyncHttpClient().getContent(metadata_url) # file_id > file_path
+    file_path = parseJson(body)["result"]["file_path"].getStr()
+    download_url = fmt"https://api.telegram.org/file/bot{API_KEY}/{file_path}"
+
+
 proc updateHandler(bot: TeleBot, e: Update): Future[bool] {.async.} =
   let
     url_getfile = fmt"https://api.telegram.org/bot{API_KEY}/getFile?file_id="
@@ -21,15 +29,14 @@ proc updateHandler(bot: TeleBot, e: Update): Future[bool] {.async.} =
       mime_type = document.mime_type.get
       file_id = document.file_id
       file_size = document.file_size.get
-      responz = await newAsyncHttpClient().get(url_getfile & file_id) # file_id > file_path
-      responz_body = await responz.body
+      responz_body = await newAsyncHttpClient().getContent(url_getfile & file_id) # file_id > file_path
       file_path = parseJson(responz_body)["result"]["file_path"].getStr()
       responx = await newAsyncHttpClient().get(api_file & file_path)  # file_path > file
       file_content = await responx.body
       msg0_text = fmt"file_name: {file_name}, mime_type: {mime_type}, file_id: {file_id}, file_size: {file_size}, file_path: {file_path}"
 
     discard await bot.sendMessage(response.chat.id, msg0_text)
-    #discard await bot.sendMessage(response.chat.id, file_content)
+    discard await bot.sendMessage(response.chat.id, file_content)
 
 let bot = newTeleBot(API_KEY)
 

src/telebot/private/api.nim

@@ -539,12 +539,14 @@ proc getFile*(b: TeleBot, fileId: string): Future[types.File] {.async.} =
   let res = await makeRequest(b, procName, data)
   result = unmarshal(res, types.File)
 
-proc kickChatMember*(b: TeleBot, chatId: string, userId: int, untilDate = 0): Future[bool] {.async.} =
+proc kickChatMember*(b: TeleBot, chatId: string, userId: int, untilDate = 0, revokeMessages = false): Future[bool] {.async.} =
   var data = newMultipartData()
   data["chat_id"] = chatId
   data["user_id"] = $userId
   if untilDate > 0:
     data["until_date"] = $untilDate
+  if revokeMessages:
+    data["revoke_messages"] = "true"
   let res = await makeRequest(b, procName, data)
   result = res.toBool
 
@@ -569,14 +571,16 @@ proc restrictChatMember*(b: TeleBot, chatId: string, userId: int, permissions: C
   let res = await makeRequest(b, procName, data)
   result = res.toBool
 
-proc promoteChatMember*(b: TeleBot, chatId: string, userId: int, isAnonymous = false, canChangeInfo = false,
-                        canPostMessages = false, canEditMessages = false, canDeleteMessages = false,
+proc promoteChatMember*(b: TeleBot, chatId: string, userId: int, isAnonymous = false, canManageChat = false, canChangeInfo = false,
+                        canPostMessages = false, canEditMessages = false, canDeleteMessages = false, canManageVoiceChats = false,
                         canInviteUsers = false, canRestrictMembers = false, canPinMessages = false, canPromoteMembers = false): Future[bool] {.async.} =
   var data = newMultipartData()
   data["chat_id"] = chatId
   data["user_id"] = $userId
   if isAnonymous:
     data["is_anonymous"] = "true"
+  if canManageChat:
+    data["can_manage_chat"] = "true"
   if canChangeInfo:
     data["can_change_info"] = "true"
   if canPostMessages:
@@ -585,6 +589,8 @@ proc promoteChatMember*(b: TeleBot, chatId: string, userId: int, isAnonymous = f
     data["can_edit_messages"] = "true"
   if canDeleteMessages:
     data["can_delete_messages"] = "true"
+  if canManageVoiceChats:
+    data["can_manage_voice_chats"] = "true"
   if canInviteUsers:
     data["can_invite_users"] = "true"
   if canRestrictMembers:
@@ -1094,7 +1100,7 @@ proc pollAsync*(b: TeleBot, timeout = 50, offset, limit = 0, clean = false) {.as
   await loop(b, timeout, offset, limit)
 
 
-proc sendGame*(b: TeleBot, chatId: int, gameShortName: string, disableNotification = false, replyToMessageId = 0,
+proc sendGame*(b: TeleBot, chatId: int64, gameShortName: string, disableNotification = false, replyToMessageId = 0,
                allowSendingWithoutReply = false, replyMarkup: InlineKeyboardMarkup): Future[Message] {.async.} =
   var data = newMultipartData()
 
@@ -1117,7 +1123,7 @@ proc setGameScore*(b: TeleBot, userId: int, score: int, force = false, disableEd
 
   var data = newMultipartData()
 
-  data["user_id"] = $chatId
+  data["user_id"] = $userId
   data["score"] = $score
   if force:
     data["force"] = "true"
@@ -1133,12 +1139,47 @@ proc setGameScore*(b: TeleBot, userId: int, score: int, force = false, disableEd
 proc getGameHighScores*(b: TeleBot, userId: int, chatId = 0, messageId = 0, inlineMessageId = 0): Future[seq[GameHighScore]] {.async.} =
   var data = newMultipartData()
 
-  data["user_id"] = $chatId
+  data["user_id"] = $userId
   if chatId != 0:
     data["chat_id"] = $chatId
   if messageId != 0:
     data["message_id"] = $messageId
   if inlineMessageId != 0:
     data["inline_message_id"] = $inlineMessageId
   let res = await makeRequest(b, procName, data)
-  result = unmarshal(res, seq[GameHighScore])
+  result = unmarshal(res, seq[GameHighScore])
+
+
+proc createChatInviteLink*(b: Telebot, chatId: ChatId, expireDate = 0, memberLimit = 0): Future[ChatInviteLink] {.async.} =
+  var data = newMultipartData()
+
+  data["chat_id"] = $chatId
+  if expireDate > 0:
+    data["expire_date"] = $expireDate
+  if memberLimit > 0:
+    data["member_limit"] = $memberLimit
+
+  let res = await makeRequest(b, procName, data)
+  result = unmarshal(res, seq[ChatInviteLink])
+
+proc editChatInviteLink*(b: Telebot, chatId: ChatId, inviteLink: string, expireDate = 0, memberLimit = 0): Future[ChatInviteLink] {.async.} =
+  var data = newMultipartData()
+
+  data["chat_id"] = $chatId
+  data["invite_link"] = invite_link
+  if expireDate > 0:
+    data["expire_date"] = $expireDate
+  if memberLimit > 0:
+    data["member_limit"] = $memberLimit
+
+  let res = await makeRequest(b, procName, data)
+  result = unmarshal(res, seq[ChatInviteLink])
+
+proc revokeChatInviteLink*(b: Telebot, chatId: ChatId, inviteLink: string): Future[ChatInviteLink] {.async.} =
+  var data = newMultipartData()
+
+  data["chat_id"] = $chatId
+  data["invite_link"] = invite_link
+
+  let res = await makeRequest(b, procName, data)
+  result = unmarshal(res, seq[ChatInviteLink])

src/telebot/private/types.nim

@@ -6,6 +6,8 @@ converter optionToBool*[T](o: Option[T]): bool = o.isSome()
 type
   TelegramObject* = object of RootObj
 
+  ChatId* = int64|string
+
   UpdateCallback* = proc(bot: Telebot, update: Update): Future[bool] {.gcsafe.}
   CommandCallback* = proc(bot: Telebot, command: Command): Future[bool] {.gcsafe.}
   CatchallCommandCallback* = proc(bot: Telebot, command: Command): Future[bool] {.gcsafe.}
@@ -185,6 +187,17 @@ type
     watcher*: User
     distance*: int
 
+  MessageAutoDeleteTimerChanged* = object of TelegramObject
+    messageAutoDeleteTime*: int
+
+  VoiceChatStarted* = object of TelegramObject
+
+  VoiceChatEnded* = object of TelegramObject
+    duration*: int
+
+  VoiceChatParticipantsInvited* = object of TelegramObject
+    users*: seq[User]
+
   UserProfilePhotos* = object of TelegramObject
     totalCount*: int
     photos*: seq[seq[PhotoSize]]
@@ -312,6 +325,7 @@ type
     groupChatCreated*: Option[bool]
     superGroupChatCreated*: Option[bool]
     chanelChatCreated*: Option[bool]
+    messageAutoDeleteTimerChanged*: Option[MessageAutoDeleteTimerChanged]
     migrateToChatId*: Option[int64]
     migrateFromChatId*: Option[int64]
     pinnedMessage*: Option[ref Message]
@@ -320,6 +334,9 @@ type
     connectedWebsite*: Option[string]
     passportData*: Option[PassportData]
     proximityAlertTriggered*: Option[ProximityAlertTriggered]
+    voiceChatStarted*: Option[VoiceChatStarted]
+    voiceChatEnded*: Option[VoiceChatEnded]
+    voiceChatParticipantsInvited*: Option[VoiceChatParticipantsInvited]
     replyMarkup*: Option[InlineKeyboardMarkup]
 
   MessageId* = object of TelegramObject
@@ -331,16 +348,26 @@ type
     bigFileId*: string
     bigFileUniqueId*: string
 
+  ChatInviteLink* = object of TelegramObject
+    inviteLink*: string
+    creator*: User
+    isPrimary*: bool
+    isRevoked*: bool
+    expireDate*: Option[int]
+    memberLimit*: Option[int]
+
   ChatMember* = object of TelegramObject
     user*: User
     status*: string
     customTitle*: Option[string]
     isAnonymous*: Option[bool]
     untilDate*: Option[int]
     canBeEdited*: Option[bool]
+    canManageChat*: Option[bool]
     canPostMessages*: Option[bool]
     canEditMessages*: Option[bool]
     canDeleteMessages*: Option[bool]
+    canManageVoiceChats*: Option[bool]
     canRestrictMembers*: Option[bool]
     canPromoteMembers*: Option[bool]
     canChangeInfo*: Option[bool]
@@ -353,6 +380,14 @@ type
     canSendOtherMessages*: Option[bool]
     canAddWebPagePreviews*: Option[bool]
 
+  ChatMemberUpdated* = object of TelegramObject
+    chat*: Chat
+    fromUser*: User
+    date*: int
+    oldChatMember*: ChatMember
+    newChatMember*: ChatMember
+    inviteLink*: Option[ChatInviteLink]
+
   ChatPermissions* = object of TelegramObject
     canSendMessages*: Option[bool]
     canSendMediaMessages*: Option[bool]
@@ -384,6 +419,8 @@ type
     preCheckoutQuery*: Option[PreCheckoutQuery]
     poll*: Option[Poll]
     pollAnswer*: Option[PollAnswer]
+    myChatMember*: Option[ChatMemberUpdated]
+    chatMember*: Option[ChatMemberUpdated]
 
   #------------------
   # Game
@@ -752,3 +789,5 @@ type
 
   PassportElementErrorUnspecified* = ref object of PassportElementError
     elementHash*: string
+
+

telebot.nimble

@@ -1,4 +1,4 @@
-version       = "1.0.4"
+version       = "1.0.5"
 author        = "Huy Doan"
 description   = "Async Telegram Bot API Client"
 license       = "MIT"