문서
포샌디로 AI가 Facebook 페이지에 올리는 방법이에요. 피드, 링크, 릴스, 스토리와 API로 안 되는 것을 정리했어요.
연결 방법
Facebook으로 로그인하면 내가 관리하는 페이지 목록이 나와요. 그중 하나를 골라요. 포샌디는 개인 프로필에는 올리지 않고, 페이지에만 올려요.
한눈에
| 항목 | 종류 | 값 |
|---|---|---|
| 글자 수 | 텍스트 | 63,206 |
| 이미지 | 미디어 | 글 하나에 10장까지. 더 넣으면 앞의 10장만 올라가고 경고가 붙어요 |
| 캐러셀 | 미디어 | 2~10개 |
| 영상 | 미디어 | 글 하나에 1개 |
| 텍스트만 | 미디어 | 가능 |
| 24시간 발행 | 한도 | 100 |
| 24시간 삭제 | 한도 | 50 |
| 상태 | 상태 | live |
이 값은 서버가 검사할 때 쓰는 파일에서 그대로 가져왔어요. 글자만 있는 글도 올라가요. 링크 글(options.facebook.link)에는 미리보기 카드가 붙고, 미디어와 같이 넣을 수 없어요.
피드, 릴스, 스토리
options.facebook.contentType으로 정해요.
- 릴스: 영상 1개짜리 글의 기본값이에요. 길이는 3~90초예요.
- 스토리: 이미지나 영상 딱 1개. 글자가 하나라도 있으면 거절돼요. 스토리는 본문 없이 올리고, 하고 싶은 말은 피드 글에 써요.
- 피드: 그 밖의 글이에요.
첫 글 올리기
글자만 넣거나, 미디어 id를 같이 넣어 publish를 불러요. 그 밖에 꼭 넣어야 하는 값은 없어요.
curl -X POST https://api.posendy.com/v1/posts \
-H "Authorization: Bearer $POSENDY_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Read the full story",
"accountIds": ["conn_..."],
"options": { "facebook": { "link": "https://posendy.com" } }
}'
options.facebook 값
| 이름 | 타입 | 설명 |
|---|---|---|
contentType | feed / story / reel | 글 종류예요. 안 넣으면 영상 1개는 reel, 나머지는 feed예요. 스토리에 글자를 넣으면 거절돼요. 본문 없이 스토리를 올리고, 글은 피드 글에 넣어요. 스토리는 이미지나 영상 딱 1개만 받고 첫 댓글도 안 돼요. |
link | string | 미리보기 카드가 붙는 링크 글을 만들어요. 미디어와 같이 못 써요. facebook.com 공유 링크는 Facebook이 받지 않아요. |
title | string | 릴스 제목이에요. 캡션과는 따로예요. |
scheduledPublishTime | string | 피드 글을 나중에 올릴 시각(ISO 8601)이에요. 지금부터 10분 뒤에서 28일 사이로 넣어요. 피드 글만 되고 릴스, 스토리는 안 돼요. firstComment와 같이 못 써요(예약 글은 아직 안 올라가서 댓글을 달 곳이 없어요). Facebook 자체 예약이에요. 여러 채널을 같이 예약하려면 글의 scheduledAt을 써요. (API 전용, 대시보드에는 없음) |
firstComment | string | 올린 직후 포샌디가 다는 첫 댓글이에요. 스토리와 예약 글에는 안 돼요. 댓글이 실패해도 글은 올라가고 경고가 붙어요. |
feedTargeting | object | 텍스트 글이나 링크 글을 더 보여주고 싶은 대상이에요. 제한이 아니라 희망 사항이라, Facebook이 이 사람들에게 더 보여줄 수는 있어도 다른 사람도 볼 수 있고 효과는 보장되지 않아요. 사진 글과 릴스에는 Facebook이 이 값을 남기지 않아서 거절해요. 올린 뒤에는 바꿀 수 없어요. (API 전용, 대시보드에는 없음) |
content | string | 이 채널에만 보낼 본문이에요. 넣으면 공통 본문 대신 이 값이 나가고, 글자 수와 미디어 검사도 이 값으로 해요. 안 넣으면 공통 본문을 써요. |
이 표는 서버가 검사에 쓰는 스키마에서 그대로 만들었어요. GET /v1/platforms도 같은 내용을 돌려줘요. scheduledPublishTime은 Facebook 자체 예약이라 피드 글만 돼요. 여러 채널로 가는 글이면 글 단위 scheduledAt을 써요.
안 되는 것
- 개인 프로필에 올리기 (페이지만 돼요)
- 올린 글 수정
- 포샌디로 올리지 않은 글 삭제
다른 사람이 내 글에 단 댓글은 list_replies로 받아요.
자주 묻는 것
개인 프로필에 올릴 수 있나요?
안 돼요. Meta API는 페이지에만 올릴 수 있게 열어 뒀고, 포샌디도 페이지를 연결해요. 개인 프로필에는 같은 권한이 없어요.
스토리가 왜 거절됐나요?
셋 중 하나예요: 글자가 들어 있었거나, 미디어가 2개 이상이었거나, 첫 댓글이 있었어요. Facebook 스토리는 이미지나 영상 딱 1개만 받아요.
Facebook 글을 예약할 수 있나요?
두 가지 방법이 있어요.
| 방법 | 누가 예약하나 | 범위 |
|---|---|---|
글의 scheduledAt | 포샌디 | 같은 요청에 넣은 다른 채널도 같이 예약돼요 |
options.facebook.scheduledPublishTime | 피드 글만, 10분 뒤부터 28일까지 |
