CLIإدارة المنشورات
العودة إلى Sofia

CLI

إدارة المنشورات

أنشئ المنشورات وجدولها واعرضها وعدّلها واحذفها من الطرفية: مسودات وعدة شبكات ووسائط وتجربة بلا نشر وجسم JSON كامل.

ينتمي كل منشور إلى منشأة، لذلك تمرّر معرّفها بالخيار -e. اعثر عليه بـ sofia establishments:list (انظر الحسابات).

نشر منشور

بدون تاريخ يُنشر المنشور فورًا.

sofia posts:create -e $ESTABLISHMENT_ID -p instagram -c "Tarte tatin du jour"

جدولة منشور

مرّر تاريخًا بصيغة ISO 8601 عبر -s, --date.

sofia posts:create -e $ESTABLISHMENT_ID -p instagram -c "Brunch ce samedi" -s 2026-11-07T09:00:00Z

حفظ مسودة

يحفظ --draft المنشور دون نشره أو جدولته.

sofia posts:create -e $ESTABLISHMENT_ID -p instagram -c "Brunch ce samedi" --draft

عدة شبكات في وقت واحد

اكتب الشبكات مفصولة بفواصل في -p, --platforms. تحصل كل شبكة على النص نفسه.

sofia posts:create -e $ESTABLISHMENT_ID -p instagram,facebook,linkedin -c "Tarte tatin du jour"

الوسائط والصيغة والحساب مشتركة أيضًا. تحدّد هذه الخيارات شكل المنشور:

  • -c, --content: نص المنشور.
  • -f, --format: الصيغة (post وreel وstory وcarousel…).
  • -a, --account: الحساب المرتبط الذي يُنشر منه.

إضافة وسائط

يقبل -m, --media معرّفات وسائط من مكتبتك أو عناوين https مفصولة بفواصل.

sofia posts:create -e $ESTABLISHMENT_ID -p instagram -c "Tarte tatin du jour" \
  -m $MEDIA_ID,https://images.example.com/tarte-tatin.jpg

بالنسبة إلى العنوان يُستنتج النوع من الامتداد: فيديو لـ mp4 وmov وwebm وm4v، وصورة فيما عدا ذلك. للرفع أولًا انظر الوسائط.

تجربة بلا نشر

يتحقق --dry-run من المنشور وفق قواعد كل شبكة دون نشر أي شيء. انظر التجربة بلا نشر.

sofia posts:create -e $ESTABLISHMENT_ID -p instagram -c "Tarte tatin du jour" --dry-run

عدم تكرار التنفيذ

أعد تنفيذ الأمر بأمان عبر --idempotency-key: المفتاح نفسه يعطي المنشور نفسه، لا منشورين. انظر عدم تكرار التنفيذ.

sofia posts:create -e $ESTABLISHMENT_ID -p instagram -c "Tarte tatin du jour" \
  --idempotency-key brunch-2026-11-07

جسم كامل من ملف

لنص مختلف لكل شبكة أو عدة وسائط أو جدولة دفعة واحدة، اكتب الجسم كاملًا في ملف ومرّره بـ -j, --json. يحلّ محل خيارات المحتوى.

{
  "establishmentId": "$ESTABLISHMENT_ID",
  "targets": [
    {
      "platform": "instagram",
      "text": "Tarte tatin du jour",
      "media": [{ "id": "$MEDIA_ID" }],
      "format": "post"
    },
    {
      "platform": "tiktok",
      "text": "Tarte tatin du jour",
      "media": [{ "url": "https://images.example.com/tarte-tatin.mp4", "type": "video" }]
    }
  ],
  "scheduledAt": "2026-11-07T09:00:00Z",
  "status": "scheduled"
}
sofia posts:create --json post.json

عرض المنشورات

صفِّ القائمة بهذه الخيارات. الردّ مقسّم إلى صفحات: انظر ترقيم الصفحات.

  • -e, --establishment: هذه المنشأة فقط.
  • --status: المنشورات بهذه الحالة فقط.
  • --from و--to: نطاق تاريخ.
  • --created-by me|app: ما كتبته بنفسك أو ما أُنشئ عبر الواجهة.
  • --limit و--cursor: حجم الصفحة ونقطة المتابعة.
sofia posts:list -e $ESTABLISHMENT_ID --status scheduled --from 2026-11-01 --to 2026-11-30 --limit 20

القراءة والتعديل والحذف

يغيّر posts:update التاريخ (-s) أو الحالة (draft أو scheduled) أو الجسم كاملًا بـ -j.

sofia posts:get $POST_ID
sofia posts:update $POST_ID -s 2026-11-08T09:00:00Z
sofia posts:update $POST_ID --status draft
sofia posts:delete $POST_ID

البرمجة النصية مع jq

بما أن المخرجات JSON، يستخرج jq ما تحتاجه: المعرّفات والحالات ومؤشر الصفحة التالية.

sofia posts:list -e $ESTABLISHMENT_ID --status scheduled | jq '.data[] | {id, status}'
sofia posts:list -e $ESTABLISHMENT_ID | jq -r '.nextCursor'

التالي: الحسابات والوسائط.

هل كانت هذه الصفحة مفيدة؟