Facebook: posztolási szabályok és beállítások
Mit fogad el a Facebook csatorna a Postyban: média, korlátok, kötelező mezők, és a settings objektum mezői az API-hoz.
Alapadatok
facebookBejegyzéstípusok
Ugyanaz a csatorna többféle alakú bejegyzést fogad el, és mindegyik mást követel meg. A táblázatból kiderül, melyikhez mi kell.
| Típus | Média | Megjegyzés |
|---|---|---|
| Szöveges | nincs | Nincs külön megjegyzés. |
| Háttérszínes szöveges | nincs | Csak média nélkül, körülbelül 130 karakterig, és csak oldalon. |
| Képes | 1 vagy több kép | Nincs külön megjegyzés. |
| Videós | 1 videó | Nincs külön megjegyzés. |
| Story | 1 kép vagy videó | post_type: story. |
Szabályok
- Csak Facebook-oldalra lehet posztolni, személyes idővonalra nem. Ez a platform szabálya.
- A háttérszínes szöveges bejegyzés csak médiamentes, körülbelül 130 karakternél rövidebb szövegnél működik.
Beállításmezők
Ezek a mezők a bejegyzés settings objektumába kerülnek, a __type mező mellé. A felületen ugyanezeket a csatorna lenyíló beállításszakaszában töltöd ki.
| Mező | Típus | Kötelező | Mit csinál |
|---|---|---|---|
| post_type | "post" | "story" | nem | Hírfolyam-bejegyzés vagy story. |
| url | string (URL) | nem | A bejegyzéshez csatolt link. |
| text_format_preset_id | string | nem | A háttérsablon azonosítója szöveges bejegyzéshez. A választható sablonokat a szerkesztő sorolja fel. |
Választható értékek
A felsorolt mezők csak ezeket az értékeket fogadják el. Bármilyen más értékre 400-as hibát kapsz, a válasz pedig megnevezi a mezőt.
post_type
| Érték | Mit jelent |
|---|---|
| post | Hírfolyam-bejegyzés az oldalon. |
| story | Story, 24 órára. |
Példák
Minden példa egy elem a POST /public/v1/posts kérés posts tömbjében. A körülötte lévő boríték minden esetben ez:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}Bejegyzés képpel
{
"integration": { "id": "<facebook-csatorna>" },
"value": [{
"content": "<p>Hétvégén is nyitva vagyunk.</p>",
"image": [{ "id": "<media>", "path": "https://uploads.posty.hu/kep.jpg" }]
}],
"settings": { "__type": "facebook", "post_type": "post" }
}Háttérszínes szöveges bejegyzés
Média nélkül, rövid szöveggel. A sablonazonosítót a szerkesztő listája adja.
{
"integration": { "id": "<facebook-csatorna>" },
"value": [{ "content": "<p>Ma 20% kedvezmény.</p>", "image": [] }],
"settings": {
"__type": "facebook",
"post_type": "post",
"text_format_preset_id": "106018623298955"
}
}Bejegyzés linkkel
{
"integration": { "id": "<facebook-csatorna>" },
"value": [{ "content": "<p>Új bejegyzés a blogon.</p>", "image": [] }],
"settings": {
"__type": "facebook",
"post_type": "post",
"url": "https://pelda.hu/blog/uj-bejegyzes"
}
}A csatorna azonosítóját a csatornalista adja, a képek és videók path értékét pedig a médiafeltöltés. A bekötött fiókra érvényes, pontos sémát a beállítássémát visszaadó végpont adja vissza. Parancssorból ugyanez a --settings kapcsolóval megy, lásd a CLI-példákat.