채널
에이전트가 업리카로 Facebook 페이지에 올리는 방법. 피드·링크·릴스·스토리와 API 가 못 하는 것.
한눈에
| 이름 | 타입 | 설명 |
|---|---|---|
characters | text | 63,206 |
images | media | up to 10 per post; more than that and the first 10 go out with a warning |
carousel | media | 2-10 items |
video | media | 1 per post |
text alone | media | allowed |
posts / 24h | limit | 100 |
deletes / 24h | limit | 50 |
status | state | live |
이 숫자는 서버가 검증에 쓰는 파일에서 그대로 옵니다. 글만으로도 올라갑니다. 링크 글(options.facebook.link)은 미리보기 카드가 붙고 미디어와 같이 못 갑니다.
피드, 릴스, 스토리?
options.facebook.contentType 이 고릅니다. 영상 하나는 기본이 릴스입니다(3~90초). 스토리는 이미지나 영상 정확히 하나이고 글자가 있으면 거절됩니다. 스토리는 본문 없이 올리고 글은 피드에 쓰세요.
첫 글은 어떻게 올리나요?
글만으로, 또는 미디어 id 와 함께 publish 를 부릅니다. 그 밖에 필수는 없습니다.
curl -X POST https://api.uplika.com/v1/posts \
-H "Authorization: Bearer $UPLIKA_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Read the full story",
"accountIds": ["conn_..."],
"options": { "facebook": { "link": "https://uplika.com" } }
}'options.facebook 이 받는 것
| 이름 | 타입 | 설명 |
|---|---|---|
contentType | feed | story | reel | What kind of post. Defaults to reel for a single video and feed otherwise. A Facebook story is rejected if you send any text: publish the story with no content, and put the words in a feed post instead. A story also takes exactly one image or video and no first comment. |
link | string | Makes a link post with a preview card. Cannot be combined with media. |
title | string | Reel title, separate from the caption. |
scheduledPublishTime | string | ISO 8601 time to publish a feed post later, 10 minutes to 28 days from now. Feed posts only, not reels or stories. Cannot be combined with firstComment (a scheduled post is not live yet, so nothing to comment on). This is Facebook's own scheduling; for scheduling across channels use scheduledAt on the post. (API only; the dashboard does not draw it.) |
firstComment | string | A comment we post right after publishing. Not on stories, and not on scheduled posts. If it fails the post still goes up, with a warning. |
content | string | Text for this channel only. When set it replaces the shared content for this channel, and the length and media checks use it. Leave it out to use the shared content. |
서버가 검증에 쓰는 스키마에서 그대로 생성했습니다. GET /v1/platforms 도 같은 것을 줍니다. scheduledPublishTime 은 페이스북 자체 예약이고 피드 글만 됩니다. 여러 채널로 가는 글이면 글 단위 scheduledAt 을 쓰세요.
안 되는 것은?
개인 프로필(페이지만), 올라간 글 수정, 이 앱으로 올리지 않은 글의 삭제. 남이 내 글에 단 댓글은 list_replies 로 옵니다.
자주 묻는 것
개인 프로필에 올릴 수 있나요?
아니요. Meta API 는 페이지에만 올리고 업리카도 그것을 연결합니다. 프로필에는 같은 권한이 없습니다.
스토리가 왜 거절됐나요?
글자가 있었거나, 미디어가 둘 이상이었거나, 첫 댓글이 있었기 때문입니다. 페이스북 스토리는 이미지나 영상 정확히 하나뿐입니다.
페이스북 글을 예약할 수 있나요?
두 가지로요. 글의 scheduledAt 은 업리카 예약이고 같은 호출의 다른 채널과 같이 됩니다. options.facebook.scheduledPublishTime 은 페이스북 자체 예약이고 피드 글만, 10분 뒤부터 28일까지입니다.