Jadwalkan postingan teks dan gambar Threads dengan SosoAPI

1. Hubungkan dan periksa tujuan

Hubungkan akun Threads yang dituju di SosoAPI. Persetujuan penyedia memerlukan threads_content_publish untuk publikasi. Pemanggil SosoAPI juga memerlukan ruang kerja yang diizinkan, akses editor, dan kemampuan agent:publish untuk penjadwalan.

Periksa bahwa SosoAPI mengembalikan akun Threads yang ingin digunakan. Jalankan kelayakan draf lengkap dengan konten dan waktu sebelum menjadwalkan. Fitur seperti balasan, lokasi, dan berbagi silang memiliki persyaratan izin serta kelayakan tambahan.

• Periksa matriks kemampuan platform

2. Jadwalkan postingan teks yang ditinjau

Gunakan helper server dari referensi API, ganti placeholder, dan pilih waktu ISO-8601 mendatang dengan offset. Menjalankan permintaan ini membuat jadwal nyata, jadi konfirmasikan akun, susunan kata, dan waktu sebelum mengirim.

Untuk postingan TEXT, biarkan media kosong. Pertahankan satu kunci idempotensi untuk permintaan ini dan simpan post.id yang dikembalikan agar dapat memeriksa statusnya. Gunakan provider_payload Threads dengan akun ini.

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>"
});

• Referensi API publikasi

3. Gunakan gambar terdaftar yang siap

Untuk gambar lokal, gunakan sosoapi_upload_asset. Untuk URL gambar publik, panggil sosoapi_import_asset_url dan periksa sosoapi_get_asset_import_status sampai siap. Gunakan ID aset terdaftar dan URL kanonis dalam postingan.

Untuk permintaan create biasa, atur post_type ke IMAGE dan tambahkan gambar siap ke media. Fragmen di bawah menggantikan kedua kolom tersebut dalam contoh teks. Pertahankan caption, akun, dan waktu, serta gunakan kunci stabil baru untuk postingan baru yang dikonfirmasi ini.

• Ganti asset_id dengan bilangan bulat positif sebenarnya, bukan string angka.
• Jangan jadwalkan dengan URL sumber, URL pratinjau sementara, atau impor yang belum selesai.
• Gambar pustaka yang sama hanya boleh digunakan kembali jika hak, ruang kerja, dan konten terpilih sesuai.

{
  "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. Verifikasi publikasi dan hindari pengiriman duplikat

Baca Scheduled Post asli dan periksa hasil akhir publikasinya. ID, jadwal diterima, atau container media Threads berarti permintaan ada; tidak mengonfirmasi publikasi. Tampilkan ID postingan atau permalink penyedia jika tersedia.

Jika Threads masih memproses, atau respons hilang, terus periksa postingan yang sama. Jangan kirim permintaan create lain dengan kunci berbeda. Menghubungkan ulang akun tidak membuktikan apakah penulisan sebelumnya berhasil.

Setelah Threads mulai memublikasikan postingan teks, langkah penyedia mungkin tidak lagi dapat diurungkan. Ikuti tindakan tersedia yang dikembalikan SosoAPI alih-alih mengirim ulang postingan. Waktu pemrosesan dapat berbeda.

• Tinjau dengan Claude Code atau Codex
• Referensi API publikasi