Node Telegram Keyboard Wrapper

A support to manage keyboards and force replies in Telegram via bots
Alternatives To Node Telegram Keyboard Wrapper
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Node Telegram Bot Api6,9871,94028312 hours ago60August 29, 202265mitJavaScript
Telegram Bot API for NodeJS
Telegram Bot Ruby1,24134332a month ago62April 19, 202284wtfplRuby
Ruby wrapper for Telegram's Bot API
Universal Arduino Telegram Bot945
10 days ago143mitC++
Use Telegram on your Arduino (ESP8266 or Wifi-101 boards)
Gokurakujoudo880
2 days ago54gpl-3.0Clojure
config karabiner with ease
Telegrambotphp7075121 days ago17June 09, 20221mitPHP
A very simple PHP Telegram Bot API for sending messages.
Botgram2261112 years ago12July 30, 20186iscJavaScript
⚙️ Microframework to build Telegram bots
Node Telegram Bot Api Tutorial198
2 years ago4
node-telegram-bot-api tutorial
Calendar Telegram158
2 years ago1mitPython
A simple inline calendar for Telegram bots
Bot Brother1551936 years ago63October 08, 20169CoffeeScript
Node.js framework for telegram bots
Ctbot129
3 months ago39mitC++
A simple (and easy to use) Arduino Telegram BOT Library for ESP8266/ESP32
Alternatives To Node Telegram Keyboard Wrapper
Select To Compare


Alternative Project Comparisons
Readme

Node telegram keyboard wrapper

This library aims to provide a set of classes to improve the creation of keyboards and setup for force-reply in Telegram bots.

Built upon yagop's node-telegram-bot-api, it can work with any Node.js Bot Api wrapper, as it exports Telegram Bot APIs-compliant JSON structures.

⚠ v3.0.0 of this library is a major rewrite that is not retro-compatible. It doesn't export anymore an object with reply_markup. From now on, it will export just the content for reply_markup, which will vary from keyboard to keyboard. ⚠


Architecture

The philosophy behind this library, since v3, is to make it easier, through a series of state-less classes, to create the JSON structures to represent Rows, Buttons and the whole keyboards.

To achieve this, both ReplyKeyboard and InlineKeyboard classes and Row class extend the native Array interface.

Therefore you can do every operation you want just like you were acting on Arrays.


Looking for previous version?

I hope you don't, but if you really need it, here it is.


Install

$ npm install --save node-telegram-keyboard-wrapper

Example

In examples folder, an example bot is available. It requires a bot token to be passed as argument.

$ npm run example -- 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

Then just type /replyKeyboard (and answer or click to hide), /inlineKeyboard (and click to trigger) or /forceReply in your Telegram client to see the wrapper in action.


API Reference


ForceReply

static .getMarkup

ForceReply.getMarkup(selective: boolean = false): Object;

ForceReply.getMarkup();
ForceReply.getMarkup(true);

Use this method to export the structure to be sent to reply_markup.

Arguments:

Argument Type Required Default Value
selective boolean false false

Row (extends Array.prototype)

new Row<R extends InlineKeyboardButton | KeyboardButton>(...values: R[]): Row;

Use this class to define a row to which buttons can be appended to.

Push this class into an InlineKeyboard or a ReplyKeyboard to let them create the structure.

This class extends native arrays and, therefore, allows every operation you can perform on Arrays to be performed on this.

Arguments:

Inherited from Array's constructor.


.clone

Row.prototype.clone(): Row<R>;

const row = new Row<KeyboardButton>();
const clone = row.clone();

row !== clone; // true;

Creates a copy of the row and clones all its children / buttons.


InlineKeyboard (extends Array.prototype)

new InlineKeyboard(...values: Row<InlineKeyboardButton>[]): InlineKeyboard;

Use this class to create a container for InlineKeyboards.

This class extends the native Array interface, therefore every operation you can perform on Arrays is allowed to be performed on this.

Arguments:

Inherited from Array's constructor.


.getMarkup

InlineKeyboard.prototype.getMarkup(): Object;

const keyboard = new InlineKeyboard();
keyboard.getMarkup();

Use this method to export the structure to be sent to reply_markup.

Throws if no rows got pushed in the object.

Arguments:

none.


.clone

InlineKeyboard.prototype.clone(): InlineKeyboard;

const keyboard = new InlineKeyboard();
const clone = row.clone();

keyboard !== clone; // true;

Creates a copy of the keyboard, a copy of all of its row and a clone of all of their children / buttons.


InlineKeyboardButton

new InlineKeyboardButton<S extends string>(text: string, exclusiveKey: S, exclusiveValue: T[S]): InlineKeyboardButton;

Use this method to create a button to be pushed in a Row. As per the Telegram Bot API Documentation, each InlineKeyboardButton must have only one of the optional properties.

Arguments:

Argument Type Required Default Value Description
text string true - The visual string to be shown on the button.
exclusiveKey S extends string true - The required key for this button.
exclusiveValue T[S] true - the value for exclusiveKey (it differs from key to key).

For the valid values of exclusiveKey and exclusiveValue refer to InlineKeyboardButton;

Example:

const row = new Row<InlineKeyboardButton>();

row.push(
	new InlineKeyboardButton("My text", "url", "https://localhost:8080/"),
	new InlineKeyboardButton(
		"My text 2",
		"callback_data",
		"any data between 1 and 64 bytes"
	)
);

.clone

InlineKeyboardButton.prototype.clone(): InlineKeyboardButton;

const button = new InlineKeyboardButton();
const clone = button.clone();

button !== clone; // true;

Creates a copy of the button and objects inside it.


ReplyKeyboard (extends Array.prototype)

new ReplyKeyboard(...values: Row<KeyboardButton>[]): ReplyKeyboard;

Use this class to create a new keyboard that is going to show up under the text area in your Telegram client.

This class extends the native Array interface, therefore every operation you can perform on Arrays is allowed to be performed on this.

Arguments:

Inherited from Array's constructor.


.getMarkup

ReplyKeyboard.prototype.getMarkup(): Object;

const keyboard = new ReplyKeyboard();
keyboard.getMarkup();

Use this method to export the structure to be sent to reply_markup for opening the keyboard.

Throws if no rows got pushed in the object.

Arguments:

Argument Type Required Default Value
options Object false {}
options.resize_keyboard boolean false undefined
options.one_time_keyboard boolean false undefined
options.selective boolean false undefined


This list might get outdated. The arguments are used as they are passed. Refer to ReplyKeyboardMarkup for the complete list, eventually.



.remove

ReplyKeyboard.prototype.remove(): Object;

const keyboard = new ReplyKeyboard();
keyboard.remove();

Use this method to export the structure to be sent to reply_markup for closing definitely the keyboard.

Arguments:

Argument Type Required Default Value
selective boolean false false


.clone

ReplyKeyboard.prototype.clone(): ReplyKeyboard;

const keyboard = new ReplyKeyboard();
const clone = keyboard.clone();

keyboard !== clone; // true;

Creates a copy of the keyboard, a copy of all of its row and a clone of all of their children / buttons.


KeyboardButton

new KeyboardButton<S extends string>(text: string, options: Options): KeyboardButton;

Use this method to create a button to be pushed in a Row.

Arguments:

Argument Type Required Default Value Description
text string true - The visual string to be shown on the button.
options Object false {} The options for this button.
options.request_contact boolean false undefined -
options.request_location boolean false undefined -
options.request_poll Object false undefined -
options.request_poll.type "quiz" | "regular" true undefined -


Example:

const row = new Row<KeyboardButton>();

row.push(
	new KeyboardButton("My text 1", {
		request_location: true,
		request_contact: false,
	})
);

.clone

InlineKeyboardButton.prototype.clone(): InlineKeyboardButton;

const button = new InlineKeyboardButton();
const clone = button.clone();

button !== clone; // true;

Creates a copy of the button and objects inside it.


Testing

Tests are build upon Jasmine Unit suite. Run these commands to test changes after have cloned the repository:

$ npm install

$ npm run build # to build from Typescript
$ npm run build:spec # to build tests
$ npm test # to both build tests and run them

Any contribution, is welcome. Made with ❤️ in Italy.

Popular Telegram Projects
Popular Keyboard Projects
Popular Messaging Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Typescript
Telegram
Keyboard
Telegram Bot