{"id":4410,"date":"2019-09-09T21:25:41","date_gmt":"2019-09-09T20:25:41","guid":{"rendered":"http:\/\/blog.fh-kaernten.at\/ingmarsretro\/?p=4410"},"modified":"2021-02-22T14:14:04","modified_gmt":"2021-02-22T13:14:04","slug":"homematic-nachrichten-pushen-mit-telegram","status":"publish","type":"post","link":"https:\/\/blog.fh-kaernten.at\/ingmarsretro\/2019\/09\/09\/homematic-nachrichten-pushen-mit-telegram\/","title":{"rendered":"Homematic Nachrichten pushen mit Telegram"},"content":{"rendered":"
<\/div>\n

<\/path><\/svg><\/i> \"Loading\"<\/p>\n

<\/div>\n

Mit der Homematic CCU ist es ja schon lange m\u00f6glich, Nachrichten aus Systemereignissen heraus zu generieren und per E-Mail zu versenden. Ein einfaches Beispiel hierf\u00fcr ist die Best\u00e4tigung der Alarmanlage. Wird diese scharf oder unscharf geschaltet, so kann der Status als Email versendet werden. Oder hat man Umweltdatensensoren verbaut, so kann man sich auch die Daten, wie Temperatur, Luftfeuchte etc. senden lassen. Dazu muss einfach nur das Email-Plug-In unter Zusatzsoftware installiert und eingerichtet werden. Die Nachrichten werden dann per Script Aufruf versendet. Jedes Mal, wenn der Ziel-Email-Client, zum Beispiel am Smartphone, die Nachrichten abruft, ist man wieder informiert.<\/p>\n

Es muss aber nicht unbedingt die E-Mail-L\u00f6sung sein um Nachrichten zu versenden. Eine weitere M\u00f6glichkeit ist der Messenger „Telegram“. Er ist den Nachrichten Messengern WhatsApp, Signal, etc. \u00e4hnlich und versendet per Push-Service. Der Versand unterschiedlichster Daten ist hier m\u00f6glich. Bilder, Videos und Audiodateien k\u00f6nnen genau so einfach wie Textnachrichten versendet werden. Um einen den Telegram Dienst mit der Homematic nutzen zu k\u00f6nnen, muss man sich der freien Telegram API bedienen. In den folgenden Zeilen zeige ich, wie ich ein f\u00fcr mich funktionsf\u00e4higes System aufgebaut habe, um von der Homematic CCU Nachrichten und IPCam-Bilder an ein Smartphone mit installiertem Telegram Messenger zu senden.<\/p>\n

In dem Beispiel beschreibe ich die Installation und Einrichtung auf einem Android System. Beginnend mit dem Download der APP „Telegram Messenger“ aus dem Google Appstore kann derselbe dann installiert und gestartet werden. Nach dem registrieren der Telefonnummer sollte die Software dann auch schon bereit sein.<\/p>\n

Einrichten des Bots:<\/h6>\n

In der rechten, oberen Ecke des Bildschirms ist das Lupensymbol f\u00fcr die Suche zu sehen. Das ist anzuw\u00e4hlen, um ein Eingabefeld zu erhalten. In dieses Feld ist nun BotFather<\/strong><\/em> einzugeben. Das ist quasi das Administrationstool f\u00fcr das Erstellen und Einrichten von Bots. Unter einem Bot<\/b> (von englisch robot<\/span> \u201aRoboter\u2018) versteht man ein Computerprogramm, das weitgehend automatisch sich wiederholende Aufgaben abarbeitet, ohne dabei auf eine Interaktion mit einem menschlichen Benutzer angewiesen zu sein.( Quelle: Wikipedia)<\/em><\/p>\n

\"\"<\/a>

Suchen des BotFather<\/p><\/div>\n

Ist der BotFather gefunden, dann kann der einfach angeklickt werden und es \u00f6ffnet sich ein Fenster.  Um die Einrichtung des eigenen Bots zu starten, ist in der Nachrichtenzeile folgendes Kommando einzutippen:<\/p>\n

\/start<\/strong><\/p>\n

Jetzt kommt als Antwort eine Liste mit Befehlen, die f\u00fcr die Bot-Einrichtung und Konfiguration n\u00fctzlich sind. Um nun einen neuen Bot zu erstellen ist<\/p>\n

\/newbot<\/strong><\/p>\n

einzugeben. Als n\u00e4chstes ist ein Name f\u00fcr den Bot auszuw\u00e4hlen. Hier habe ich als Beispiel CCU <\/strong>gew\u00e4hlt. Sollte der Name bereits vergeben sein, dann einen anderen w\u00e4hlen. Das gilt ebenso f\u00fcr den Benutzernamen, der mit „_bot“ zu enden hat. Hier habe ich iretro_bot<\/strong> gew\u00e4hlt.<\/p>\n

\"\"<\/a><\/p>\n

Ist der Name gew\u00e4hlt und g\u00fcltig, so kommt als Antwort eine Meldung mit einem Token, der in der Regel 45 Zeichen lang ist. Dieser Token ist zu kopieren oder abzuschreiben. Er ist der Schl\u00fcssel f\u00fcr den Bot. Die Arbeiten am Smartphone sind nun soweit abgeschlossen und es geht am PC weiter. Im Browser (am besten Firefox) ist die Telegram Website aufzurufen. web.telegram.org <\/a>ist der Link zu Website. Diese Schritte dienen dazu, neben dem Token auch noch die ChatID zu erhalten, die in weiterer Folge in den Homematic Skripten ben\u00f6tigt wird. Um sich im Webbrowser anmelden zu k\u00f6nnen, ist die zu Anfang in der App registrierte Telefonnummer einzugeben. Ist die Nummer eingegeben wird auf das Smartphone ein Anmeldecode gesendet. Mit dem kann die Telegram Session im Browser gestartet werden. Jetzt sollte im Browser Telegram auch der iretro_bot<\/strong><\/em> per Suche zu finden sein. Ist er gefunden, dann ist er mit „STARTEN<\/strong>“ zu \u00f6ffnen und irgendeine beliebige Nachricht einzugeben. Das Eingeben einer beliebigen Nachricht ist wichtig um dann auch die ChatID erhalten zu k\u00f6nnen. Ist das geschehen, dann ist in der Adresszeile desselben Browserfensters der folgende Link einzugeben:<\/p>\n

https:\/\/api.telegram.org\/bothier_den_45_Zeichen_langen_APItoken_eingeben<\/em><\/strong>\/getUpdates<\/p>\n

und mit Enter best\u00e4tigen. Jetzt sollte im Browser in etwa folgendes zu sehen sein: (Tab JSON ausgew\u00e4hlt) Den Inhalt der Website habe ich in die untenstehende Tabelle kopiert. (die originale ID wurde nat\u00fcrlich ge\u00e4ndert…)<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ok<\/span><\/td>\ntrue<\/span><\/span><\/td>\n<\/tr>\n
result<\/span><\/td>\n0<\/td>\n<\/tr>\n
update_id<\/span><\/td>\n121212121<\/span><\/span><\/td>\n<\/tr>\n
message<\/span><\/td>\n <\/td>\n<\/tr>\n
message_id<\/span><\/td>\n106<\/span><\/span><\/td>\n<\/tr>\n
from id
\n<\/span><\/td>\n		123456789<\/span><\/span><\/td>\n<\/tr>\n
is_bot<\/span><\/td>\nfalse<\/span><\/span><\/td>\n<\/tr>\n
first_name<\/span><\/td>\n„ingmarsretro“<\/span><\/span><\/td>\n<\/tr>\n
language_code<\/span><\/td>\n„de“<\/span><\/span><\/td>\n<\/tr>\n
chat id<\/span>
\n<\/span><\/td>\n		123456789<\/span><\/span><\/td>\n<\/tr>\n
first_name<\/span><\/td>\n„ingmarsretro“<\/span><\/span><\/td>\n<\/tr>\n
type<\/span><\/td>\n„private“<\/span><\/span><\/td>\n<\/tr>\n
date<\/span><\/td>\n1565349110<\/span><\/span><\/td>\n<\/tr>\n
text<\/span><\/td>\n„test“<\/span><\/span><\/td>\n<\/tr>\n
update_id<\/span><\/td>\n121212121<\/span><\/span><\/td>\n<\/tr>\n
message<\/span><\/td>\n <\/td>\n<\/tr>\n
message_id<\/span><\/td>\n111<\/span><\/span><\/td>\n<\/tr>\n
from id
\n<\/span><\/td>\n		123456789<\/span><\/span><\/td>\n<\/tr>\n
is_bot<\/span><\/td>\nfalse<\/span><\/span><\/td>\n<\/tr>\n
first_name<\/span><\/td>\n„iretro“<\/span><\/span><\/td>\n<\/tr>\n
language_code<\/span><\/td>\n„de“<\/span><\/span><\/td>\n<\/tr>\n
chat id
\n<\/span><\/td>\n		123456789<\/span><\/span><\/td>\n<\/tr>\n
first_name<\/span><\/td>\n„iretro“<\/span><\/span><\/td>\n<\/tr>\n
type<\/span><\/td>\n„private“<\/span><\/span><\/td>\n<\/tr>\n
date<\/span><\/td>\n1565349112<\/span><\/span><\/td>\n<\/tr>\n
text<\/span><\/td>\n„test“<\/span><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Nun kann durch Eingabe in die Browserzeile eine Testnachricht vom PC an das Smartphone gesendet werden.<\/p>\n

https:\/\/api.telegram.org\/botAPITOKEN<\/em><\/strong>\/sendMessage?chat_id=123456789<\/em><\/strong>&text=Hallo das ist ein Test<\/p>\n

Nach Best\u00e4tigen erscheint die Nachricht in der Telegram App am Smartphone und alles hat geklappt. F\u00fcr alles Weitere wird nun nur mehr der API-Token und die chatID ben\u00f6tigt.<\/p>\n

Homematic und Telegram<\/h6>\n

Jetzt ist soweit alles f\u00fcr den Einsatz von Telegram mit der Homematic vorbereitet. Meine Beispiele hier beziehen sich auf eine CCU2. Als Addon muss die aktuelle Version des CUxD auf der CCU installiert sein. (Zum Zeitpunkt des erstellen des Blogbeitrages ist es 2.3.0). Der CUx-Daemon erm\u00f6glicht es unter anderem, per Skript auf das Linux System der CCU zuzugreifen und stellt somit eine universelle Schnittstelle zu anderen Systemen dar.<\/p>\n

Die einfachste und am schnellsten realisierbare Anwendung mit Telegram ist, ein von der Homematic getriggertes Skript zu starten, das eine PUSH-Nachricht versendet. Dazu erstellt man in der CCU ein neues Programm und w\u00e4hlt zuerst unter Bedingung<\/em> einen „Trigger“ aus. Mit „Trigger“ ist zum Beispiel eine Tastereingabe, eine Bewegungserkennung des Bewegungsmelders, oder auch einfach nur das Ausl\u00f6sen eines beliebigen Sensors gemeint. Das sollte f\u00fcr einen HomeMatic Benutzer auch kein Problem darstellen. Dann w\u00e4hlt man als Aktivit\u00e4t<\/em> Skript aus und \u00f6ffnet das Scripteingabefenster.  Das folgende Code-Beispiel sendet eine Nachricht an das Handy, wenn bei der HomeMatic der gew\u00e4hlte Trigger ausgel\u00f6st ist und das Script gestartet wird:<\/p>\n

\n
!Variablen definieren\r\nstring msg = \"Das ist eine Testnachricht von der CCU\";\r\nstring chatid = \"123456789\"; !das ist die chatid\r\nstring botAPI = \"987654321:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghi\"; !und das ist die BOT API id\r\n\r\n!Textnachricht versenden\r\ndom.GetObject(\"CUxD.CUX2801001:1.CMD_EXEC\").State(\"extra\/curl -s -k https:\/\/api.telegram.org\/bot\"#botAPI#\"\/sendMessage -F text='\"#msg#\"' -F chat_id=\"#chatid);\r\n<\/pre>\n<\/div>\n
 <\/p>\n
Die ChatID in dem Beispielscript und auch die botAPI ist hier nur symbolisch angef\u00fchrt. W\u00e4ren da reale IDs angef\u00fchrt, dann w\u00fcrden eure Versuche alle als Nachrichten auf meinem Handy landen. \ud83d\ude42 Diese beiden IDs sind also durch die vorher ermittelten zu ersetzen.<\/p>\n
 <\/p>\n
Versenden von Kamerabildern<\/h6>\n
Es geht aber noch besser. Viele User haben neben der HomeMatic CCU auch noch IP-Kameras im Einsatz. Da bietet es sich doch an, den Trigger der HomeMatic und seine Webanbindung f\u00fcr das Versenden der IP-Kamera Bilder zu verwenden. Denn Telegramm kann neben Textnachrichten auch Bilddateien versenden.<\/p>\n
Um das zu realisieren muss die IP Kamera in der Lage sein, einen Snapshot per http – Aufruf zu erzeugen. Das sollte bei den meisten Kameras m\u00f6glich sein. In diesem Beispiel habe ich eine Dlink DCS-932<\/strong><\/em> und eine Vivotec FD81xx<\/strong><\/em> Domkamera getestet. Es klappt mit beiden.<\/p>\n
Hier die grundlegenden Snapshotaufrufe der Kameras:
\nDLINK:
\nhttps:\/\/benutzername:passwort@ip_der_kamera\/image\/jpeg.cgi<\/p>\n
VIVOTEK:
\nhttps:\/\/benutzername:passwort@ip_der_kamera\/cgi-bin\/viewer\/video.jpg?<\/p>\n
Als n\u00e4chstes muss sichergestellt sein, dass die HomeMatic nach dem Aufruf der Snapshot-Links die von der Kamera gelieferten Bilder auch irgendwo im Dateisystem der CCU speichern kann. Hier hilft der CUx-Daemon wieder weiter. Ich speichere im \/tmp Ordner das Bild der Kamera unter dem Dateinamen „cambild.jpg“<\/p>\n
\"\"<\/a>
CUxD Startbildschirm<\/p><\/div>\n
Nach dem Aufruf desKameralinks \u00fcber das unten gelistete Script sollte die Datei im \/tmp Ordner zu sehen sein.<\/p>\n
\"\"<\/a>
\/tmp Ordner<\/p><\/div>\n
Eine Kontrolle des Inhaltes der Datei „cambild.jpg“ kann einfach durch Doppelklicken durchgef\u00fchrt werden. Das Bild sollte dann im CUxD Fenster zu sehen sein.<\/p>\n
\"\"<\/a>
Kamerabild im CUxD Fenster<\/p><\/div>\n
Das folgend gelistete Script in einem neu erstellten HomeMatic Programm kann nun durch Aufruf das Kamerabild abholen und versendet es als Telegram Push Nachricht.<\/p>\n
<\/p>\n
\n
string picture = \"\/tmp\/cambild.jpg\";  !das ist der Pfad in dem die Bilddatei erzeugt und gespeichert wird\r\nstring chatid = \"123456789\";        !das ist die chatid\r\nstring botAPI = \"987654321:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghi\";  !und das ist die BOT API id\r\n\r\n!Kamera aufrufen und snapshotdatei in \/tmp\/ anlegen und als datei cambild.jpg speichern\r\ndom.GetObject(\"CUxD.CUX2801001:1.CMD_EXEC\").State(\"wget --auth-no-challenge -O \/tmp\/cambild.jpg 'https:\/\/user:passwort@000.000.000.000:80\/image\/jpeg.cgi?profileid=1'\");\r\n\r\n!Kamerabild per Telegram versenden\r\ndom.GetObject(\"CUxD.CUX2801001:1.CMD_EXEC\").State(\"extra\/curl -s -k https:\/\/api.telegram.org\/bot\"#botAPI#\"\/sendPhoto -F chat_id=\"#chatid#\" -F photo='@\"#picture#\"'\");\r\n<\/pre>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
<\/div>\n
<\/path><\/svg><\/i> \"Loading\"<\/p>\n
<\/div>\n
Mit der Homematic CCU ist es ja schon lange m\u00f6glich, Nachrichten aus Systemereignissen heraus zu generieren und per E-Mail zu versenden. Ein einfaches Beispiel hierf\u00fcr ist die Best\u00e4tigung der Alarmanlage. Wird diese scharf oder unscharf geschaltet, so kann der Status als Email versendet werden. Oder hat man Umweltdatensensoren verbaut, so kann man sich auch die… 
 Weiterlesen<\/a><\/p>\n","protected":false},"author":86,"featured_media":4418,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"ngg_post_thumbnail":0,"footnotes":""},"categories":[1],"tags":[469,1311,1310,1314,1313,1307,1306,1308,1303,1304,1305,1312,1309],"class_list":["post-4410","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-allgemeines","tag-ccu","tag-cux-daemon","tag-cuxd","tag-dlink-dcs932","tag-fd81xx","tag-homematic-ipcam","tag-homematic-push-nachrichten","tag-ipcam-bilder-per-telegram","tag-telegram","tag-telegram-messenger","tag-telegram-und-homematic","tag-vivotec","tag-whatsapp-alternative"],"a3_pvc":{"activated":true,"total_views":1145,"today_views":1},"_links":{"self":[{"href":"https:\/\/blog.fh-kaernten.at\/ingmarsretro\/wp-json\/wp\/v2\/posts\/4410","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.fh-kaernten.at\/ingmarsretro\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.fh-kaernten.at\/ingmarsretro\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.fh-kaernten.at\/ingmarsretro\/wp-json\/wp\/v2\/users\/86"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.fh-kaernten.at\/ingmarsretro\/wp-json\/wp\/v2\/comments?post=4410"}],"version-history":[{"count":0,"href":"https:\/\/blog.fh-kaernten.at\/ingmarsretro\/wp-json\/wp\/v2\/posts\/4410\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.fh-kaernten.at\/ingmarsretro\/wp-json\/wp\/v2\/media\/4418"}],"wp:attachment":[{"href":"https:\/\/blog.fh-kaernten.at\/ingmarsretro\/wp-json\/wp\/v2\/media?parent=4410"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.fh-kaernten.at\/ingmarsretro\/wp-json\/wp\/v2\/categories?post=4410"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.fh-kaernten.at\/ingmarsretro\/wp-json\/wp\/v2\/tags?post=4410"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}