Telegram-Beitrag (publora)

Telegram-Beitrag

Erstellen und planen Sie Beiträge für Telegram-Kanäle und -Gruppen mit dem Publora MCP-Server. Unterstützt reichhaltige Markdown-Formatierung, Fotos, Videos und Zustellungsoptionen.

Voraussetzungen

Tarife: Funktioniert mit dem kostenlosen Starter-Tarif. Aktuelle Limits und Preise: publora.com/pricing.

Erste Schritte

1. Konto erstellen bei publora.com/register (kostenlos)
2. Telegram-Bot erstellen:
   • Schreiben Sie @BotFather auf Telegram
   • Senden Sie /newbot und folgen Sie den Anweisungen
   • Speichern Sie das Bot-Token
3. Bot zu Ihrem Kanal hinzufügen:
   • Fügen Sie den Bot als Administrator zu Ihrem Kanal/Ihrer Gruppe hinzu
   • Erteilen Sie die Berechtigung can_post_messages
4. In Publora verbinden im Dashboard mit Bot-Token und Kanalname
5. API-Schlüssel abrufen unter app.publora.com/dashboard/api
6. Verbinden Sie Ihren Agenten mit dem MCP-Server unter https://mcp.publora.com und authentifizieren Sie sich mit Authorization: Bearer sk_YOUR_API_KEY. In Claude Code:

claude mcp add publora --transport http https://mcp.publora.com \
  --header "Authorization: Bearer sk_YOUR_API_KEY"

Claude Desktop, Cursor, Codex, OpenClaw und der claude.ai-Connector benötigen jeweils eine andere Konfigurationsdatei oder einen anderen Ablauf: Siehe Client Setup für den genauen Pfad und Code-Ausschnitt.

REST-API-Fallback

Falls der MCP-Server nicht verfügbar ist oder Fehler zurückgibt, verwenden Sie direkt die REST-API:

Basis-URL: https://api.publora.com/api/v1

Authentifizierung: Verwenden Sie den Header x-publora-key (NICHT Authorization: Bearer):

# Ihre verbundenen Plattformen abrufen
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_your_api_key"

# Einen Beitrag erstellen
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["telegram-1001234567890"],
    "content": "*Ankündigung*\n\nIhre Nachricht hier",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

Plattform-ID-Format: telegram-{chat_id} wobei {chat_id} die numerische ID des Kanals/der Gruppe von /platform-connections ist.

Beispiel-IDs: telegram-1001234567890, telegram--1002345678901

📖 Vollständige API-Dokumentation: docs.publora.com

Plattformlimits (Bot-API)

Funktion	Limit
Textnachricht	4.096 Zeichen
Medienunterschrift	1.024 Zeichen (kritisches Limit!)
Bilder	max. 10 MB, max. 10 pro Mediengruppe
Bildformate	JPEG, PNG, GIF, BMP, WebP
Videogröße	max. 50 MB (nicht 4 GB – das gilt für normale Nutzer!)
Videoformate	MP4, MOV, AVI, MKV, WebM
Ratenlimit	30 Nachrichten/s global, 20 Nachrichten/min pro Gruppe

Kritisch: Die Bot-API hat deutlich niedrigere Limits als normale Telegram-Nutzer. Videos über 50 MB und Unterschriften über 1.024 Zeichen schlagen fehl.

Markdown-Formatierung

Telegram verwendet eine eigene Markdown-Variante mit einfachen Sternchen für Fettdruck:

Syntax	Ergebnis
*fett*	fett
_kursiv_	kursiv
`code`	Inline-Code
code	Codeblock
[text](url)	Hyperlink
> text	Zitatblock

Hinweis: Dies unterscheidet sich von standardmäßigem Markdown, wo **doppelte Sternchen** für Fettdruck verwendet werden.

Verfügbare Tools

create_post

Erstellt einen neuen Telegram-Beitrag.

Parameter:

• platforms: Array mit Ihrer Telegram-Verbindungs-ID (z. B. ["telegram-1001234567890"])
• content: Nachrichtentext (unterstützt Markdown)
• scheduledTime: ISO 8601 UTC-Datums-/Uhrzeitangabe. Optional: Wenn ausgelassen, wird der Beitrag als Entwurf erstellt. Senden Sie einen zukünftigen Zeitpunkt, um ihn zu planen. Ein Zeitpunkt fünf oder mehr Minuten in der Vergangenheit wird mit SCHEDULED_TIME_IN_PAST abgelehnt. Verwenden Sie daher für sofortiges Posten die aktuelle Zeit plus eine Minute.
• mediaUrls: bis zu 10 öffentliche https-Bild- oder Video-URLs. Publora lädt sie serverseitig herunter und hängt sie vor der Validierung an, sodass Medien und Planung in einem Aufruf erfolgen. Dies ist die einmalige Alternative zum Ablauf „Entwurf, dann get_upload_url, dann complete_media“. Die Aufnahme ist auf 60 URLs pro Stunde begrenzt.

get_upload_url

Ruft eine vorab signierte URL für Medien-Uploads ab.

complete_media

Schließt eine über get_upload_url hochgeladene Datei ab, nachdem der vorab signierte PUT erfolgreich war. Optional, da die Planung auch ausstehende Medien abschließt, aber ein frühzeitiger Aufruf zeigt Format- und Sondierungsfehler vor der Veröffentlichung an. Nicht erforderlich für Medien, die mit mediaUrls angehängt wurden.

Parameter:

• mediaId: die von get_upload_url zurückgegebene ID

list_connections

Listet Ihre verbundenen Konten mit ihren Plattform-IDs auf. Rufen Sie dies zuerst auf und kopieren Sie die IDs wörtlich; sie sind niemals erratbar.

list_posts / get_post / update_post / delete_post

Verwalten Sie geplante Beiträge und Entwürfe. update_post ändert auch content und platforms eines Entwurfs oder geplanten Beitrags, sodass die Korrektur eines Tippfehlers oder die Neuzuweisung nicht mehr das Löschen und Neuerstellen bedeutet. delete_media und prune_media_reference bereinigen hochgeladene Dateien.

Beitragsoptionen (über REST-API)

Telegram-spezifische Optionen verfügbar über die REST-API platformSettings.telegram:

Option	Beschreibung
disableNotification	Still senden (kein Ton)
disableWebPagePreview	Keine Linkvorschaukarten
protectContent	Weiterleitung/Speichern verhindern

Unterschrift über Medien ist nicht einstellbar: showCaptionAboveMedia ist kein akzeptierter Schlüssel und das Senden gibt 400 PLATFORM_SETTING_UNKNOWN zurück.

Hinweis: platformSettings wird sowohl von den MCP-Tools create_post und update_post als auch über REST akzeptiert. Das Schema ist streng: Eine falsch geschriebene Plattform oder ein falscher Schlüssel wird mit einem Validierungsfehler abgelehnt, nicht stillschweigend ignoriert.

Beispiele

Einfacher Kanalbeitrag

Poste dies in meinem Telegram-Kanal:
"*Produktupdate v2.5*

Wir haben folgende Verbesserungen ausgeliefert:
- _Schnellere API-Antwortzeiten_ (durchschnittlich 45ms)
- Neuer `batch`-Endpunkt für Massenvorgänge

[Änderungsprotokoll lesen](https://example.com/changelog)"

Formatierte Ankündigung

Erstelle einen Telegram-Beitrag mit dieser Formatierung:
"*Wichtiges Update*

Wir starten morgen um 10:00 UTC unsere neue Funktion.

_Was ist neu:_
- Verbesserungen an Funktion A
- Veröffentlichung von Funktion B

[Die vollständige Ankündigung lesen](https://example.com/update)"

Beitrag mit Bild

Poste dieses Bild mit folgender Unterschrift in meinem Telegram-Kanal:
"*Neue Dashboard-Vorschau*

Hier ist ein erster Blick auf unser neu gestaltetes Analyse-Dashboard."

Wichtig: Bei Beiträgen mit Medien muss die Unterschrift unter 1.024 Zeichen liegen.

Geplanter Beitrag

Plane dies für morgen um 8:00 Uhr Moskauer Zeit:
"*Guten Morgen!* Hier ist Ihre tägliche Marktzusammenfassung..."

Wichtige Einschränkungen

1. Unterschriftenlimit beträgt 1.024 Zeichen: Bei Beiträgen mit Medien (Bilder/Videos) wird der Text als Unterschrift gesendet, die auf 1.024 Zeichen begrenzt ist. Nur-Text-Nachrichten erlauben 4.096 Zeichen.

2. Video max. 50 MB: Die Bot-API begrenzt Videos auf 50 MB (nicht 4 GB wie normale Nutzer). Große Videos schlagen fehl.

3. Bot muss Administrator sein: Ihr Bot benötigt die Administratorrolle mit der Berechtigung can_post_messages. Dies wird beim Verbinden überprüft.

4. Keine gemischten Medien: Ein einzelner Beitrag kann nicht sowohl Bilder als auch Videos enthalten.

5. Überlauf der Unterschrift: Wenn die Unterschrift bei einem Medienbeitrag 1.024 Zeichen überschreitet, wird sie als separate Antwortnachricht gesendet, anstatt abgeschnitten zu werden.

Best Practices

Inhalt

1. Formatierung verwenden: Fette Überschriften, kursive Hervorhebung verbessern die Lesbarkeit
2. Linkvorschauen: Großartig für Artikel; für schlichtere Ankündigungen deaktivieren
3. Emoji-Verwendung: Auf Telegram üblich und erwartet
4. Beitragslänge: Keine Nachteile bei längeren Beiträgen bei Nur-Text-Nachrichten

Zeitplanung

• Globales Publikum: Telegram-Nutzer sind weltweit; denken Sie an Beiträge in verschiedenen Zeitzonen
• Beste Zeiten: 8–10 Uhr, 12–14 Uhr, 19–21 Uhr in den Zielregionen
• Häufigkeit: Kanäle können häufiger posten (5–10/Tag)

Engagement

• Aktivieren Sie Kommentare in den Kanaleinstellungen für Diskussionen
• Verwenden Sie Umfragen für Interaktion
• Heben Sie wichtige Ankündigungen hervor

Fehlerbehebung

Fehler	Ursache	Lösung
„Bot ist kein Admin“	Bot hat keine Admin-Rechte	Bot als Admin mit can_post_messages hinzufügen
„Kanal nicht gefunden“	Falscher Kanalname/ID	Überprüfen Sie @kanalname oder die numerische Chat-ID
MEDIA_CAPTION_TOO_LONG	Unterschrift > 1.024 Zeichen	Unterschrift kürzen oder Nur-Text-Beitrag verwenden
„Bad Request: Datei zu groß“	Datei > 50 MB	Video/Bild auf unter 50 MB komprimieren
„Gemischte Medien nicht unterstützt“	Bilder + Video im selben Beitrag	Verwenden Sie einen Medientyp pro Beitrag