Opengram NPM | npm.io

Telegram Bot API framework for Node.js based on Telegraf 3.38

Introduction

Bots are special Telegram accounts designed to handle messages automatically. Users can interact with bots by sending them command messages in private or group chats. These accounts serve as an interface for code running somewhere on your server.

Opengram is a library that makes it simple for you to develop your own Telegram bots using JavaScript.

Features

Full Telegram Bot API 6.9 support
JSDoc annotated
Lightweight
AWS λ / Firebase / Glitch / Fly.io / Deta space / Whatever ready
http / https / fastify / Connect.js / express.js compatible webhooks
Extensible

Quickstart

If you are new to Telegram bots, read the official Introduction for Developers written by the Telegram team.

Visit @BotFather and create a new bot. You will obtain a bot token.
Install opengram:
- pnpm: pnpm install opengram
- yarn: yarn add opengram
- npm: npm i opengram

Create bot.js file and paste code

const { Opengram, isTelegramError } = require('opengram')

if (process.env.BOT_TOKEN === undefined) {
  throw new TypeError('BOT_TOKEN must be provided!')
}

// Create Opengram instance with BOT TOKEN given by http://t.me/BotFather
const bot = new Opengram(process.env.BOT_TOKEN)

// Add handler for text messages
bot.on('text', async ctx => {
  await ctx.reply(ctx.message.text)
})

// Register error handler, for preventing bot crashes
bot.catch((error, ctx) => {
  if (isTelegramError(error)) {
    console.error(error, ctx) // Print error and context
    return
  }
  throw error
})

// Start bot using long-polling
bot.launch()
  .then(() => console.log(`Bot started`))

// Enable graceful stop
process.once('SIGINT', () => bot.stop())
process.once('SIGTERM', () => bot.stop())