Social-Media-Posting — Benutzerhandbuch

Was das Modul „Social Media" leistet

Das Modul ist Editor und Scheduler für Posts auf 18 Plattformen. Sie schreiben Inhalt im TipTap-Editor, hängen Medien an, wählen Ziele, setzen die Zeit — der Post geht sofort oder zeitgesteuert raus. OAuth-Anbieter mit Auto-Refresh und Plattformen mit direkten API-Tokens werden unterstützt.

Was Sie bekommen:

Ein Post → viele Plattformen — ein Entwurf wird gleichzeitig in die gewählten Netzwerke veröffentlicht.
Reicher Editor — TipTap; Inhalt wird in drei Formaten gespeichert (content_json, content_html, content_text).
Planung — scheduled_at (ISO 8601) oder sofortiger Versand.
Medien — Drag-and-Drop in den Editor mit Vorschau.
Plattformspezifische Felder — YouTube-Titel, Reddit-NSFW, Telegram-parse_mode usw.
OAuth mit Auto-Refresh — Tokens werden 1 Minute vor Ablauf automatisch erneuert.
Lokaler OAuth-Server auf Port 19284 für interaktive Anmeldung.

Unterstützte Plattformen (18)

Alle mit funktionierenden Adaptern: Discord, Telegram, VK, OK, Twitter (X), Facebook, Instagram, Threads, TikTok, YouTube, WhatsApp, Reddit, LinkedIn, Substack, Boosty, Patreon, WeChat, Weibo.

Auth-Modi:

OAuth (Auto-Refresh) — Reddit, Instagram, Facebook, LinkedIn, Threads, Patreon, YouTube, TikTok.
API-Tokens + Extras:
- Telegram — bot_token + chat_id.
- Discord — webhook_url.
- VK — access_token + group_id.
- OK — app_id, app_public_key, app_secret, access_token, session_key, group_id.
- Weibo — access_token + uid.
- WeChat — app_id, app_secret, token, aes_key.
- Twitter — OAuth 1.0a: api_key, api_secret, access_token, access_token_secret.
- WhatsApp — template_id, recipient_phone.

Post-Parameter

Inhalt — content_json, content_html, content_text.
Medien — Datei-Array mit mime_type, size, lokalem Pfad.
Zielplattformen — Liste der Konten.
Plan — scheduled_at; leer = sofort.
Status — draft / scheduled / sending / sent / partial / failed / cancelled.
Plattform-Felder — extra_fields (JSON) pro Konto.

Plattformspezifische Felder

Plattform	Felder
Instagram	`image_url` (Pflicht)
TikTok	`video` (Pflicht), `hashtags`
YouTube	`video` (Pflicht), `title`, `visibility`
Reddit	`title` (Pflicht), `subreddit`, `nsfw`
Telegram	`parse_mode`, `image`
Twitter	`media` (bis 10)
VK	`images` (bis 5)
Facebook	`image`
LinkedIn	`image`
Discord	`files` (bis 10)
Threads	`image_url`
WeChat	`title` (Pflicht), `thumb_media_id`
Weibo	`image`, `hashtags`
Substack	`title` (Pflicht), `subtitle`
Boosty	`title` (optional)
Patreon	`title` (optional)
WhatsApp	`template_id`, `recipient_phone` (Pflicht)
OK	keine

Globale Einstellungen

Keine speziellen posting*-Schlüssel in den zentralen Einstellungen. Alles liegt in der DB (posting_platforms, posting_posts, posting_post_platforms, posting_media).

Ablauf

1. Plattformen verbinden

Modul Posting im linken Menü öffnen.
Auf Plattformen Konto hinzufügen.
Tokens eintragen oder OAuth-Flow durchlaufen (Browser öffnet sich auf localhost:19284).
Verbindung testen validiert den Zugriff.

2. Post erstellen

Auf Posts Neuer Post klicken.
Inhalt im TipTap-Editor schreiben, Medien anhängen.
Zielplattformen wählen (mehrere möglich).
Plattform-Felder ausfüllen (z. B. subreddit bei Reddit).

3. Senden

Jetzt senden — Post geht sofort raus.
Planen — scheduled_at setzen; Scheduler veröffentlicht automatisch.
Abbrechen — Entwürfe und geplante Posts können vor dem Versand abgebrochen werden; der Post wird als cancelled markiert und nicht gesendet.

4. Status verfolgen

Die Postliste zeigt die Statuswerte. partial bedeutet, dass der Post auf einigen Plattformen veröffentlicht wurde, aber nicht auf allen. Öffne die Details, um den Fehler pro Plattform zu sehen — du kannst nur die fehlgeschlagene Plattform erneut versuchen, ohne erneut an die erfolgreichen zu senden.

Nächste Schritte

Inhalts-Quellen aus RSS und RAG-Kontexten, Ideen im AI Chat entwickeln.
Längere Entwürfe in Docs vorbereiten.

Hilfe und Feedback

Wünschen Sie Mastodon, Bluesky, Pinterest oder A/B-Tests von Posts? Schreiben Sie uns über das Feedback-Formular.