تخطَّ إلى المحتوى
Kasblyدليل كسبلي

مرجع الأدوات

لا يرى التطبيق إلا الأدوات التي تسمح بها صلاحياته. كل التواريخ بصيغة ISO 8601، مثل 2026-07-01 أو 2026-07-01T09:00:00Z. تتضمن النتائج حقل link يفتح العنصر في كسبلي.

الأداة ما تفعله الصلاحية
get_workspace مساحة العمل ودورك وصلاحيات هذا الربط أي صلاحية
list_social_accounts حسابات التواصل المرتبطة عرض حسابات التواصل
list_posts البحث عن المنشورات بالفلاتر قراءة المنشورات
get_post منشور واحد بنصه الكامل ووسائطه وحالته قراءة المنشورات
create_draft_post حفظ مسودة جديدة للمراجعة إنشاء مسودات منشورات
list_campaigns الحملات المستمرة قراءة الحملات
get_campaign حملة واحدة بإعداداتها قراءة الحملات
get_posting_summary عدد المنشورات حسب الحالة لفترة قراءة النتائج
get_account_insights ما ينجح مع حساب واحد خلال 90 يومًا قراءة النتائج
list_workflows سير العمل الآلي قراءة سير العمل
get_workflow سير عمل واحد بمحفّزه وخطواته قراءة سير العمل

get_workspace

Section titled “get_workspace”

استخدمها أولًا. تعيد اسم مساحة العمل ودورك وصلاحيات هذا الربط والأدوات المتاحة. لا مدخلات لها.

list_social_accounts

Section titled “list_social_accounts”
المدخل النوع ملاحظات
platform نص، اختياري مثل INSTAGRAM أو FACEBOOK أو TIKTOK
limit رقم، اختياري من 1 إلى 100، الافتراضي 50

استخدم id الحساب من هنا كقيمة accountId في create_draft_post.

list_posts

Section titled “list_posts”
المدخل النوع ملاحظات
status نص، اختياري DRAFT أو SCHEDULED أو PUBLISHING أو PUBLISHED أو FAILED
approvalStatus نص، اختياري PENDING أو IN_REVIEW أو APPROVED أو REJECTED أو CHANGES_REQUESTED
platform نص، اختياري منصة التواصل
accountId نص، اختياري حساب واحد
campaignId نص، اختياري حملة واحدة
search نص، اختياري نص في العنوان أو المحتوى
from وto تاريخ، اختياري نطاق زمني
page وpageSize رقم، اختياري pageSize حتى 50، الافتراضي 20

get_post

Section titled “get_post”
المدخل النوع ملاحظات
postId نص من list_posts

create_draft_post

Section titled “create_draft_post”

تحفظ مسودة وتعيدها مع رابط. لا يُجدول أو يُنشر شيء؛ يراجعها شخص في لوحة التسويق.

المدخل النوع ملاحظات
accountId نص من list_social_accounts
content نص، اختياري نص المنشور
title نص، اختياري عنوان داخلي
platformCaptions كائن، اختياري نص مختلف لكل منصة
targetPlatforms قائمة، اختياري المنصات المستهدفة؛ الافتراضي منصة الحساب
mediaUrls قائمة، اختياري حتى 10 روابط صور أو فيديو

قدّم content أو رابط وسائط واحدًا على الأقل. بعض المنصات مثل إنستغرام تحتاج إلى وسائط.

list_campaigns و get_campaign

Section titled “list_campaigns و get_campaign”

لا مدخلات لـ list_campaigns. وتأخذ get_campaign المدخل campaignId.

get_posting_summary

Section titled “get_posting_summary”
المدخل النوع ملاحظات
from وto تاريخ، اختياري نطاق زمني
accountId نص، اختياري حساب واحد

تعيد عدد المنشورات لكل حالة وعدد المنشورات التي تنتظر المراجعة.

get_account_insights

Section titled “get_account_insights”
المدخل النوع ملاحظات
accountId نص من list_social_accounts

تعيد أنواع البدايات والصيغ والمصادر التي تفوقت على متوسط تفاعل الحساب خلال آخر 90 يومًا، والتي تأخرت عنه.

list_workflows و get_workflow

Section titled “list_workflows و get_workflow”

لا مدخلات لـ list_workflows. وتأخذ get_workflow المدخل workflowId.