اسأل المساعد (Copilot)

شغّل مساعد التسويق الواعي بالعربية لتعليمة واحدة واحصل على إجابته بالإضافة إلى خطة حيّة متعدّدة الخطوات.

POST/api/v1/copilot/ask

Requirescopilot

شغّل مساعد التسويق في eWasl — وكيل واعٍ بالعربية يحلّل أداء إعلاناتك، ويسترجع صوت علامتك التجارية، ويفحص توافق النص مع السياسات، ويخطّط عملاً متعدّد الخطوات — لتعليمة واحدة. يستدعي الوكيل أدوات قراءة عبر بيانات إعلاناتك ومنشوراتك حسب الحاجة (حتى 8 جولات أدوات) ويعيد إجابته النهائية بالإضافة إلى خطة المهام الحيّة التي أنتجها.

مرّر sessionId المُعاد في استدعائك التالي لمتابعة الخطة نفسها.

إجراءات الكتابة على الإعلانات (إيقاف الحملات، تبديل الطيّار الآلي) متاحة فقط عندما يحمل مفتاحك أيضاً نطاق ads:write. بنطاق copilot وحده، يكون المساعد للقراءة والتخطيط فقط — ولا يغيّر أبداً منصّة إعلانات حيّة.

معاملات الجسم

messagestringRequired

تعليمتك أو سؤالك للمساعد. بحد أقصى 4000 حرف. بالعربية أو الإنجليزية.

sessionIdstring (uuid)Required

متابعة جلسة/خطة قائمة. أغفِله لبدء جلسة جديدة — تعيد الاستجابة الـ sessionId الجديد.

locale'ar' | 'en'Optional

Default: ar

لغة الرد. الافتراضي العربية.

الاستجابة

data.sessionIdstring (uuid)

الجلسة التي تنتمي إليها هذه الدورة. أعِد استخدامها لمتابعة الخطة.

data.replystring

إجابة المساعد النهائية باللغة الطبيعية.

data.todosarray

الخطة الحيّة المرتّبة التي أنتجها المساعد — لكل عنصر position و text و status (pending | in_progress | done | skipped).

data.usageobject | null

استهلاك التوكنات للدورة (inputTokens، outputTokens).

Response Example

{
  "data": {
    "sessionId": "9c3f0a1e-7b2d-4e54-9c2a-1f3b6d8e0a44",
    "reply": "راجعت آخر 7 أيام: حملة \"عروض رمضان\" هي الأفضل (ROAS 4.1). أقترح خطة من 3 خطوات…",
    "todos": [
      { "position": 0, "text": "تحليل أداء آخر 7 أيام", "status": "done" },
      { "position": 1, "text": "اقتراح إعادة توزيع الميزانية", "status": "in_progress" },
      { "position": 2, "text": "صياغة نص إعلاني متوافق مع السياسات", "status": "pending" }
    ],
    "usage": { "inputTokens": 5123, "outputTokens": 412 }
  }
}

رموز الحالة

200 شُغّل المساعد بنجاح.

403 المفتاح يفتقر إلى نطاق copilot، أو الخطة ليست Professional/Enterprise.

422 خطأ تحقّق (مثل message فارغة أو طويلة جداً).

502 تعذّر إكمال المساعد — يمكن إعادة المحاولة بأمان.

503 المساعد غير متاح مؤقتاً.

مثال

curl -X POST https://app.ewasl.com/api/v1/copilot/ask \
  -H "Authorization: Bearer ewasl_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "message": "كيف أداء حملاتي هذا الأسبوع وما الذي تنصح بتعديله؟", "locale": "ar" }'