Telegram
Anyy verbindet sich über ein Bot-Token und das Bot-API-Long-Polling-Profil mit Telegram. Es unterstützt Direktnachrichten, Gruppen, eingehende Medien, Kopplung und Live-Zustandsprüfungen.
1. Einen Telegram-Bot erstellen
Öffnen Sie in Telegram das offizielle Konto BotFather:
- Senden Sie
/newbot. - Wählen Sie Anzeigenamen und Benutzernamen des Bots.
- Kopieren Sie das Bot-Token einmal.
- Prüfen Sie BotFather-Datenschutz-/Gruppeneinstellungen, wenn Sie den Bot Gruppen hinzufügen möchten.
Behandeln Sie das Token als Passwort. Wer es besitzt, kann als Bot handeln.
2. Das Konto in Anyy hinzufügen
Öffnen Sie Dashboard → Kanal → Hinzufügen → Telegram. Geben Sie Konto-ID und Bot-Token für den Bot-API-Long-Polling-Eintrag ein. Verwenden Sie für Richtlinien den folgenden CLI-Assistenten; das Dashboard-Zugangsdatenformular enthält sie nicht.
CLI-Einrichtung ist ebenfalls verfügbar:
anyy setup channel
Wählen Sie Telegram im Assistenten. Die Einrichtung speichert das Token als Profil-Geheimnisreferenz und prüft mit Telegram getMe die entfernte Identität, bevor der Adapter gesund wird.
3. Zugriffsrichtlinien wählen
Standardrichtlinien sind:
| Gespräch | Standard |
|---|---|
| Direktnachrichten | pairing |
| Gruppen | mention |
DM-Richtlinie kann open, allowlist, pairing oder disabled sein. Der aktuelle Einrichtungskatalog bietet Gruppenrichtlinie mention, allowlist, open oder disabled. Vorhandene Zulassungslisten verwenden numerische Telegram-Benutzer-/Chatkennungen; die aktuelle Telegram-Einrichtung bearbeitet keine Listeneinträge. Siehe gemeinsame Einrichtungsgrenzen.
Ein offener Bot kann Anbieterkontingent verbrauchen und unerwarteten Absendern Werkzeuge zugänglich machen. Prüfen Sie Absenderzugriffsrichtlinie und aktivierte Werkzeuge, bevor Sie Zugriff erweitern.
4. Starten und prüfen
anyy channel reload
anyy channel doctor telegram
Senden Sie dem Bot dann eine Direktnachricht. Listen und bestätigen Sie bei standardmäßiger Kopplungsrichtlinie den ausstehenden Absender über die CLI:
anyy channel pairing list --channel telegram
anyy channel pairing approve --request REQUEST_ID
Senden Sie nach Bestätigung der Kopplungsanfrage eine weitere Nachricht und prüfen Sie, ob Anyy im selben Telegram-Gespräch antwortet.
Gruppen und Erwähnungen
Fügen Sie den Bot einer Gruppe hinzu und verwenden Sie seinen @username mit der Standardrichtlinie mention. Verhindern Telegram-Datenschutzeinstellungen den Empfang gewünschter Gruppennachrichten, passen Sie sie in BotFather an und fügen/laden Sie den Bot nach Telegram-Vorgaben erneut hinzu.
Der aktuelle Adapter weist keine Telegram-Thread-Unterstützung aus; verlassen Sie sich nicht auf themenspezifisches Routing.
Medien und lange Antworten
Anyy kann unterstützte eingehende Telegram-Medien für die Sitzung zwischenspeichern. Langer ausgehender Text wird entsprechend dem Adapter-Textlimit aufgeteilt. Mediendownload und Nachrichtengröße unterliegen weiterhin Adapter- und Telegram-Grenzen.
Fehlerbehebung
| Symptom | Prüfung |
|---|---|
| Token abgelehnt | BotFather-Token neu erzeugen/kopieren und gespeicherte Zugangsdaten ersetzen |
| Bot bleibt im Backoff | anyy channel doctor telegram ausführen; getMe und Bot-API-Netzzugriff prüfen |
| DM erhält Kopplungshinweis, aber keine Antwort | Ausstehende Anfrage bestätigen, dann neue Nachricht senden |
| Gruppennachricht ignoriert | Bot erwähnen, Gruppenrichtlinie/Zulassungsliste und BotFather-Datenschutzmodus prüfen |
| Doppelte/alte Nachrichten erscheinen | Long-Poll-Zustand prüfen und neu laden; Anyy speichert den Telegram-Update-Offset |
Gemeinsame Kanalsteuerung finden Sie unter Nachrichtenplattformen.