SosoAPIでThreadsのテキスト・画像投稿を予約

1. 接続して投稿先を確認する

SosoAPIで目的のThreadsアカウントを接続します。公開にはプロバイダーのthreads_content_publish同意が必要です。予約するSosoAPI呼び出し元にも、許可されたワークスペース、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、未完了インポートで予約しないでください。
• ライブラリ画像は、権利、ワークスペース、選択内容が適切な場合のみ再利用できます。

{
  "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の最終publish結果を確認します。ID、予約受理、Threadsコンテナは存在の証明で、公開確認ではありません。プロバイダーIDやリンクがあれば表示します。

Threadsが処理中、または応答を失った場合は同じ投稿を確認し続けます。別キーで新規作成を送らないでください。再接続しても以前の書き込みの成否はわかりません。

Threadsが公開を始めると取り消せない場合があります。再送せずSosoAPIの返した操作に従ってください。処理時間は変動します。

• Claude Code・Codexで確認
• 投稿APIリファレンス