دليل Threads

جدولة منشورات النصوص والصور على Threads باستخدام SosoAPI

جدوِل منشور نص أوصورة لحساب Threads متصل واحد ثم تحقّق من نشره. تستخدم الأمثلة عناصر نائبة ولا تُشغّل من الصفحة. روجع عقد النشر في 20 أكتوبر 2026.

اقرأ بصيغة Markdown

راجعه فريق SosoAPI · 2026-10-20

1. الربط وفحص الوجهة

اربط حساب Threads المقصود في SosoAPI. تتطلب موافقة المزوّد threads_content_publish للنشر. ويحتاج مستدعي SosoAPI مساحة عمل مسموحة ووصول editor وإمكانية agent:publish للجدولة.

تحقّق من أن SosoAPI أعاد حساب Threads المقصود. افحص أهلية المسودة كاملةً بمحتواها ووقتها قبل الجدولة. للردود والمواقع والمشاركة المتقاطعة متطلبات أذونات وأهلية إضافية.

فحص مصفوفة إمكانات المنصات

2. جدولة منشور نصي تمت مراجعته

استخدم مساعد الخادم بمرجع API واستبدل العناصر النائبة واختر وقت ISO-8601 مستقبلياً مع إزاحة. ينشئ الطلب جدولاً حقيقياً؛ أكّد الحساب والصياغة والوقت قبل إرساله.

لمنشور TEXT، أبقِ media فارغة. احتفظ بمفتاح منع تكرار واحد للطلب واحفظ post.id المُعاد لفحص حالته. استخدم provider_payload لـ Threads مع هذا الحساب.

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 حتى يجهز. استخدم معرّف الأصل المسجّل ورابطه الأساسي في المنشور.

لإنشاء عادي، اضبط 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 الأصلي وافحص نتيجته النهائية للنشر. المعرّف أوالجدول المقبول أوحاوية وسائط Threads يثبت وجود الطلب؛ ولا يؤكد النشر. اعرض معرّف منشور المزوّد أورابطه الدائم عند توفره.

إذا ظل Threads يعالج أومُنيت بفقدان الاستجابة، واصل فحص المنشور نفسه. لا ترسل إنشاء جديداً بمفتاح آخر. إعادة ربط الحساب لا تثبت نجاح كتابة سابقة.

بعد بدء Threads نشر منشور نصي، قد يتعذّر التراجع عن خطوة المزوّد. اتّبع الإجراءات المتاحة التي يعيدها SosoAPI بدلاً من إعادة الإرسال. تختلف مدة المعالجة.