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.
Základní údaje
instagram, instagram-standaloneTypy příspěvků
Stejný kanál přijímá víc druhů příspěvků. Každý má jiné požadavky. Tabulka ukáže, co k čemu potřebujete.
| Typ | Média | Poznámka |
|---|---|---|
| Feed, jeden obrázek | 1 obrázek, povinné | post_type: post. |
| Feed, karusel | 2 nebo více obrázků | Více obrázků se automaticky stane listovatelným karuselem. |
| Reels | 1 video | post_type: post, s videem. Instagram rozhodne, jestli se zobrazí jako Reel. |
| Story | 1 obrázek nebo video | post_type: story. Povolená je jen jedna položka. |
Pravidla
- Jsou dva druhy propojení. „instagram” je firemní účet napojený na stránku na Facebooku, „instagram-standalone” je účet propojený přímo. Pole nastavení jsou stejná.
- Story vyjde jen tehdy, když to účet na platformě smí publikovat.
Pole nastavení
Tato pole jdou do objektu settings příspěvku, vedle pole __type. V rozhraní je vyplníte v rozbalovací sekci nastavení kanálu.
| Pole | Typ | Povinné | Co dělá |
|---|---|---|---|
| post_type | "post" | "story" | ano | Příspěvek ve feedu, nebo Story. |
| collaborators | pole, u každé položky { label: string } | ne | Uživatelská jména spolupracujících účtů. |
| audio | objekt | ne | Identifikátor hudební stopy, volitelně s interpretem, názvem a hlasitostí zvuku i videa (mezi 0 a 100). |
| is_trial_reel | boolean | ne | Publikuje ho jako zkušební Reel. |
| graduation_strategy | "MANUAL" | "SS_PERFORMANCE" | ne | U zkušebního Reelu: do hlavního feedu ho přesunete ručně, nebo se přesune automaticky podle výkonu. |
Povolené hodnoty
Uvedená pole přijímají jen tyto hodnoty. U jakékoli jiné hodnoty dostanete chybu 400 a odpověď pojmenuje pole.
post_type
| Hodnota | Co znamená |
|---|---|
| post | Příspěvek ve feedu. |
| story | Story, na 24 hodin. |
graduation_strategy
| Hodnota | Co znamená |
|---|---|
| MANUAL | Zkušební Reel přesunete do hlavního feedu. |
| SS_PERFORMANCE | Instagram ho přesune, když má dobré výsledky. |
Příklady
Každý příklad je jedna položka v poli posts požadavku POST /public/v1/posts. Obálka kolem něj je vždy tato:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}Příspěvek ve feedu s jedním obrázkem
{
"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" }
}Karusel se třemi obrázky
{
"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
Jeden obrázek nebo video. Když je položek víc, platforma to odmítne.
{
"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" }
}Se spolupracujícím účtem
Položky collaborators očekávají uživatelská jména, bez znaménka @.
{
"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" }]
}
}Identifikátor kanálu získáte ze seznamu kanálů. Hodnoty path u obrázků a videí z nahrání médií. Přesné schéma platné pro propojený účet vrací endpoint se schématem nastavení. Z příkazové řádky to samé uděláte přepínačem --settings, viz příklady CLI.