انتقل إلى المحتوى
English

الوكلاء والواجهة البرمجية

وكلاؤك يقترحون، وقواعد العلامة تقرّر.

تتيح الواجهة البرمجية لـ AKETRA لأدواتك ووكلائك قراءة العلامة واقتراح العمل. ويمرّ كل إجراء يقترحونه بالحارس نفسه الذي تمرّ به اقتراحات AKETRA، وتبقى القرارات بيد المسؤولين لديك.

POST /public/v1/brands/{brandId}/actions
Authorization: <API key>

{
  "type": "post.publish",
  "title": "Launch week teaser",
  "payload": {
    "integrationId": "…",
    "content": "Our new model is fully autonomous."
  }
}
{
  "observed": false,
  "action": {
    "status": "PROPOSED",
    "autonomy": "RECOMMEND",
    "holds": ["Mentions a prohibited claim: \"fully autonomous\""],
    "proposedBy": "API"
  }
}
اقتراح، وجواب الحارس

ما الذي يحدث للاقتراح

  1. 1

    المراقبة

    لا يُنشأ أي إجراء، وتصل الفكرة إشارةَ فرصة.

  2. 2

    التوصية

    ينتظر الإجراء مسؤولًا يعتمده أو يعدّله أو يرفضه في التطبيق.

  3. 3

    التحضير

    يُنشأ المنشور مسودةً في التقويم.

  4. 4

    التشغيل

    يُجدوَل المنشور ضمن الحدّ اليومي، أو يبقى مسودةً حين لا تقبله القناة كما كُتب.

ما الذي يوقفه الحارس

  • ادعاء محظور في المنشور
  • قناة تحتاج إلى انتباه
  • قناة على تطبيق علامة أخرى، أو خارج تطبيق العلامة الخاص حين تشترطه
  • الحدّ اليومي حين يُبلَغ
  • إجراء آخر من النوع نفسه قيد التنفيذ للعلامة

في مستويَي التحضير والتشغيل، يعود الاقتراح الموقوف إلى مستوى التوصية وينتظر مسؤولًا يرى السبب.

ما الذي تستطيعه الواجهة البرمجية

  • القراءة

    العلامات وقنواتها، وصفحة العلامة، وعقل العلامة، والأهداف، والحملات وتوجّهاتها الإبداعية، والاستقلالية، والإجراءات، والإشارات المفتوحة، وسجلّ النشاط.

  • الاقتراح

    المنشورات وعناصر عقل العلامة والخطط ومسودات الحملات، تكتبها أدواتك أو يكتبها AKETRA، والتوجّهات الإبداعية للحملة يقترحها AKETRA، وإدارة الأهداف. وتنتظر عناصر العقل مسؤولًا يقبلها، والحملات مسؤولًا يعتمدها، والتوجّهات أحد معتمِدي العلامة أو مسؤولًا يختار واحدًا منها.

  • ما يبقى في التطبيق

    اعتماد الإجراءات ورفضها وسحبها، واعتماد الحملات وإيقافها مؤقتًا واستئنافها وإلغاؤها، واختيار التوجّهات الإبداعية ورفضها، وتغيير الاستقلالية، وتعيين القنوات، وإدارة تطبيقات العلامة.

ابدأ

المصادقة
مفتاح API الخاص بمؤسستك، أو رمز OAuth، في ترويسة Authorization
Node.js
npm install @aketra/node
المرجع
وصف OpenAPI على المسار ‎/public/v1/docs‎
الحدود
الاقتراحات، وتغييرات الأهداف والحملات والعقل، وطلبات التوجّهات، والمنشورات الجديدة: 90 في الساعة لكل مسار ومؤسسة. والقراءة بلا حدود

أسئلة

هل يستطيع الوكيل اعتماد اقتراحاته بنفسه؟
لا. يبقى اعتماد الإجراءات ورفضها وسحبها للمسؤولين في التطبيق، ولا مسارات لها في الواجهة البرمجية.
هل يمرّ كل ما يفعله الوكيل بالحارس؟
تمرّ به اقتراحاته عبر مسارات العلامة، وكذلك المنشورات الجديدة التي يرسلها عبر أدوات MCP في المحرّك: تنتظر مسؤولًا ما لم تسمح العلامة بأكثر من ذلك أو يوقف مسؤولٌ هذا الفحص. ويظل MCP قادرًا على تغيير إعدادات منشور مجدول دون فحص. لكن المفتاح نفسه يفتح أيضًا مسارات المنشورات في المحرّك، وهي تجدول المنشورات وتغيّرها وتحذفها مباشرة كما يفعل تقويم فريقك؛ ولا يُفحص منها إلا المنشورات الجديدة، حين تفعّل العلامة ذلك.
هل توجد Webhooks؟
ليس لأحداث العلامة بعد. تُبلغ Webhooks محرّك النشر عن المنشورات المنشورة، ولما سوى ذلك اقرأ سجلّ نشاط العلامة أو إشاراتها المفتوحة.
أين الواجهة البرمجية؟
على api.aketra.co، حين يُفتح AKETRA Cloud.

ابنِ على علامات تلتزم بقواعدها.

يُفتح الوصول المبكر على مراحل، علامةً بعد علامة.