Telegram-Anforderungen & -Grenzen

1. Nachrichtenlimits

  • Nur-Text-Nachricht: Maximal 4.096 Zeichen.
  • Nachricht mit einem Bild: Maximal 1.024 Zeichen (für ein 1080x1080 px Bild).

2. Bildanforderungen

  • Format: Quadratische Bilder werden bevorzugt.
  • Optimale Größe: 900x900 Pixel, maximal 5 MB.

3. Dateianforderungen

Die Telegram-API hat spezifische Anforderungen für hochgeladene Dateien:

  • Bots können Dateien bis zu 2 GB senden.
  • Du kannst file_id verwenden, um mit zuvor hochgeladenen Dateien zu arbeiten. In diesem Fall gelten die Dateilimits gemäß der Telegram-Dokumentation.
  • Dateien können über eine URL gesendet werden (der Bot lädt sie herunter und sendet sie):
    • Fotos: ≤ 5 MB
    • Andere Dateien: ≤ 20 MB
  • Für das Posten gelten andere Limits:
    • Fotos: 10 MB
    • Andere Dateien: 2 GB

Mehr in der Originalquelle lesen

Telegram-Bot-Erstellung

Ein Telegram-Bot wird über BotFather erstellt, dem offiziellen Bot-Verwaltungssystem von Telegram. Dieses verifizierte Tool (erkennbar am blauen Haken) ermöglicht es dir, einen Bot ohne Programmierkenntnisse zu erstellen und schützt dich vor betrügerischen Nachahmern.

Erstellungsschritte:

  1. Starte einen Chat mit BotFather.
  2. Sende den Befehl: /newbot
  3. Wähle einen Namen für deinen Bot (dies ist der Anzeigename für Benutzer).
  4. Wähle einen Benutzernamen für deinen Bot. Er muss mit bot oder _bot enden (z. B. my_test_bot).

Wenn der Benutzername verfügbar ist, sendet dir BotFather eine Bestätigungsnachricht mit einem "Token" – einem eindeutigen Schlüssel für den API-Zugriff.

Wichtig: Dieser Token ist ein Passwort für deinen Bot. Speichere ihn sicher und teile ihn niemals mit irgendjemandem.

Navigiere zum Bereich Messenger, wähle Telegram aus und füge den Token deines Bots in das dafür vorgesehene Feld ein.

Klicke auf die Schaltfläche Fertig, um die Bot-Einrichtung abzuschließen und die Verbindung zu deinem Projekt zu aktivieren.

Arbeiten mit Telegram-Gruppen/-Kanälen

Nützliche Informationen

Eine Telegram-Gruppe ist ein Kommunikationskanal zwischen Teilnehmern: Alle Teilnehmer können darin schreiben.

Der Telegram-Kanal ist ein einseitiges Kommunikationsmittel. Nur der Eigentümer oder Administratoren können Nachrichten senden, während die anderen Teilnehmer sie nur ansehen und Kommentare hinterlassen können.

So fügst du einen Bot zu einer Telegram-Gruppe/einem Kanal hinzu

Diese Funktion für den Bot ist in BotFather enthalten:

Schritt 1. Gehe zu den Bot-Einstellungen:

Schritt 2. Klicke auf "Allow Groups?"

Schritt 3. Es sollte ein aktivierter Status angezeigt werden.

Einen Bot als Administrator in einer Gruppe/einem Kanal hinzufügen

Um die Arbeit in Chats und Kanälen zu automatisieren, musst du deinen eigenen Bot als Administrator hinzufügen.

Wie macht man das?

Schritt 1. Gehe zur Gruppen-/Kanalverwaltung und wähle den Tab Administratoren aus

Schritt 2. Klicke auf die Schaltfläche "Admin hinzufügen".

Schritt 3. Gib den Benutzernamen deines Bots in das Suchfeld ein.

Schritt 4. Stelle für die volle Funktionalität sicher, dass der Bot die Rechte zum Lesen und Löschen von Nachrichten hat.

Variablen für die Arbeit in Chats

Bitte beachte!

Das Speichern von Variablen in Gruppenchats für Ereignisse wie Beitritt, Austritt, neuer Like usw. ist nicht verfügbar.

Variablen sind nur innerhalb des Blocks verfügbar, der ausgelöst wurde. Du kannst diese Variablen im Block ausgeben, um die Arbeit zu verfolgen.

Dies wird die Funktionsweise von Chatbots in KEINER WEISE beeinflussen; es wird unmöglich sein, im Bereich "Clients" nachzuverfolgen, wer beigetreten/ausgetreten ist.

  • Variablen mit Informationen über den Autor der Nachricht

message_from - die ID des Nachrichtenautors

message_from_name - der Name des Nachrichtenautors

message_from_username - der Spitzname des Nachrichtenautors in Telegram

  • Variablen mit Informationen über die weitergeleitete Nachricht

reply_message_id - die Nummer der weitergeleiteten Nachricht

reply_from - wer ist der Autor der weitergeleiteten Nachricht

reply_from_name - der Name der Person, deren Nachricht weitergeleitet wird

reply_from_username - der Spitzname der Person, deren Nachricht weitergeleitet wird

reply_from_chat_id - die Nummer des Dialogs, aus dem die Nachricht weitergeleitet wurde

  • Hinzufügen und Entfernen aus einer Gruppe

In diesem Fall werden die Callbacks new_chat_member und left_chat_member ausgelöst (Variablen werden nicht in der Client-Karte gespeichert):

chat_member_name - Benutzername

chat_member_username - Spitzname des Benutzers

chat_member_id - Nummer des Benutzers

Callbacks in Telegram

client_unsubscribed - der Client hat das Abonnement gekündigt, den Bot blockiert

client_returned - der Client hat den Bot entblockiert

Callbacks in Gruppen/Kanälen

new_chat_member - ein neuer Benutzer wurde hinzugefügt

left_chat_member - der Benutzer hat den Kanal verlassen

kicked_chat_member - der Benutzer wurde vom Administrator gelöscht

chat_join_request - eine Anfrage zum Hinzufügen zum Kanal wurde erhalten

edited_channel_post - der Beitrag im Kanal wurde bearbeitet (edited_channel_post + Datum und Uhrzeit der Bearbeitung)

Callbacks werden im Bereich Clients angezeigt

bot_added_to_group - ein Bot wurde zum Chat hinzugefügt (egal welcher, er reagiert auf jeden, auch wenn der verbundene Bot selbst zur Gruppe hinzugefügt wurde);

bot_left_group - ein ähnlicher Callback ist das Entfernen des Bots aus dem Kanal;

new_like - der Beitrag wurde geliked

like_deleted - ein Like vom Beitrag wurde gelöscht

Die Nummer im Callback (new_like; like_deleted) ist die ID der Nachricht, auf die reagiert oder von der entfernt wurde.

Bitte beachte!

  • Callbacks für Reaktionen werden in Telegram-Kanälen NICHT angezeigt! Callbacks für Reaktionen kommen nur in Gruppen.
  • Wenn eine Person mehrere Likes gesetzt und dann 1 davon gelöscht hat, wird nicht angezeigt, welches gelöscht wurde.

Wenn Callbacks mit Reaktionen in Gruppen auftreten, sind Variablen im Block verfügbar:

reaction_on_message_id - enthält die ID der Nachricht, auf die reagiert wurde

reaction_from - ID von wem die Reaktion kam

message_from_username - Benutzername von wem die Reaktion kam (falls vorhanden)

reaction_from_name - Name von wem die Reaktion kam

Wenn Telegram außerdem auf eine Nachricht antwortet, enthält die Variable reply_text in der Karte den vollständigen Text der Nachricht, auf die geantwortet wurde.

Wenn eine Nachricht als Antwort (unter Zitieren einer vorherigen Nachricht) gesendet wurde, generiert das System auch die Variable tg_quote, die den zitierten Text enthält.

Callbacks mit Boost

  • chat_boost_from user #{id_user} - hat dem Chat (oder Kanal) einen Boost gegeben:

Wenn dieser Callback ausgelöst wird, werden Variablen generiert:

  • remove_boost_from user #{id_user} - der Boost wurde dem Chat (oder Kanal) entzogen:

Wenn dieser Callback ausgelöst wird, werden Variablen generiert:

  • chat_boost from giveaway - ausgestellt während der Verlosung von Sternen im Kanal
  • remove_chat_boost from giveaway - der Boost-Zeitraum für die Verlosung von Sternen im Kanal ist abgelaufen

So automatisierst du das Entfernen von Systembenachrichtigungen in Gruppen

Um automatisch alle Systemnachrichten zu löschen, reicht es aus, der Variable del_tg_system_messages einen beliebigen Wert zuzuweisen (die Variable kann entweder eine Projektkonstante oder eine Transaktionsvariable sein) und dem Bot die Berechtigung zum Löschen von Nachrichten zu erteilen.

Die Variable del_tg_system_messages kann nur in Gruppen verwendet werden. In Kanälen führt die Zuweisung eines beliebigen Werts zu dieser Variable zu keinem Ergebnis.

Administratorrechte in den Telegram-Gruppeneinstellungen

Die folgenden Arten von Systembenachrichtigungen werden entfernt:

- Der Name der Gruppe wurde geändert

- Das Foto der Gruppe wurde geändert

- Gruppenfoto gelöscht

- Die Nachricht ist angepinnt

- Der Benutzer ist der Gruppe beigetreten

- Der Benutzer hat die Gruppe verlassen

Wenn du nur ausgewählte Arten von Systembenachrichtigungen löschen möchtest, erstelle anstelle der Variable del_tg_system_messages die Variable del_tg_chosen_messages und füge darin ein Array mit den zu löschenden Benachrichtigungstypen, getrennt durch Kommas, ein.

Bitte beachte!

Diese Variablen funktionieren nur für Telegram-Gruppen, nicht für Kanäle.

Optionen für Systembenachrichtigungen:

  • 'new_chat_member' – der Benutzer ist der Gruppe beigetreten,
  • 'left_chat_member' – der Benutzer hat die Gruppe verlassen,
  • 'pinned_message' – die Nachricht ist angepinnt,
  • 'delete_chat_photo' – Gruppenfoto gelöscht,
  • 'new_chat_photo' – das Foto der Gruppe wurde geändert,
  • 'new_chat_title' – der Name der Gruppe wurde geändert

Wenn du beispielsweise alle Arten von Systemnachrichten außer dem Beitritt zur Gruppe löschen musst, dann musst du alle Arten von Callbacks zur Projektvariable (Konstante) hinzufügen, außer "new_chat_member".

Bitte beachte!

Das Löschen von Systembenachrichtigungen hat keinen Einfluss auf Callbacks. Nur die Systemnachricht aus dem Telegram-Dialog wird gelöscht.

Forum in Telegram

Ein Forum ist eine Gruppe, in der du separate Themen zur Diskussion erstellen kannst. Du kannst im Forum Standardfunktionen verwenden: Mediendateien anhängen, Umfragen erstellen und Benachrichtigungen einrichten. Du kannst auch Nachrichten anpinnen und einzelnen Bots zu jedem Chat hinzufügen.

Der Hauptzweck eines Forums ist es, die Kommunikation innerhalb einer großen Community zu strukturieren.

In einem standardmäßigen Gruppenchat mit vielen Teilnehmern wird es schwierig, Unterhaltungen zu verfolgen und relevante Nachrichten zu finden. Foren lösen dies, indem sie Diskussionen in dedizierte, thematische Threads organisieren. Dies segmentiert die Community automatisch nach Thema und Interesse und macht die Kommunikation fokussierter und überschaubarer.

Nur der Gruppeneigentümer kann ein Thema erstellen, wenn die Gruppe mehr als 100 Mitglieder hat. Wenn die Gruppe mit einem Kanal verknüpft ist, kannst du kein Thema erstellen. Themen werden in den Gruppeneinstellungen aktiviert:

Als Administrator kannst du in den Einstellungen der Forum-Gruppe ein Thema erstellen:

Nach dem Verbinden der Themen ändert sich das Avatar von rund zu quadratisch, wodurch du das Forum von anderen Telegram-Chats unterscheiden kannst:

Wie konfiguriere ich ein Telegram-Client-Bundle mit einer Website?

Lies mehr darüber, wie du einen Telegram-Client und einen Client von der Website nach einer erfolgreichen Zahlung hier verknüpfst.