Instagram: posztolási szabályok és beállítások
Mit fogad el a Instagram csatorna a Postyban: média, korlátok, kötelező mezők, és a settings objektum mezői az API-hoz.
Eckdaten
instagram, instagram-standaloneBeitragstypen
Derselbe Kanal akzeptiert mehrere Beitragstypen. Jeder verlangt etwas anderes. Die Tabelle zeigt, was du wofür brauchst.
| Typ | Medien | Hinweis |
|---|---|---|
| Feed, ein Bild | 1 Bild, Pflicht | post_type: post. |
| Feed, Karussell | 2 oder mehr Bilder | Mehrere Bilder werden automatisch zum wischbaren Karussell. |
| Reels | 1 Video | post_type: post, mit Video. Instagram entscheidet, ob es als Reel erscheint. |
| Story | 1 Bild oder Video | post_type: story. Nur ein Element ist erlaubt. |
Regeln
- Es gibt zwei Arten der Verbindung. „instagram“ ist das mit einer Facebook-Seite verknüpfte Geschäftskonto, „instagram-standalone“ das direkt verbundene Konto. Die Einstellungsfelder sind dieselben.
- Eine Story geht nur raus, wenn das Konto auf der Plattform dazu berechtigt ist.
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 |
|---|---|---|---|
| post_type | "post" | "story" | ja | Feed-Beitrag oder Story. |
| collaborators | Array, je Element { label: string } | nein | Nutzernamen der Kollaborateure. |
| audio | Objekt | nein | Die ID des Musiktitels, optional mit Interpret, Titel sowie Audio- und Videolautstärke (zwischen 0 und 100). |
| is_trial_reel | boolean | nein | Veröffentlicht ihn als Test-Reel. |
| graduation_strategy | "MANUAL" | "SS_PERFORMANCE" | nein | Beim Test-Reel: du schiebst ihn von Hand in den Haupt-Feed, oder er wandert automatisch anhand der Performance. |
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.
post_type
| Wert | Bedeutung |
|---|---|
| post | Feed-Beitrag. |
| story | Story, für 24 Stunden. |
graduation_strategy
| Wert | Bedeutung |
|---|---|
| MANUAL | Du hebst das Test-Reel in den Haupt-Feed. |
| SS_PERFORMANCE | Instagram hebt es, wenn es gut läuft. |
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": [ /* az alábbi elem */ ]
}Feed-Beitrag mit einem Bild
{
"integration": { "id": "<instagram-csatorna>" },
"value": [{
"content": "<p>Új a kínálatunkban.</p>",
"image": [{ "id": "<media>", "path": "https://uploads.posty.hu/kep.jpg" }]
}],
"settings": { "__type": "instagram", "post_type": "post" }
}Karussell, mit drei Bildern
{
"integration": { "id": "<instagram-csatorna>" },
"value": [{
"content": "<p>Lapozz végig a részleteken.</p>",
"image": [
{ "id": "<media-1>", "path": "https://uploads.posty.hu/1.jpg" },
{ "id": "<media-2>", "path": "https://uploads.posty.hu/2.jpg" },
{ "id": "<media-3>", "path": "https://uploads.posty.hu/3.jpg" }
]
}],
"settings": { "__type": "instagram", "post_type": "post" }
}Story
Ein einzelnes Bild oder Video. Bei mehreren Elementen lehnt die Plattform ab.
{
"integration": { "id": "<instagram-csatorna>" },
"value": [{
"content": "<p>Ma nyitunk.</p>",
"image": [{ "id": "<media>", "path": "https://uploads.posty.hu/story.jpg" }]
}],
"settings": { "__type": "instagram", "post_type": "story" }
}Mit Collaborator-Konto
Die Einträge in collaborators erwarten Nutzernamen, ohne @-Zeichen.
{
"integration": { "id": "<instagram-csatorna>" },
"value": [{
"content": "<p>Közös munka.</p>",
"image": [{ "id": "<media>", "path": "https://uploads.posty.hu/kep.jpg" }]
}],
"settings": {
"__type": "instagram",
"post_type": "post",
"collaborators": [{ "label": "masik_fiok" }]
}
}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.