Typedgram Bot
Interactive Telegram Bot API.
To start with a deploy-ready template see: typedgram-bot-openshift-template
Install
This project uses node-telegram-bot-api Node module. Make sure you have installed Node and npm.
$ npm install --save typedgram-botIf you are using tsd, run tsd link to import the typings. This should import to your typings/tsd.d.ts:
/// <reference path="../node_modules/typedgram-bot/definitions/src/typedgram-bot.d.ts" />
/// <reference path="../node_modules/typedgram-bot/definitions/src/node-telegram-bot-api.d.ts"/>Typescript Usage
This project interacts with Telegram using webhooks, so make sure you have access to your server ip, port and host.
Make sure you have installed Typescript:
npm install -g typescriptToken
Go talk to Telegram's official bot: @BotFather and ask for a token.
Setup
There are three default actions for every bot:
initializationAction: When the bot start and it's registered in Telegram servers.missingAction: When someone executes a command/without associated action.plainTextAction: When simple text (without commands/) is inputed.
Example
/// <reference path="../typings/tsd.d.ts"/>
import {TelegramTypedBot as Bot, IServerOptions, TelegramEvent} from 'typedgram-bot'
const PORT = process.env.PORT // do not choose 443
const TELEGRAM_TOKEN = process.env.TELEGRAM_TOKEN // from @botfather
const HOST = process.env.LOCAL_IP // Example: 127.0.0.1
const DOMAIN = process.env.LOCAL_URL // mybot.domain.com
const server: IServerOptions = {
host: HOST,
port: PORT,
domain: DOMAIN,
}
const bot = new Bot(TELEGRAM_TOKEN, server);
bot.onInitialization(me => {
console.log(`
------------------------------
Bot successfully deployed!
------------------------------
Bot info:
- ID: ${me.id}
- Name: ${me.first_name}
- Username: ${me.username}
Server info:
- Host: ${server.host}
- Port: ${server.port}
- Domain: ${server.domain}
- Node version: ${process.version}
------------------------------
`)
})How to response to /commands
When you register a command the associated method will be called. You can declare associate multiple commands to the same action.
Example
bot.onCommand(['/hello_world', '/hello'], msg => {
return bot.sendMessage(msg.chat.id, 'Hello world!')
}Interactive Responses
To make the interactions with the API easier, after sending a message of any type, make the resolve promise of that operation to wait for the user reply with bot.waitResponse(msg) where msg is the message from the user who triggered the interactive operation. This works saving the userId and the chatId.
Also, there is a timeout of 10000ms that you can change by adding a second parameter, example: bot.waitResponse(msg, 20000).
You can change the default value:
bot.responseTimeout = 20000On timeout the promise is rejected with a TimeoutError. See: Bluebird API reference.
Example
bot.onCommand(['/apps', '/applications'], msg => {
return bot.sendMessage(msg.chat.id, 'Select an app', {
reply_to_message_id: msg.message_id,
reply_markup: {
keyboard: [
['Telegram'],
['Whatsapp'],
],
force_reply: true,
one_time_keyboard: true,
selective: true
},
})
.then(bot.waitResponse(msg)) // Here!
.then(response => {
const keyboard = {
reply_to_message_id: response.message_id,
reply_markup: {
hide_keyboard: true
}
}
switch (response.text) {
case 'Telegram': {
return bot.sendPhoto(response.chat.id, './example/images/telegram.png', keyboard)
}
case 'Whatsapp': {
return bot.sendPhoto(response.chat.id, './example/images/whatsapp.png', keyboard)
}
default: {
return bot.sendMessage(response.chat.id, 'None selected', keyboard)
}
}
})
})See examples or check the definitions. There is a example showing how to use it on a Javascript project.
Development
To develop your bot locally, you need a secure connection to your local host. One way to achieve this is using a ngrok to create a tunnel to your computer.
Example
Once installed, create a tunnel to your app.
$ ngrok 8080
# Tunnel Status online
# Version 1.7/1.7
# Forwarding http://SUBDOMAIN.ngrok.com -> 127.0.0.1:8080
# Forwarding https://SUBDOMAIN.ngrok.com -> 127.0.0.1:8080
# Web Interface 127.0.0.1:4040
# # Conn 0
# Avg Conn Time 0.00msThen we set our development environment variables.
$ export TELEGRAM_TOKEN="TOKEN"
$ export PORT="8080"
$ export LOCAL_IP="127.0.0.1"
$ export LOCAL_URL="SUBDOMAIN.ngrok.com"Run your bot and it everything is ok, the initializationAction should be executed.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent