HTTP->Telegram Gateway Notification Service

Simplistic server which connects to a Telegram bot, takes messages via POST-requests containing json encoded data and sends them to all clients subscribed.

Telegram Setup

create a bot as described here
add your bot as a contact

Telegram Bot Commands

/start          # subscribe
/unsubscribe    # unsubscribe

Server Setup

 usage: telegram-interface.py [-h] [--interface INTERFACE] [--port PORT]
                              [--token-file TOKEN_FILE]
 
 optional arguments:
   -h, --help               show this help message and exit
   --interface INTERFACE    Interface on which to listen (default: localhost)
   --port PORT              Port on which to listen (default: 5000)
   --token-file TOKEN_FILE  File containing the Bot-Token (default: bot.token)

HTTP Request

The HTTP request must be a POST-request, with Content-Type: application/json and a json-field containing the key "message" with the value being the message you want to send.

The following locations are supported:

/send-all   # send a message to all subscribed clients

Example (curl)

curl -X POST -H "Content-Type: application/json" --data '{"message":"hallo world"}' localhost:5000/send-all

1.3 KiB Raw Permalink Blame History