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.
Basics
facebookPost types
The same channel accepts more than one kind of post, and each kind has different requirements. The table shows what you need for each.
| Type | Media | Notes |
|---|---|---|
| Text | none | No extra notes. |
| Text with background color | none | Only without media, up to about 130 characters, and only on a Page. |
| Image | 1 or more images | No extra notes. |
| Video | 1 video | No extra notes. |
| Story | 1 image or video | post_type: story. |
Rules
- You can only post to a Facebook Page, not to a personal timeline. That is a platform rule.
- A text post with a background color only works when there is no media and the text is shorter than about 130 characters.
Settings fields
These fields go into the post's settings object, alongside the __type field. In the UI, you fill in the same ones in the channel's settings section.
| Field | Type | Required | What it does |
|---|---|---|---|
| post_type | "post" | "story" | no | Feed post or Story. |
| url | string (URL) | no | The link attached to the post. |
| text_format_preset_id | string | no | The background template ID for a text post. The editor lists the templates you can choose from. |
Allowed values
The fields below only accept these values. Any other value returns a 400, and the response names the field.
post_type
| Value | Meaning |
|---|---|
| post | Feed post on the page. |
| story | Story, for 24 hours. |
Examples
Each example is one item in the POST /public/v1/posts request's posts array. The envelope around it is always this:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}Post with an image
{
"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" }
}Text post with background color
No media, short text. The editor's list provides the template ID.
{
"integration": { "id": "<facebook-csatorna>" },
"value": [{ "content": "<p>Ma 20% kedvezmény.</p>", "image": [] }],
"settings": {
"__type": "facebook",
"post_type": "post",
"text_format_preset_id": "106018623298955"
}
}Post with a link
{
"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"
}
}The channel ID comes from the channel list, and the path values for images and videos from media upload. The exact schema for the connected account comes from the settings schema endpoint. From the command line, the same thing is the --settings flag. See the CLI examples.