Social-Beiträge

Überblick

Seit 0.7: ein Social-Beitrag ist ein Beitrag. Er entsteht unter Inhalte wie jeder andere Text, und die Netzwerke sind seine Ziele. Damit gibt es ihn nur noch EINMAL — vorher stand derselbe Gedanke als Social-Zeile und als Blog-Beitrag nebeneinander, und beide liefen auseinander. Planung, Freigabe, Sprachen und Fassungen kommen vom Redaktionssystem; was dieses Modul beisteuert, ist die Verbindung zum Netzwerk.

Beiträge werden hier geschrieben, terminiert und veröffentlicht. Die Veröffentlichung selbst übernimmt ein Netzwerk-Adapter — das System kennt die Beiträge, die Verbindung zum jeweiligen Netzwerk liefert der Adapter.

Ein Beitrag kann einer Kampagne zugeordnet werden. Dann zählt er in deren Herkunfts-Auswertung mit; ohne Zuordnung bleibt er ein Beitrag für sich.

Fällige Beiträge werden von einem täglichen Lauf veröffentlicht. Der Lauf ist idempotent und arbeitet stapelweise — ein zweiter Durchgang veröffentlicht nichts doppelt.

Bezahlte Reichweite steht daneben: Werbekampagnen.

Kernaufgaben

Beitrag anlegen. Inhalt schreiben, Netzwerk und Veröffentlichungszeitpunkt festlegen.

Netzwerke vorwählen. Unter Veröffentlicht auf am Inhaltstyp stehen die Netzwerke samt Format, die ein neuer Beitrag schon gewählt hat — je Marke ihr verbundenes Konto. Fehlt der Marke ein Netzwerk, führt Verbinden im Beitrag hierher.

Terminieren. Der geplante Zeitpunkt steuert, wann der Lauf den Beitrag aufgreift. Bis dahin bleibt er änderbar.

Status verfolgen. Die Status der Beiträge sind konfigurierbar, siehe Marketing-Einstellungen. Auf dem Dashboard lassen sich die anstehenden Beiträge als Widget einblenden.

Kampagne zuordnen. Optional — sie ist die Klammer, die den Beitrag mit Versänden und Herkunft zusammenbringt.

Instagram: Feed, Karussell oder Story wählen. Im Beitrag steht unter Ziele am gewählten Instagram-Ziel die Angabe Format:

• Beitrag im Feed (Vorgabe) — das erste Bild mit dem Text als Bildunterschrift.
• Karussell — 2 bis 10 Bilder des Beitrags zum Wischen, in ihrer Reihenfolge, mit dem Text als

Bildunterschrift. Mit weniger oder mehr Bildern scheitert die Ausspielung mit diesem Grund, bevor etwas beim Netzwerk ankommt.

• Story — das erste Bild, ohne Text (Stories tragen keine Bildunterschrift); sie verschwindet

nach 24 Stunden.

Instagram zeigt Beiträge nur mit Bild. Fehlt dem Beitrag (oder seiner Fassung für Instagram) ein Bild, steht am gewählten Instagram-Ziel ein Hinweis. Er sperrt nichts — das Ziel bleibt gewählt, und der Hinweis verschwindet, sobald ein Bild im Beitrag ist, auch schon vor dem Speichern. Ohne Bild schlägt die Veröffentlichung bei Instagram fehl.

Bilder aus dem Editor. Bilder, die Sie im Beitrag hochladen oder aus der Dateiablage wählen, gehen an jedes Netzwerk, das Bilder nimmt. LinkedIn, X und Facebook bekommen die Datei selbst; Formate, die ein Netzwerk nicht annimmt (WebP bei LinkedIn und Facebook), gehen als JPEG. Instagram holt das Bild über eine signierte Adresse, die nach zwei Stunden abläuft, und bekommt immer eine JPEG-Fassung — auch für WebP- und PNG-Bilder. Für Instagram muss die Instanz aus dem Internet erreichbar sein (öffentliche Adresse in MARKETING_BASE_URL).

Andere Netzwerke haben ihre eigenen Angaben am Ziel: YouTube Titel, Sichtbarkeit und „für Kinder gemacht", TikTok Sichtbarkeit und das Abschalten von Kommentaren, Duetten und Stitch. Gespeichert wird mit dem Beitrag; über die Schnittstelle als targetOptions am Beitrag ({"<Ziel-ULID>": {"format": "carousel"}}), die erlaubten Werte nennt availableTargets[].optionSchema.

Formate je Netzwerk

Jedes Ziel hat unter Ziele die Angabe Format. Ohne Wahl gilt das erste Format der Liste. Was das Format braucht — Medien, Antworten, Teile, ein PDF —, steht in den Feldern des Beitrags; was nur dieses Netzwerk wissen will (erster Kommentar, Playlist, Freischaltung), am Ziel.

Was in welches Feld gehört. Bilder und Videos stehen unter Bilder und Videos (Auswahl aus der Dateiablage), in ihrer Reihenfolge. Das PDF für LinkedIn steht unter Dokument (PDF). Die Umfrage-Antworten stehen je Zeile eine; der Text des Beitrags ist die Frage. Ein Thread beginnt mit dem Text, jeder weitere Teil steht unter Weitere Thread-Teile, durch eine Leerzeile getrennt.

Link. Das Feld Link des Beitrags geht an die Netzwerke, die Links nehmen: LinkedIn zeigt ihn ohne Bild als Artikel mit Vorschau, Facebook als Link-Beitrag; bei X und wo ein Bild dabei ist, steht er am Ende des Textes (X zählt jede Adresse mit 23 Zeichen). Angaben am Ziel (Text, Link) nehmen bis 500 Zeichen.

Gründe vor dem Termin. Passt der Beitrag nicht zum Format — ein Reel ohne Video, ein Short im Querformat, ein Video über der Länge, zu viele Bilder, eine Antwort zu lang, ein Freischalt-Zeitpunkt in der Vergangenheit —, steht der Grund am Ziel, bevor Sie veröffentlichen. Das Ziel wird dann nicht angefahren.

Videos. Instagram verarbeitet ein Video erst; das Ziel steht so lange auf Wird verarbeitet und ist danach veröffentlicht — der erste Kommentar folgt dann. Facebook und Instagram holen das Video über eine signierte Adresse; dafür muss die Instanz aus dem Internet erreichbar sein. YouTube-Freischaltung: das Video wird sofort hochgeladen und bleibt privat, bis YouTube es zum gewählten Zeitpunkt freischaltet.

TikTok. Ein Entwurf landet im Postfach der TikTok-App; dort stellen Sie ihn fertig (Musik, Effekte) und veröffentlichen ihn. Ein Foto-Karussell holt TikTok über signierte Adressen — die Domain der Instanz muss dafür bei TikTok bestätigt sein. Stammt ein Bild oder Video aus der KI, trägt der Beitrag TikToks KI-Kennzeichen.

Nur in der App. Was ein Netzwerk über seine Schnittstelle nicht annimmt — Musik und Trend-Sounds (Instagram, Facebook, TikTok), Live, LinkedIn-Artikel, YouTube-Community-Beiträge —, steht in der Formatwahl mit dem Zusatz nur in der App und lässt sich nicht wählen. Für einen TikTok-Beitrag mit Musik: als Entwurf ins Postfach schicken und in der App ergänzen.

Mitgelieferte Inhaltstypen. Beitrag, Karussell, Kurzvideo, Story und Video bringen ihre Netzwerke samt Format schon mit — etwa Kurzvideo: Instagram-Reel, TikTok, YouTube-Short und Facebook-Reel; Karussell: Instagram-Karussell, LinkedIn-Dokument, TikTok-Foto und Facebook mit mehreren Bildern. Ändern lässt sich das unter Veröffentlicht auf am Inhaltstyp.

Ihre Änderungen an den mitgelieferten Typen bleiben. Ein Update überschreibt Felder, Namen und „Veröffentlicht auf" der mitgelieferten Inhaltstypen nicht mehr, und einen gelöschten Typ legt es nicht wieder an. Bringt ein Update neue Felder mit (etwa Dokument (PDF), Umfrage-Antworten, Weitere Thread-Teile oder Videos in der Medien-Auswahl), ergänzt es nur, was fehlt — einmal: ein Feld, das Sie danach entfernen, kommt nicht wieder.

Felder im Detail

Ein Beitrag im sozialen Netz ist ein Inhalt, kein eigener Datensatz. Es gibt keine getrennte Verwaltung — Social liefert die Kanäle, die Beitragsfelder kommen von dort.

Verbundenes Konto

Die eigene Maske dieses Moduls liegt unter Einstellungen → Social-Verbindungen. Sie hat genau einen Zweck: festzulegen, in wessen Namen das Haus spricht.

Mindestens eines von Konto und Werbekonto muss gesetzt sein — ein Aufruf ohne beides wird abgewiesen.

Angezeigt, nicht eingegeben werden:

Trennen entfernt die Geheimnisse der Verbindung. Die App-Zugangsdaten bleiben — sie gehören der Installation, nicht der Verbindung; siehe Integrationen.

App-Zugangsdaten hinterlegen: in den Integrationen die Vorlage des Netzwerks (LinkedIn, Meta, X, YouTube, TikTok, Pinterest, Threads, Google-Unternehmensprofil) wählen und client_id (die App-Kennung, offen gespeichert; bei TikTok heißt sie „Client Key") sowie client_secret (verschlüsselt) aus der Entwickler-Konsole des Netzwerks eintragen. Als Rückweg-Adresse ist dort https://<Ihre Adresse>/api/v1/social/public/oauth/callback einzutragen. Erst dann führt Verbinden zur Zustimmung beim Netzwerk; nach der Zustimmung kommen Sie auf diese Seite zurück und wählen die Seite bzw. das Konto.

YouTube und TikTok: Verbinden holt bei YouTube ein dauerhaftes Erneuerungs-Token (Google fragt dafür jedes Mal erneut nach der Zustimmung) — der Zugang läuft nicht ab. Bei TikTok hält die Verbindung ein Jahr; das kurzlebige Zugriffs-Token wird vor jedem Beitrag automatisch erneuert, gewarnt wird sieben Tage vor dem Jahresende. Beide Netzwerke prüfen die App vor der Freigabe zum Veröffentlichen (Google: Upload-Recht, TikTok: App-Review) — bis dahin funktioniert das Verbinden nur mit den Testkonten der App. Der bisherige Weg von Hand (Erneuerungs- bzw. Zugriffs-Token in den Integrationen) bleibt möglich.

Pinterest, Threads und Google-Unternehmensprofil

Drei weitere Netzwerke werden wie die übrigen unter Einstellungen → Social-Verbindungen mit Verbinden angebunden. Mit dem Verbinden entsteht das Ausspiel-Ziel; im Beitrag erscheint es unter Ziele, am Inhaltstyp unter Veröffentlicht auf. Was ein Netzwerk nicht nimmt, steht schon beim Schreiben am Ziel — nicht erst nachts zum geplanten Termin.

Pinterest

Was hinausgeht: ein Pin auf die gewählte Pinnwand — mit einem Bild, mit mehreren Bildern (2 bis 5, zum Wischen) oder mit einem Video. Der Text wird zur Beschreibung (höchstens 800 Zeichen), die erste Zeile zum Titel. Am Pinterest-Ziel im Beitrag stehen dazu:

Bilder gehen als Datei an Pinterest (JPEG oder PNG; andere Formate als JPEG) — dafür muss die Instanz nicht aus dem Internet erreichbar sein. Ein Video wird hochgeladen, Pinterest verarbeitet es, danach wird angeheftet; als Titelbild dient das erste Bild des Beitrags, sonst das erste Bild des Videos. Ohne Bild und ohne Video lehnt das Ziel den Beitrag ab („Pinterest braucht ein Bild oder ein Video"), ebenso bei mehr als fünf Bildern.

Pinnwand wählen: nach dem Verbinden stehen die Pinnwände des Kontos unter Pinnwand; hat das Konto nur eine, ist sie schon gewählt. Ohne gewählte Pinnwand geht nichts hinaus.

Was Sie einrichten müssen (einmalig):

1. Auf developers.pinterest.com eine App anlegen (Unternehmenskonto nötig) und für

die Rechte boards:read, pins:read, pins:write, user_accounts:read Zugang beantragen. Bis Pinterest den Standardzugang freigibt, gilt der Testzugang (nur Ihr eigenes Konto, Pins zunächst nur für Sie sichtbar).

1. In der App als Rückweg-Adresse https://<Ihre Adresse>/api/v1/social/public/oauth/callback eintragen.
2. In Octibiz unter Integrationen die Vorlage Pinterest wählen und App-ID

(client_id) sowie App-Geheimnis (client_secret) eintragen.

Die Anmeldung hält 60 Tage und erneuert sich selbst — vor jedem Pin und im täglichen Lauf, bevor sie abläuft. Nur wenn das scheitert, warnt die Verbindungs-Seite sieben Tage vorher.

Threads

Was hinausgeht: ein Beitrag mit Text (höchstens 500 Zeichen), mit Bild, mit Video oder als Karussell aus 2 bis 20 Bildern und Videos. Threads holt Bilder und Videos selbst ab: Dateien aus Octibiz bekommen eine signierte Adresse, die nach zwei Stunden abläuft, Videos werden dabei in Stücken ausgeliefert. Dafür muss die Instanz aus dem Internet erreichbar sein (öffentliche Adresse in MARKETING_BASE_URL); Text und fremde Bild-Adressen gehen auch ohne. Videos verarbeitet Threads erst, veröffentlicht wird danach.

Am Threads-Ziel steht Wer antworten darf replyControl: alle, Profile, denen Sie folgen, oder nur Erwähnte.

Was Sie einrichten müssen (einmalig):

1. In Ihrer vorhandenen Meta-App (dieselbe wie für Facebook und Instagram) den Anwendungsfall „Threads API"

hinzufügen und die Rechte threads_basic und threads_content_publish aktivieren.

1. Dort als Rückweg-Adresse https://<Ihre Adresse>/api/v1/social/public/oauth/callback eintragen.
2. Threads-App-ID und Threads-App-Geheimnis ablesen (App-Einstellungen → Allgemein, Bereich Threads — sie

unterscheiden sich von der App-ID der Meta-App) und in den Integrationen unter der Vorlage Threads als client_id und client_secret eintragen.

1. Bis Meta die App für die Threads-Rechte freigibt (App-Prüfung), funktioniert das Verbinden nur mit den Testkonten

der App.

Threads ist ein eigener Zugang: Facebook und Instagram bleiben unabhängig davon verbunden. Das Zeichen hält 60 Tage; Octibiz erneuert es sieben Tage vor dem Ablauf selbst.

Google-Unternehmensprofil

Was hinausgeht: ein Beitrag am gewählten Standort Ihres Unternehmensprofils (Google Suche und Maps) — als Neuigkeit, Angebot oder Veranstaltung, mit dem ersten Bild des Beitrags (Video nimmt Google für Beiträge nicht). Am Ziel stehen dazu:

Fehlen bei Angebot oder Veranstaltung Titel, Beginn oder Ende, endet die Veranstaltung vor ihrem Beginn oder fehlt der Link einer Schaltfläche, scheitert die Ausspielung mit diesem Grund, bevor etwas bei Google ankommt. Das Bild holt Google selbst über eine signierte Adresse — dafür muss die Instanz aus dem Internet erreichbar sein.

Standort wählen: nach dem Verbinden stehen alle Standorte aller Konten, auf die Ihre Anmeldung zugreift, unter Standort (Name, bei Bedarf mit Ort); gibt es nur einen, ist er schon gewählt.

Was Sie einrichten müssen (einmalig):

1. In der Google Cloud Console ein Projekt wählen (das von YouTube kann es sein)

und die Business Profile APIs aktivieren: My Business Account Management API, My Business Business Information API und Google My Business API (Beiträge).

1. Zugang beantragen: Google gibt die Business Profile APIs nur auf Antrag frei (Formular „Business Profile API

access request"); bis dahin liegt das Kontingent bei null und jeder Aufruf scheitert.

1. Einen OAuth-Client (Webanwendung) anlegen, als Rückweg-Adresse

https://<Ihre Adresse>/api/v1/social/public/oauth/callback eintragen und das Recht https://www.googleapis.com/auth/business.manage im Zustimmungs-Bildschirm aufnehmen.

1. In den Integrationen die Vorlage Google-Unternehmensprofil wählen und

client_id sowie client_secret des OAuth-Clients eintragen.

Wie bei YouTube holt Verbinden ein dauerhaftes Erneuerungs-Token; die Verbindung läuft nicht ab.

Einrichtung prüfen

Unter Einstellungen → Social-Verbindungen steht an jedem verbundenen Zugang, was der Instanz für ein Netzwerk noch fehlt — als Hinweis, nicht als Sperre: veröffentlicht wird weiter, was ohne die Voraussetzung geht. Derselbe Hinweis erscheint im Beitrag am Ziel (Zustand Warnung).

Die Einrichtung unter den Verbindungen sehen Sie mit dem Recht platform.settings.manage; dieselben Werte stehen auch unter Einstellungen → System (social.linkedin.api_version, social.tiktok.domain_verified).

Einstellungen & Rechte

• Modul module.social für die Verbindungen; die Beiträge selbst hängen an module.content.
• social.post.manage — Beiträge planen und veröffentlichen. In der Rolle Vertrieb

vorbelegt.

• social.connection.manage — Firmenkonten verbinden und trennen. Bewusst ein eigenes Recht:

Beiträge schreiben ist Tagesgeschäft, ein Firmenkonto anzubinden ist es nicht.

• social.brand.all — markenübergreifende Sicht auf Verbindungen und Zahlen.
• Ohne Netzwerk-Adapter keine Veröffentlichung. Die Planung funktioniert, die Ausspielung braucht

eine eingerichtete Verbindung.

• Status pflegen Sie unter Marketing-Einstellungen mit

marketing.config.manage.

FAQ & Fehlerbilder

Der Beitrag bleibt geplant und wird nicht veröffentlicht. Entweder ist der Zeitpunkt noch nicht erreicht, oder für das Netzwerk ist kein Adapter eingerichtet.

„Instagram-Karussell braucht 2 bis 10 Bilder." Das Format Karussell ist gewählt, der Beitrag hat aber weniger als zwei oder mehr als zehn Bilder. Bilder ergänzen bzw. entfernen oder das Format auf Beitrag im Feed stellen.

Instagram meldet, das Bild sei nicht abrufbar. Instagram holt das Bild bei Ihrer Instanz ab. Ist sie nicht aus dem Internet erreichbar oder steht in MARKETING_BASE_URL eine interne Adresse, scheitert der Abruf. Abhilfe: öffentliche Adresse eintragen oder das Bild an anderer Stelle ablegen und dessen Adresse im Beitrag verwenden.

Der Beitrag wurde doppelt veröffentlicht. Sollte nicht vorkommen: der tägliche Lauf ist idempotent. Prüfen Sie, ob derselbe Inhalt zweimal angelegt wurde.

„Läuft am … ab — bitte neu verbinden." Der Zugang des Netzwerks endet in weniger als sieben Tagen. Verbinden Sie das Konto neu, bevor der Ablauf erreicht ist — danach erscheint kein geplanter Beitrag mehr.

Bei Meta wird in die falsche Seite gepostet. Dann steht unter Konto die falsche Seite. Ein Meta-Zugang umfasst oft mehrere Seiten; die Auswahl entscheidet, welche es ist.

Ich sehe keine Auswertung zum Beitrag. Ohne Kampagnen-Zuordnung gibt es keine Herkunfts-Verbindung — und damit keine Zeile im Marketing-Report.

social.uebersicht · Gilt ab Version 0.5.0