Version: 5.3

Telegram Plug-in

You set the following properties in the configuration of the Telegram Bot plug-in:


Name	Assign a free unique name for your connection.

Part: Plug in

Bot access token


Bot access token	The Access Token is provided by the “BotFather”:1. Go to the Telegram program and select BotFather from the contacts. Go to the Telegram program and select BotFather from the contacts. Ask for a new bot with the command `/newbot`. The BotFather will now ask you for a name for your bot. This name can be defined by you.. The BotFather then asks for a username. This must always end with `_bot`. e. g. `Temperature_bot` If the name is not yet occupied, the BotFather will send you a confirmation and the AccessToken, which you can copy into the properties at the Plug-in area. Enter the other properties and confirm your entries with “OK”.
Maximum file size	The maximum file size indicates (in MB) how large received files may be before the transfer is aborted automatically.

The Access Token is provided by the “BotFather”:1. Go to the Telegram program and select BotFather from the contacts.

Go to the Telegram program and select BotFather from the contacts.
Ask for a new bot with the command /newbot.
The BotFather will now ask you for a name for your bot. This name can be defined by you..
The BotFather then asks for a username. This must always end with _bot. e. g. Temperature_bot
If the name is not yet occupied, the BotFather will send you a confirmation and the AccessToken, which you can copy into the properties at the Plug-in area.
Enter the other properties and confirm your entries with “OK”.

Maximum file size The maximum file size indicates (in MB) how large received files may be before the transfer is aborted automatically.

The BotFather was made to administrate your Telegram bots. With the BotFather you can create, edit or delete bots. If you already created a bot, the BotFather can tell you the AccessToken. You can ask the BotFather for your AccessToken whenever you want. The account, which has created the bot, is the inalienable owner of the bot. This section is for information, you do not need to enter anything in this area.

Part: BotFather


Help text	If you want to show users automatic suggestions of possible commands, proceed as follows: Send “/setcommands” by the botholder to the BotFather. Send @BotUsername to the BotFather. Copy the help text from the “BotFather” section in the Telegram plug-in of your OPC Router and send it to the BotFather. Repeat the process after adding, deleting or changing telegram triggers.

Help text

If you want to show users automatic suggestions of possible commands, proceed as follows:

Send “/setcommands” by the botholder to the BotFather.
Send @BotUsername to the BotFather.
Copy the help text from the “BotFather” section in the Telegram plug-in of your OPC Router and send it to the BotFather.
Repeat the process after adding, deleting or changing telegram triggers.

Telegram Bots are always displayed publicly and can be accessed by any Telegram user. Internal authentication filters out unauthenticated users before triggers are initiated.

Users can be authenticated manually after writing to the bot (/start) or by authenticating themselves with a previously generated confirmation code.


Authentication method	Select the desired authentication method: Authentication method “None”: Telegram bots are always public and everyone can send request to the bot. No further settings need to be made. Authentication method “Intern”: The internal user authentication filters unauthorized users before they uses any trigger. Users can get authorized manually after a request (/start) or they can send an authorization code which was already generated. Note: Messages can only be sent to users who have already sent at least one message to the bot. Messages to be sent to all will be sent to all registered users (even those who are not authenticated). However, a maximum of 30 messages per second may be sent (Limit Telegram API).

Authentication method

Select the desired authentication method:

Authentication method “None”: Telegram bots are always public and everyone can send request to the bot. No further settings need to be made.
Authentication method “Intern”: The internal user authentication filters unauthorized users before they uses any trigger. Users can get authorized manually after a request (/start) or they can send an authorization code which was already generated.
Note: Messages can only be sent to users who have already sent at least one message to the bot. Messages to be sent to all will be sent to all registered users (even those who are not authenticated). However, a maximum of 30 messages per second may be sent (Limit Telegram API).

Section: Authentication



Authentication method	None: None authentication (not recommended) Internal: user can be managed in the plug-in FAS Login: Sign in via the FAS-Login

For Authentication method Internal

Section: Known users


Known users	List of known users. You can remove a user from the list using the “Delete user” button. You can use the “Deny permission” or “Allow permission” buttons to deny or allow permissions to known users.

Section Registration key


Registration key	Displays the known registration keys. Use the “Delete registration code” and “Create validation code” buttons to remove registration keys from the list or add new ones.

Section: Database

Provide the database instance where the FAS login database is deployed.

Section: E-mail

Provide the email instance which should be used to send the authorization emails.

Enter here the sender address.

Edit the E-mail text of the Registration email.

Confirm your entries with “OK”.

The following edit bots are helpful:

/setname - change a bot's name
/setdescription - change bot description
/setabouttext - change bot about info
/setuserpic - change bot profile photo
/setcommands - change the list of commands
/deletebot - delete a bot
/setjoingroups - the bot may be added in groups
/setprivacy - the bot may see/read messages in groups

For Authentication method Internal​

For authentication method FAS-Login​

For Authentication method Internal

For authentication method FAS-Login