Telegram is a messaging service for iOS, Android and other devices. A great advantage of Telegram is that it provides an open web service which can be used to send Telegram messages via software. More information about Telegram can be found here – the API documentation is available here.
To send Telegram messages for the NETx BMS Server, the so called Bot API can be used. This is used to communicate with so called Telegram bots. Bots are special accounts that do not require a phone number. This tutorial explains how a Telegram Bot can be created and how the NETx BMS Server can send messages to this bot.
Info |
---|
In order to use this functionality, it is assumed that you have installed the Telegram app on your smart phone. The Telegram app can be download from Apple iTunes or Google Play Store. In addition, it is assumed to you have created a Telegram account. More information about Telegram can be found here. |
...
Now you have created a new bot. To access a bot via the HTTP API, an authentication token is necessary. This token has to be send within the URL of each HTTP request. The token for your bot is shown within the chat after having created the bot. Write down the token – we will need it within the NETx BMS Server configuration afterwards.
Open a chat with your bot
After having created your bot, you have to open a chat with him. Click on search button within your Telegram app, enter your bot name and add him to your contact list. Afterwards, click on "start" to start the chat and send any message (e.g. "hello") to the bot.
As next we need to retrieve the so called chat_id. The chat_id is necessary to send messages via the HTTP API. To get the chat_id, open your webbrowser and the enter the following URL (<your bot token> has to be replaced by the authentication token of your bot):
Code Block |
---|
https://api.telegram.org/bot<your bot token>/getUpdates |
You will get a JSON response which the message that you have sent to your bot.
Code Block |
---|
{
ok: true,
result: [
{
update_id: 43423455,
message: {
message_id: 8,
from: {
id: 54365464,
is_bot: false,
first_name: "<your first name>",
last_name: "<your last name>",
language_code: "de"
},
chat: {
id: 54365464,
first_name: "<your first name>",
last_name: "<your last name>",
type: "private"
},
date: 1512549481,
text: "Hello"
}
}
]
} |