X (Twitter): Posting-Regeln und Einstellungen
Was der Kanal X (Twitter) in Posty annimmt: Medien, Limits, Pflichtfelder, und die Felder des settings-Objekts für die API.
Eckdaten
xBeitragstypen
Derselbe Kanal akzeptiert mehrere Beitragstypen. Jeder verlangt etwas anderes. Die Tabelle zeigt, was du wofür brauchst.
| Typ | Medien | Hinweis |
|---|---|---|
| Text | keine | Der häufigste. Nur der Text zählt zum Zeichenlimit. |
| Bild | höchstens 4 Bilder | Die vier Bilder erscheinen in einem Beitrag, als Raster. |
| Video | 1 Video | Zu einem Video kannst du kein Bild hinzufügen. |
| Thread | pro Teil eigene | Die weiteren Elemente im value-Array hängen als Antworten an den ersten. |
Regeln
- Den Thread schreibst du als weitere Teile des Beitrags: der erste Teil ist der Beitrag, der Rest hängt als Antworten darunter.
- Das Zeichenlimit hängt vom Kontotyp ab, deshalb zeigt der Editor den für das verbundene Konto freigeschalteten Wert.
- Links schicken wir nicht an X, weil X für jeden Beitrag mit Link eine Gebühr berechnet. Links (https://…, www.…, posty.hu/arak und ähnliche) werden beim Speichern aus dem Beitrag und jedem Teil des Threads entfernt, die API-Antwort nennt sie im Feld notices. Einen Link postest du direkt auf X.
Einstellungsfelder
Diese Felder kommen in das settings-Objekt des Beitrags, neben das Feld __type. In der Oberfläche füllst du dieselben im Einstellungsbereich des Kanals aus.
| Feld | Typ | Pflicht | Was es tut |
|---|---|---|---|
| who_can_reply_post | "everyone" | "following" | "mentionedUsers" | "subscribers" | "verified" | ja | Wer auf den Beitrag antworten darf. Das sind die Werte, die die X API anbietet; eine Option „Follower“ oder „Follower von Followern“ gibt es auf X nicht. |
| community | string | nein | Die vollständige URL einer X-Community, im Format https://x.com/i/communities/<Zahl>. Leer gelassen geht der Beitrag auf deine eigene Timeline. |
| made_with_ai | boolean | nein | Markiert den Beitrag als mit KI erstellt. |
| paid_partnership | boolean | nein | Markiert den Beitrag als bezahlte Partnerschaft. |
| active_thread_finisher | boolean | nein | Thread-Abschluss: bei true veröffentlicht Posty den Text aus thread_finisher als LETZTEN Beitrag des Threads (nach allen Teilen des Threads, oder als Antwort auf den Beitrag, wenn es keinen Thread gibt). Es gilt dasselbe Zeichenlimit, und er bekommt keine Links. Der Kanal merkt sich das: Er bleibt bei den nächsten Beiträgen an, bis du ihn ausschaltest. |
| thread_finisher | string | nein | Der Text des Thread-Abschlusses. Schreib ihn ohne Link, an X schicken wir keine Links. |
Zulässige Werte
Die aufgeführten Felder akzeptieren nur diese Werte. Bei jedem anderen Wert bekommst du einen 400er-Fehler. Die Antwort nennt das Feld.
who_can_reply_post
| Wert | Bedeutung |
|---|---|
| everyone | Jeder kann antworten. |
| following | Nur Leute, denen du folgst. |
| mentionedUsers | Nur die im Beitrag Erwähnten. |
| subscribers | Nur deine Abonnenten. |
| verified | Nur verifizierte Konten. |
Beispiele
Jedes Beispiel ist ein Element im posts-Array der Anfrage POST /public/v1/posts. Der Rahmen darum ist immer dieser:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* das Element unten */ ]
}Textbeitrag
{
"integration": { "id": "<x-kanal>" },
"value": [{ "content": "<p>Heute haben wir eine neue Funktion veröffentlicht.</p>", "image": [] }],
"settings": { "__type": "x", "who_can_reply_post": "everyone" }
}Beitrag mit zwei Bildern
Die path-Werte gibt der Medien-Upload zurück. Eine beliebige URL aus dem Internet funktioniert nicht.
{
"integration": { "id": "<x-kanal>" },
"value": [{
"content": "<p>Zwei Bilder in einem Beitrag.</p>",
"image": [
{ "id": "<media-1>", "path": "https://uploads.posty.hu/eins.png" },
{ "id": "<media-2>", "path": "https://uploads.posty.hu/zwei.png" }
]
}],
"settings": { "__type": "x", "who_can_reply_post": "everyone" }
}Thread, mit zwei Minuten Verzögerung
Das erste Element ist der Beitrag, die übrigen hängen als Antworten darunter. delay ist in Minuten.
{
"integration": { "id": "<x-kanal>" },
"value": [
{ "content": "<p>1/3 Starten wir mit einem kurzen Thread.</p>", "image": [] },
{ "content": "<p>2/3 Der zweite Teil.</p>", "image": [], "delay": 2 },
{ "content": "<p>3/3 Und der Abschluss.</p>", "image": [], "delay": 2 }
],
"settings": { "__type": "x", "who_can_reply_post": "everyone" }
}Beitrag in eine Community
Das Feld community erwartet die vollständige URL der X-Community.
{
"integration": { "id": "<x-kanal>" },
"value": [{ "content": "<p>Eine Frage an die Community.</p>", "image": [] }],
"settings": {
"__type": "x",
"who_can_reply_post": "everyone",
"community": "https://x.com/i/communities/1493446837214187523"
}
}Die Kanalliste liefert die Kanal-ID, der Medien-Upload den path-Wert für Bilder und Videos. Das genaue Schema für das verbundene Konto gibt der Endpunkt für das Einstellungsschema zurück. Von der Kommandozeile aus geht dasselbe mit dem Flag --settings, siehe die CLI-Beispiele.