Telegram Plug-in

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

Property	Description
Name	Assign any unique name for your connection.

Section: Plug-in

Feature	Description
Bot Access Token	The access token is provided by "BotFather": Go to the Telegram program and select BotFather from your contacts. Request a new bot with the command /newbot. BotFather will now ask you for a name for your bot. You can choose any name you like. BotFather will then ask for a username. This must always end with _bot end with, for example Redaktion123_bot If the name is not already taken, BotFather will send you a confirmation and the AccessToken, which you can find in the properties under the Plug-in section. Enter the other properties and confirm your entries with "OK."
Maximum file size	The maximum file size specifies (in MB) how large received files may be before the transfer is rejected.

The BotFather is used to manage Telegram bots. You can use BotFather to create, edit, and delete bots. Once you have created a bot, BotFather will provide you with the access token. You can retrieve the access token from BotFather at any time. The account that created a bot is the non-transferable owner of the bot. This section is for information purposes only; you do not need to enter anything in this area.

Section: BotFather

Property	Description
Help text	If you want to show users automatic suggestions for possible commands, proceed as follows: Send "/setcommands" to BotFather with the bot owner. Send your bot name (@BotUsername) to BotFather. Copy the help text from the "BotFather" section in the Telegram plugin of your OPC Router and send it to BotFather. Repeat the process after you have added, removed, or changed Telegram triggers.

Telegram bots are always displayed publicly and can be addressed by any Telegram user. Internal authentication filters out unauthenticated users before the triggers are activated.

Users can be manually authenticated after they have written to the bot (/start) or authenticate themselves using a previously generated confirmation code.

Property

Description

Authentication method

Select the desired authentication method: Authentication method "None": Telegram bots are always displayed publicly and can be accessed by any Telegram user without restrictions. No further settings are required. "Internal" authentication method: Internal authentication filters out unauthenticated users before the triggers are activated. Users can be authenticated manually after they have written to the bot (/start) or authenticate themselves using a previously generated confirmation code.

note

Note: Messages can only be sent to users who have already sent at least one message to the bot. Messages that are to be sent to everyone are sent to all registered users (including those who are not authenticated). However, a maximum of 30 messages per second may be sent (Telegram API limit).

Section: Registration

Property	Description
Authentication method	None: no authentication required (not recommended) Internal: Users can be managed in the plug-in FAS Login: Log in via FAS login.

For internal authentication method

Section: Known users

Property	Description
Known users	List of known users. You can remove a user from the list using the "Delete user" button. You can revoke or assign permissions to known users using the "Revoke permission" or "Grant permission" buttons.

Confirmation key section

Property	Description
Confirmation Key	Displays the known confirmation keys. You can remove confirmation keys from the list or add new ones using the "Delete Confirmation Code" and "Create Confirmation Code" buttons.

For FAS login authentication method

Section: Database

Here, connect the plug-in instance that can access the FAS login database.

Section: Email

Here, connect the plug-in instance that will be used to send registration emails.

Enter the sender address in the field and edit the email text.

Confirm your entries with "OK."

The following edit bots are helpful:

• /setname - to change a bot name
• /setdescription - to change a bot's description
• /setabouttext - to change the bot's info
• /setuserpic - to change a profile picture
• /setcommands - to change the command list
• /deletebot - to delete a bot
• /setjoingroups - the bot may be added to groups
• /setprivacy - the bot may see/read messages in groups