EgiGeoZone Telegram Plugin

Beschreibung

Das neue EgiGeoZone Telegram Plugin https://play.google.com/store/apps/details?id=de.egi.geofence.geozone.plugin.tgm kann Kommandos in Form von Nachrichten an den FHEM TelegramBot Modul senden. Die Nachrichten werden über den Telegram Nachrichtdienst verschickt.
Es ist denkbar, dass solche Nachrichten auch an andere Bots oder Teilnehmer versendet werden können.

TelegramBot-Modul in Fhem installieren

Beschreibung dazu gibt es hier: https://wiki.fhem.de/wiki/TelegramBot

Registrieren des Bots

Achtung: Das EgiGeoZone Telegram Plugin kann z.Z. einen neuen Bot nicht registrieren! Dazu bitte eine der offiziellen Telegram Apps dazu verwenden.

Nach dem Registrieren des Bots, dann diesen in der offiziellen Telegram App in der Suche vollständig eingeben und einen Chat mit diesem starten. Dazu bitte /start eingeben und abschicken oder den STARTEN-Button klicken.

EgiGeoZone Telegram Plugin einrichten

Nun kann man das EgiGeoZone Telegram Plugin starten.

Im Hauptdialog sollte man durch klicken auf den Plugin aktivieren-Knopf das Plugin aktivieren. Somit wird dieses seine Aufgabe aufnehmen. Falls man keine Nachrichten mehr über dieses Plugin versenden möchte, kann man es hier schnell deaktivieren.
Auch in der EgiGeoZone-App in den Einstellungen die Übermittlung an Plugins erlauben.

main

Das rote/grüne Symbol soll den Anmeldestatus zeigen.

Anschließend kann man bis zu sechs Zonen mit den dazugehörigen Kommandos angeben.
Der Name der Zone muss exakt dem Namen aus der EgiGeoZone-App entsprechen, da sonst das Kommando nicht ausgeführt wird. Neben dem Namen der Zone nun das Kommando für Fhem eingeben.

Indem man das in Fhem definierte Schlüsselworte (Attribut: "cmdKeyword") dem Befehl voranstellt, kann das TelegramBot-Modul aus Fhem das Kommando direkt ausführen.

Man kann aber auch einen beliebigen String als Nachricht versenden und muss dann diesen im Fhem selbst interpretieren und entsprechende Aktionen durchführen. Dies kann zum Beispiel über einen Notify passieren.

Einige Variablen kann man in der Nachricht mit angeben. Diese werden zur Laufzeit mit den richtigen Werten ersetzt.

Diese sind:
${zone} Name der Zone
${transition} betreten/verlassen in Worten
${transitionType} 1 für Betreten / 0 für Verlassen (wie im Geofancy Modul von Fhem)
${latitude} Breitengrad
${longitude} Längengrad
${deviceId} Geräte-ID
${date} Datum/Uhrzeit in ISO-Format
${realLatitude} Breitengrad gemeldet vom Google-Dienst, beim Eintreten des Ereignisses
${realLongitude} Längengrad gemeldet vom Google-Dienst, beim Eintreten des Ereignisses
${accuracy} Standortgenauigkeit gemeldet vom Google-Dienst, beim Eintreten des Ereignisses

Anmelden

Um sich anzumelden den Anmelden-Button klicken.
Danach Telefonnummer in Form von +49XXX1111222 eingeben und abschicken. Kurz darauf erhält man eine SMS oder eine Nachricht in der offiziellen Telegram App mit dem Bestätigungscode.

phone

Bestätigungscode

Diesen Bestätigungscode im folgenden Dialog eingeben. Zusätzlich noch Vorname, Familienname und den Namen des Bots eingeben - also mit Bot am Ende des Namens, so wie dieser registriert wurde!

code

Sonstiges

Das Plugin zeigt Fehlermeldungen und Antworten vom TelegramBot Modul aus Fhem als Benachrichtigungen an.
Autorisierungsprozedur neu starten: Sollten Fehlermeldungen erscheinen, dann sich bitte Abmelden und neu Anmelden.

Eine Log-Datei ist im tgmplugin-Verzeichnis zu finden. Diese ist in den ersten Versionen ziemlich gesprächig (Log-Level INFO). Ich werde diesen Level auf ERROR in eine der nächsten Version setzen.

Tipp: Anhand der offiziellen Telegram App kann man den Verlauf des Chats nachvollziehen.

Bei Fragen, bitte im Forum https://www.egigeozone.de/forum//index.php?board=17.0 posten.

Versionen

25.01.2024 - Version 1.1.3

Version 1.1.3:
- Prepared for Android 14

22.12.2023 - Version 1.1.2

Version 1.1.2:
- Adpated read/write permission

13.03.2023 - Version 1.1.1

Version 1.1.1:
- Adapted to the new requirements of Telegram and Android

02.03.2018 - Version 1.0.9

Version 1.0.9:
- Folgende Variablen können nun benutzt werden:
    ${realLatitude}
    ${realLongitude}
    ${accuracy}

08.10.2017 - Version 1.0.7

Version 1.0.7:
- Bugfixing: Beim Testen sind die Variablen Transition und TransytionType vertauscht gewesen

01.06.2017 - Version 1.0.6

Version 1.0.6:
- Zweimaliges Senden der Nachricht unterbunden

17.05.2017 - Version 1.0.5

Version 1.0.5:
- Bugfixing

11.05.2017 - Version 1.0.4

Version 1.0.4:
- Gemerkte Eingaben beim Abmelden löschen: BOT ID und Code
- Test funktioniert nun auch beim ersten Mal nach dem Login
- Meldung, dass der BOT nicht gefunden wurde

03.05.2017 - Version 1.0.3

Version 1.0.3:
- Log Level setzen. Error = weniger Logausgaben (... Menü/Log Level)
- Gespeicherte Parameter anzeigen (... Menü/Eigenschaften)
- Absturz bei Logausgaben behoben