Telegram

Sendet Nachrichten, Bilder, Dokumente und Videos über einen Telegram-Bot. Kann auch neue Nachrichten empfangen und Chats verwalten. Ideal für automatische Benachrichtigungen, Alerts oder Bot-gesteuerte Kommunikation.

Kategorie: Kommunikation | Quelldatei: telegramBlock.js | Auth: Ja (Bot Token)

---

Was kann dieser Block?

• Nachrichten senden: Text, Fotos, Dokumente, Videos, Audio, Standorte
• Nachrichten empfangen: Neue Nachrichten per Webhook oder Polling abrufen
• Bot verwalten: Bot-Infos anzeigen, Webhook konfigurieren
• Chat-Infos: Mitgliederzahl, Admins, Chat-Details abrufen

Was brauche ich dafür?

Telegram Bot erstellen (5 Minuten)

1. Öffne Telegram und suche nach @BotFather
2. Sende /newbot
3. Wähle einen Namen (z.B. "Uella Notifications")
4. Wähle einen Username (muss auf bot enden, z.B. digitag_notify_bot)
5. Du bekommst einen Bot Token zurück (sieht so aus: 7123456789:AAH...)
6. Trage den Token im Agent Loop Block unter enabledTools → Telegram → botToken ein

Chat-ID herausfinden

Einzelchat:

1. Sende deinem Bot eine Nachricht (/start)
2. Öffne im Browser: https://api.telegram.org/bot<DEIN_TOKEN>/getUpdates
3. In der Antwort findest du die Chat-ID unter message.chat.id (z.B. 123456789)

Gruppen-Chat:

1. Füge den Bot zur Gruppe hinzu
2. Sende eine Nachricht in der Gruppe
3. Gleiche URL aufrufen — Gruppen-ID beginnt mit - (z.B. -1001234567890)

Wichtig: Der Empfänger muss den Bot zuerst mit /start starten, sonst kommt ein 403-Fehler.

---

So benutzt du den Block

Nachricht senden

Prompt: "Sende eine Telegram-Nachricht an Chat 123456789: Das tägliche Backup war erfolgreich."

Ergebnis: Nachricht wird gesendet.

Foto senden

Prompt: "Sende dieses Bild per Telegram an Chat 123456789"

Ergebnis: Foto wird mit optionaler Bildunterschrift gesendet.

Neue Nachrichten prüfen

Prompt: "Gibt es neue Telegram-Nachrichten?"

Ergebnis: Liste der neuen Nachrichten mit Absender und Text.

---

Alle Funktionen im Überblick

Nachrichten senden (6 Operationen)

Funktion	Was passiert	Beispiel-Prompt
Text senden	Textnachricht senden	"Sende eine Nachricht: Hallo Welt"
Foto senden	Bild senden (URL oder Datei)	"Sende dieses Bild per Telegram"
Dokument senden	Datei senden	"Sende dieses PDF per Telegram"
Video senden	Video senden	"Sende dieses Video"
Audio senden	Audiodatei senden	"Sende diese Audiodatei"
Standort senden	GPS-Koordinaten senden	"Sende den Standort von Zürich"

Empfangen (2 Operationen)

Funktion	Was passiert	Beispiel-Prompt
Webhook	Eingehende Events verarbeiten	Automatisch bei Webhook-Trigger
Polling	Neue Nachrichten abrufen	"Prüfe ob neue Nachrichten da sind"

Bot & Chat (5 Operationen)

Funktion	Was passiert	Beispiel-Prompt
Bot-Infos	Name und Username anzeigen	"Zeige die Bot-Infos"
Webhook setzen/löschen	Webhook konfigurieren	"Setze den Webhook auf https://..."
Chat-Infos	Details zum Chat	"Zeige die Chat-Infos"
Mitglieder zählen	Anzahl Mitglieder	"Wie viele Mitglieder hat die Gruppe?"
Admins auflisten	Administratoren anzeigen	"Wer sind die Admins?"

---

Häufige Probleme und Lösungen

Problem	Lösung
403 Forbidden	Empfänger hat /start noch nicht gesendet — Bot muss erst gestartet werden
401 Unauthorized	Bot Token falsch — bei @BotFather prüfen
Chat not found	Chat-ID falsch — über /getUpdates erneut ermitteln
Chat-ID unbekannt	Immer die numerische ID verwenden, nicht den @username
Block wird vom AgentLoop nicht aufgerufen	Prüfen ob der Telegram-Block in den enabledTools aktiviert ist

---

Weiterführende Links

• Telegram Bot API: https://core.telegram.org/bots/api
• @BotFather: https://t.me/BotFather
• Bot erstellen (Anleitung): https://core.telegram.org/bots#how-do-i-create-a-bot

---

Technische Details

Parameter	Typ	Pflicht	Beschreibung
operation	Select	Ja	Die Aktion (send_text, send_photo, bot_info etc.)
botToken	Password	Ja	Bot Token von @BotFather
chatId	Text	Ja (bei meisten Operationen)	Numerische Chat-ID
parseMode	Select	Nein	Formatierung: HTML, Markdown, MarkdownV2. Standard: HTML