댓글 조회와 답글
답할 댓글을 찾아 답글을 달고, 댓글을 숨기거나 지우세요.
답할 댓글 찾기
curl --get "https://www.posteady.com/api/v1/comments" \
--data "status=unanswered" --data "days=7" \
--header "Authorization: Bearer $POSTEADY_API_KEY"| 인자 | 의미 |
|---|---|
platform | threads·instagram·x·youtube·tiktok·linkedin·facebook, 생략 시 전체 |
accountId | 계정 UUID로 필터 |
status | all(기본)·unanswered·replied·resolved |
days | 7·30(기본)·90, 0이면 동기화된 모든 댓글 |
cursor | 이전 응답의 nextCursor |
필터와 상태는 Posteady 댓글 인박스와 같습니다. replied는 그 댓글 아래 마지막 답글이 계정 것이라는 뜻입니다. resolved는 Posteady에서 처리 완료로 표시한 댓글입니다. 그 밖의 다른 사람 댓글은 unanswered입니다. 계정이 단 댓글은 fromAccount: true이고 상태가 없습니다.
답글에는 각 댓글의 commentId·accountId·platform을 씁니다. postId는 게시물의 플랫폼 ID이고, parentCommentId는 이 댓글이 답한 댓글입니다.
이 API는 Posteady에 이미 동기화된 댓글을 읽습니다. 호출할 때 플랫폼에서 새 댓글을 가져오지 않습니다.
hasMore가 true이면 nextCursor를 같은 필터와 함께 cursor로 보내세요. failedPlatforms가 있으면 그 플랫폼의 댓글을 읽지 못한 것입니다. 이때는 그 플랫폼 댓글을 건너뛰지 않도록 nextCursor가 null입니다. 잠시 뒤 같은 요청을 다시 보내세요.
댓글에 답글 달기
목록의 commentId·platform·accountId를 보내세요. LinkedIn은 같은 commentId가 여러 게시물에 있을 수 있으므로 postId도 함께 보내세요.
curl --request POST "https://www.posteady.com/api/v1/comments/18000000000000101/replies" \
--header "Authorization: Bearer $POSTEADY_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"platform": "instagram",
"accountId": "11111111-1111-4111-8111-111111111111",
"text": "네, 지금 재고가 있어요."
}'답글은 댓글을 받은 계정 이름으로 달립니다. 텍스트만 됩니다. 응답에는 새 답글의 replyId와 답글이 실제로 달린 parentCommentId가 있습니다. Posteady는 단 답글을 댓글 목록에도 바로 넣으므로, 다음 동기화 전에도 그 스레드가 replied로 보입니다.
| 플랫폼 | 답글 규칙 |
|---|---|
| Instagram·YouTube·Facebook | 답글은 한 단계까지만 둡니다. 답글에 단 답글은 스레드의 최상위 댓글에 달리고 note로 알려 줍니다 |
| 페이지 이름으로 답글을 답니다. 연결한 계정에 댓글 관리 권한과, 댓글을 관리할 수 있는 페이지 역할이 있어야 합니다 | |
| TikTok | TikTok for Business로 연결한 계정이어야 합니다. TikTok이 새 답글 ID를 주지 않으면 replyId가 null이고, 답글은 다음 동기화 뒤 목록에 나타납니다 |
| X | 한글·중국어·일본어 글자와 이모지는 2자로 셉니다. Posteady가 답글을 목록에 저장하지 못하면 note로 알려 줍니다 |
댓글 목록의 postId를 함께 보내세요 |
| 플랫폼 | 본문 최대 길이 |
|---|---|
| 2,200자 | |
| YouTube | 10,000자 |
| Threads | 500자 |
| X | 280자 |
| 1,250자 | |
| 8,000자 | |
| TikTok | TikTok이 정한 한도 |
결과와 오류
답글 요청에는 requestId가 없습니다. 같은 요청을 다시 보내면 답글이 두 번 달릴 수 있으니, 결과를 확인한 뒤 다시 보내세요.
| 응답 | 다음 할 일 |
|---|---|
422 VALIDATION_ERROR | 메시지를 읽으세요. 본문이 너무 길거나, X가 같은 내용을 거절했거나, LinkedIn 답글에 postId가 필요할 수 있습니다 |
403 INSUFFICIENT_PERMISSION | 워크스페이스 권한을 확인하세요. Facebook은 그 페이지에서 계정의 역할도 확인하세요 |
404 COMMENT_NOT_FOUND | 댓글 목록의 ID를 쓰세요. 댓글이 삭제되었을 수 있습니다 |
409 ACCOUNT_TOKEN_EXPIRED | Posteady에서 계정을 다시 연결하세요 |
429 RATE_LIMITED | 플랫폼 요청 한도에 걸렸습니다. 기다렸다가 다시 보내세요 |
502 PLATFORM_ERROR | 답글이 이미 달렸을 수 있습니다. 다시 보내기 전에 플랫폼에서 그 댓글을 확인하세요 |
503 SERVICE_UNAVAILABLE | 아무것도 달리지 않았습니다. 잠시 뒤 다시 보내세요 |
요청 시간이 초과되면 다시 보내기 전에 플랫폼에서 그 댓글을 확인하세요. 댓글을 읽으려면 API 키를 만든 멤버에게 '댓글 조회' 권한이, 답글을 달려면 '댓글 작성' 권한이 있어야 합니다.
댓글 숨기기와 삭제
curl --request PATCH "https://www.posteady.com/api/v1/comments/18000000000000101" \
--header "Authorization: Bearer $POSTEADY_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"platform": "instagram",
"accountId": "11111111-1111-4111-8111-111111111111",
"hidden": true
}'다시 보이게 하려면 "hidden": false를 보내세요. 댓글을 지우려면 같은 값을 쿼리 인자로 보냅니다.
curl --request DELETE "https://www.posteady.com/api/v1/comments/18000000000000101?platform=instagram&accountId=11111111-1111-4111-8111-111111111111" \
--header "Authorization: Bearer $POSTEADY_API_KEY"규칙은 Posteady 댓글 인박스와 같습니다. LinkedIn은 postId도 함께 보내세요.
| 작업 | 규칙 |
|---|---|
| 숨기기·다시 보이기 | 다른 사람이 단 댓글만 됩니다. LinkedIn은 숨기기를 지원하지 않습니다. YouTube는 최상위 댓글만 숨길 수 있고, 숨기면 검토 보류가 됩니다. X는 계정이 시작한 대화의 답글만 숨길 수 있습니다 |
| 삭제 | 우리 계정이 단 댓글(fromAccount: true)은 모든 플랫폼에서, 그 댓글을 쓴 계정으로 지웁니다. 다른 사람이 단 댓글은 Instagram·Facebook에서만 지울 수 있고, 다른 플랫폼에서는 숨기세요. Instagram·Facebook·LinkedIn은 그 댓글의 답글도 함께 지웁니다 |
삭제는 되돌릴 수 없습니다. 숨기거나 지울 수 없는 댓글이면 이유와 함께 422 VALIDATION_ERROR를 돌려줍니다. Posteady는 댓글 목록도 바로 고치고, 고치지 못하면 note로 알려 줍니다. 숨기려면 '댓글 편집' 권한이, 지우려면 '댓글 삭제' 권한이 있어야 합니다.
댓글 조회 레퍼런스 · 답글 레퍼런스 · 숨기기 레퍼런스 · 삭제 레퍼런스 · 오류 가이드