NodeJS : Writing your first telegram bot

22 Jun 2018

Telegram bots helps to add you own custom functionality to telegram by running your own third party applications. It can help to communicate or share information, do some fun/informative tasks with in the telegram, can help groups to avoid spam messages or may be take a poll in the group.

In this tutorial we will look into inline mode bots which users can use them in the text field itself.

Register bot

Writing an telegram bot starts with the simple task of registering your bot with @BotFather and get the bot token. You can create a new bot by sending the command /newbot to BotFather.Then BotFather will take you though a interactive chat to set the username, description etc and give back the bot token. Once you have the bot token keep it confidential and don’t share it with anyone. In this blog post we are creating an Inline mode bot. For this we have to enable inline mode by sending /setinline command to BotFather and provide a placeholder text.

Setup project

Lets setup up a nodejs project using command npm init -y and install the first and main package telegram-node-bot using

npm i telegram-node-bot

This package uses MVC kind of architecture with router, controller etc.

Then setup your main controller and router. For inline mode bot the contoller should extend from Telegram.TelegramBaseInlineQueryController.

'use strict'

const Telegram = require('telegram-node-bot')

const TelegramBaseInlineQueryController = Telegram.TelegramBaseInlineQueryController
const tg = new Telegram.Telegram(process.env.TELEGRAM_BOT_TOKEN, {
    workers: 1

class DuckController extends TelegramBaseInlineQueryController {
    handle($) {
        // handle the query

    .inlineQuery(new DuckController())

By default telegram-node-bot uses long-polling to get the updates. If you want to setup the webhook, you can use the option webhook along with workers option.

const tg = new Telegram.Telegram(process.env.TELEGRAM_BOT_TOKEN, {
    workers: 1,
    webhook: {
        url: process.env.WEBHOOK_URL,
        port: process.env.PORT || 3000,
        host: process.env.WEBHOOK_HOST || 'localhost'

In my opinion, webhook is needed only on production. If you want to use webhook in development, then you need to expose the local webserver to internet via ngrok or some other similar services.

Handling query

Handling query is the part where we want our bot to do the main task which they are intended to do. like search for images, search for google results etc. For this demo we will convert the user query into search url.

class DuckController extends TelegramBaseInlineQueryController {
    handle($) {
        const query = $._inlineQuery.query;
        let results = [];
        if (query) {
            results = [{
                id: Math.random().toString(36).substring(7),
                message_text: `${encodeURIComponent(query)}`,
                title: 'Duck It',
                description: `${query}`
        $.answer(results, {}, function(result) {

The handle method will be called with first argument ($) which has the context of message like, what’s the user query, who is the user and other details. In our case we need only the query send by the user which we can get from $._inlineQuery.query.

Next, constuct the results array using appropriate inline query result type, In this case article. Once we have the results constructed, pass it to $.answer method and the result will be shown to the users in telegram.

To see our inline bot in action,

TELEGRAM_BOT_TOKEN=<bot token> node index.js

You can optionally add start command (node index.js) to npm scripts.


Hosting your bot

You can use any hosting provider to host our bot. For me the easiest to host node project is heroku. You can setup a new project there and get the public url. like and then setup the ENV variable in the project settings.

In this make sure you provide

  • WEBHOOK_HOST as and

heroku env vars

After this go to BotFather and set webhookurl using the command /setwebhookurl or use the api url<bot token>/setwebhook?url=

This bot is available as @lmdtfy_bot for telegram users and code on github

Hope it helped.

Versions of Language/packages used in this post.

| Library/Language  | Version |
| ----------------- |---------|
|      Node         |  10.0.0 |
|      NPM          |  6.0.1  |
| telegram-node-bot |  4.0.5  |
If you particularly enjoy my work, I appreciate donations via PayPal.
comments powered by Disqus