# mullwar/telebot

The easy way to write Telegram bots in Node.js

Repository: https://github.com/mullwar/telebot
Canonical: https://ross.abutalabs.com/products/mullwar-telebot
Homepage: https://www.npmjs.com/package/telebot
Language: JavaScript
License: MIT
License Family: permissive
Topics: telegram, telegram-bot, telegram-bot-api, telebot, bot, nodejs, node, npm
Archived: true
Last push: 2023-12-10T12:48:29+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4059, "days_push": 997, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: archived
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1476, forks 254 (observed 2026-08-28T04:04:50.229470+00:00)

## What it is
Telebot is a Node.js library that wraps the Telegram Bot API, letting developers create Telegram bots with a simple, promise-based interface. It supports both polling and webhooks, full Bot API coverage including payments, and an extensible plugin and event system.

## Use cases
- build a telegram bot in node.js
- create a telegram bot with javascript
- handle telegram bot updates via webhook
- make a telegram bot that answers commands
- add payments to a telegram bot
- extend a telegram bot with plugins
- simple telegram bot api wrapper for node

## When to choose
- You want a lightweight, promise-based Node.js wrapper that covers the full Telegram Bot API, including payments
- You want to get a bot running quickly with polling or webhook support and minimal boilerplate
- You want to organize bot logic with an event system and share behavior via plugins

## When to avoid
- You need a framework with heavy ongoing development, frequent releases, or long-term guarantees - activity is low and a 2.0 rewrite has been in progress for a long time
- Your project is not on Node.js/JavaScript
- You need advanced built-in bot patterns such as conversation scenes, wizards, or state management without building them yourself

## Facets
- artifact type: library
- maturity: maintenance
- function: chatbot, sdk, webhook, plugin-system, http-client
- domain: chatbots, messaging-platforms, developer-tools
- platform: -
- tags: telegram-bot, telegram-bot-api, api-wrapper, bot-framework, promises, long-polling, payments, npm-package, javascript, nodejs

## Member repositories
- mullwar/telebot (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:50.229470+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:34:28.276154+00:00, confidence not recorded.
  - readme: https://github.com/mullwar/telebot (fetched 2026-08-28T04:04:50.229470+00:00, sha 4d83265361f2)
  - registry_npm: https://registry.npmjs.org/telebot (fetched 2026-08-29T11:41:59.072258+00:00, sha 0c4e0bcddec0)
- Data as of 2026-08-30T08:39:29.467469+00:00.
