اربط نظامك بـلَبيب

حين يرفق المستخدم صورة (أو عدّة صور) ويطلب نشرها أو جدولتها على فيسبوك: نادِ هذه الأداة بعدد الصور، فتعيد لكلّ صورة media_id ورابط رفعٍ لمرّةٍ واحدة (30 دقيقة). إن كانت عندك بيئةُ تنفيذ كود (مثل Claude): ارفع كلَّ ملفٍّ أرفقه المستخدم إلى رابطه بالأمر curl المرفق (بايتات الملف نفسه — لا تعيد رسمه ولا تحوّله)، ثمّ تحقّق أنّ الجواب ok:true. إن رُفض الاتصال (403 أو proxy أو عدم وصول) أو لا بيئة كود عندك: أعطِ المستخدم user_link ليفتحه ويرفع الصورة بنفسه، وانتظر أن يقول إنّه رفعها. بعدها نادِ create_facebook_post (صورة واحدة) أو create_facebook_photos_post (2–10) بـ media_ids. تشات جي بي تي لا يحتاجها: يمرّر الصورة المرفقة مباشرةً في حقل image.

الصلاحية المطلوبة لموظّف الربط: facebook.post.add.all

curl -X POST https://labeb.app/api/v1/tools/create_facebook_image_upload \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"page":"…","count":10}'

نشر منشور بعدّة صور (2–10: روابط عامّة image_urls و/أو صورٌ مرفوعة media_ids) مع نصّ، الآن أو مجدولاً. علنيّ باسم الصفحة. **قبل النداء اعرض على المستخدم النصَّ الحرفيّ وخذ موافقته الصريحة — لا تنشر نصّاً لم يره.**

الصلاحية المطلوبة لموظّف الربط: facebook.post.add.all

curl -X POST https://labeb.app/api/v1/tools/create_facebook_photos_post \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"page":"…","message":"…"}'

نشر منشور على الصفحة، الآن أو مجدولاً: نصّ مع رابط، أو صورة — برابطها (image_url) أو صورةٍ أرفقها المستخدم (media_ids من create_facebook_image_upload، أو image في ChatGPT). صورتان فأكثر تُنشران منشوراً واحداً بعدّة صور. علنيّ باسم الصفحة. **قبل النداء اعرض على المستخدم النصَّ الحرفيّ وخذ موافقته الصريحة — لا تنشر نصّاً لم يره.**

الصلاحية المطلوبة لموظّف الربط: facebook.post.add.all

curl -X POST https://labeb.app/api/v1/tools/create_facebook_post \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"message":"…"}'

نشر فيديو من رابطٍ عامّ مع عنوان ووصف (الوصف هو نصّ المنشور). يُنشر فوراً — لا جدولة للفيديو هنا. علنيّ. **قبل النداء اعرض على المستخدم النصَّ الحرفيّ وخذ موافقته الصريحة — لا تنشر نصّاً لم يره.**

الصلاحية المطلوبة لموظّف الربط: facebook.post.add.all

curl -X POST https://labeb.app/api/v1/tools/create_facebook_video_post \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"video_url":"…"}'

حذف تعليق نهائياً (تعليق زبون أو ردّ للصفحة). للإبعاد عن العامّة يكفي hide_facebook_comment. **لا رجعة فيه — أكّد مع المستخدم أولاً.**

الصلاحية المطلوبة لموظّف الربط: facebook.comment.delete.all

curl -X POST https://labeb.app/api/v1/tools/delete_facebook_comment \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"comment_id":"…"}'

حذف منشور (منشور أو مجدول) نهائياً من الصفحة. **لا رجعة فيه — أكّد مع المستخدم أولاً.**

الصلاحية المطلوبة لموظّف الربط: facebook.post.delete.all

curl -X POST https://labeb.app/api/v1/tools/delete_facebook_post \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"…"}'

معلومات صفحة فيسبوك: الاسم والتصنيف وعدد المتابعين والإعجابات والرابط.

الصلاحية المطلوبة لموظّف الربط: facebook.post.view.all

curl -X POST https://labeb.app/api/v1/tools/get_facebook_page_info \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"page":"…"}'

إحصاءات الصفحة اليوميّة (الوصول والتفاعل مع المنشورات والمتابعات والزيارات) — الافتراضي آخر 28 يوماً.

الصلاحية المطلوبة لموظّف الربط: facebook.post.view.all

curl -X POST https://labeb.app/api/v1/tools/get_facebook_page_insights \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"page":"…","days":10}'

تعليقات منشورٍ (الأحدث أولاً) مع حالتها: مخفيّ؟ أعجبت به الصفحة؟ عدد الردود.

الصلاحية المطلوبة لموظّف الربط: facebook.comment.view.all

curl -X POST https://labeb.app/api/v1/tools/get_facebook_post_comments \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"…"}'

أرقام منشورٍ واحد: التفاعلات والتعليقات والمشاركات والوصول والنقرات (حين تتيحها ميتا).

الصلاحية المطلوبة لموظّف الربط: facebook.post.view.all

curl -X POST https://labeb.app/api/v1/tools/get_facebook_post_metrics \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"…"}'

إخفاء تعليق عن العامّة (يبقى ظاهراً لصاحبه وأصدقائه) أو إظهاره.

الصلاحية المطلوبة لموظّف الربط: facebook.comment.edit.all

curl -X POST https://labeb.app/api/v1/tools/hide_facebook_comment \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"comment_id":"…"}'

إعجاب الصفحة بتعليق أو إلغاؤه.

الصلاحية المطلوبة لموظّف الربط: facebook.comment.edit.all

curl -X POST https://labeb.app/api/v1/tools/like_facebook_comment \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"comment_id":"…"}'

صفحات فيسبوك المربوطة بقناة «تعليقات فيسبوك» لهذا الحساب. نادِها أولاً إن كان للحساب أكثر من صفحة، ومرّر اسمها في page.

الصلاحية المطلوبة لموظّف الربط: facebook.post.view.all

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/list_facebook_pages \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

قائمة آخر المنشورات مع التفاعلات والتعليقات والمشاركات ومعرّف كل منشور. للوصول والنقرات لمنشورٍ بعينه استعمل get_facebook_post_metrics، ولسؤال «كيف صفحتي؟» اجمعها مع get_facebook_page_insights.

الصلاحية المطلوبة لموظّف الربط: facebook.post.view.all

curl -X POST https://labeb.app/api/v1/tools/list_facebook_posts \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"page":"…","limit":10}'

المنشورات المجدولة التي لم تُنشر بعد ومواعيدها.

الصلاحية المطلوبة لموظّف الربط: facebook.post.view.all

curl -X POST https://labeb.app/api/v1/tools/list_facebook_scheduled_posts \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"page":"…"}'

تعليقات الزبائن على آخر المنشورات التي لم تردّ عليها الصفحة بعد (بلا المخفيّ)، مع رابط كلّ تعليق. لكلّ تعليقٍ commentId جاهزٌ لـ reply_to_facebook_comment: اقترح ردوداً قصيرة بلهجة الزبون واعرضها كلّها للموافقة قبل أيّ إرسال.

الصلاحية المطلوبة لموظّف الربط: facebook.comment.view.all

curl -X POST https://labeb.app/api/v1/tools/list_facebook_unanswered_comments \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"page":"…","posts":10}'

نشر منشورٍ مجدولٍ فوراً بدل موعده. **قبل النداء اعرض على المستخدم النصَّ الحرفيّ وخذ موافقته الصريحة — لا تنشر نصّاً لم يره.**

الصلاحية المطلوبة لموظّف الربط: facebook.post.edit.all

curl -X POST https://labeb.app/api/v1/tools/publish_facebook_scheduled_post_now \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"…"}'

ردّ علنيّ من الصفحة تحت تعليق — يراه الجميع. **قبل النداء اعرض على المستخدم النصَّ الحرفيّ وخذ موافقته الصريحة — لا تنشر نصّاً لم يره.**

الصلاحية المطلوبة لموظّف الربط: facebook.comment.add.all

curl -X POST https://labeb.app/api/v1/tools/reply_to_facebook_comment \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"comment_id":"…","message":"…"}'

تغيير موعد منشورٍ مجدول.

الصلاحية المطلوبة لموظّف الربط: facebook.post.edit.all

curl -X POST https://labeb.app/api/v1/tools/reschedule_facebook_post \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"…","scheduled_at":"…"}'

رسالة خاصّة على ماسنجر لصاحب تعليق (مرّة لكلّ تعليق، خلال 7 أيام من التعليق، تحتاج إذن الرسائل). **قبل النداء اعرض على المستخدم النصَّ الحرفيّ وخذ موافقته الصريحة — لا تنشر نصّاً لم يره.**

الصلاحية المطلوبة لموظّف الربط: facebook.comment.add.all

curl -X POST https://labeb.app/api/v1/tools/send_facebook_private_reply \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"comment_id":"…","message":"…"}'

تعديل نصّ منشورٍ منشور أو مجدول. علنيّ. **قبل النداء اعرض على المستخدم النصَّ الحرفيّ وخذ موافقته الصريحة — لا تنشر نصّاً لم يره.**

الصلاحية المطلوبة لموظّف الربط: facebook.post.edit.all

curl -X POST https://labeb.app/api/v1/tools/update_facebook_post_text \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"…","message":"…"}'

إضافة ملاحظة مؤرخة على بطاقة عميل محتمل.

الصلاحية المطلوبة لموظّف الربط: leads.update.all

curl -X POST https://labeb.app/api/v1/tools/add_lead_note \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"customerId":"…","note":"…"}'

إسناد قالب متابعة لعميل: **يلغي كل متابعاته المعلّقة أولاً** ثم ينشئ تسلسل خطوات القالب من الآن. استخدم list_follow_up_templates لمعرفة القوالب ومراحلها.

الصلاحية المطلوبة لموظّف الربط: leads.update.all

curl -X POST https://labeb.app/api/v1/tools/assign_follow_up_template \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"customerId":"…","templateId":"…"}'

إسناد بطاقة عميل محتمل لموظف، أو إلغاء إسنادها، أو إعادتها إلى لَبيب. يحرّك البطاقة والمحادثة معاً كما في الشاشة (نقلُ المحادثة يحتاج صلاحية استلام/تسليم المحادثات). مرّر userId لموظف، أو toLabeeb=true، أو unassign=true.

الصلاحية المطلوبة لموظّف الربط: leads.update.own

curl -X POST https://labeb.app/api/v1/tools/assign_lead \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"leadId":"…"}'

إيقاف كل المتابعات المعلّقة لعميل دفعةً واحدة (مثلاً حين يردّ العميل أو يُغلق ملفه). لا يمسّ المُرسَلة.

الصلاحية المطلوبة لموظّف الربط: leads.update.all

curl -X POST https://labeb.app/api/v1/tools/cancel_lead_follow_ups \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"customerId":"…"}'

إقفال تذكير متابعة بـ«تمّت المتابعة» بعد أن تواصل الموظف فعلاً، مع «شو صار؟» اختيارياً: outcome replied|no_reply|appointment|lost · contactVia queue|call|mobile|none · nextAt+nextNote = تذكير تالٍ.

الصلاحية المطلوبة لموظّف الربط: leads.update.all

curl -X POST https://labeb.app/api/v1/tools/complete_follow_up \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"followUpId":"…"}'

إنشاء خطّة متابعة جديدة لمرحلة (interested مهتم · engaged متفاعل · trial تجريبي) — تُنشأ غير افتراضية ثم تُضاف خطواتها. مع steps تُحفظ الخطوات مباشرة (النمط الافتراضي ai_smart يحتاج aiGoal لكل خطوة).

الصلاحية المطلوبة لموظّف الربط: followup.create

curl -X POST https://labeb.app/api/v1/tools/create_follow_up_plan \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"…"}'

إضافة عميل محتمل جديد برقمه (واسمه ومصدره ومرحلته اختيارياً). يُسند لك افتراضياً. يرفض رقماً له بطاقةٌ قائمة ويعيد معرّفها. stage: interested مهتم (الافتراضي) · engaged متفاعل · trial تجريبي.

الصلاحية المطلوبة لموظّف الربط: leads.create

curl -X POST https://labeb.app/api/v1/tools/create_lead \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"phone":"…"}'

اعتماد صفقة إضافية أو إرجاعها مع السبب.

الصلاحية المطلوبة لموظّف الربط: leads.won.approve

curl -X POST https://labeb.app/api/v1/tools/decide_postsale_deal \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"dealId":"…","approve":true}'

اعتمادُ صفقةٍ رابحة (approve=true) أو إرجاعُها للتصحيح (approve=false مع reason). تُرفض إن لم تكن بانتظار الاعتماد، أو نقصتها الباقة أو المبلغ، أو كان المعتمِد هو مَن أرسلها. بعد القرار يُشعَر المرسِل ومديرو المبيعات، والمعتمَد وحده يُحسب إيراداً. لا طريق لتحويل عميلٍ إلى «رابح» عبر الأدوات: التحويل من الواجهة بحقوله الإجبارية.

الصلاحية المطلوبة لموظّف الربط: leads.won.approve

curl -X POST https://labeb.app/api/v1/tools/decide_won \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"customerId":"…","approve":true}'

حذف خطّة متابعة. إن كان عليها متابعات مجدولة يُرفض الحذف ويُذكر عددها، إلّا مع force=true فتُلغى المجدولة والسلاسل الجارية ثم تُحذف.

الصلاحية المطلوبة لموظّف الربط: followup.delete

curl -X POST https://labeb.app/api/v1/tools/delete_follow_up_plan \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"id":"…"}'

توليد (أو تحديث) ملخّص رحلة العميل المحتمل بالذكاء: ماذا أراد، الاعتراضات، الوعود، وسبب الربح المقترح. يستهلك من رصيد الذكاء.

الصلاحية المطلوبة لموظّف الربط: leads.update.own

curl -X POST https://labeb.app/api/v1/tools/generate_lead_journey_summary \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"leadId":"…"}'

قمعُ حملةٍ واحدة: كم عميلاً جلبت وماذا حدث لهم (interested · engaged · trial · won · lost)، مع نسبة التحويل وأسباب الخسارة. الإنفاق: spentInWindow إنفاقُ الفترة نفسِها بعملة الحساب (currency) وspentInWindowUsd بالدولار بسعر صرف كلّ يوم، ومنه costPerLeadUsd وcostPerWonUsd؛ وspentLifetime إنفاقُ العمر كلِّه للمرجع فقط. الإنفاق اليوميّ محفوظ منذ 2026-07-01.

الصلاحية المطلوبة لموظّف الربط: leads.view

curl -X POST https://labeb.app/api/v1/tools/get_campaign_funnel \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"campaign":"…"}'

تقرير العملاء المحتملين: byStage لقطةٌ لكلّ البطاقات منذ البداية · newInPeriod عددُ الجدد في الفترة · newByStage مراحلُ الجدد أنفسِهم · آخرُ العملاء. الفترة: fromDate/toDate (YYYY-MM-DD بتوقيت الحساب، شاملة) وتتقدّم على days، أو days (الافتراضي 30). لقمعٍ شهريّ بالتعريفات المعتمدة استخدم get_sales_funnel.

الصلاحية المطلوبة لموظّف الربط: leads.view

curl -X POST https://labeb.app/api/v1/tools/get_crm_report \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"days":10,"fromDate":"…"}'

سجلّ تسليم المتابعات: ما أُرسل لكل عميل ومن أي خطّة وخطوة، وهل وصل أو رُفض ولماذا (رمز الخطأ)، وهل خرج قالباً بديلاً — مع الأعداد. outcome: delivered وصل · rejected رُفض · fallback بقالب بديل. ومع health=true: صحّة كل قناة في آخر 24 ساعة.

الصلاحية المطلوبة لموظّف الربط: leads.view

curl -X POST https://labeb.app/api/v1/tools/get_follow_up_delivery_log \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"days":10,"outcome":"delivered"}'

خطوات خطّة متابعة بالتفصيل (id من list_follow_up_templates): ترتيبها وتوقيتها ونصّها وهدفها وقالب واتساب لكل لغة، ونمط الخطّة ومرحلتها.

الصلاحية المطلوبة لموظّف الربط: followup.view

curl -X POST https://labeb.app/api/v1/tools/get_follow_up_plan_steps \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"id":"…"}'

تقرير المتابعات: التوزيع على الحالات والأنواع خلال فترة + المتابعات القادمة غير المرسلة.

الصلاحية المطلوبة لموظّف الربط: leads.view

curl -X POST https://labeb.app/api/v1/tools/get_follow_ups_report \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"days":10}'

بطاقة عميل محتمل كاملة بالبحث بالهاتف أو الاسم: البيانات، المرحلة، الملاحظات، ملخص الرحلة إن وجد.

الصلاحية المطلوبة لموظّف الربط: leads.view

curl -X POST https://labeb.app/api/v1/tools/get_lead_details \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"phone":"…","name":"…"}'

إعدادات العملاء المحتملين: مصادر العملاء المعرّفة وأسباب الخسارة — مفيدة قبل تحليل المصادر أو الخسارة.

الصلاحية المطلوبة لموظّف الربط: leads.settings.manage

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/get_lead_settings \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

مصادرُ العملاء خلال فترة، ولكلّ مصدرٍ اسمٌ مقروء (label) وتوزيعُ حملاته — ومجموعُ التفصيل يطابق الإجمالي دائماً لأنّ ما بلا حملةٍ يظهر سطراً صريحاً «بلا حملة». المصادر: meta_ctwa = إعلانات ميتا (يشمل من نقر الإعلان ثم كتب نصّاً من عنده) · whatsapp = تواصل مباشر بلا إعلان · tenant_data = بيانات مستوردة · manual = إدخال يدوي. ومعه توزيعٌ حسب القناة (واتساب · ماسنجر · الموقع) والبلد ومسار الإسناد (ctwa_click = نقرة إعلان مؤكّدة · opener = عبارة افتتاحية). الفترة تقويميّة بتوقيت حساب المستأجر.

الصلاحية المطلوبة لموظّف الربط: leads.sources.view

curl -X POST https://labeb.app/api/v1/tools/get_lead_source_report \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"period":"…","fromDate":"…"}'

عملاءُ حملةٍ واحدة: العددُ أوّلاً ثمّ القائمةُ ثمّ الملخّص. تقبل معرّف الحملة أو معرّفها في ميتا أو اسمها كاملاً أو جزءاً منه (تُطابَق بعد تجاهل علامات اتّجاه النصّ وفروق المسافات). ولكلّ عميل: الاسمُ والهاتفُ ووقتُ الدخول والمصدرُ والمرحلةُ والمسؤولُ وسببُ الخسارة والبلدُ ومسارُ الإسناد (نقرة إعلان أم عبارة افتتاحية).

الصلاحية المطلوبة لموظّف الربط: leads.view

curl -X POST https://labeb.app/api/v1/tools/get_leads_by_campaign \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"campaign":"…"}'

قوالب متابعة العملاء المحتملين: المرحلة التي تنطبق عليها، مفعّلة أم لا، عدد خطواتها، ونمط التشغيل.

الصلاحية المطلوبة لموظّف الربط: followup.view

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/list_follow_up_templates \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

المتابعات المجدولة والمرسلة (الافتراضي القادمة والمعلقة)، ولكلّ مُقفَلةٍ يدوياً: النتيجة (outcome) ومن أقفلها ومتى وكيف تواصل.

الصلاحية المطلوبة لموظّف الربط: leads.view

curl -X POST https://labeb.app/api/v1/tools/list_follow_ups \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"limit":10}'

قائمة بطاقات العملاء المحتملين بفلاتر: المرحلة، الموظف المُسنَد (معرّفه أو me لي أو unassigned غير مُسنَد)، القناة، بحث بالاسم/الرقم، تاريخ الإضافة، الأولوية، المتأخّرة، وبلا متابعة مجدولة. يعيد العدد الكلي وعدّ كل مرحلة. من لا يملك «كل العملاء» يرى عملاءه فقط. المراحل: interested مهتم · engaged متفاعل · trial تجريبي · won ربح · lost خسارة.

الصلاحية المطلوبة لموظّف الربط: leads.view

curl -X POST https://labeb.app/api/v1/tools/list_leads \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"stage":"…","assignedTo":"…"}'

الصفقاتُ الرابحة بانتظار الاعتماد: العميل (customerId) · الباقة · المبلغ بالدولار · المدة بالأشهر · عدد المستخدمين · طريقة الدفع · نوع البيع · مَن أرسلها ومتى. للاعتماد أو الإرجاع استخدم decide_won.

الصلاحية المطلوبة لموظّف الربط: leads.won.approve

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/list_pending_won \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

الفرص البيعية: التوزيع على المراحل مع مجموع القيمة + آخر الفرص وأسباب الخسارة.

الصلاحية المطلوبة لموظّف الربط: leads.view

curl -X POST https://labeb.app/api/v1/tools/list_sales_opportunities \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"limit":10}'

تعديل متابعة معلّقة: تأجيلها أو تغيير نصها أو تخطيها أو إلغاؤها. followUpId من list_follow_ups أو get_follow_ups_report. status: pending|skipped|cancelled. المتابعات المُرسَلة تاريخٌ لا يُعدَّل.

الصلاحية المطلوبة لموظّف الربط: leads.update.all

curl -X POST https://labeb.app/api/v1/tools/reschedule_follow_up \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"followUpId":"…"}'

جدولة متابعة لعميل محتمل في موعد مستقبلي. kind: channel (تُرسل للعميل عبر واتساب تلقائياً) | reminder (تذكير داخلي للموظف لا يصل العميل). الافتراضي channel — فاختر reminder صراحةً إن كان المقصود تذكير الفريق لا مراسلة العميل.

الصلاحية المطلوبة لموظّف الربط: leads.update.all

curl -X POST https://labeb.app/api/v1/tools/schedule_follow_up \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"customerId":"…","messageText":"…","scheduledAt":"…"}'

تعديل خطّة متابعة: الاسم، المرحلة، تفعيلها، جعلها الافتراضية لمرحلتها (تُطفئ افتراضيّة غيرها)، نمطها، واستبدال خطواتها (حتى 12 خطوة). لا يُسمح بخطوات أقلّ من موضع عميلٍ وصل إليه في سلسلة جارية.

الصلاحية المطلوبة لموظّف الربط: followup.update

curl -X POST https://labeb.app/api/v1/tools/update_follow_up_plan \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"id":"…"}'

تعديل حقول بطاقة عميل محتمل: الاسم، الملاحظات، الأولوية، الباقة وقيمتها، المصدر (sourceType: channel قناة · campaign حملة · manual مصدر يدوي، مع sourceValue)، وسبب الخسارة لعميلٍ خاسر (lossReasonId من الكتالوج أو lossReason نصاً، وlossSaid «ماذا قال العميل» إلزاميٌّ حين يكون السبب اعتراضاً صريحاً). لتغيير المرحلة استعمل update_lead_stage.

الصلاحية المطلوبة لموظّف الربط: leads.update.own

curl -X POST https://labeb.app/api/v1/tools/update_lead_fields \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"leadId":"…"}'

نقل عميل محتمل إلى مرحلة: interested|trial|engaged. «نجاح» عبر ترقية ما بعد البيع، و«خسارة» من الواجهة مع سبب.

الصلاحية المطلوبة لموظّف الربط: leads.update.all

curl -X POST https://labeb.app/api/v1/tools/update_lead_stage \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"customerId":"…","stage":"…"}'

إسناد محادثة واتساب أو تغيير مالكها. action: human إسناد لموظف (userId، افتراضياً أنت) فيسكت لَبيب فوراً · ai إرجاعها للَبيب · unassign إلغاء الإسناد · resolve إغلاقها. من لا يملك «تعديل كل المحادثات» يدير محادثاته وغير المُسندة فقط.

الصلاحية المطلوبة لموظّف الربط: whatsapp.conversation.update.own

curl -X POST https://labeb.app/api/v1/tools/assign_conversation \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"threadKey":"…","action":"human"}'

إلغاء موعد مع إشعار العميل بالإلغاء. خذ appointmentId من list_appointments، وreason اختياري.

الصلاحية المطلوبة لموظّف الربط: appointments.update.all

curl -X POST https://labeb.app/api/v1/tools/cancel_appointment \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"appointmentId":"…"}'

التحكّم بحملة واتساب (id من list_whatsapp_broadcasts): pause إيقاف مؤقت · resume استئناف · stop إيقاف نهائي · start_now تشغيل حملة مجدولة الآن. من لا يملك «الكل» يتحكّم بحملاته فقط.

الصلاحية المطلوبة لموظّف الربط: whatsapp.broadcast.update.own

curl -X POST https://labeb.app/api/v1/tools/change_whatsapp_broadcast_state \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"id":"…","action":"pause"}'

حجز موعد يدوي لعميل برقمه في وقت محدد بتوقيت الشركة (scheduledAt بصيغة 2026-09-21T15:30). يتحقق من التعارض ويربطه ببطاقة العميل إن وجدت. لا يرسل رسالة للعميل.

الصلاحية المطلوبة لموظّف الربط: appointments.create

curl -X POST https://labeb.app/api/v1/tools/create_appointment \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"phone":"…","scheduledAt":"…"}'

إطلاق حملة واتساب بقالب معتمد لجمهور من العملاء المحتملين (حتى 1000 مستلم): instanceId الرقم المرسِل · templateId القالب · stages مراحل الجمهور (interested · engaged · trial · lost …) · activeWithinDays تفاعل خلال كم يوماً · params قيم متغيّرات القالب بالترتيب (source: first_name · full_name · package · text مع text) · ratePerHour سرعة الإرسال 30 أو 120 أو 400 · scheduledAt موعد لاحق اختياري. تُستثنى تلقائياً الأرقام الرافضة والمكرّرة. يعيد عدد من سيصلهم قبل الإطلاق.

الصلاحية المطلوبة لموظّف الربط: whatsapp.broadcast.create

curl -X POST https://labeb.app/api/v1/tools/create_whatsapp_broadcast \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"…","instanceId":"…","templateId":"…"}'

إنشاء قالب واتساب رسمي وإرساله لمراجعة ميتا. name بحروف إنجليزية صغيرة وشرطات سفلية، body نص القالب والمتغيرات بصيغة {{1}} {{2}} مع مثال لكل متغير في examples، category واحدة من UTILITY (خدمي) أو MARKETING (تسويقي) أو AUTHENTICATION (رمز تحقق)، language مثل ar أو en، footer اختياري، buttons اختيارية: QUICK_REPLY حتى 10، URL حتى 2 مع url، PHONE_NUMBER واحد مع phoneNumber. instanceId مطلوب فقط إن كان في الحساب أكثر من قناة رسمية. القالب لا يرسل قبل اعتماده — تابع حالته بـ get_whatsapp_template_status.

الصلاحية المطلوبة لموظّف الربط: whatsapp.template.create

curl -X POST https://labeb.app/api/v1/tools/create_whatsapp_template \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"…","body":"…","category":"UTILITY"}'

حذف قالب واتساب رسمي من ميتا ومن القائمة — لا رجعة فيه، ولا يمكن إعادة استعمال اسمه فوراً عند ميتا. مرر templateId (المعرّف أو الاسم). القالب الذي تديره خدمة رمز التحقق لا يحذف من هنا.

الصلاحية المطلوبة لموظّف الربط: whatsapp.template.delete

curl -X POST https://labeb.app/api/v1/tools/delete_whatsapp_template \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"templateId":"…"}'

إعدادات وكيل المواعيد: التفعيل، المدة، القوالب، كلمات الكشف، وmeetingLateMinutes = بعد كم دقيقة من بداية الموعد يُعتبر الموظف «تأخّر» عن الاجتماع.

الصلاحية المطلوبة لموظّف الربط: appointments.settings.manage

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/get_appointment_settings \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

حركة كل قناة وكلفة لَبيب عليها لفترة: الوارد (خاص · مجموعات)، والصادر (لَبيب ومنه الصوتي · موظفين · متابعات آلية)، وكلفة الذكاء بالدولار ووسطي كلفة رسالة لَبيب. days: آخر كم يوماً (افتراضياً 1 = آخر 24 ساعة)، أو from/to بصيغة ISO 8601 لفترة محدّدة. الخط العادي السوري يُضمّ إلى قناته الأمّ. unattributedAiCostUsd = كلفةٌ لم تُربط بقناة (قبل 2026-11-01 كلّ الكلفة كانت كذلك). costTrackedFrom = بداية تسجيل الكلفة لكل قناة، والوسطي يُحسب على ردود لَبيب من بعدها فقط.

الصلاحية المطلوبة لموظّف الربط: whatsapp.instance.read.all

curl -X POST https://labeb.app/api/v1/tools/get_channel_traffic \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"days":10,"from":"…"}'

الملخصات المحفوظة لمحادثات العملاء (ذاكرة المحادثات الطويلة).

الصلاحية المطلوبة لموظّف الربط: whatsapp.message.read.all

curl -X POST https://labeb.app/api/v1/tools/get_conversation_summaries \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"phone":"…","limit":10}'

رسائل محادثة عميل على أي قناة أو مجموعة واتساب (بالتسلسل الزمني) — للتحليل العميق: الاتجاه والنص والوقت، ولكل رسالة قناتها ونوعها، وchannels تعدّ رسائل كل قناة. مرّر في phone رقم العميل أو address كما أعادته list_whatsapp_conversations (مثل …@tg)، وchannel أو channelType لقراءة قناة واحدة حين راسل العميل أكثر من رقم. للمجموعة مرّر معرّفها الكامل (…@g.us من list_whatsapp_groups) في phone، فتعيد لكلّ رسالة من أرسلها: لَبيب أو موظّف أو رقم المشارك.

الصلاحية المطلوبة لموظّف الربط: whatsapp.message.read.all

curl -X POST https://labeb.app/api/v1/tools/get_whatsapp_conversation \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"phone":"…"}'

أعضاء مجموعة واتساب بأسمائهم وأرقامهم ومن المشرف — groupJid من list_whatsapp_groups.

الصلاحية المطلوبة لموظّف الربط: whatsapp.message.read.all

curl -X POST https://labeb.app/api/v1/tools/get_whatsapp_group_members \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"groupJid":"…"}'

إعداد توجيه محادثات الواتساب لكل رقم: ذكاء أم موظف واحد أم تناوب.

الصلاحية المطلوبة لموظّف الربط: whatsapp.routing.manage

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/get_whatsapp_routing \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

هل نافذة 24 ساعة مفتوحة لهذا الرقم على القناة الرسمية. اسأل قبل إرسال ملف أو نص حر: خارج النافذة لا تقبل ميتا إلا قالبا معتمدا. القنوات غير الرسمية لا تخضع لهذا الحد.

الصلاحية المطلوبة لموظّف الربط: whatsapp.message.send

curl -X POST https://labeb.app/api/v1/tools/get_whatsapp_send_window \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"phone":"…"}'

حالة قالب واتساب الآن: يسحب الحالة من ميتا أولاً ثم يعيد status (approved معتمد، pending قيد المراجعة، rejected مرفوض، paused موقوف) مع معناها وسبب الرفض إن وجد والنص وعدد المتغيرات. مرر templateId (المعرّف أو الاسم)، وrefresh=false للقراءة المخزنة بلا سحب.

الصلاحية المطلوبة لموظّف الربط: whatsapp.template.view

curl -X POST https://labeb.app/api/v1/tools/get_whatsapp_template_status \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"templateId":"…"}'

المواعيد ضمن فترة (الافتراضي القادمة 14 يوماً، والماضية بـ daysBack) مع الحالة والعميل والمسؤول، ولموعد الاجتماع أونلاين: هل دخل العميل ومتى، وهل دخل الموظّف ومتى وكم تأخّر (meeting.data=unknown يعني ما في بيانات).

الصلاحية المطلوبة لموظّف الربط: appointments.view.all

curl -X POST https://labeb.app/api/v1/tools/list_appointments \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"daysAhead":10,"daysBack":10}'

من يملك المحادثات: مع threadKey — مالك محادثة واحدة (لَبيب أم موظف، ومتى، وهل لَبيب ما زال يساعد). بلا threadKey — محادثاتك المفتوحة المسندة لك، ولمن يملك «تعديل كل المحادثات» أيضاً عدد المحادثات المفتوحة لكل موظف.

الصلاحية المطلوبة لموظّف الربط: whatsapp.message.read.all

curl -X POST https://labeb.app/api/v1/tools/list_conversation_assignments \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"threadKey":"…","limit":10}'

حملات واتساب: الاسم والحالة والقالب وعدد المستلمين وما أُرسل وما فشل وما تُخطّي والكلفة التقديرية والمواعيد. مع id: تفصيل حملةٍ واحدة — وصل/قُرئ/ردّ، أسباب التخطّي والفشل، والكلفة الفعلية. من لا يملك «الكل» يرى حملاته فقط. سقف الحملة 1000 مستلم.

الصلاحية المطلوبة لموظّف الربط: whatsapp.broadcast.view.own

curl -X POST https://labeb.app/api/v1/tools/list_whatsapp_broadcasts \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"id":"…","limit":10}'

كل قنوات الحساب (أرقام واتساب · تلغرام · انستغرام · ماسنجر · تعليقات فيسبوك · الموقع): الاسم والرقم والمزوّد ونوع القناة type/typeLabel (whatsapp_official واتساب رسمي · whatsapp واتساب · telegram …) وهل متصل الآن ومتى آخر اتصال وسبب الانقطاع، والرقم المرافق، وأرقام آخر 24 ساعة: أُرسل · فشل · وصل · قُرئ · وارد · نسبة الفشل.

الصلاحية المطلوبة لموظّف الربط: whatsapp.instance.read.all

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/list_whatsapp_channels \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

المحادثات الخاصة على كل القنوات (واتساب بأرقامه · تلغرام · انستغرام · ماسنجر · تعليقات فيسبوك · الموقع) مع فلاتر: نافذة زمنية بتوقيت الحساب (period أو fromDate/toDate)، ومرحلة العميل (stage)، والقناة باسمها أو رقمها (channel)، ونوع القناة (channelType)، وunanswered للمحادثات التي آخر رسالة فيها من العميل ولم يُردّ عليها. المحادثة = عميل على قناة واحدة: من راسل رقمين من أرقامنا يظهر محادثتين. لكل محادثة: address (عنوان العميل — رقمه على واتساب، أو عنوانه بلاحقة القناة مثل …@tg على تلغرام؛ مرّره كما هو إلى get_whatsapp_conversation وأدوات الإرسال وthreadKey)، وphone (رقم جواله إن عُرف)، والاسم والمرحلة، وchannel وchannelType وchannelTypeLabel وourNumber (رقمنا الذي راسله)، وعدد الرسائل في النافذة وآخر رسالة ومن أرسلها وهل تنتظر ردّاً، مع العدد الكلي وbyChannelType. نقطة البداية لتحليل المحادثات.

الصلاحية المطلوبة لموظّف الربط: whatsapp.message.read.all

curl -X POST https://labeb.app/api/v1/tools/list_whatsapp_conversations \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"period":"…","fromDate":"…"}'

مجموعات واتساب التي يشارك بها حسابك: المعرف الكامل بصيغة أرقام تليها @g.us والاسم والنوع (post_sale ما بعد البيع · agent وكلاء · internal داخلية) وعدد الرسائل وآخر نشاط، مرتبة بالأحدث نشاطاً. هذا المعرف هو ما يوضع في حقل phone عند send_whatsapp_message أو send_whatsapp_media للإرسال إلى مجموعة. query يبحث في اسم المجموعة عبر كل تاريخها، وtype يفلتر بالنوع. ومع period أو fromDate/toDate (الحدّ الأقصى 92 يوماً) تعيد المجموعات التي تحرّكت في الفترة، ولكل مجموعة: رسائل العميل ورسائل الفريق ورسائل لَبيب منفصلة (رسائل الموظّفين من جوّالاتهم تُعدّ للفريق لا للعميل؛ التفاعلات ورسائل النظام لا تُعدّ)، ومن ردّ من الموظّفين، وهل آخرها رسالة عميل بلا ردّ (pending) ومنذ متى، والموظّف المسؤول، والتذاكر المفتوحة منها في الفترة؛ مع summary محسوب على كل المطابق: المتحرّكة والتي ردّ عليها الفريق والمعلّقة، لكل موظّف. pendingOnly للمعلّقة وحدها. صفحات: page (من 1) وlimit (الافتراضي 20، الأقصى 100)، وhasMore. ولقراءة رسائل مجموعة مرّر معرّفها إلى get_whatsapp_conversation.

الصلاحية المطلوبة لموظّف الربط: whatsapp.message.read.all

curl -X POST https://labeb.app/api/v1/tools/list_whatsapp_groups \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"query":"…","type":"post_sale"}'

قوالب واتساب الرسمية المعتمدة: الاسم واللغة والحالة وعدد المتغيّرات ونصّها.

الصلاحية المطلوبة لموظّف الربط: whatsapp.template.view

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/list_whatsapp_official_templates \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

تغيير وقت موعد قائم (scheduledAt بتوقيت الشركة) مع إشعار العميل بالوقت الجديد. خذ appointmentId من list_appointments.

الصلاحية المطلوبة لموظّف الربط: appointments.update.all

curl -X POST https://labeb.app/api/v1/tools/reschedule_appointment \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"appointmentId":"…","scheduledAt":"…"}'

إرسال ملف أو صورة أو مستند عبر واتساب إلى رقم أو إلى مجموعة، أو إلى عميل قناة أخرى بعنوانه (…@tg) من قناة محادثته — وللمجموعة مرر معرفها الكامل بصيغة @g.us في حقل phone، وتُقرأ المعرفات بـ list_whatsapp_groups. مرر fileId لملف رفعته سابقا بـ upload_file وهو الأفضل عند الإرسال لأكثر من رقم لأنه لا يعيد الحمولة، أو url للملف، أو base64 لمحتواه — مصدر واحد فقط لا أكثر. مع fileName وcaption اختياريا. تصل للعميل فعلا. السقف 16 ميغابايت، والصور والفيديو سقفها 16 من واتساب نفسه. الصوت غير مدعوم بعد. يخضع لحدود الإرسال: فاصل زمني بين رسالتين لنفس الرقم، وسقف ساعي للحساب، وسقف لعدد الأرقام المختلفة في الساعة.

الصلاحية المطلوبة لموظّف الربط: whatsapp.message.send

curl -X POST https://labeb.app/api/v1/tools/send_whatsapp_media \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"phone":"…"}'

إرسال رسالة نصية إلى رقم أو مجموعة واتساب، أو إلى عميل على قناة أخرى (تلغرام · انستغرام · ماسنجر…) بتمرير address كما أعادته list_whatsapp_conversations (مثل …@tg) فتخرج من قناة محادثته نفسها. للرقم: أرقام فقط مع رمز الدولة بلا + ولا مسافات. وللمجموعة: مرر معرفها الكامل في نفس حقل phone بصيغة أرقام تليها @g.us — والمعرفات تُقرأ بـ list_whatsapp_groups. ويمكن تمرير isGroup صريحاً ومعه يُقبل المعرف كما هو. تصل فعلياً — استخدمها بحذر وبنص نهائي جاهز. وإذا عند الحساب أكثر من قناة مرّر channel باسم القناة، وإلا ترجع لك الأداة أسماء القنوات لتسأل المستخدم.

الصلاحية المطلوبة لموظّف الربط: whatsapp.message.send

curl -X POST https://labeb.app/api/v1/tools/send_whatsapp_message \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"phone":"…","text":"…"}'

إرسال قالب واتساب معتمد إلى رقم — وهو الطريق الوحيد لفتح محادثة بعد انتهاء نافذة 24 ساعة على القناة الرسمية، لأن الوسائط والنص الحر لا يقبلان خارجها. اقرأ القوالب أولا بـ list_whatsapp_official_templates وخذ منها المعرف وعدد المتغيرات. يخضع لنفس حدود الإرسال.

الصلاحية المطلوبة لموظّف الربط: whatsapp.message.send

curl -X POST https://labeb.app/api/v1/tools/send_whatsapp_template \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"phone":"…","templateId":"…"}'

إرسال قالب واتساب معتمد لمجموعة عملاء دفعة واحدة (حتى 25 رقماً): مرر phones قائمة أرقام، أو stage مرحلة البطاقات (interested · trial · engaged · won) فيؤخذ أحدث 25 بلا الخاسرين والمؤجّلين. params قيم المتغيرات، وfirstParamIsCustomerName=true يضع الاسم الأول لكل عميل في المتغير الأول. كل رقم يمر بسياسة ميتا (لا قالب خلال 24 ساعة من سابقه ولا بعد رفض حديث) فيتخطى المحمي ويذكر السبب.

الصلاحية المطلوبة لموظّف الربط: whatsapp.message.send

curl -X POST https://labeb.app/api/v1/tools/send_whatsapp_template_bulk \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"templateId":"…"}'

إيقاف ردود لَبيب على محادثة عميل بعينه ليتولّاها موظف (يبقى موقوفاً حتى تُرجعها له بـ assign_conversation action=ai).

الصلاحية المطلوبة لموظّف الربط: whatsapp.message.send

curl -X POST https://labeb.app/api/v1/tools/stop_labeeb_on_conversation \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"threadKey":"…"}'

تعديل إعدادات المواعيد: تفعيل/مدة/أقصى أيام/قوالب الرسائل، وstaffMayBookOutsideHours = الموظّف يحجز يدوياً خارج الدوام (لَبيب يبقى ضمنه)، وaiOfferStartHour/aiOfferEndHour = ساعاتٌ أضيق من الدوام يعرض لَبيب مواعيده ضمنها (-1 يلغيها)، وmeetingLateMinutes (0–60) = اعتبر الموظف متأخّراً إذا دخل الاجتماع بعد هذا العدد من الدقائق من موعده.

الصلاحية المطلوبة لموظّف الربط: appointments.settings.manage

curl -X POST https://labeb.app/api/v1/tools/update_appointment_settings \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"isEnabled":true,"staffMayBookOutsideHours":true}'

تحديث موعد: status: completed اكتمل · no_show لم يحضر (كلاهما يتطلّب outcomeNote «ماذا حدث») · scheduled مجدول · pending_time بانتظار تحديد الوقت. وassigneeId لتغيير المسؤول (من فريق المواعيد) أو clearAssignee، وnotes لملاحظات الموعد. للإلغاء مع إشعار العميل استعمل cancel_appointment.

الصلاحية المطلوبة لموظّف الربط: appointments.update.own

curl -X POST https://labeb.app/api/v1/tools/update_appointment_status \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"appointmentId":"…"}'

تغيير توجيه رقم واتساب (instanceId من get_whatsapp_routing): mode = ai لَبيب يردّ · single_agent موظف واحد (singleAgentUserId) · round_robin تناوب (roundRobinUserIds) · none بلا توجيه. handoffUserIds اختياري: فريق التحويل لهذا الرقم.

الصلاحية المطلوبة لموظّف الربط: whatsapp.routing.manage

curl -X POST https://labeb.app/api/v1/tools/update_whatsapp_routing \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"instanceId":"…","mode":"ai"}'

رفع ملف مرة واحدة إلى النظام وأخذ معرف قصير له، ثم إرساله لأي عدد من الأرقام بـ send_whatsapp_media ومعه fileId — بلا إعادة الحمولة في كل مرة وبلا خطر حرف فاسد يفسد الملف. مرر base64 لمحتوى الملف أو url لجلبه، مع fileName وmimeType. المعرف صالح سبعة أيام ولا يصلح إلا داخل حسابك.

الصلاحية المطلوبة لموظّف الربط: whatsapp.message.send

curl -X POST https://labeb.app/api/v1/tools/upload_file \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"base64":"…","url":"…"}'

إضافة ملاحظة داخلية مؤرّخة على عميل ما بعد البيع (يراها الفريق فقط ولا تصل العميل).

الصلاحية المطلوبة لموظّف الربط: postsale.update.own

curl -X POST https://labeb.app/api/v1/tools/add_postsale_note \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"customerId":"…","content":"…"}'

إضافة رسالة على تذكرة دعم. internal=true (الافتراضي) ملاحظة داخلية للفريق لا تصل العميل؛ internal=false ردٌّ يُرسَل للعميل على محادثته.

الصلاحية المطلوبة لموظّف الربط: tickets.update.own

curl -X POST https://labeb.app/api/v1/tools/add_ticket_message \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"ticketId":"…","text":"…"}'

إسناد تذكرة لموظف (استخدم list_users للمعرّف).

الصلاحية المطلوبة لموظّف الربط: tickets.update.all

curl -X POST https://labeb.app/api/v1/tools/assign_ticket \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"ticketId":"…","userId":"…"}'

تحويل تذكرة دعم إلى عمل تقني. mode=card (الافتراضي): بطاقة منتج (cardType: bug خطأ · feature ميزة · improvement تحسين · suggestion اقتراح) ببيانٍ يُسجَّل على التذكرة ويُرسَل للعميل إن sendToCustomer=true، ويُربط العميل طالباً فيصله إشعار الإطلاق. mode=feature_request: طلب ميزة على العميل.

الصلاحية المطلوبة لموظّف الربط: tickets.update.own

curl -X POST https://labeb.app/api/v1/tools/convert_ticket_to_card \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"ticketId":"…"}'

إضافة مقال جديد لقاعدة المعرفة (يتفهرس فوراً لبوت الدعم).

الصلاحية المطلوبة لموظّف الربط: postsale.kb.create

curl -X POST https://labeb.app/api/v1/tools/create_kb_article \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"title":"…","content":"…"}'

إضافة عميل ما بعد بيع يدوياً (صفقة أُغلقت خارج النظام): الرقم مطلوب، والاسم والمسؤول اختياريان. يرفض رقماً له عميلٌ قائم. لنقل عميل محتمل استعمل promote_lead_to_postsale.

الصلاحية المطلوبة لموظّف الربط: postsale.create

curl -X POST https://labeb.app/api/v1/tools/create_postsale_customer \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"phone":"…"}'

إضافة صفقة جديدة لعميل عنده بطاقة: اشتراك جديد بباقته ومبلغه، وتنفتح له مجموعة واتساب باسم الاشتراك. التجديد لا يُسجَّل هنا.

الصلاحية المطلوبة لموظّف الربط: postsale.update.own

curl -X POST https://labeb.app/api/v1/tools/create_postsale_deal \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"customerId":"…"}'

كتابة ملخّص جلسة/اجتماع لعميل ما بعد البيع (المشكلة والحلّ والمدة، واختيارياً التذكرة)، وإرساله للعميل على واتساب إن sendToWhatsApp=true.

الصلاحية المطلوبة لموظّف الربط: postsale.update.own

curl -X POST https://labeb.app/api/v1/tools/create_postsale_summary \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"customerId":"…"}'

فتح تذكرة دعم جديدة (تحسب SLA تلقائياً).

الصلاحية المطلوبة لموظّف الربط: tickets.create

curl -X POST https://labeb.app/api/v1/tools/create_ticket \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"title":"…"}'

قراءة إعداد إنشاء مجموعات ما بعد البيع ووصف الخدمة الخاص بهذه الشركة فقط.

الصلاحية المطلوبة لموظّف الربط: postsale.read.own

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/get_post_sale_group_settings \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

تحليلات ما بعد البيع. section: today إحصاء اليوم · queue طابور العمل «الأحوج أولاً» مع عدّادات الطوابير وحِمل كل موظف (queue: waiting ينتظر ردّاً · mine عملائي · silent صامتون · new جدد · tickets تذاكر مفتوحة · noowner بلا مسؤول · all) · velocity سرعة التحويل لكل موظف · success مؤشّرات النجاح وأسبابه وتوزيع الباقات. من لا يملك «كل العملاء» يرى طابور عملائه فقط، ولا يرى velocity وsuccess.

الصلاحية المطلوبة لموظّف الربط: postsale.read.own

curl -X POST https://labeb.app/api/v1/tools/get_postsale_analytics \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"section":"today"}'

تفاصيل عميل ما بعد البيع (بالهاتف أو الاسم): الحالة وخطوات الإعداد ودرجة الصحة وسبب النجاح وسرعة التحويل + آخر الملاحظات الداخلية + كلّ اشتراكاته في نظامك (subscriptions: الاسم والحالة والباقة والانتهاء وآخر نشاط — الفعّال ثمّ الأقرب انتهاءً).

الصلاحية المطلوبة لموظّف الربط: postsale.read

curl -X POST https://labeb.app/api/v1/tools/get_postsale_customer \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"phone":"…","name":"…"}'

تقرير تذاكر الدعم. دائماً: byStatus (لقطة كل الحالات) وopenList (أحدث المفتوحة). ومع الفلاتر: tickets — لكل تذكرة الرمز والعميل والموضوع والحالة والموظّف المسؤول ومن أغلقها وتاريخ الإنشاء والإغلاق ونوع الإغلاق (problem_solved حلّ مشكلة · inquiry_answered ردّ على استفسار · converted_to_card تحويل لبطاقة تقنية مع رقمها · cancelled إلغاء · null غير محدّد) وهل تجاوزت SLA؛ وsummary — المغلقة لكل موظّف موزّعة حسب نوع الإغلاق. الفترة fromDate/toDate (YYYY-MM-DD بتوقيت الحساب، شاملة) أو period، وتُطبَّق على تاريخ الإغلاق افتراضياً (dateField=created لتاريخ الإنشاء). employee اسم الموظّف أو معرّف المستخدم، وemployeeRole: closedBy | assignedTo | any (الافتراضي any). القائمة مقسّمة صفحات: page (من 1) وlimit (الافتراضي 50، الأقصى 100)، والملخّص محسوب على كل المطابق لا على الصفحة.

الصلاحية المطلوبة لموظّف الربط: tickets.view.all

curl -X POST https://labeb.app/api/v1/tools/get_tickets_report \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"period":"…","fromDate":"…"}'

قائمة مقالات قاعدة المعرفة (منشورة ومسودات) مع التصنيف وimagesCount. includeContent=true يعيد نصّ كل مقال كاملاً وصوره: لكل صورة imageId وurl وcaption (الوصف) وsortOrder (الترتيب) وsendCondition (شرط الإرسال: always دائماً · on_steps فقط حين يطلب العميل خطوات أو شرحاً · never مرجع داخلي لا يُرسل) — اطلبه قبل تعديل مقال أو صوره.

الصلاحية المطلوبة لموظّف الربط: postsale.read

curl -X POST https://labeb.app/api/v1/tools/list_kb_articles \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"search":"…","limit":10}'

فجوات المعرفة: الأسئلة التي لم يعرف لَبيب جوابها، وكم تكرّرت، وما ردّ به، وهل عُلّم. status: pending ينتظر (الافتراضي) · answered عُلّم · ignored أُهمل. phase: pre قبل البيع · post بعد البيع. للتعليم أضِف الجواب بمقالٍ عبر create_kb_article.

الصلاحية المطلوبة لموظّف الربط: postsale.kb.view

curl -X POST https://labeb.app/api/v1/tools/list_knowledge_gaps \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"status":"pending","phase":"pre"}'

عملاء ما بعد البيع: التوزيع على الحالات + قائمة بالاسم والهاتف ودرجة الصحة والفئة والمسؤول.

الصلاحية المطلوبة لموظّف الربط: postsale.read

curl -X POST https://labeb.app/api/v1/tools/list_postsale_customers \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"status":"…","limit":10}'

صفقات العميل الإضافية بمجموعاتها واعتمادها، أو كل الصفقات بانتظار الاعتماد إذا ما مرّرت customerId.

الصلاحية المطلوبة لموظّف الربط: postsale.read.own

curl -X POST https://labeb.app/api/v1/tools/list_postsale_deals \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"customerId":"…"}'

وعود الفريق لعميل ما بعد البيع: ما وُعد به، وموعده، وهل أُنجز، ومصدره (manual يدوي · lead_journey من رحلة البيع · ai_detected_pending اقتراحٌ من المحادثة ينتظر التأكيد).

الصلاحية المطلوبة لموظّف الربط: postsale.read.own

curl -X POST https://labeb.app/api/v1/tools/list_postsale_promises \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"customerId":"…"}'

تذكرة دعم واحدة كاملة: العميل، العنوان، الحالة، الأولوية، المسؤول، مهلة الخدمة، الحلّ، ورسائلها (ردود العميل والفريق والملاحظات الداخلية) الأحدث آخراً.

الصلاحية المطلوبة لموظّف الربط: tickets.view.own

curl -X POST https://labeb.app/api/v1/tools/list_ticket_messages \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"ticketId":"…"}'

إدارة وعود العميل. action: add تسجيل وعد جديد (customerId + text + dueDate اختياري) · fulfill تعليمه منجزاً · unfulfill إلغاء الإنجاز · confirm تأكيد اقتراحٍ التقطه الذكاء · reject رفض الاقتراح · delete حذف وعدٍ خاطئ (promiseId من list_postsale_promises).

الصلاحية المطلوبة لموظّف الربط: postsale.update.own

curl -X POST https://labeb.app/api/v1/tools/manage_postsale_promises \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"action":"add"}'

نقل عميل محتمل إلى ما بعد البيع: يُنشئ له بطاقة عميل ما بعد البيع (أو يعيد القائمة إن وُجدت على رقمه) ويجدول خطوات التهيئة. إعلان الربح نفسه بباقته ومبلغه وإيصاله يتمّ من شاشة البطاقة ويُعتمد عبر decide_won.

الصلاحية المطلوبة لموظّف الربط: postsale.create

curl -X POST https://labeb.app/api/v1/tools/promote_lead_to_postsale \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"leadId":"…"}'

إغلاق فجوة معرفة (سؤال لم يعرف لَبيب جوابه — معرّفها من list_knowledge_gaps). action=answer: اكتب الجواب، ومع addToKb=true (الافتراضي) يُضاف لقاعدة المعرفة مقالاً جديداً (articleTitle/category اختياريّان) أو يُلحق بمقال قائم (targetArticleId). sendToCustomer=true يرسل الجواب للعميل صاحب السؤال (معطّل افتراضياً). action=ignore: ليست فجوة، مع السبب reason: chitchat دردشة · out_of_scope خارج النطاق · personal شخصي · duplicate مكرّر.

الصلاحية المطلوبة لموظّف الربط: postsale.kb.create

curl -X POST https://labeb.app/api/v1/tools/resolve_knowledge_gap \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"id":"…","action":"answer"}'

إعادة محاولة الأجزاء غير المكتملة من إعداد مجموعة عميل ما بعد البيع: إضافة الأشخاص أو ترقيتهم أو حفظ وصف الخدمة. لمجموعة قائمة لديها سجل تهيئة فقط؛ لا ينشئ مجموعة ولا يعيد الترحيب أو ملخص الرحلة.

الصلاحية المطلوبة لموظّف الربط: postsale.update.own

curl -X POST https://labeb.app/api/v1/tools/retry_post_sale_group_setup \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"customerId":"…"}'

إعادة محاولة إنشاء مجموعة الصفقة أو إكمال إعدادها.

الصلاحية المطلوبة لموظّف الربط: postsale.update.own

curl -X POST https://labeb.app/api/v1/tools/retry_postsale_deal_group \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"dealId":"…"}'

بحث دلالي في قاعدة المعرفة — نفس البحث الذي يستخدمه بوت الدعم. لكل نتيجة hasImages وimagesCount: هل للمقال صور يرسلها لَبيب وكم صورة (تفاصيلها بـ list_kb_articles مع includeContent).

الصلاحية المطلوبة لموظّف الربط: postsale.read

curl -X POST https://labeb.app/api/v1/tools/search_knowledge_base \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"query":"…"}'

تعديل مقال معرفة قائم (عنوان/محتوى/تصنيف/نشر) وصوره. لتعديل جزءٍ من المحتوى مرّر edits (find/replace) أو append بدل content الكامل؛ اقرأ النصّ أولاً بـ list_kb_articles مع includeContent. صور المقال (التي يرسلها لَبيب للعملاء) عبر media: action=add بـ url أو base64 (صورة JPG/PNG/WebP/GIF حتى 5 ميغابايت، تُحفظ برابط دائم) مع caption وsortOrder وsendCondition اختيارياً · action=update بـ imageId لتغيير caption أو sortOrder أو sendCondition · action=delete بـ imageId. sendCondition: always دائماً · on_steps فقط حين يطلب العميل خطوات أو شرحاً (الافتراضي) · never مرجع داخلي لا يُرسل. أيّ تعديلٍ فاشل ⇒ لا يُحفظ شيء.

الصلاحية المطلوبة لموظّف الربط: postsale.kb.update.all

curl -X POST https://labeb.app/api/v1/tools/update_kb_article \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"articleId":"…"}'

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

الصلاحية المطلوبة لموظّف الربط: postsale.settings.manage

curl -X POST https://labeb.app/api/v1/tools/update_post_sale_group_settings \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"createGroupOnWin":true,"groupDescriptionEnabled":true}'

تحديث عميل ما بعد البيع. action: update تعديل الحقول (الاسم، الرقم، المسؤول assigneeId أو clearAssignee، الحالة status: pending تهيئة · active نشط · churned مغادر مع reason، ملاحظات، الباقة، قيمة الاشتراك ودورته) · complete_step إكمال خطوة تهيئة (step: payment الدفع · subscription تمديد الاشتراك · plan اختيار الخطة) · set_responder مَن يردّ عليه (responder: ai لَبيب أو معرّف موظف — يُسند العميل والمحادثة معاً) · first_action تعليم إجراء من قائمة الأسبوع الأول (actionId + completed).

الصلاحية المطلوبة لموظّف الربط: postsale.update.own

curl -X POST https://labeb.app/api/v1/tools/update_postsale_customer \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"action":"update"}'

تعديل تذكرة دعم قائمة: العنوان، الوصف، التصنيف (categoryId)، الأولوية (low منخفضة · normal عادية · high عالية · critical حرجة). للحالة update_ticket_status وللمسؤول assign_ticket.

الصلاحية المطلوبة لموظّف الربط: tickets.update.own

curl -X POST https://labeb.app/api/v1/tools/update_ticket \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"ticketId":"…"}'

تغيير حالة تذكرة: in_progress | waiting_customer | testing | resolved | cancelled. مع resolved مرّر closureType: problem_solved (حُلّت مشكلة) أو inquiry_answered (ردّ على استفسار).

الصلاحية المطلوبة لموظّف الربط: tickets.update.all

curl -X POST https://labeb.app/api/v1/tools/update_ticket_status \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"ticketId":"…","status":"…"}'

إضافة تعليق على مهمة (توجيه أو استفسار) — يُشعَر المُسنَد إليه ومن تذكرهم في mentionUserIds (معرّفات من list_users). replyToId للردّ على تعليقٍ بعينه.

الصلاحية المطلوبة لموظّف الربط: tasks.task.update.own

curl -X POST https://labeb.app/api/v1/tools/add_task_comment \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"taskId":"…","content":"…"}'

إنشاء مهمة جديدة. استخدم list_users للحصول على assignedToUserId عند الإسناد.

الصلاحية المطلوبة لموظّف الربط: tasks.task.create

curl -X POST https://labeb.app/api/v1/tools/create_task \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"title":"…"}'

حذف مهمة (حذف ناعم).

الصلاحية المطلوبة لموظّف الربط: tasks.task.delete.all

curl -X POST https://labeb.app/api/v1/tools/delete_task \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"taskId":"…"}'

مؤشرات أداء الفريق لشهر: المهام المُسندة والمنجزة في وقتها والمتأخرة والمرفوضة ومتوسط زمن الإنجاز، باسم كل موظف.

الصلاحية المطلوبة لموظّف الربط: tasks.task.read.all

curl -X POST https://labeb.app/api/v1/tools/get_performance_metrics \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"year":10,"month":10}'

مهمة واحدة كاملة: الوصف ومعايير القبول والحالة والتقدّم والمُسنَد إليه والاستحقاق، مع نقاشها (التعليقات، الأحدث آخراً) وسجلّ أحداثها (من غيّر ماذا ومتى). يجيب «لماذا تأخّرت المهمة؟». من لا يملك «الكل» يرى مهامّه فقط.

الصلاحية المطلوبة لموظّف الربط: tasks.task.read.own

curl -X POST https://labeb.app/api/v1/tools/get_task_details \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"taskId":"…"}'

سجلّ الوقت المسجَّل على مهمة: كل جلسة عمل ببدايتها ونهايتها ومدّتها بالدقائق وصاحبها وملاحظتها، ومجموع الدقائق.

الصلاحية المطلوبة لموظّف الربط: tasks.task.read.own

curl -X POST https://labeb.app/api/v1/tools/get_task_time_entries \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"taskId":"…"}'

روابط اعتماد المهام (من يحجب من) — لكشف سلاسل التعطيل.

الصلاحية المطلوبة لموظّف الربط: tasks.task.read.own

curl -X POST https://labeb.app/api/v1/tools/list_task_dependencies \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"taskId":"…"}'

قائمة المهام مع فلاتر اختيارية. إن لم تملك صلاحية قراءة الكل تُعاد مهامك فقط.

الصلاحية المطلوبة لموظّف الربط: tasks.task.read.own

curl -X POST https://labeb.app/api/v1/tools/list_tasks \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"status":"…","onlyMine":true}'

ربط مهمة بأخرى تنتظرها (add) أو فكّ الربط (remove): المهمة taskId لا تبدأ قبل أن تنتهي blockedByTaskId. لعرض الاعتماديات القائمة: list_task_dependencies.

الصلاحية المطلوبة لموظّف الربط: tasks.task.update.own

curl -X POST https://labeb.app/api/v1/tools/set_task_dependency \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"taskId":"…","blockedByTaskId":"…","action":"add"}'

نقل مهمة إلى حالة: open | in_progress | submitted | approved | rejected | cancelled.

الصلاحية المطلوبة لموظّف الربط: tasks.task.update.own

curl -X POST https://labeb.app/api/v1/tools/set_task_status \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"taskId":"…","status":"…"}'

تشغيل عدّاد الوقت على مهمة (start) أو إيقافه (stop) للمستخدم نفسه، مع ملاحظة اختيارية.

الصلاحية المطلوبة لموظّف الربط: tasks.task.update.own

curl -X POST https://labeb.app/api/v1/tools/task_timer \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"taskId":"…","action":"start"}'

تعديل مهمة قائمة (العنوان/الوصف/الأولوية/الاستحقاق/الإسناد/الروابط).

الصلاحية المطلوبة لموظّف الربط: tasks.task.update.own

curl -X POST https://labeb.app/api/v1/tools/update_task \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"taskId":"…"}'

تحديث نسبة إنجاز مهمة من 0 إلى 100.

الصلاحية المطلوبة لموظّف الربط: tasks.task.update.own

curl -X POST https://labeb.app/api/v1/tools/update_task_progress \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"taskId":"…","progress":10}'

تفاصيل بطاقة تقنية بمفتاحها (key مثل WKD-59) أو عنوانها: الوصف والحالة والأولوية والنظام وعدد الطالبين + **كل** ملاحظات الفريق بكاتبها وتاريخها وإشاراتها (@) وروابط مرفقاتها + البطاقة الأمّ (إن كانت فرعية) + البطاقات الفرعية. العنوانُ يطابق تامّاً أولاً؛ وإن طابقت أكثر من بطاقة تعود القائمةُ (ambiguous) لتعيد النداء بالمفتاح.

الصلاحية المطلوبة لموظّف الربط: product.cards.view

curl -X POST https://labeb.app/api/v1/tools/get_product_card \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"key":"…","title":"…"}'

تقرير إدارة المنتج: توزّع البطاقات على الحالات والأولويّات والأنواع، وأقدمُ البطاقات العالقة، وحِمل كلّ مسؤول، وحال الإصدارات.

الصلاحية المطلوبة لموظّف الربط: product.cards.view

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/get_product_report \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

محفّزات البطاقات التقنية: رسالة تُرسل عند تحوّل حالة البطاقة أو عند إطلاق إصدار.

الصلاحية المطلوبة لموظّف الربط: product.cards.view

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/list_product_card_triggers \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

بطاقات المنتج (ميزات/أخطاء) مع الحالة والأولوية وعدد الطالبين — لتحليل أولويات التطوير.

الصلاحية المطلوبة لموظّف الربط: product.cards.view

curl -X POST https://labeb.app/api/v1/tools/list_product_cards \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"status":"…","cardType":"…"}'

بطاقات إصدار منتجٍ واحد، لكلٍّ عمودُها على اللوحة، مع قصٍّ مُعلَن (totalRows/shownRows).

الصلاحية المطلوبة لموظّف الربط: product.cards.view

curl -X POST https://labeb.app/api/v1/tools/list_release_cards \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"releaseId":"…"}'

آخر إصدارات النظام (ما الجديد) وبنودها.

الصلاحية المطلوبة لموظّف الربط: product.releases.view

curl -X POST https://labeb.app/api/v1/tools/list_releases \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"limit":10}'

إدارة إصدارات المنتج. action: create إنشاء (version + title، وdescription وplannedDate yyyy-MM-dd اختياريان) · update تعديل بياناته (releaseId) · set_status تغيير الحالة (status: planning تخطيط · in_progress قيد العمل · testing اختبار · released أُطلق — الإطلاق الكامل برسائل العملاء يتمّ من شاشة الإصدار بعد preview_release_launch).

الصلاحية المطلوبة لموظّف الربط: product.releases.update

curl -X POST https://labeb.app/api/v1/tools/manage_product_release \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"action":"create"}'

إضافة بطاقة فرعية تحت بطاقة أمّ — نفس نافذة «أضف بطاقة فرعية» في الشاشة. إلزامي: parentCardId (الأمّ) · title · assignedTo (المسؤول). اختياري: role · description · firstNote. role: study|backend|frontend|design|qa|other (الافتراضي other). الفرعية ترث من الأمّ النوع والأولوية والنظام والإصدار، وتبدأ «مقبولة» — أو «قيد العمل» إن كانت الأمّ على لوحة المطوّرين. firstNote تُسجَّل ملاحظةً داخلية أولى على الفرعية. البطاقة الفرعية لا تُفرَّع.

الصلاحية المطلوبة لموظّف الربط: product.cards.manage

curl -X POST https://labeb.app/api/v1/tools/pm_add_child_card \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"parentCardId":"…","title":"…","assignedTo":"…"}'

تعليق داخلي على بطاقة منتج (نقاش الفريق — لا يصل العميل).

الصلاحية المطلوبة لموظّف الربط: product.cards.manage

curl -X POST https://labeb.app/api/v1/tools/pm_add_comment \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"cardId":"…","text":"…"}'

إسناد بطاقة منتج لعضو فريق (أو إلغاء الإسناد بترك userId فارغاً). يُشعر المُسنَد إليه.

الصلاحية المطلوبة لموظّف الربط: product.cards.manage

curl -X POST https://labeb.app/api/v1/tools/pm_assign_card \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"cardId":"…"}'

ضمّ بطاقة منتج إلى إصدار.

الصلاحية المطلوبة لموظّف الربط: product.cards.manage

curl -X POST https://labeb.app/api/v1/tools/pm_assign_to_release \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"cardId":"…","releaseId":"…"}'

إنشاء بطاقة منتج (ميزة/خطأ/تحسين/اقتراح) بمصدر داخلي. استخدمها حين يطلب المستخدم تسجيل طلب تطوير أو خطأ. cardType: bug|feature|improvement|suggestion · priority: low|normal|high|critical.

الصلاحية المطلوبة لموظّف الربط: product.cards.create

curl -X POST https://labeb.app/api/v1/tools/pm_create_card \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"title":"…","cardType":"…"}'

حذف بطاقة منتج. **حذف ناعم**: تختفي من القوائم ويبقى أثرها وسجلّها للتدقيق، ولا تُفقد أوقاتُها المسجَّلة.

الصلاحية المطلوبة لموظّف الربط: product.cards.delete.all

curl -X POST https://labeb.app/api/v1/tools/pm_delete_card \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"cardId":"…"}'

سجلّ أوقات العمل على البطاقات بين تاريخين: الموظف والبطاقة والإصدار ونوع العمل والبداية والنهاية والمدة والملاحظة ومصدر الإدخال (يدويّ/مُعدَّل/أُغلق آلياً). from/to بصيغة ISO (اليوم كاملاً). employeeId/releaseId/categoryId فلاترٌ اختيارية.

الصلاحية المطلوبة لموظّف الربط: product.time.report.team

curl -X POST https://labeb.app/api/v1/tools/pm_list_time_entries \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"from":"…","to":"…"}'

طالبو بطاقة المنتج (من يصله إشعار إطلاقها). action: add ربط طالب (sourceType: customer عميل ما بعد البيع customerId · lead عميل محتمل leadId · internal موظف userId) · remove إزالة طالب (requesterId من get_product_card) · set_source تعديل صاحب البطاقة الأصلي (sourceType + المرجع).

الصلاحية المطلوبة لموظّف الربط: product.cards.manage

curl -X POST https://labeb.app/api/v1/tools/pm_manage_requesters \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"cardId":"…","action":"add"}'

سجلّات الوقت على بطاقات المنتج. action: add إضافة وقت يدوي (cardId + minutes، وnote وworkDate yyyy-MM-dd وstartTime HH:mm اختيارية) · edit تصحيح سجلّ (logId + minutes) · delete حذفه (logId). تعديل/حذف سجلّات غيرك يحتاج صلاحية «الكل». السجلّات من pm_list_time_entries.

الصلاحية المطلوبة لموظّف الربط: product.time.create

curl -X POST https://labeb.app/api/v1/tools/pm_manage_time_entry \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"action":"add"}'

دمج بطاقة منتج مكرّرة في الأصلية: تُعلَّم المكرّرة duplicate ويُنقل طالبوها إلى الأصلية فيصلهم إشعار إطلاقها.

الصلاحية المطلوبة لموظّف الربط: product.cards.manage

curl -X POST https://labeb.app/api/v1/tools/pm_merge_duplicate \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"cardId":"…","duplicateOfId":"…"}'

نقل بطاقة تقنية بين **أعمدة لوحة المطوّرين** بأسماء أعمدة الحساب نفسِها (مثل: لم تبدأ · قيد العمل · مراجعة ودمج · اختبار الجودة · تمت). استخدمها حين يطلب المستخدم نقل البطاقة إلى عمودٍ في لوحة التطوير. تحترم النقلات المسموحة، وتنقل الحالة العامّة تلقائياً (قيد التطوير، أو اختبار عند العمود الأخير).

الصلاحية المطلوبة لموظّف الربط: product.cards.devstate

curl -X POST https://labeb.app/api/v1/tools/pm_move_dev_state \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"cardId":"…","state":"…"}'

إخراج بطاقة من إصدارها. تعود البطاقة إلى مرحلتها قبل الضمّ (أو «مقبولة» إن لم يُعرف).

الصلاحية المطلوبة لموظّف الربط: product.cards.manage

curl -X POST https://labeb.app/api/v1/tools/pm_remove_from_release \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"cardId":"…"}'

رسالة من داخل بطاقة منتج: internal=true (الافتراضي) ملاحظة للفريق؛ internal=false تُرسَل للعملاء الطالبين للبطاقة على واتساب.

الصلاحية المطلوبة لموظّف الربط: product.cards.manage

curl -X POST https://labeb.app/api/v1/tools/pm_send_card_message \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"cardId":"…","content":"…"}'

بدء عدّاد الوقت على بطاقة منتج للمستخدم الحالي. إن كان له عدّاد شغّال على بطاقة أخرى **لا يُشغَّل شيء** وتعود started=false مع بيانات العدّاد الشغّال: اسأل المستخدم هل يلغي، أو يوقف الحالي ويشغّل الجديد (أعد النداء بـ stopRunning=true و note لما أُنجز).

الصلاحية المطلوبة لموظّف الربط: product.cards.manage

curl -X POST https://labeb.app/api/v1/tools/pm_start_timer \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"cardId":"…"}'

إيقاف عدّاد وقت المستخدم الحالي أياً كانت بطاقته، مع بيان ما أُنجز (اختياري).

الصلاحية المطلوبة لموظّف الربط: product.cards.manage

curl -X POST https://labeb.app/api/v1/tools/pm_stop_timer \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"note":"…"}'

تجميعُ أوقات العمل بين تاريخين: إجماليٌّ عامّ + حسب الإصدار + حسب الموظف. يُحسب على **كلّ** صفوف الفترة بلا قصّ. يميّز الدقائقَ المُدخلة يدوياً (تقديرٌ لا قياس).

الصلاحية المطلوبة لموظّف الربط: product.time.report.team

curl -X POST https://labeb.app/api/v1/tools/pm_time_summary \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"from":"…","to":"…"}'

مقارنة الوقت المسجّل على البطاقات بساعات الحضور لكل موظف خلال آخر days يوماً (افتراضياً 7): الحاضر، المسجّل، الفجوة، ونسبة التغطية. employeeId لموظف واحد.

الصلاحية المطلوبة لموظّف الربط: product.time.report.team

curl -X POST https://labeb.app/api/v1/tools/pm_time_vs_attendance \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"days":10,"employeeId":"…"}'

تعديل بطاقة منتج قائمة: العنوان/الوصف/النوع/الأولوية/النظام. الحقول غير المذكورة تبقى كما هي. cardType: bug|feature|improvement|suggestion · priority: low|normal|high|critical.

الصلاحية المطلوبة لموظّف الربط: product.cards.update.all

curl -X POST https://labeb.app/api/v1/tools/pm_update_card \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"cardId":"…"}'

نقل بطاقة منتج إلى مرحلة جديدة في **الحالة العامّة** (مسار مدير المنتج). **يُطلق رسالة التريغر للعملاء الطالبين** إن كان لتلك المرحلة تريغر فعّال. ⚠️ لا تغيّر عمود لوحة المطوّرين (لم تبدأ · قيد العمل · مراجعة…) — لذلك استخدم pm_move_dev_state. status: new|reviewing|accepted|rejected|in_release|in_progress|testing|done · reason إلزامي عند rejected.

الصلاحية المطلوبة لموظّف الربط: product.cards.manage

curl -X POST https://labeb.app/api/v1/tools/pm_update_card_status \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"cardId":"…","status":"…"}'

معاينة إطلاق إصدار قبل الموافقة: أيّ البطاقات ستُطلق، ومن سيصله إشعار الإطلاق من العملاء الطالبين وعلى أيّ قناة، ومن لن يصله ولماذا. قراءةٌ فقط.

الصلاحية المطلوبة لموظّف الربط: product.releases.update

curl -X POST https://labeb.app/api/v1/tools/preview_release_launch \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"releaseId":"…"}'

عدّادات إصدار منتجٍ واحد على أعمدة اللوحة كما يراها المستأجر (أعمدة لوحة المطوّر بأسمائها عنده)، مع فصل «تمّ التطوير» عن «تمّت ورُفعت للإصدار». مرّر نسخة الإصدار أو عنوانه في releaseId.

الصلاحية المطلوبة لموظّف الربط: product.cards.view

curl -X POST https://labeb.app/api/v1/tools/release_status_summary \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"releaseId":"…"}'

ردّ في نقاش ملاحظة تدريب.

الصلاحية المطلوبة لموظّف الربط: coaching.notes.update

curl -X POST https://labeb.app/api/v1/tools/add_coaching_note_message \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"noteId":"…","content":"…"}'

تسجيل حضوري أنا الآن (يتطلب أن يكون لحسابك سجل موظف). اقتبس الوقت من checkInAt في النتيجة حرفياً — ولا تذكر وقتاً غيره.

الصلاحية المطلوبة لموظّف الربط: hr.attendance.create.own

curl -X POST https://labeb.app/api/v1/tools/attendance_check_in \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"notes":"…"}'

تسجيل انصرافي أنا الآن. اقتبس الوقت من checkOutAt في النتيجة حرفياً — ولا تذكر وقتاً غيره.

الصلاحية المطلوبة لموظّف الربط: hr.attendance.create.own

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/attendance_check_out \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

تصحيح سجل حضور يوم سابق: وقت الدخول/الخروج (ISO مع الإزاحة، مثل 2026-10-20T09:00:00+03:00) والحالة (Present · Absent · Late · Remote) والملاحظات. الحقول غير المذكورة تبقى. يُدقَّق التعديل ويُرفض إن كان راتب الشهر معتمداً.

الصلاحية المطلوبة لموظّف الربط: hr.attendance.update.team

curl -X POST https://labeb.app/api/v1/tools/correct_attendance_record \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"attendanceId":"…"}'

كتابة ملاحظة تدريب (كوتشينغ) لموظف (assignedToUserId من list_users): العنوان والوصف وتوجيه المدير والأولوية (low · medium · high · critical)، مع ربط اختياري بمحادثة عميل.

الصلاحية المطلوبة لموظّف الربط: coaching.notes.create

curl -X POST https://labeb.app/api/v1/tools/create_coaching_note \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"assignedToUserId":"…","title":"…"}'

إضافة موظف جديد إلى سجل الموارد البشرية بلا حساب دخول (الاسم والهاتف مطلوبان؛ المنصب والقسم وتاريخ التعيين اختيارية). الراتب يُضبط من شاشة الرواتب.

الصلاحية المطلوبة لموظّف الربط: hr.employee.create

curl -X POST https://labeb.app/api/v1/tools/create_employee \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"fullName":"…","phone":"…"}'

البتّ في ملاحظة تدريب سلّمها الموظف: approve اعتمادها وإغلاقها (مع تعليق اختياري) أو send_back إعادتها له مع ملاحظة (مطلوبة).

الصلاحية المطلوبة لموظّف الربط: coaching.notes.update

curl -X POST https://labeb.app/api/v1/tools/decide_coaching_note \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"noteId":"…","decision":"approve"}'

الموافقة على طلب إجازة أو رفضه. استخدم get_leaves_report أولاً — يعيد id لكل طلب مع اسم صاحبه.

الصلاحية المطلوبة لموظّف الربط: hr.leave.approve.direct

curl -X POST https://labeb.app/api/v1/tools/decide_leave \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"leaveId":"…","approve":true}'

قبول عذر تأخير موظف في يومٍ بعينه: يُلغى وسم التأخير وخصمه مع سبب يُحفظ في السجل. يُرفض إن كان راتب الشهر معتمداً.

الصلاحية المطلوبة لموظّف الربط: hr.attendance.update.team

curl -X POST https://labeb.app/api/v1/tools/excuse_late_attendance \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"attendanceId":"…","reason":"…"}'

تقرير الحضور لفترة (الافتراضي 14 يوماً): حضور/غياب/تأخير لكل موظف.

الصلاحية المطلوبة لموظّف الربط: hr.attendance.read.all

curl -X POST https://labeb.app/api/v1/tools/get_attendance_report \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"days":10}'

نقاش ملاحظة تدريب بين المدير والموظف (الأقدم أولاً).

الصلاحية المطلوبة لموظّف الربط: coaching.notes.view

curl -X POST https://labeb.app/api/v1/tools/get_coaching_note_messages \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"noteId":"…"}'

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

الصلاحية المطلوبة لموظّف الربط: hr.attendance.read.team

curl -X POST https://labeb.app/api/v1/tools/get_employee_attendance \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"employee":"…"}'

تقرير حضور فريق موظف (من تحته في الخط الإداري) خلال فترة (الافتراضي 30 يوماً): ملخص الفريق + لكل عضو ملخصه وحالته اليوم + من لم يسجّل دخوله اليوم. بلا employee يعيد فريقك أنت. من يملك قراءة حضور الجميع يرى فريق أي مدير، وغيره يرى فريقه أو فريق مدير تحته فقط.

الصلاحية المطلوبة لموظّف الربط: hr.attendance.read.team

curl -X POST https://labeb.app/api/v1/tools/get_employee_team_attendance \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"employee":"…","days":10}'

حِمل كل موظف من المهام: المفتوحة والمتأخرة (استحقاقها قبل اليوم)، الأثقل أولاً. أساس «لمن أُسند هذه المهمة؟».

الصلاحية المطلوبة لموظّف الربط: hr.employee.read.all

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/get_employees_workload \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

أثر إجازة: ما سيتوقّف خلالها (متابعات · مواعيد · تذاكر مفتوحة · عملاء نشطون، مع أمثلة) — لمن يبتّ في الإجازات — وتقرير التسليم بعد النقل: البديل وما أُعيد وما تُخطّي وهل اطّلع العائد. صاحب الإجازة يرى تقرير تسليمه.

الصلاحية المطلوبة لموظّف الربط: hr.leave.read.own

curl -X POST https://labeb.app/api/v1/tools/get_leave_impact \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"leaveId":"…"}'

طلبات الإجازات (معلقة وموافَقة) ضمن فترة.

الصلاحية المطلوبة لموظّف الربط: hr.leave.read.all

curl -X POST https://labeb.app/api/v1/tools/get_leaves_report \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"days":10}'

سجل حضوري خلال فترة (الافتراضي 14 يوماً).

الصلاحية المطلوبة لموظّف الربط: hr.attendance.read.own

curl -X POST https://labeb.app/api/v1/tools/get_my_attendance \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"days":10}'

مَن في فريقي: الموظفون الذين أديرهم مباشرةً أو عبر الخطّ الإداري، بأسمائهم ومناصبهم.

الصلاحية المطلوبة لموظّف الربط: hr.employee.read.team

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/get_my_team \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

الهيكل الإداري: المناصب وشجرتها + الموظفون ومناصبهم ومدراؤهم المباشرون.

الصلاحية المطلوبة لموظّف الربط: hr.employee.read.all

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/get_org_chart \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

حضور فريقي خلال فترة (الافتراضي 14 يوماً): حضور وغياب وتأخير لكل فرد أديره.

الصلاحية المطلوبة لموظّف الربط: hr.attendance.read.team

curl -X POST https://labeb.app/api/v1/tools/get_team_attendance \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"days":10}'

البطاقة الوظيفية لموظف في فريقي بالاسم: المنصب والقسم وتاريخ التوظيف والمدير المباشر.

الصلاحية المطلوبة لموظّف الربط: hr.profile.read.team

curl -X POST https://labeb.app/api/v1/tools/get_team_member_profile \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"…"}'

طلبات تصحيح وقت الانصراف (status: pending معلّق · approved · rejected) ومن لم يسجّل انصرافه بعد. canReview: هل تستطيع البتّ فيه. كلٌّ يرى ما يخصّه أو فريقه بحسب صلاحيته.

الصلاحية المطلوبة لموظّف الربط: hr.attendance.create.own

curl -X POST https://labeb.app/api/v1/tools/list_checkout_requests \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"employeeId":"…","status":"pending"}'

ملاحظات التدريب (الكوتشينغ) للموظفين: العنوان والأولوية والحالة والمُسنَد إليه.

الصلاحية المطلوبة لموظّف الربط: coaching.notes.view

curl -X POST https://labeb.app/api/v1/tools/list_coaching_notes \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"status":"…","limit":10}'

قائمة الموظفين: id (معرّف الموظف)، userId (معرّف المستخدم — هذا ما تطلبه أدوات الإسناد)، الاسم، المنصب، القسم، الحالة.

الصلاحية المطلوبة لموظّف الربط: hr.employee.read.all

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/list_employees \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

العطل الرسمية المُعلنة (التاريخ والاسم والسبب) لسنة (افتراضياً كلّها).

الصلاحية المطلوبة لموظّف الربط: hr.attendance.read.own

curl -X POST https://labeb.app/api/v1/tools/list_holidays \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"year":10}'

تظلّمات الرواتب: الموضوع والحالة ومن فتحها ومتى روجعت.

الصلاحية المطلوبة لموظّف الربط: payroll.grievance.review

curl -X POST https://labeb.app/api/v1/tools/list_payroll_grievances \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"status":"…","limit":10}'

دورات الرواتب: الفترة والحالة واعتمادات المدير والموارد البشرية وحاجة إعادة الاحتساب.

الصلاحية المطلوبة لموظّف الربط: payroll.run.read

بلا وسائط — أرسل {}.

curl -X POST https://labeb.app/api/v1/tools/list_payroll_runs \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{}'

تسجيل حضور موظف آخر بالنيابة عنه اليوم (للمدير أو الموارد البشرية): action واحدة من present حاضر · late متأخر · absent غائب · remote عن بعد · check_out انصراف الآن. employee بالاسم أو المعرّف.

الصلاحية المطلوبة لموظّف الربط: hr.attendance.update.all

curl -X POST https://labeb.app/api/v1/tools/mark_employee_attendance \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"employee":"…","action":"present"}'

نقل عمل الموظف المُجاز إلى زميل طوال الإجازة: بطاقات العملاء (ومتابعاتها) والمواعيد والتذاكر — كلٌّ اختياري (افتراضياً الكل). يُرجَع ما لم يمسّه البديل تلقائياً عند انتهاء الإجازة. approve: true يعتمد الإجازة في الخطوة نفسها.

الصلاحية المطلوبة لموظّف الربط: hr.leave.approve.direct

curl -X POST https://labeb.app/api/v1/tools/reassign_leave_tasks \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"leaveId":"…","toUserId":"…"}'

تقديم طلب إجازة لي: النوع (annual|sick|unpaid|other) وتاريخا البداية والنهاية.

الصلاحية المطلوبة لموظّف الربط: hr.leave.request.own

curl -X POST https://labeb.app/api/v1/tools/request_leave \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"leaveType":"…","startDate":"…","endDate":"…"}'

قبول أو رفض طلب تصحيح وقت الانصراف (approve: true يقبل) مع سبب. لموظفي فريقك أو للكل بحسب صلاحيتك.

الصلاحية المطلوبة لموظّف الربط: hr.attendance.update.team

curl -X POST https://labeb.app/api/v1/tools/review_checkout_request \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"requestId":"…","approve":true}'

تعديل بيانات موظف: الاسم والهاتف والبريد والمنصب والقسم والمدير المباشر (directManagerUserId — معرّف مستخدم؛ "none" للإزالة) أو إدراجه في منصبٍ من الهيكل (positionId). postSaleOwnGroupMode: inherit السلوك السابق، off لا يضاف لعملائه، member عضو، admin مشرف. الراتب والحالة لا يتغيّران هنا.

الصلاحية المطلوبة لموظّف الربط: hr.employee.update.all

curl -X POST https://labeb.app/api/v1/tools/update_employee \
  -H "Authorization: Bearer wkm_…" \
  -H "Content-Type: application/json" \
  -d '{"employeeId":"…"}'

إعلان عطلة رسمية (تاريخ واسم وسبب)، أو تعديلها بتمرير holidayId. اليوم المُعلن لا يُحسب غياباً.

الصلاحية المطلوبة لموظّف الربط: hr.attendance.update.all