mir/node-telegram-bot-api
2
0
Fork 0
mirror of https://github.com/yagop/node-telegram-bot-api synced 2025-08-22 01:47:25 +00:00
Code Issues Releases Wiki Activity

feat: Support Telegram Bot API 9.0

Browse Source
This commit is contained in:
danielperez9430 2025-04-17 01:04:54 +02:00
parent 8fe6f04df2
commit 6d7adc3e12
4 changed files with 163 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
CHANGELOG.md
View File

@ -24,6 +24,26 @@ This project adheres to [Semantic Versioning](http://semver.org/).
* removeUserVerification
* removeChatVerification
5. Support Telegram Bot API 9.0 (@danielperez9430)
* readBusinessMessage
* deleteBusinessMessages
* setBusinessAccountName
* setBusinessAccountUsername
* setBusinessAccountBio
* setBusinessAccountProfilePhoto
* removeBusinessAccountProfilePhoto
* setBusinessAccountGiftSettings
* getBusinessAccountStarBalance
* transferBusinessAccountStars
* getBusinessAccountGifts
* convertGiftToStars
* upgradeGift
* transferGift
* postStory
* editStory
* deleteStory
* giftPremiumSubscription
## [0.67.0][0.67.0] - 2024-05-30
1. Support Telegram Bot API 7.4 (@danielperez9430)

2
README.md
View File

@ -5,7 +5,7 @@
Node.js module to interact with the official [Telegram Bot API](https://core.telegram.org/bots/api).
[![Bot API](https://img.shields.io/badge/Bot%20API-v.8.3-00aced.svg?style=flat-square&logo=telegram)](https://core.telegram.org/bots/api)
[![Bot API](https://img.shields.io/badge/Bot%20API-v.9.0-00aced.svg?style=flat-square&logo=telegram)](https://core.telegram.org/bots/api)
[![npm package](https://img.shields.io/npm/v/node-telegram-bot-api?logo=npm&style=flat-square)](https://www.npmjs.org/package/node-telegram-bot-api)
[![Coverage Status](https://img.shields.io/codecov/c/github/yagop/node-telegram-bot-api?style=flat-square&logo=codecov)](https://codecov.io/gh/yagop/node-telegram-bot-api)

3
package.json
View File

@ -61,8 +61,7 @@
"jsdoc-to-markdown": "^3.0.3",
"mocha": "^3.5.3",
"mocha-lcov-reporter": "^1.3.0",
"node-static": "^0.7.10",
"request": "^2.88.2"
"node-static": "^0.7.10"
},
"repository": {
"type": "git",

155
src/telegram.js
View File

@ -425,7 +425,7 @@ class TelegramBot extends EventEmitter {
const fileIds = {};
files.forEach((file, index) => {
let filedata = file.media || file.data;
let filedata = file.media || file.data || file[type];
let filename = file.filename || fileOptions.filename;
let contentType = file.contentType || fileOptions.contentType;
@ -1328,7 +1328,7 @@ class TelegramBot extends EventEmitter {
* Use this method to send paid media.
* @param {Number|String} chatId Unique identifier for the target chat or username of the target channel (in the format `@channelusername`)
* @param {Number} starCount The number of Telegram Stars that must be paid to buy access to the media; 1-10000
* @param {String|stream.Stream|Buffer} media A file path or Stream.
* @param {Array} media Array of [InputPaidMedia](https://core.telegram.org/bots/api#inputpaidmedia). The media property can bea String, Stream or Buffer.
* @param {Object} [options] Additional Telegram query options
* @return {Promise} On success, the sent [Message](https://core.telegram.org/bots/api#message) object is returned
* @see https://core.telegram.org/bots/api#sendpaidmedia
@ -3338,7 +3338,7 @@ class TelegramBot extends EventEmitter {
/**
* Use this method to returns the list of gifts that can be sent by the bot to users and channel chats.
*
* @param {Object} [options] Additional Telegram query options
* @param {Object} [options] Additional Telegram query options.
* @return {Promise} On success, returns a [Gifts](https://core.telegram.org/bots/api#gifts) objects.
* @see https://core.telegram.org/bots/api#getavailablegifts
*/
@ -3350,7 +3350,7 @@ class TelegramBot extends EventEmitter {
* Use this method to sends a gift to the given user or channel chat.
*
* @param {String} giftId Unique identifier of the gift
* @param {Object} [options] Additional Telegram query options
* @param {Object} [options] Additional Telegram query options.
* @return {Promise} On success, returns true.
* @see https://core.telegram.org/bots/api#getavailablegifts
*/
@ -3359,11 +3359,28 @@ class TelegramBot extends EventEmitter {
return this._request('sendGift', { form });
}
/**
* Use this method to sends a gift to the given user or channel chat.
*
* @param {Number} userId Unique identifier of the target user who will receive a Telegram Premium subscription.
* @param {Number} monthCount Number of months the Telegram Premium subscription will be active for the user; must be one of 3, 6, or 12.
* @param {String} starCount Number of Telegram Stars to pay for the Telegram Premium subscription; must be 1000 for 3 months, 1500 for 6 months, and 2500 for 12 months.
* @param {Object} [options] Additional Telegram query options.
* @return {Promise} On success, returns true.
* @see https://core.telegram.org/bots/api#getavailablegifts
*/
giftPremiumSubscription(userId, monthCount, starCount, form = {}) {
form.user_id = userId;
form.month_count = monthCount;
form.star_count = starCount;
return this._request('giftPremiumSubscription', { form });
}
/**
* This method verifies a user [on behalf of the organization](https://telegram.org/verify#third-party-verification) which is represented by the bot.
*
* @param {Number} userId Unique identifier of the target user
* @param {Object} [options] Additional Telegram query options
* @param {Number} userId Unique identifier of the target user.
* @param {Object} [options] Additional Telegram query options.
* @return {Promise} On success, returns true.
* @see https://core.telegram.org/bots/api#verifyuser
*/
@ -3375,9 +3392,9 @@ class TelegramBot extends EventEmitter {
/**
* This method verifies a chat [on behalf of the organization](https://telegram.org/verify#third-party-verification) which is represented by the bot.
*
* @param {Number} chatId Unique identifier of the target chat
* @param {Number} chatId Unique identifier of the target chat.
* @return {Promise} On success, returns true.
* @param {Object} [options] Additional Telegram query options
* @param {Object} [options] Additional Telegram query options.
* @see https://core.telegram.org/bots/api#verifychat
*/
verifyChat(chatId, form = {}) {
@ -3401,8 +3418,8 @@ class TelegramBot extends EventEmitter {
/**
* This method removes verification from a chat who is currently verified [on behalf of the organization](https://telegram.org/verify#third-party-verification) which is represented by the bot.
*
* @param {Number} chatId Unique identifier of the target chat
* @param {Object} [options] Additional Telegram query options
* @param {Number} chatId Unique identifier of the target chat.
* @param {Object} [options] Additional Telegram query options.
* @return {Promise} On success, returns true.
* @see https://core.telegram.org/bots/api#removechatverification
*/
@ -3437,7 +3454,7 @@ class TelegramBot extends EventEmitter {
*
* @param {String} businessConnectionId Unique identifier of the business connection on behalf of which to delete the message.
* @param {Number[]} messageIds List of 1-100 identifiers of messages to delete. All messages **must be from the same chat**.
* @param {Object} [options] Additional Telegram query options
* @param {Object} [options] Additional Telegram query options.
* @return {Promise} On success, returns true.
* @see https://core.telegram.org/bots/api#deletebusinessmessages
*/
@ -3505,9 +3522,9 @@ class TelegramBot extends EventEmitter {
* @return {Promise} On success, returns true.
* @see https://core.telegram.org/bots/api#setbusinessaccountprofilephoto
*/
setBusinessAccountProfilePhoto(businessConnectionId, photo, form = {}) {
setBusinessAccountProfilePhoto(businessConnectionId, photo, options = {}) {
const opts = {
qs: {},
qs: options,
};
opts.qs.business_connection_id = businessConnectionId;
@ -3520,7 +3537,7 @@ class TelegramBot extends EventEmitter {
return Promise.reject(ex);
}
return this._request('setBusinessAccountProfilePhoto', { form });
return this._request('setBusinessAccountProfilePhoto', opts);
}
/**
@ -3659,6 +3676,116 @@ class TelegramBot extends EventEmitter {
return this._request('transferGift', { form });
}
/**
* This method posts a story on behalf of a managed business account.
*
* Requires the **can_manage_stories** business bot right.
*
* @param {String} businessConnectionId Unique identifier of the business connection.
* @param {Array} content [InputStoryContent](https://core.telegram.org/bots/api#inputpaidmedia). The photo/video property can be String, Stream or Buffer.
* @param {Number} activePeriod Unique identifier of the chat which will own the gift. The chat **must be active in the last 24 hours**.
* @param {Object} [options] Additional Telegram query options
* @return {Promise} On success, returns [Story](https://core.telegram.org/bots/api#story).
* @see https://core.telegram.org/bots/api#poststory
*/
postStory(businessConnectionId, content, activePeriod, options = {}) {
const opts = {
qs: options,
};
opts.qs.business_connection_id = businessConnectionId;
opts.qs.active_period = activePeriod;
try {
const inputHistoryContent = content;
opts.formData = {};
if (!content.type) {
return Promise.reject(new Error('content.type is required'));
}
const { formData, fileIds } = this._formatSendMultipleData(content.type, [content]);
opts.formData = formData;
if (fileIds[0]) {
inputHistoryContent[content.type] = fileIds[0];
} else {
inputHistoryContent[content.type] = `attach://${content.type}_0`;
}
opts.qs.content = stringify(inputHistoryContent);
} catch (ex) {
return Promise.reject(ex);
}
return this._request('postStory', opts);
}
/**
* This method edits a story previously posted by the bot on behalf of a managed business account.
*
* Requires the **can_manage_stories** business bot right.
*
* @param {String} businessConnectionId Unique identifier of the business connection.
* @param {Number} storyId Unique identifier of the story to edit.
* @param {Array} content [InputStoryContent](https://core.telegram.org/bots/api#inputpaidmedia). The photo/video property can be String, Stream or Buffer.
* @param {Object} [options] Additional Telegram query options
* @return {Promise} On success, returns [Story](https://core.telegram.org/bots/api#story).
* @see https://core.telegram.org/bots/api#editstory
*/
editStory(businessConnectionId, storyId, content, options = {}) {
const opts = {
qs: options,
};
opts.qs.business_connection_id = businessConnectionId;
opts.qs.story_id = storyId;
try {
const inputHistoryContent = content;
opts.formData = {};
if (!content.type) {
return Promise.reject(new Error('content.type is required'));
}
const { formData, fileIds } = this._formatSendMultipleData(content.type, [content]);
opts.formData = formData;
if (fileIds[0]) {
inputHistoryContent[content.type] = fileIds[0];
} else {
inputHistoryContent[content.type] = `attach://${content.type}_0`;
}
opts.qs.content = stringify(inputHistoryContent);
} catch (ex) {
return Promise.reject(ex);
}
return this._request('editStory', opts);
}
/**
* This method deletes a story previously posted by the bot on behalf of a managed business account.
*
* Requires the **can_manage_stories** business bot right.
*
* @param {String} businessConnectionId Unique identifier of the business connection.
* @param {Number} storyId Unique identifier of the story to delete.
* @param {Object} [options] Additional Telegram query options.
* @return {Promise} On success, returns True.
* @see https://core.telegram.org/bots/api#deletestory
*/
deleteStory(businessConnectionId, storyId, form = {}) {
form.business_connection_id = businessConnectionId;
form.story_id = storyId;
return this._request('deleteStory', { form });
}
}
module.exports = TelegramBot;