Node.js Telegram Bot API

📦 Install

1npm i node-telegram-bot-api

✍️ Note: If you use Typescript you can install this package that contains type definitions for this library

1npm install --save-dev @types/node-telegram-bot-api

🚀 Usage

1const TelegramBot = require('node-telegram-bot-api');
2
3// replace the value below with the Telegram token you receive from @BotFather
4const token = 'YOUR_TELEGRAM_BOT_TOKEN';
5
6// Create a bot that uses 'polling' to fetch new updates
7const bot = new TelegramBot(token, {polling: true});
8
9// Matches "/echo [whatever]"
10bot.onText(/\/echo (.+)/, (msg, match) => {
11  // 'msg' is the received Message from Telegram
12  // 'match' is the result of executing the regexp above on the text content
13  // of the message
14
15  const chatId = msg.chat.id;
16  const resp = match[1]; // the captured "whatever"
17
18  // send back the matched "whatever" to the chat
19  bot.sendMessage(chatId, resp);
20});
21
22// Listen for any kind of message. There are different kinds of
23// messages.
24bot.on('message', (msg) => {
25  const chatId = msg.chat.id;
26
27  // send a message to the chat acknowledging receipt of their message
28  bot.sendMessage(chatId, 'Received your message');
29});

📚 Documentation

• Usage
• Examples
• Tutorials
• Help Information
• API Reference: (api-release / development / experimental)
• Contributing to the Project
• Experimental Features

Note: Development is done against the development branch. Code for the latest release resides on the master branch. Experimental features reside on the experimental branch.

💭 Community

We thank all the developers in the Open-Source community who continuously take their time and effort in advancing this project. See our list of contributors.

We have a Telegram channel where we post updates on the Project. Head over and subscribe!

We also have a Telegram group to discuss issues related to this library.

Some things built using this library that might interest you:

• tgfancy: A fancy, higher-level wrapper for Telegram Bot API
• node-telegram-bot-api-middleware: Middleware for node-telegram-bot-api
• teleirc: A simple Telegram ↔ IRC gateway
• bot-brother: Node.js library to help you easily create telegram bots
• redbot: A Node-RED plugin to create telegram bots visually
• node-telegram-keyboard-wrapper: A wrapper to improve keyboards structures creation through a more easy-to-see way (supports Inline Keyboards, Reply Keyboard, Remove Keyboard and Force Reply)
• beetube-bot: A telegram bot for music, videos, movies, EDM tracks, torrent downloads, files and more.
• telegram-inline-calendar: Date and time picker and inline calendar for Node.js telegram bots.
• telegram-captcha: Telegram bot to protect Telegram groups from automatic bots.

👥 Contributors

License

The MIT License (MIT)

Copyright © 2019 Yago