Opengram

Telegram Bot API framework for Node.js based on **Telegraf 3.38** [![Bot API Version][bots-api-image]][bots-api-url] [![CI][ci-image]][ci-url] [![codecov][codecov-image]][codecov-url] [![npm][npm-image]][npm-url] [![downloads][downloads-image]][downloads-url] [![javascript style guide][standard-image]][standard-url] [![Codacy Badge][codacy-image]][codacy-url] [![License: MIT][license-image]][license-url] [![FOSSA Status][fossa-image]][fossa-url]

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())

• Run node bot.js
• Congrats! You just wrote a Telegram bot 🥳

For more examples, check docs/examples in repository

Resources

• API Reference
• GitHub Discussions
• Chats:
  • Russian-speaking chat
  • English chat
• News channel

License