TelegramBot - Versionsgeschichte

Ph1959de: diverse kleinere Korrekturen, Ergänzungen und Formatierungsänderungen

2025-06-04T16:44:47Z

diverse kleinere Korrekturen, Ergänzungen und Formatierungsänderungen

Maista: /* Fehlermeldungen bei veralteter SSL-Version */

2020-12-28T20:24:37Z

Fehlermeldungen bei veralteter SSL-Version

← Nächstältere Version		Version vom 28. Dezember 2020, 22:24 Uhr
Zeile 169:		Zeile 169:

	=== Befehle von Telegram an FHEM senden ===		=== Befehle von Telegram an FHEM senden ===
	Es handelt sich hier um ein Tool, das {{Link2Forum\|Topic=51425\|Message=464928\|LinkText=hier im Forum}} vorgestellt wurde. Dabei wird ein notify in FHEM angelegt, das den TelegramBot überwacht. Wird eine Befehlsfolge an den Bot gesendet, liest das Telegram-~~device~~ die gesendete Information aus und führt den Befehl aus. Weitere Details, wie hier vorzugehen ist, unter dem oben angegebenen Link im Forum.		Es handelt sich hier um ein Tool, das {{Link2Forum\|Topic=51425\|Message=464928\|LinkText=hier im Forum}} vorgestellt wurde. Dabei wird ein notify in FHEM angelegt, das den TelegramBot überwacht. Wird eine Befehlsfolge an den Bot gesendet, liest das Telegram-Device die gesendete Information aus und führt den Befehl aus. Weitere Details, wie hier vorzugehen ist, unter dem oben angegebenen Link im Forum.

	Wenn man an FHEM Befehle senden will, muss der TelegramBot bereit sein, diese Nachrichten zu empfangen. Wenn man allerdings aus Sicherheitsgründen das Attribut		Wenn man an FHEM Befehle senden will, muss der TelegramBot bereit sein, diese Nachrichten zu empfangen. Wenn man allerdings aus Sicherheitsgründen das Attribut

Dustbln: /* TelegramBot-Aktionen auslösen */

2020-08-26T15:01:45Z

TelegramBot-Aktionen auslösen

← Nächstältere Version		Version vom 26. August 2020, 17:01 Uhr
Zeile 269:		Zeile 269:

	==== TelegramBot-Aktionen auslösen ====		==== TelegramBot-Aktionen auslösen ====
	Der Bot sendet Nachrichten standardmäßig an den defaultPeer (falls definiert). So kann mit folgendem Befehl ~~etwas~~ der Versand eines Videos ausgelöst werden:		Der Bot sendet Nachrichten standardmäßig an den defaultPeer (falls definiert). So kann mit folgendem Befehl etwa der Versand eines Videos ausgelöst werden:

	<code>doit set telegrambot sendMedia cam.mp4</code>		<code>doit set telegrambot sendMedia cam.mp4</code>

Dustbln: /* TelegramBot-Aktionen auslösen */

2020-08-26T15:00:43Z

TelegramBot-Aktionen auslösen

← Nächstältere Version		Version vom 26. August 2020, 17:00 Uhr
Zeile 269:		Zeile 269:

	==== TelegramBot-Aktionen auslösen ====		==== TelegramBot-Aktionen auslösen ====
	Der Bot sendet Nachrichten standardmäßig an den defaultPeer (falls definiert). So kann mit folgendem Befehl etwas der Versand eines Videos ausgelöst werden~~:<syntaxhighlight>~~		Der Bot sendet Nachrichten standardmäßig an den defaultPeer (falls definiert). So kann mit folgendem Befehl etwas der Versand eines Videos ausgelöst werden:
	~~doit set telegrambot sendMedia cam.mp4~~
	</syntaxhighlight>Soll eine Nachricht an einen anderen (bekannten) User geschickt werden, so ist die Angabe der ID des Users erforderlich. Dies kann dynamisch mit set-Logik und Abfrage der Readings erfolgen. Der folgende Befehl sendet das Video an den User, der das Kommando an den Bot geschickt hat:

	doit set telegrambot sendMedia <code>@[TB:msgChatId]</code> ~~cam.mp4~~		<code>doit set telegrambot sendMedia cam.mp4</code>

			Soll eine Nachricht an einen anderen (bekannten) User geschickt werden, so ist die Angabe der ID des Users erforderlich. Dies kann dynamisch mit set-Logik und Abfrage der Readings erfolgen. Der folgende Befehl sendet das Video an den User, der das Kommando an den Bot geschickt hat:

			<code>doit set telegrambot sendMedia @[TB:msgChatId] cam.mp4</code>

	Bei der Definition von Favoriten (siehe unten) kann genau so vorgegangen werden.{{Randnotiz\|RNTyp=Warn\|RNText=Achtung: Bei den Kommandos sollten man unbedingt das Attribut "cmdRestrictedPeer" setzen, damit nicht jeder Kommandos auf dem FHEM-Server ausführen kann. Dazu sollten die BenutzerIDs der erlaubten Benutzer (durch Leerzeichen getrennt angeben). Da Benutzernamen selber vergeben werden und nicht unbedingt eindeutig sind, sollten hier auch NUR BenutzerIDs verwendet werden.		Bei der Definition von Favoriten (siehe unten) kann genau so vorgegangen werden.{{Randnotiz\|RNTyp=Warn\|RNText=Achtung: Bei den Kommandos sollten man unbedingt das Attribut "cmdRestrictedPeer" setzen, damit nicht jeder Kommandos auf dem FHEM-Server ausführen kann. Dazu sollten die BenutzerIDs der erlaubten Benutzer (durch Leerzeichen getrennt angeben). Da Benutzernamen selber vergeben werden und nicht unbedingt eindeutig sind, sollten hier auch NUR BenutzerIDs verwendet werden.

Dustbln: set-Logik für TB-Kommandos in einem Multiuser-Setup

2020-08-26T14:59:07Z

set-Logik für TB-Kommandos in einem Multiuser-Setup

← Nächstältere Version		Version vom 26. August 2020, 16:59 Uhr
Zeile 101:		Zeile 101:

	Um einen Chat an einen "Contact" versenden zu können, muss zuerst in Contacts (bei Readings) ein Kontakt auftauchen. Wenn man sich zum allerersten Mal bei Telegram angemeldet hat, gibt es noch keinen Chat mit irgendjemanden. Man muss sich zuerstmal selbst eine Nachricht im Smartphone zusenden, dann taucht unter Readings der Eintrag Contacts auf. Erst dann kann man eine Nachricht mit @msgPeerId (das ist Ziffernfolge des Contacts ) oder mit @msgPeer (das ist der Name nach dem Doppelpunkt) vom TelegramBot auf sein Smartphone senden.		Um einen Chat an einen "Contact" versenden zu können, muss zuerst in Contacts (bei Readings) ein Kontakt auftauchen. Wenn man sich zum allerersten Mal bei Telegram angemeldet hat, gibt es noch keinen Chat mit irgendjemanden. Man muss sich zuerstmal selbst eine Nachricht im Smartphone zusenden, dann taucht unter Readings der Eintrag Contacts auf. Erst dann kann man eine Nachricht mit @msgPeerId (das ist Ziffernfolge des Contacts ) oder mit @msgPeer (das ist der Name nach dem Doppelpunkt) vom TelegramBot auf sein Smartphone senden.



Zeile 255:		Zeile 254:
	=== Kommandos auslösen ===		=== Kommandos auslösen ===

	Ein wichtiges Szenario ist die Möglichkeit Kommandos in FHEM ausführen zu können, ohne einen Zugang durch die Firewall einrichten zu müssen. Dazu ist die Definition eines Schlüsselwortes (Attribut: "cmdKeyword")erforderlich, mit dem man die Nachrichten beginnen muss, damit der TelegramBot die Kommandos erkennt.		Ein wichtiges Szenario ist die Möglichkeit Kommandos in FHEM ausführen zu können, ohne einen Zugang durch die Firewall einrichten zu müssen. Dazu ist die Definition eines Schlüsselwortes (Attribut: "cmdKeyword") erforderlich, mit dem man die Nachrichten beginnen muss, damit der TelegramBot die Kommandos erkennt.

	<code>attr myTelegramBot cmdKeyword doit</code>		<code>attr myTelegramBot cmdKeyword doit</code>
Zeile 269:		Zeile 268:
	<code>doit list telegrambot</code>		<code>doit list telegrambot</code>

	{{Randnotiz\|RNTyp=Warn\|RNText=Achtung: Bei den Kommandos sollten man unbedingt das Attribut "cmdRestrictedPeer" setzen, damit nicht jeder Kommandos auf dem FHEM-Server ausführen kann. Dazu sollten die BenutzerIDs der erlaubten Benutzer (durch Leerzeichen getrennt angeben). Da Benutzernamen selber vergeben werden und nicht unbedingt eindeutig sind, sollten hier auch NUR BenutzerIDs verwendet werden.		==== TelegramBot-Aktionen auslösen ====
			Der Bot sendet Nachrichten standardmäßig an den defaultPeer (falls definiert). So kann mit folgendem Befehl etwas der Versand eines Videos ausgelöst werden:<syntaxhighlight>
			doit set telegrambot sendMedia cam.mp4
			</syntaxhighlight>Soll eine Nachricht an einen anderen (bekannten) User geschickt werden, so ist die Angabe der ID des Users erforderlich. Dies kann dynamisch mit set-Logik und Abfrage der Readings erfolgen. Der folgende Befehl sendet das Video an den User, der das Kommando an den Bot geschickt hat:

			doit set telegrambot sendMedia <code>@[TB:msgChatId]</code> cam.mp4

			Bei der Definition von Favoriten (siehe unten) kann genau so vorgegangen werden.{{Randnotiz\|RNTyp=Warn\|RNText=Achtung: Bei den Kommandos sollten man unbedingt das Attribut "cmdRestrictedPeer" setzen, damit nicht jeder Kommandos auf dem FHEM-Server ausführen kann. Dazu sollten die BenutzerIDs der erlaubten Benutzer (durch Leerzeichen getrennt angeben). Da Benutzernamen selber vergeben werden und nicht unbedingt eindeutig sind, sollten hier auch NUR BenutzerIDs verwendet werden.
	}}		}}

Ph1959de: Forenlinks auf Wiki-Vorlage geändert

2020-08-04T14:46:48Z

Forenlinks auf Wiki-Vorlage geändert

Andies: /* Befehle von Telegram an FHEM senden */ siehe https://forum.fhem.de/index.php/topic,38328.msg1075650.html#msg1075650

2020-08-01T12:21:53Z

Befehle von Telegram an FHEM senden: siehe https://forum.fhem.de/index.php/topic,38328.msg1075650.html#msg1075650

← Nächstältere Version		Version vom 1. August 2020, 14:21 Uhr
Zeile 172:		Zeile 172:
	=== Befehle von Telegram an FHEM senden ===		=== Befehle von Telegram an FHEM senden ===
	Es handelt sich hier um ein Tool, das im Forum vorgestellt wurde: https://forum.fhem.de/index.php/topic,51425.msg464928.html#msg464928. Dabei wird ein notify in FHEM angelegt, das den TelegramBot überwacht. Wird eine Befehlsfolge an den Bot gesendet, liest das Telegram-device die gesendete Information aus und führt den Befehl aus. Weitere Details, wie hier vorzugehen ist, unter dem oben angegebenen Link im Forum.		Es handelt sich hier um ein Tool, das im Forum vorgestellt wurde: https://forum.fhem.de/index.php/topic,51425.msg464928.html#msg464928. Dabei wird ein notify in FHEM angelegt, das den TelegramBot überwacht. Wird eine Befehlsfolge an den Bot gesendet, liest das Telegram-device die gesendete Information aus und führt den Befehl aus. Weitere Details, wie hier vorzugehen ist, unter dem oben angegebenen Link im Forum.

			Wenn man an FHEM Befehle senden will, muss der TelegramBot bereit sein diese Nachrichten zu empfangen. Wenn man allerdings aus Sicherheitsgründen das Attribut
			allowUnknownContacts = 0
			gesetzt hat, dann ist ein solcher Empfang nicht möglich. Daher muss (zumindest einmalig) erlaubt werden, von unbekannten Kontakten eine Nachricht zu bekommen. Nach dem ersten Empfang ist dann der Kontakt bekannt und man kann erneut den Empfang auf bekannte Kontakte beschränken.

	== Beispielszenarien ==		== Beispielszenarien ==

Andies: /* Befehle von Telegram an FHEM senden */

2020-07-31T20:27:27Z

Befehle von Telegram an FHEM senden

← Nächstältere Version		Version vom 31. Juli 2020, 22:27 Uhr
Zeile 170:		Zeile 170:


	==== Befehle von Telegram an FHEM senden ====		=== Befehle von Telegram an FHEM senden ===
	Es handelt sich hier um ein Tool, das im Forum vorgestellt wurde: https://forum.fhem.de/index.php/topic,51425.msg464928.html#msg464928. Dabei wird ein notify in FHEM angelegt, das den TelegramBot überwacht. Wird eine Befehlsfolge an den Bot gesendet, liest das Telegram-device die gesendete Information aus und führt den Befehl aus. Weitere Details, wie hier vorzugehen ist, unter dem oben angegebenen Link im Forum.		Es handelt sich hier um ein Tool, das im Forum vorgestellt wurde: https://forum.fhem.de/index.php/topic,51425.msg464928.html#msg464928. Dabei wird ein notify in FHEM angelegt, das den TelegramBot überwacht. Wird eine Befehlsfolge an den Bot gesendet, liest das Telegram-device die gesendete Information aus und führt den Befehl aus. Weitere Details, wie hier vorzugehen ist, unter dem oben angegebenen Link im Forum.

Andies: Neuer Abschnitt zu: Wie sendet man mit Telegram Befehle an den Bot?

2020-07-31T20:27:02Z

Neuer Abschnitt zu: Wie sendet man mit Telegram Befehle an den Bot?

← Nächstältere Version		Version vom 31. Juli 2020, 22:27 Uhr
Zeile 168:		Zeile 168:
	IO::Socket::SSL 2.002 -> 2.066		IO::Socket::SSL 2.002 -> 2.066
	notwendig. Es wird darauf hingewiesen, dass idealerweise nicht einzelne Module, sondern das gesamte OS sowie alle Perlmodule auf den neuesten Stand gebracht werden sollten.		notwendig. Es wird darauf hingewiesen, dass idealerweise nicht einzelne Module, sondern das gesamte OS sowie alle Perlmodule auf den neuesten Stand gebracht werden sollten.


			==== Befehle von Telegram an FHEM senden ====
			Es handelt sich hier um ein Tool, das im Forum vorgestellt wurde: https://forum.fhem.de/index.php/topic,51425.msg464928.html#msg464928. Dabei wird ein notify in FHEM angelegt, das den TelegramBot überwacht. Wird eine Befehlsfolge an den Bot gesendet, liest das Telegram-device die gesendete Information aus und führt den Befehl aus. Weitere Details, wie hier vorzugehen ist, unter dem oben angegebenen Link im Forum.

	== Beispielszenarien ==		== Beispielszenarien ==

Viegener: added setjoingroups empfehlung

2020-05-07T13:28:21Z

added setjoingroups empfehlung

← Nächstältere Version		Version vom 7. Mai 2020, 15:28 Uhr
Zeile 96:		Zeile 96:
	For a description of the Bot API, see this page: https://core.telegram.org/bots/api		For a description of the Bot API, see this page: https://core.telegram.org/bots/api
	</pre>		</pre>
			{{Randnotiz\|RNTyp=Info\|RNText=Achtung: Da Bots generell für alle Benutzer sichtbar sind und es gelegentlich Problem mit spammern gibt, die fremde bots auch in Gruppen hinzufügen, ist es empfehlenswert die Einstellung /setjoingroups auf false zu setzen, wenn die Zugehörigkeit zu Gruppen (und der Empfang von Meldungen aus gruppen) nicht notwendig ist
			}}


	Um einen Chat an einen "Contact" versenden zu können, muss zuerst in Contacts (bei Readings) ein Kontakt auftauchen. Wenn man sich zum allerersten Mal bei Telegram angemeldet hat, gibt es noch keinen Chat mit irgendjemanden. Man muss sich zuerstmal selbst eine Nachricht im Smartphone zusenden, dann taucht unter Readings der Eintrag Contacts auf. Erst dann kann man eine Nachricht mit @msgPeerId (das ist Ziffernfolge des Contacts ) oder mit @msgPeer (das ist der Name nach dem Doppelpunkt) vom TelegramBot auf sein Smartphone senden.		Um einen Chat an einen "Contact" versenden zu können, muss zuerst in Contacts (bei Readings) ein Kontakt auftauchen. Wenn man sich zum allerersten Mal bei Telegram angemeldet hat, gibt es noch keinen Chat mit irgendjemanden. Man muss sich zuerstmal selbst eine Nachricht im Smartphone zusenden, dann taucht unter Readings der Eintrag Contacts auf. Erst dann kann man eine Nachricht mit @msgPeerId (das ist Ziffernfolge des Contacts ) oder mit @msgPeer (das ist der Name nach dem Doppelpunkt) vom TelegramBot auf sein Smartphone senden.




	== Tipps ==		== Tipps ==
Zeile 121:		Zeile 128:
	BotFather:		BotFather:
	Success! The new status is: DISABLED. /help</pre>		Success! The new status is: DISABLED. /help</pre>

			Siehe auch Info zu /setjoingroups oben.

	=== Kontakte ===		=== Kontakte ===

← Nächstältere Version		Version vom 4. August 2020, 16:46 Uhr
Zeile 160:		Zeile 160:
	NonBlockingGet: returned <hidden>: Can't connect(2) to <nowiki>https://api.telegram.org:443</nowiki>		NonBlockingGet: returned <hidden>: Can't connect(2) to <nowiki>https://api.telegram.org:443</nowiki>

	Dies deutet auf eine veraltete SSL-Version hin, siehe dazu die Forumsdiskussion ab ~~[https://forum.fhem.de/index.php/topic,~~38328~~.msg1021642.html#msg1021642~~ diesem ~~Eintrag]~~. Hilfreich hat sich ein upgrade der SSL-Module erwiesen. Zuerst muss uU ein Modul installiert werden		Dies deutet auf eine veraltete SSL-Version hin, siehe dazu die Forumsdiskussion ab {{Link2Forum\|Topic=38328\|Message=1021642\|LinkText=diesem Beitrag}}. Hilfreich hat sich ein upgrade der SSL-Module erwiesen. Zuerst muss u.U. ein Modul installiert werden
	sudo apt-get install libssl-dev		:<code>sudo apt-get install libssl-dev</code>
	und danach in zwei Schritten		und danach in zwei Schritten
	sudo cpan <enter>		sudo cpan <enter>
Zeile 168:		Zeile 168:
	IO::Socket::SSL 2.002 -> 2.066		IO::Socket::SSL 2.002 -> 2.066
	notwendig. Es wird darauf hingewiesen, dass idealerweise nicht einzelne Module, sondern das gesamte OS sowie alle Perlmodule auf den neuesten Stand gebracht werden sollten.		notwendig. Es wird darauf hingewiesen, dass idealerweise nicht einzelne Module, sondern das gesamte OS sowie alle Perlmodule auf den neuesten Stand gebracht werden sollten.


	=== Befehle von Telegram an FHEM senden ===		=== Befehle von Telegram an FHEM senden ===
	Es handelt sich hier um ein Tool, das im Forum vorgestellt wurde~~: https://forum.fhem.de/index.php/topic,51425.msg464928.html#msg464928~~. Dabei wird ein notify in FHEM angelegt, das den TelegramBot überwacht. Wird eine Befehlsfolge an den Bot gesendet, liest das Telegram-device die gesendete Information aus und führt den Befehl aus. Weitere Details, wie hier vorzugehen ist, unter dem oben angegebenen Link im Forum.		Es handelt sich hier um ein Tool, das {{Link2Forum\|Topic=51425\|Message=464928\|LinkText=hier im Forum}} vorgestellt wurde. Dabei wird ein notify in FHEM angelegt, das den TelegramBot überwacht. Wird eine Befehlsfolge an den Bot gesendet, liest das Telegram-device die gesendete Information aus und führt den Befehl aus. Weitere Details, wie hier vorzugehen ist, unter dem oben angegebenen Link im Forum.

	Wenn man an FHEM Befehle senden will, muss der TelegramBot bereit sein diese Nachrichten zu empfangen. Wenn man allerdings aus Sicherheitsgründen das Attribut		Wenn man an FHEM Befehle senden will, muss der TelegramBot bereit sein, diese Nachrichten zu empfangen. Wenn man allerdings aus Sicherheitsgründen das Attribut
	allowUnknownContacts = 0		:<code>allowUnknownContacts = 0</code>
	gesetzt hat, dann ist ein solcher Empfang nicht möglich. Daher muss (zumindest einmalig) erlaubt werden, von unbekannten Kontakten eine Nachricht zu bekommen. Nach dem ersten Empfang ist dann der Kontakt bekannt und man kann erneut den Empfang auf bekannte Kontakte beschränken.		gesetzt hat, dann ist ein solcher Empfang nicht möglich. Daher muss (zumindest einmalig) erlaubt werden, von unbekannten Kontakten eine Nachricht zu bekommen. Nach dem ersten Empfang ist dann der Kontakt bekannt und man kann erneut den Empfang auf bekannte Kontakte beschränken.

	== Beispielszenarien ==		== Beispielszenarien ==

	=== Benachrichtigungen über Ereignisse ===		=== Benachrichtigungen über Ereignisse ===

	Das einfachste Szenario für die Integration von Messaging-Diensten mit FHEM ist zur Benachrichtigung über Ereignisse. Diese Funktion kann zum Beispiel verwendet werden, um über einen erfolgten Neustart von FHEM zu informieren:		Das einfachste Szenario für die Integration von Messaging-Diensten mit FHEM ist zur Benachrichtigung über Ereignisse. Diese Funktion kann zum Beispiel verwendet werden, um über einen erfolgten Neustart von FHEM zu informieren: