Telegram - old API method: Unterschied zwischen den Versionen

Telegram - old API method
Zweck / Funktion
	Senden und Empfangen von Nachrichten (Text und Fotos) mit dem freien Messagingdienst Telegram
Allgemein
Typ	Inoffiziell
Details
Dokumentation	Thema
Support (Forum)	Unterstützende Dienste
Modulname	70_Telegram.pm
Ersteller	viegener (Forum / Wiki)
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Version vom 8. Juli 2015, 07:59 Uhr

Das Telegram-Modul ermöglicht das Senden und Empfangen von Nachrichten über den Telegram-instant messaging Dienst (https://telegram.org/). Es entsteht eine Möglichkeit Benachrichtungen aus Fhem zu versenden, zum Beispiel Alarmmeldungen. Ausserdem können auch Kommandos über Telegram an Fhem gesendet werden um Steuerungsbefehle in Fhem auszulösen.

Für den Betrieb des Telegram Moduls ist eine funktionsfähige Installation des inoffiziellen telegram command-line clients für Linux, telegram-cli (https://github.com/vysheng/tg), erforderlich.

Für die Unterstützung von WhatsApp siehe Modul yowsup.

Über Telegram Instant Messaging

Telegram-IDs und Versand/Empfang von Nachrichten sind kostenfrei. Clients sind für gängige Smartphonesysteme erhältlich (iOS iPhone und Tablet, Android, Windows Phone) und können auch aus dem WebBrowser verwendet werden. Es gibt auch einen Kommandozeilen-Client für Linux, der die Grundlage dieses Moduls darstellt. Mehrfachanmeldungen, auch parallel mit verschiedenen Geräten (z.B. Tablet und Smartphone), sind möglich. Gruppenchats und Chats mit End-2-End-Verschlüsselung werden ebenfalls unterstützt.

Features

Unterstützt werden:

Versand von Textnachrichten an einen vordefinierten Kontakt (default peer)
Versand von Textnachrichten an einen vordefinierten Kontakt als verschlüsselter Chat (secret chat)
Versand von Bildern
Empfang von Textnachrichten von beliebigen Kontakten
Direkte Befehle an den telegram-client

Eine detaillierte Beschreibung des Moduls ist im Fhem Forum in diesem Diskussionsthread zu finden, die jeweils aktuelle Version des Moduls ist im ersten Beitrag als Anhang verfügbar.

Hinweise zum Betrieb mit Fhem

Achtung: telegram-cli wird momentan NICHT aus Fhem heraus gestartet, sondern muss separat gestartet werden. Ausserdem muss telegram-cli bereits angemeldet sein und entsprechende Kontakte müssen eingerichtet werden. Generell ist auch die Verwendung einer existierenden telegram, empfohlen wird aber die Verwendung einer getrennten ID, zum Beispiel für die eigene Festnetznummer. telegram-cli kann generell auch auf einem anderen Host betrieben werden, da die Kommunikation mit telegram-cli über Netzwerkprotokolle erfolgt.

Das Telegram-Modul basiert auf einem im Hintergrund laufenden telegram-cli (https://github.com/vysheng/tg).

Informationen zu Einrichtung und Betrieb von telegram-cli finden sich im Readme in obigem Repository. Weitere Informationen finden sich auch im Wiki des github Repositories: https://github.com/vysheng/tg/wiki

Hinweise zum Start von telegram-cli mit fhem finden sich in der Commandref / Doku zum Modul.

Links

Source code für das 70_Telegram.pm-Modul: https://github.com/viegener/Telegram-fhem
Forum-Thread in dem das Modul vorgestellt wurde Fhem-Forum
Repository mit telegram-cli https://github.com/vysheng/tg
Telegram messaging system https://telegram.org/

@@ Zeile 2: / Zeile 2: @@
 |ModPurpose=Senden und Empfangen von Nachrichten (Text und Fotos) mit dem freien Messagingdienst Telegram
 |ModType=x
-|ModCmdRef= ---- noch nicht Teil von FHEM ----
 |ModForumArea=Unterstützende Dienste
+|ModFTopic=38328
 |ModTechName=[https://github.com/viegener/Telegram-fhem/blob/master/70_Telegram.pm 70_Telegram.pm]
-|ModOwner=viegener ([http://forum.fhem.de/index.php/topic,38328.0.html] / [[Benutzer Diskussion:Viegener|Wiki]])}}
+|ModOwner=viegener ({{Link2FU|12772|Forum}} / [[Benutzer Diskussion:Viegener|Wiki]])}}
 Das [[Telegram]]-Modul ermöglicht das Senden und Empfangen von Nachrichten über den Telegram-instant messaging Dienst (https://telegram.org/).
-Es entsteht eine Möglichkeit Benachrichtungen aus fhem zu versenden, zum Beispiel Alarmmeldungen.
+Es entsteht eine Möglichkeit Benachrichtungen aus Fhem zu versenden, zum Beispiel Alarmmeldungen.
-Ausserdem können auch Kommandos über Telegram an fhem gesendet werden um Steuerungsbefehle in fhem auszulösen.
+Ausserdem können auch Kommandos über Telegram an Fhem gesendet werden um Steuerungsbefehle in Fhem auszulösen.
-<u>Für den Betrieb des Telegram Moduls ist eine funktionsfähige Installation des inoffiziellen telegram command-line clients für Linux telegram-cli (https://github.com/vysheng/tg) erforderlich</u>
+Für den Betrieb des Telegram Moduls ist eine funktionsfähige Installation des inoffiziellen telegram command-line clients für Linux, ''telegram-cli'' (https://github.com/vysheng/tg), erforderlich.
+Für die Unterstützung von ''WhatsApp'' siehe Modul [[yowsup]].
 == Über Telegram Instant Messaging ==
+Telegram-IDs und Versand/Empfang von Nachrichten sind kostenfrei.
-Telegram-IDs und Versand/Empfang von Nachrichten ist kostenfrei.
 Clients sind für gängige Smartphonesysteme erhältlich (iOS iPhone und Tablet, Android, Windows Phone) und
 können auch aus dem WebBrowser verwendet werden.
-Es gibt auch einen Kommandozeilen-Client für Linux, der die Grundlage dieses Moduls darstellt
+Es gibt auch einen Kommandozeilen-Client für Linux, der die Grundlage dieses Moduls darstellt.
-Mehrfachanmeldungen auch parallel mit verschiedenen Geräten (z.B. tablet und smartphone) sind möglich.
+Mehrfachanmeldungen, auch parallel mit verschiedenen Geräten (z.B. Tablet und Smartphone), sind möglich.
 Gruppenchats und Chats mit End-2-End-Verschlüsselung werden ebenfalls unterstützt.
 == Features ==
+Unterstützt werden:
-Unterstützt werden
 * Versand von Textnachrichten an einen vordefinierten Kontakt (default peer)
@@ Zeile 32: / Zeile 32: @@
 * Direkte Befehle an den telegram-client
-Eine detaillierte Beschreibung des Moduls ist in der Diskussion
+Eine detaillierte Beschreibung des Moduls ist im Fhem Forum in diesem  {{Link2Forum|Topic=38328|LinkText=Diskussionsthread}} zu finden, die jeweils aktuelle Version des Moduls ist im ersten Beitrag als Anhang verfügbar.
-Thread im {{Link2Forum|Topic=24519|LinkText=Fhem-Forum}} mit der jeweils aktuellen Version des Moduls als Anhang im ersten Beitrag.
 == Hinweise zum Betrieb mit Fhem ==
+{{Randnotiz|RNTyp=Warn|RNText=Achtung: telegram-cli wird momentan NICHT aus Fhem heraus gestartet, sondern muss separat gestartet werden. Ausserdem muss telegram-cli bereits angemeldet sein und entsprechende Kontakte müssen eingerichtet werden. Generell ist auch die Verwendung einer existierenden telegram, empfohlen wird aber die Verwendung einer getrennten ID, zum Beispiel für die eigene Festnetznummer.
-Das Telegram-Modul basiert auf einem im Hintergrund laufenden telegram-cli (https://github.com/vysheng/tg)
+telegram-cli kann generell auch auf einem anderen Host betrieben werden, da die Kommunikation mit telegram-cli über Netzwerkprotokolle erfolgt.
+}}
+Das Telegram-Modul basiert auf einem im Hintergrund laufenden telegram-cli (https://github.com/vysheng/tg).
-Informationen zur Einrichtung und Betrieb von telegram-cli finden sich im Readme in obigem Repository.
+Informationen zu Einrichtung und Betrieb von telegram-cli finden sich im Readme in obigem Repository.
-Weitere Infos finden sich auch im wiki des github Repositories: https://github.com/vysheng/tg/wiki
+Weitere Informationen finden sich auch im Wiki des github Repositories: https://github.com/vysheng/tg/wiki
 Hinweise zum Start von telegram-cli mit fhem finden sich in der Commandref / Doku zum Modul.
-{{Randnotiz|RNTyp=Info|RNText=Achtung: telegram-cli wird momentan NICHT aus fhem herausgestartet, sondern muss separat gestartet werden.
+== Links ==
-Ausserdem muss telegram-cli bereits angemeldet sein und entsprechende Kontakte müssen eingerichtet werden.
+* Source code für das 70_Telegram.pm-Modul: https://github.com/viegener/Telegram-fhem
-Generell ist auch die Verwendung einer existierenden telegram, empfohlen wird aber die Verwendung einer getrennten ID,
+* Forum-Thread in dem das Modul vorgestellt wurde {{Link2Forum|Topic=38328|LinkText=Fhem-Forum}}
-zum Beispiel für die eigene Festnetznummer.
-telegram-cli kann generell auch auf einem anderen host betrieben werden, da die Kommunikation mit telegram-cli über Netzwerkprotokolle erfolgt.
-}}
-== Weblinks ==
-* Source code für das 70_Telegram.pm-Modul : https://github.com/viegener/Telegram-fhem
-* Forum-Thread in dem das Modul vorgestellt wurde {{Link2Forum|Topic=24519|LinkText=Fhem-Forum}}
 * Repository mit telegram-cli https://github.com/vysheng/tg
 * Telegram messaging system https://telegram.org/
 [[Kategorie:Other Components]]