Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
March 27, 2019 02:18
March 27, 2019 14:08
January 20, 2016 18:22
July 22, 2017 13:17
April 19, 2018 22:24
March 27, 2019 02:19


Bots are special Telegram users controlled with an HTTP API. Botgram aims to expose the capabilities of this API with a very clear and minimal syntax, so you can create Telegram bots easily.

const botgram = require("botgram")
const bot = botgram("<auth token>")

bot.command("start", "help", (msg, reply) =>
  reply.text("To schedule an alert, do: /alert <seconds> <text>"))

bot.command("alert", (msg, reply, next) => {
  var [ seconds, text ] = msg.args(2)
  if (!seconds.match(/^\d+$/) || !text) return next()

  setTimeout(() => reply.text(text), Number(seconds) * 1000)

bot.command((msg, reply) =>
  reply.text("Invalid command."))


  • Simple, intuitive API.
  • Quick setup; just put your auth token and you're in business.
  • Exposes all functionality in the Bot API 2.3.1, including custom keyboards, inline keyboards, force reply, chat actions, deep linking, kicking users, editing messages, notifications...
  • Ability to stream downloads and uploads.
  • Powerful, connect-style message handling and filtering.

Bots API version implemented: December 4, 2016


npm install botgram

Follow the tutorial, take a look at more examples, or consult the documentation.