telegram-http-echo-bot's Introduction

Telegram HTTP echo bot

This bot allows broadcasting HTTP requests sent to a little web service to Telegram conversations. It can be used as an echo service for your applications to send notices to subscribed users through Telegram.

Quick start

Install dependencies

npm install

Copy config.json.tmpl to config.json

cp config.json.tmpl config.json

Add your BotFather token to config.json.
Run the application:

npm run-script serve

This will run the HTTP server on port 3030.

curl -X POST \
  http://localhost:3030/topic \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -d '{
	"topic": "sports"
}'

curl -X POST \
  http://localhost:3030/topic \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -d '{
	"topic": "technology"
}'

Add the bot to a Telegram chat
Subscribe to some topics with /subscribe :topic, e.g. /subscribe sports

Send messages to subscribed chats:

curl -X POST \
  http://localhost:3030/broadcast \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -d '{
	"topic": "sports",
	"message": {
		"Title": "Gareth Southgate has paid tribute to former team-mate Ugo Ehiogu",
		"Summary": "England manager Gareth Southgate has paid tribute to Ugo Ehiogu and spoken of the *true partnership* he shared with his former Aston Villa and Middlesbrough team-mate.",
		"Read more": "http://www.skysports.com/football/news/11095/10845530/gareth-southgate-has-paid-tribute-to-former-team-mate-ugo-ehiogu"
	}
}'