문서

Facebook

포샌디로 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 값

이름타입설명
contentTypefeed / story / reel글 종류예요. 안 넣으면 영상 1개는 reel, 나머지는 feed예요. 스토리에 글자를 넣으면 거절돼요. 본문 없이 스토리를 올리고, 글은 피드 글에 넣어요. 스토리는 이미지나 영상 딱 1개만 받고 첫 댓글도 안 돼요.
linkstring미리보기 카드가 붙는 링크 글을 만들어요. 미디어와 같이 못 써요. facebook.com 공유 링크는 Facebook이 받지 않아요.
titlestring릴스 제목이에요. 캡션과는 따로예요.
scheduledPublishTimestring피드 글을 나중에 올릴 시각(ISO 8601)이에요. 지금부터 10분 뒤에서 28일 사이로 넣어요. 피드 글만 되고 릴스, 스토리는 안 돼요. firstComment와 같이 못 써요(예약 글은 아직 안 올라가서 댓글을 달 곳이 없어요). Facebook 자체 예약이에요. 여러 채널을 같이 예약하려면 글의 scheduledAt을 써요. (API 전용, 대시보드에는 없음)
firstCommentstring올린 직후 포샌디가 다는 첫 댓글이에요. 스토리와 예약 글에는 안 돼요. 댓글이 실패해도 글은 올라가고 경고가 붙어요.
feedTargetingobject텍스트 글이나 링크 글을 더 보여주고 싶은 대상이에요. 제한이 아니라 희망 사항이라, Facebook이 이 사람들에게 더 보여줄 수는 있어도 다른 사람도 볼 수 있고 효과는 보장되지 않아요. 사진 글과 릴스에는 Facebook이 이 값을 남기지 않아서 거절해요. 올린 뒤에는 바꿀 수 없어요. (API 전용, 대시보드에는 없음)
contentstring이 채널에만 보낼 본문이에요. 넣으면 공통 본문 대신 이 값이 나가고, 글자 수와 미디어 검사도 이 값으로 해요. 안 넣으면 공통 본문을 써요.

이 표는 서버가 검사에 쓰는 스키마에서 그대로 만들었어요. GET /v1/platforms도 같은 내용을 돌려줘요. scheduledPublishTime은 Facebook 자체 예약이라 피드 글만 돼요. 여러 채널로 가는 글이면 글 단위 scheduledAt을 써요.

안 되는 것

  • 개인 프로필에 올리기 (페이지만 돼요)
  • 올린 글 수정
  • 포샌디로 올리지 않은 글 삭제

다른 사람이 내 글에 단 댓글은 list_replies로 받아요.

자주 묻는 것

개인 프로필에 올릴 수 있나요?

안 돼요. Meta API는 페이지에만 올릴 수 있게 열어 뒀고, 포샌디도 페이지를 연결해요. 개인 프로필에는 같은 권한이 없어요.

스토리가 왜 거절됐나요?

셋 중 하나예요: 글자가 들어 있었거나, 미디어가 2개 이상이었거나, 첫 댓글이 있었어요. Facebook 스토리는 이미지나 영상 딱 1개만 받아요.

Facebook 글을 예약할 수 있나요?

두 가지 방법이 있어요.

방법누가 예약하나범위
글의 scheduledAt포샌디같은 요청에 넣은 다른 채널도 같이 예약돼요
options.facebook.scheduledPublishTimeFacebook피드 글만, 10분 뒤부터 28일까지