Telegrambo
Telegrambo is a simple library for interacting with the Telegram Bot API
This library is based on the telegram API, so all methods of the bot instance will be available methods from the telegram list.
The context in the event handler also uses the available methods, while having ready-made fields in the arguments of these methods, such as chat_id or message_id and others. If necessary, you can overwrite these fields.
Installation
You can install Telegrambo using npm:
npm install telegrambo
Usage
At first, create bot:
// bot.js
import telegrambo from 'telegrambo';
const bot = telegrambo(process.env.YOU_BOT_TOKEN);
// Create echo-bot
bot.on('message', (event) => {
event.sendMessage({
text: event.message.text
});
});
export default bot;
Then import it as a module. For example, using bot with webhook:
import bot from './bot.js';
export default async function handler(request, response) {
// Listening webhook on POST-request
if (request.method === 'POST') {
// request.body must be a object
const {ok, result} = await bot.setUpdate(request.body);
console.log(result);
// Set webhook if query-string of url have 'webhook':
// https://my-syte.com?webhook
} else ('webhook' in request.query) {
await bot.setWebhook({
url: 'https://my-syte.com'
});
}
return response.send('Ok');
}
Or with long polling:
import bot from './bot.js';
(async () => {
let offset = 0;
let timeout = 60;
while (true) {
const {ok, result} = await bot.getUpdates({
offset,
timeout
});
if (!ok)
break;
if (!result.length)
continue;
offset = result.at(-1).update_id + 1;
for (let update of result)
bot.setUpdate(update);
}
})();
List of events you can get from type Update in official documentation. It can be any field except update_id. For example, listen event callback_query:
// bot.js
import telegrambo from 'telegrambo';
const bot = telegrambo(process.env.YOU_BOT_TOKEN);
// Send keyboard on command "/somedata"
bot.on('message', (event) => {
if (event.message.text === '/somedata') {
event.sendMessage({
text: 'Press the button and bot send some data',
reply_markup: {
inline_keyboard: [[{
text: 'Send some data',
callback_data: 'SOME DATA'
}]]
}
});
}
});
// Handle callback-query event
bot.on('callback_query', (event) => {
if (event.callback_query.data === 'SOME DATA') {
event.sendMessage({
text: 'You press the button, and bot send <b>some data</b>',
parse_mode: 'HTML'
});
}
});
If passed just one argument in 'bot.on' method, and it's a function, this handler be applied to any event:
// bot.js
import telegrambo from 'telegrambo';
const bot = telegrambo(process.env.YOU_BOT_TOKEN);
// Passed just function
bot.on((event, eventName) => {
const name = event[eventName].from.first_name;
event.sendMessage({
text: `Hi, ${name}! The event <i>${eventName}</i> just happened`,
parse_mode: 'HTML'
});
});Own methods
You can create own methods for bot. For example:
import bot from './bot.js';
// Write function for creating new method
function createOnTextMethod(bot) {
return (matchText, handler) => {
bot.on('message', (event) => {
if (event.message.text === matchText)
return handler(event);
});
};
};
// Initialize new method onText
bot.onText = createOnTextMethod;
// Run new method
bot.onText('Hello', (event) => {
return event.sendMessage({
text: 'Hi there!'
});
});Also you can add new methods for event context. Like this:
import bot from './bot.js';
// Write method for send log from object to user:
function createEventLog(event, eventName) {
return (object) => {
event.sendMessage({
text: `<pre>${JSON.stringify(object, null, ' ')}</pre>`,
parse_mode: 'HTML'
});
};
};
// Initialize new method
bot.event.log = createEventLog;
// And use in event handler
bot.on('message', (event) => {
return event.log(event.message)
});API
nodeBotAsync(token)
Creates a new BotContext object that handles events and provides a proxy to interact with the bot.
token (string): Telegram token of bot
bot.on(eventName, eventHandler)
Adds an event handler for the specified event name.
eventName (string|function): The name of the event or a function to handle all events.
eventHandler (function): The function to handle the event.
bot.setUpdate(update)
Processes the given event payload and returns an array of event handlers.
update (Object): The payload of the event to be processed.
License
Telegrambo is MIT licensed.
Please make sure to update the installation, usage, and API sections with the correct information for your library. Also, don't forget to include a license file and a contributing guidelines file if applicable.