Startseite | alvasys automation ag
Startseite | alvasys automation ag
Telegram
User Manual for alvasys automation models including: SSI-DR-TELEGRAMIP1U, DR Telegram Driver, Telegram Driver, Driver
Jan 22, 2025 · For your information there is only one bot per JACE, but multiple groups can be made per bot! https://web.telegram.org/k/and connect to your ...
Treiber für Telegram für Niagara 4 Update 1 Gruppen | alvasys automation ag
File Info : application/pdf, 15 Pages, 1.41MB
DocumentDocumentALVASYS-DR-Telegram Driver
Software installation and configuration manual.
Ver: 1.0 Date: January 20, 2025 Author: M.Meriano
1 History
Rev.
Date January 22, 2025
Author Marcello Meriano
Description First draft
+41 (0)44 261 00 70 info@alvasys.ch / www.alvasys.ch / www.alvasys.de
alvasys automation ag / Hermetschloostrasse 75 / CH-8048 Zürich
2 index
1 History .....................................................................................................................................................................1 2 index .......................................................................................................................................................................2 3 Confidentiality Notice ..............................................................................................................................................3 4 introduction .............................................................................................................................................................3
Requirements .........................................................................................................................................................3 5 Telegram bot and group..........................................................................................................................................4
Select the people who should be in this alarm group. Important: Your bot (I'mnowyourBOT) must also be a member of this group! ............................................................................................................................................7 ............................................................................................................................................................................... 7 6 modules...............................................................................................................................................................8 Compatibility ........................................................................................................................................................... 9 7 license .....................................................................................................................................................................9
78 Installing the modules...........................................................................................................................................9
9 Installing TELEGRAM modules ............................................................................................................................12 Inserting the modules under the service JACE/MAC/HAWK/ ..............................................................................12 Setting in the Telegram service ............................................................................................................................13 Setting up and configuring Telegram Recipient (JACE/MAC/HAWK) ..................................................................14
+41 (0)44 261 00 70 info@alvasys.ch / www.alvasys.ch / www.alvasys.de
alvasys automation ag / Hermetschloostrasse 75 / CH-8048 Zürich
3 Confidentiality Notice
The information in this document is confidential Information of alvasys automation ag ("alvasys"). Such information and the software described herein are provided under license agreement and may only be used in accordance with this agreement. The information contained in this document is provided solely for the use of employees, licensees and system owners of ALVASYS. The contents of this document may not be passed on to others or reproduced for others. Although all efforts made to ensure the accuracy of this document, ALVASYS shall not be liable for damages of any kind, including consequential damages, resulting from the application of the information contained herein. Information and specifications published here are current as of the date of this publication and are subject to change without notice. This document may be copied by parties authorized to distribute ALVASYS products in connection with the distribution of those products, provided that this is authorized by the contracts permitting such distribution. It may not otherwise be copied, photocopied, reproduced, translated or reduced in any electronic or machine-readable form, in whole or in part, without the prior written consent of ALVASYS.
4 introduction
Requirements · Niagara 4.x(>= 4.7)
· A license to use the alvassiTELEGRAM driver is necessary! The License is included with newly issued
licenses, if not please provide the Host ID + Serial Number and the info@alvasys.ch send.
· Telegram account!
+41 (0)44 261 00 70 info@alvasys.ch / www.alvasys.ch / www.alvasys.de
alvasys automation ag / Hermetschloostrasse 75 / CH-8048 Zürich
5 Telegram bot and group
The best way to create the Telegram bot is on the web! Important: You must already have the APP installed on your mobile phone! For your information there is only one bot per JACE, but multiple groups can be made per bot! https://web.telegram.org/k/and connect to your mobile phone:
1. Set up your own account: Search for BotFather and select it!
+41 (0)44 261 00 70 info@alvasys.ch / www.alvasys.ch / www.alvasys.de
alvasys automation ag / Hermetschloostrasse 75 / CH-8048 Zürich
2. own bot create under BotFather: /newbot
Give name: IchbinjetzdeinBOT (name for your BOT)
Enter user name: IchbinjetzdeinBOT
Please save user and token!!
Also configure the acknowledgement directly in the same chat! /setcommands
+41 (0)44 261 00 70 info@alvasys.ch / www.alvasys.ch / www.alvasys.de
alvasys automation ag / Hermetschloostrasse 75 / CH-8048 Zürich
@IchbinjetzdeinBOT your bot
ack Specify the Alarm UUID to acknowledge it. Your bot is now finished! Now call your bot! @I'mnowyourBOT
START /start Adjust icons and description if desired
+41 (0)44 261 00 70 info@alvasys.ch / www.alvasys.ch / www.alvasys.de
alvasys automation ag / Hermetschloostrasse 75 / CH-8048 Zürich
A group with the rightCreate alarm recipients:
Select the people who should be in this alarm group.Important: Your bot (I'mnowyourBOT) must also be a member of this group! Assign names and icons! And more
+41 (0)44 261 00 70 info@alvasys.ch / www.alvasys.ch / www.alvasys.de
alvasys automation ag / Hermetschloostrasse 75 / CH-8048 Zürich
Chat IDRemember: (inbrowser https://web.telegram.org/a/#-xxxxxxxxxxxxx
Telegram is set up!
6 modules
The modules of the driveralvassiTELEGRAM contains two · alvassiTELEGRAM-rt.jar · alvassiTELEGRAM-wb.jar
Compatibility Platforms The driveralvassiTELEGRAMruns on Niagara 4.x(>= 4.7) platforms.
Test with the version Niagara 4.14.x
6 Lizenz
Without a license, sending and receiving of theNo news!
Licenses:
SSI-DR-TELEGRAM5 SSI-DR-TELEGRAMIP15 SSI-DR-TELEGRAMIP50 SSI-DR-TELEGRAMIP1U SSI-DR-TELEGRAMIP5U SSI-DR-TELEGRAMIP10U
for 5 alarm groups for 15 alarm groups for 50 alarm groups Update + 1 alarm group Update + 5 alarm group Update + 10 alarm group
+41 (0)44 261 00 70 info@alvasys.ch / www.alvasys.ch / www.alvasys.de
alvasys automation ag / Hermetschloostrasse 75 / CH-8048 Zürich
7 Installing the modules
Insert the modules under your installation: C:\Niagara\Niagara-4.Versionxyz\modules
Step 1 First, unzip the files containing the driver and technical notes. Step 2 Copy the two JAR files into the module directory of your Niagara Work Bench. Step 3 Restart your Work Bench.
After rebooting, the file should appear in the list of available software. This can be viewedby clicking Step 4 on the "Software Manager" section of your Work Bench platform
+41 (0)44 261 00 70 info@alvasys.ch / www.alvasys.ch / www.alvasys.de
alvasys automation ag / Hermetschloostrasse 75 / CH-8048 Zürich
To install the driver on the JACE/HAWK unit, follow these steps:
Step 1 The Work Bench allows you to connect to aManufacture JACE/HAWK barrel unit.
Step 2 Transfer thealvassiTELEGRAMmodule into the device under the Modules folder.
This can be done by activating the standard Tridium software upgrade procedure or by simply copying theJAR files can be transferred using the File Transfer Client method available in the Platform Options Step 3 list in your Workbench. The destination directory in Jace8000 is: /opt/niagara/modules For more details on transferring files from Work Bench to JACE/HAWK units, see the official Tridium documentation.
Step 4 After copying the driver to the JACE/HAWK unit, force a reboot.
+41 (0)44 261 00 70 info@alvasys.ch / www.alvasys.ch / www.alvasys.de
alvasys automation ag / Hermetschloostrasse 75 / CH-8048 Zürich
7 Installing TELEGRAM modules
Inserting the modules underthe service JACE/MAC/HAWK/
Open the palette:
Install TelegramService under Service! Install this on the JACE/HAWK/MAC/ like this.
+41 (0)44 261 00 70 info@alvasys.ch / www.alvasys.ch / www.alvasys.de
alvasys automation ag / Hermetschloostrasse 75 / CH-8048 Zürich
Setting in the Telegram service
Enable service: Shows how many messages are still pending and which ones were last received.
Bot Name: Bot Token:
from Telegram from Telegram to BotFather
Right click on the station you can still see the newsClear Queue (delete the messages still to be sent) Reset Count (delete the counter)
+41 (0)44 261 00 70 info@alvasys.ch / www.alvasys.ch / www.alvasys.de
alvasys automation ag / Hermetschloostrasse 75 / CH-8048 Zürich
Setting up and configuring Telegram Recipient (JACE/MAC/HAWK)
Insert the Telegram Recipient into the Alarm Service
Connect to the desired alarm class!
Setting the desired alarm text (BFormat) Source:%alarmData.sourceName% Timestamp:%timestamp% State:%sourceState% / %ackState% Priority:%priority% Alarm Class:%alarmClass% Text:%alarmData.msgText% UUID:%uuid%
+41 (0)44 261 00 70 info@alvasys.ch / www.alvasys.ch / www.alvasys.de
alvasys automation ag / Hermetschloostrasse 75 / CH-8048 Zürich
Add new users:
Filling in the data:
Name:
Name of the alarm group in Telegram
Chat ID:
Chat ID of Telegram group
IchbinjetzdeinBOT -4607045xx6
Now the system is ready to send and acknowledge alarms!
+41 (0)44 261 00 70 info@alvasys.ch / www.alvasys.ch / www.alvasys.de
alvasys automation ag / Hermetschloostrasse 75 / CH-8048 Zürich
Alarms that arrive in the Telegram group can be freely adapted to recipients in the alarm text. If the alarms need to be acknowledged, it is necessary to send the UUID.
Acknowledge alarms: /ack and theUUIDmust be in the text! /ack 8a691470-21b0-4012-ad20-4e6e76514e89
As soon as the usersare configured correctly, the ping can also be executed!
+41 (0)44 261 00 70 info@alvasys.ch / www.alvasys.ch / www.alvasys.de
alvasys automation ag / Hermetschloostrasse 75 / CH-8048 Zürich