SosoAPI로 Threads 텍스트 및 이미지 게시물 예약

1. 대상 연결 및 확인

SosoAPI에서 원하는 Threads 계정을 연결하세요. 게시용 제공업체 동의에는 threads_content_publish가 필요합니다. SosoAPI 호출자는 예약을 위해 허용된 Workspace, editor 접근, agent:publish 기능도 필요합니다.

SosoAPI가 원하는 Threads 계정을 반환했는지 확인하세요. 예약 전에 콘텐츠와 시간으로 초안 전체 적격성을 검사하세요. 답글, 위치, 교차 공유 같은 기능에는 추가 권한 및 적격성 요구 사항이 있습니다.

• 플랫폼 기능 매트릭스 확인

2. 검토한 텍스트 게시물 예약

API 참조의 서버 헬퍼를 사용하고 자리표시자를 바꾸며 오프셋이 포함된 미래 ISO-8601 시각을 선택하세요. 이 요청을 실행하면 실제 예약을 생성하므로 전송 전에 계정, 문구, 시간을 확인하세요.

TEXT 게시물은 media를 비워 두세요. 요청에 하나의 멱등성 키를 유지하고 반환된 post.id를 저장하여 상태를 확인하세요. 이 계정에는 Threads provider_payload를 사용하세요.

await sosoPost("/studio-api/scheduled-posts/create", {
  "workspace_id": "<workspace-uuid>",
  "social_account_id": "<threads-account-uuid>",
  "caption": "A reviewed update from our team.",
  "hashtags": [],
  "media": [],
  "provider_payload": {
    "platform": "threads",
    "publish_options": {
      "post_type": "TEXT"
    }
  },
  "scheduled_at": "<future-ISO-8601-instant-with-offset>",
  "display_timezone": "Asia/Hong_Kong",
  "idempotency_key": "<stable-key-for-this-one-intent>"
});

• 게시 API 참조

3. 준비된 등록 이미지 사용

로컬 이미지는 sosoapi_upload_asset을 사용하세요. 공개 이미지 URL은 sosoapi_import_asset_url을 호출하고 sosoapi_get_asset_import_status로 준비될 때까지 확인하세요. 등록된 에셋 ID와 정식 URL을 게시물에 사용하세요.

일반 생성 요청에서는 post_type을 IMAGE로 설정하고 준비된 이미지를 media에 추가하세요. 아래 조각은 텍스트 예제의 두 필드를 교체합니다. 캡션, 계정, 시간을 유지하고 새로 확인한 게시물에 새 고정 키를 사용하세요.

• asset_id를 숫자 문자열이 아닌 실제 양의 정수로 교체하세요.
• 소스 URL, 임시 미리보기 URL 또는 미완료 가져오기로 예약하지 마세요.
• 권리, Workspace, 선택 콘텐츠가 적절할 때만 같은 라이브러리 이미지를 재사용할 수 있습니다.

{
  "media": [{
    "kind": "image",
    "asset_id": "<ready-image-asset-id-as-number>",
    "url": "<canonical-image-asset-url>"
  }],
  "provider_payload": {
    "platform": "threads",
    "publish_options": {"post_type": "IMAGE"}
  }
}

4. 게시 검증 및 중복 전송 방지

원래 Scheduled Post를 읽고 최종 게시 결과를 확인하세요. ID, 접수 예약, Threads 미디어 컨테이너는 요청의 존재를 뜻하며 게시 확인이 아닙니다. 가능하면 제공업체 게시물 ID나 고유 링크를 보여주세요.

Threads가 아직 처리 중이거나 응답을 잃었으면 같은 게시물을 계속 확인하세요. 다른 키로 생성 요청을 다시 보내지 마세요. 계정 재연결은 이전 쓰기의 성공 여부를 입증하지 않습니다.

Threads가 텍스트 게시물 게시를 시작하면 제공업체 단계를 되돌리지 못할 수 있습니다. 게시물을 다시 보내지 말고 SosoAPI가 반환한 가능한 작업을 따르세요. 처리 시간은 다를 수 있습니다.

• Claude Code 또는 Codex로 검토
• 게시 API 참조