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

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

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

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.manage

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":"…"}'

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

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

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

إقفال تذكير متابعة بـ«تمّت المتابعة» بعد أن تواصل الموظف فعلاً. للتذكيرات الداخلية لا لرسائل القناة.

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

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 · won · lost)، مع نسبة التحويل وأسباب الخسارة وتكلفة العميل وتكلفة الصفقة من إنفاق الحملة.

الصلاحية المطلوبة لموظّف الربط: 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":"…"}'

تقرير العملاء المحتملين: توزيعهم على المراحل + الجدد خلال فترة + آخر العملاء. days الافتراضي 30.

الصلاحية المطلوبة لموظّف الربط: 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}'

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

الصلاحية المطلوبة لموظّف الربط: 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.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.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.manage

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

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

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

الصلاحية المطلوبة لموظّف الربط: 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}'

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

الصلاحية المطلوبة لموظّف الربط: 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.manage

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.manage

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":"…"}'

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

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

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

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

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

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

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

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

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

إنشاء قالب واتساب رسمي وإرساله لمراجعة ميتا. 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.instance.manage

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.instance.manage

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

إعدادات وكيل المواعيد: التفعيل، المدة، القوالب، كلمات الكشف.

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

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

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

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

الصلاحية المطلوبة لموظّف الربط: 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}'

رسائل محادثة واتساب لرقم محدد أو لمجموعة (الأحدث أولاً) — للتحليل العميق للمحادثة: الاتجاه والنص والوقت. للمجموعة مرّر معرّفها الكامل (…@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":"…"}'

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

الصلاحية المطلوبة لموظّف الربط: 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.instance.manage

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 يوماً) مع الحالة والعميل.

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

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

محادثات واتساب الخاصة مع فلاتر: نافذة زمنية بتوقيت الحساب (period أو fromDate/toDate)، ومرحلة العميل (stage)، والقناة باسمها أو رقمها (channel)، وunanswered للمحادثات التي آخر رسالة فيها من العميل ولم يُردّ عليها. لكل محادثة: الرقم والاسم والمرحلة والقناة وعدد الرسائل في النافذة وآخر رسالة ومن أرسلها وهل تنتظر ردّاً، مع العدد الكلي المطابق. نقطة البداية لتحليل المحادثات.

الصلاحية المطلوبة لموظّف الربط: 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 والاسم وعدد الرسائل وآخر نشاط، مرتبة بالأحدث نشاطاً. هذا المعرف هو ما يوضع في حقل phone عند send_whatsapp_message أو send_whatsapp_media للإرسال إلى مجموعة. الحساب قد يكون في مئات المجموعات، فمرر query بجزء من اسم المجموعة للبحث عنها بالاسم بدل تصفح الأحدث. ومع period أو fromDate/toDate تعيد فقط المجموعات التي تحرّكت في تلك الفترة مع عدد رسائلها فيها وآخر رسالة ومن أرسلها (لَبيب · موظّف · رقم المشارك) — لسؤال «أيّ مجموعات تحرّكت اليوم». ولقراءة رسائل مجموعة مرّر معرّفها إلى get_whatsapp_conversation. limit الافتراضي 20 وأقصاه 50.

الصلاحية المطلوبة لموظّف الربط: 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":"…","period":"…"}'

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

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

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

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.manage

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

إرسال ملف أو صورة أو مستند عبر واتساب إلى رقم أو إلى مجموعة — وللمجموعة مرر معرفها الكامل بصيغة @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":"…"}'

إرسال رسالة واتساب نصية إلى رقم أو إلى مجموعة. للرقم: أرقام فقط مع رمز الدولة بلا + ولا مسافات. وللمجموعة: مرر معرفها الكامل في نفس حقل 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":"…"}'

تعديل إعدادات المواعيد: تفعيل/مدة/أقصى أيام/قوالب الرسائل.

الصلاحية المطلوبة لموظّف الربط: appointments.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,"durationMinutes":10}'

رفع ملف مرة واحدة إلى النظام وأخذ معرف قصير له، ثم إرساله لأي عدد من الأرقام بـ 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":"…"}'

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

الصلاحية المطلوبة لموظّف الربط: quality.ticket.assign

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

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

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

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

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

الصلاحية المطلوبة لموظّف الربط: quality.ticket.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

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

تقرير تذاكر الدعم: توزيع الحالات + أحدث التذاكر المفتوحة.

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

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

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

قائمة مقالات قاعدة المعرفة (منشورة ومسودات) مع التصنيف.

الصلاحية المطلوبة لموظّف الربط: 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}'

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

الصلاحية المطلوبة لموظّف الربط: 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}'

بحث دلالي في قاعدة المعرفة — نفس البحث الذي يستخدمه بوت الدعم.

الصلاحية المطلوبة لموظّف الربط: 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":"…"}'

تعديل مقال معرفة قائم (عنوان/محتوى/تصنيف/نشر).

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

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

تغيير حالة تذكرة: in_progress | waiting_customer | testing | resolved | cancelled.

الصلاحية المطلوبة لموظّف الربط: quality.ticket.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":"…"}'

إنشاء مهمة جديدة. استخدم 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/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}'

نقل مهمة إلى حالة: 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":"…"}'

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

الصلاحية المطلوبة لموظّف الربط: 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":"…"}'

تفاصيل بطاقة تقنية بعنوانها: الوصف والحالة والأولوية والنظام وعدد الطالبين + آخر التعليقات.

الصلاحية المطلوبة لموظّف الربط: 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 '{"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}'

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

الصلاحية المطلوبة لموظّف الربط: 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

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":"…"}'

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

الصلاحية المطلوبة لموظّف الربط: 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":"…"}'

بدء عدّاد الوقت على بطاقة منتج للمستخدم الحالي — يوقف عدّاده الجاري (إن وُجد) تلقائياً.

الصلاحية المطلوبة لموظّف الربط: 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":"…"}'

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

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

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

نقل بطاقة منتج إلى مرحلة جديدة. **يُطلق رسالة التريغر للعملاء الطالبين** إن كان لتلك المرحلة تريغر فعّال. 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":"…"}'

عدّادات إصدار منتجٍ واحد على أعمدة اللوحة كما يراها المستأجر (أعمدة لوحة المطوّر بأسمائها عنده)، مع فصل «تمّ التطوير» عن «تمّت ورُفعت للإصدار». مرّر نسخة الإصدار أو عنوانه في 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":"…"}'

تسجيل حضوري أنا الآن (يتطلب أن يكون لحسابك سجل موظف). اقتبس الوقت من 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 '{}'

الموافقة على طلب إجازة أو رفضه. استخدم 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}'

تقرير الحضور لفترة (الافتراضي 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}'

تقرير حضور موظف واحد بالاسم أو المعرّف خلال فترة (الافتراضي 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.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":"…"}'

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

الصلاحية المطلوبة لموظّف الربط: 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 '{}'

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

الصلاحية المطلوبة لموظّف الربط: 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"}'

تقديم طلب إجازة لي: النوع (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":"…"}'

إنشاء هدف شهري مرتبط بهدف سنوي (استخدم list_annual_goals للحصول على annualObjectiveId).

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

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

إنشاء مشروع جديد، مع ربط اختياري بأهداف سنوية/شهرية.

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

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

حذف هدف شهري.

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

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

حذف مشروع.

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

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

الأهداف السنوية (الاستراتيجية) مع حالتها وتقدمها.

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

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

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

تعليقات الأهداف (سنوية/شهرية) — للاطلاع على نقاش الفريق حول هدف.

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

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

الأهداف الشهرية (التشغيلية) لشهر محدد مع KPI والتقدم. الافتراضي الشهر الحالي.

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

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

المشاريع مع الحالة والتقدم والصحة وعدد المهام.

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

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

الركائز الاستراتيجية للشركة — الإطار الذي تُنسب إليه الأهداف والمخاطر.

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

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

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

سجلّ المخاطر الاستراتيجية مرتّباً بدرجة الخطورة: الاحتمال والأثر والحالة وخطة التخفيف.

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

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

تعديل هدف شهري (عنوان/وصف/حالة/KPI). الحقول غير المذكورة تبقى كما هي.

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

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

تعديل مشروع (عنوان/وصف/حالة/أولوية/استحقاق). الحقول غير المذكورة تبقى.

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

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

تفاصيل وكيل ذكاء واحد بما فيها البرومبت الكامل — للمراجعة أو التحسين.

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

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

ملفّ الشركة (النشاط · المنتجات · الجمهور · النبرة · اللهجة · السياسات · الباقات · الأسئلة الشائعة …) مع **قائمة الحقول الناقصة** و**هل يصل الملفّ للبوت فعلاً** أم يحجبه برومبتٌ يدويّ. ابدأ بها قبل أي نصيحة عن ردود البوت: برومبتٌ ضعيف سببه غالباً ملفٌّ ناقص لا قالبٌ خاطئ.

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

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

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

وكلاء الذكاء القابلون للضبط في الشركة (المبيعات، ما بعد البيع...) مع النموذج والحالة.

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

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

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

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

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

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

اختبار برومبت وكيل: أرسل رسالة عميل تجريبية واحصل على ردّ الوكيل الفعلي (يُخصم من رصيد الذكاء).

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

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

تعديل وكيل ذكاء: البرومبت أو النموذج أو الإعدادات أو التفعيل. يسري فوراً على ردود البوت.

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

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

تعديل جزئيّ لملفّ الشركة ثم **إعادة بناء برومبت الوكلاء المبنيّين منه تلقائياً**. مرّر الحقول التي تريد تغييرها فقط؛ الحقل غير المُمرَّر لا يُلمس، والقيمة الفارغة تفريغٌ صريح. الوكيل ذو البرومبت اليدويّ لا يتأثّر (تُعاد نتيجةُ الأداة بذلك صراحةً).

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

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

يعتمد مسودة محاكاة مكتملة برومبتا محفوظا للموظف لبيب عبر مسار الحفظ الرسمي (نسخة احتياطية + سجل نسخ). لا تستعملها إلا بعد أن يرى المستخدم النتيجة ويوافق صراحة.

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

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

تقدير محاكاة برومبت لبيب قبل بدئها: كم دورا حقيقيا في النطاق (range: today اليوم · yesterday أمس · 7d آخر 7 أيام · 24h · 48h · custom مع fromDate/toDate بساعة الحساب) أو في محادثات بعينها (threadKeys من list_labeeb_prompt_simulation_conversations) سيعاد، كم نداء ذكاء، وكم ستكلف من رصيد الذكاء الاصطناعي للحساب وهل الرصيد يكفي. اقرأ البرومبت الحالي أولا بـ get_ai_agent (sales) واكتب المسودة كاملة في draftPrompt. لا تكلف شيئا.

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

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

نتيجة محاكاة برومبت لبيب: الحالة والتقدم، عدد الردود التي تحسنت أو ساءت أو بقيت، متوسط درجة الرد القديم مقابل الجديد، التكلفة الفعلية، ولكل دور رسالة العميل والرد القديم (before) والرد الجديد (after) ودرجتاهما وسبب المحكم. بلا id تعيد آخر المحاكاات.

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

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

تقرير لبيب لفترة (days الافتراضي 1 = اليوم، حتى 31): عدد المحادثات والردود والتحويلات للموظفين والمتابعات والمواعيد، التوزيع اليومي، ما يحتاج انتباهاً، المحادثات المنتظرة، الأسئلة التي لم يعرف جوابها، وزمن الاستجابة. channel اختياري: whatsapp · messenger · website.

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

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

إعدادات الموظف لبيب كاملة: persona هويته (الاسم والنبرة واللهجة وطول الرد والإفصاح والإيموجي) · selling أسلوب البيع · limits حدود المتابعة · handoff قواعد التحويل للبشر · powers قدراته المفعلة · trial إعدادات التجربة · model نموذج الذكاء المستعمل · branches الفروع · rules قواعد رحلة العميل. بلا section تعيد الأقسام القياسية، والفروع والقواعد تقرأ بقسمها صراحة لأنها قد تكون مئات الصفوف. وترد مع كل حقل قيمه المسموحة.

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

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

تقرير جودة المحادثات (تدقيق البوت): درجات المحادثات، النتائج، مستوى الإحباط، الأسئلة المكررة، أبطأ استجابة.

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

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

ساعات عمل الشركة والمنطقة الزمنية وإعدادات المواعيد — مرجع لأي تحليل عن زمن الاستجابة.

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

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

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

قواعد الأتمتة/التحويل المفعّلة: الاسم والنطاق والحالة والأولوية ومنطق المطابقة — لفهم «لماذا تصرّف النظام هكذا».

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

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

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

المحادثات التي رد عليها لبيب في نطاق زمني (range: today · yesterday · 7d · 24h · 48h · custom مع fromDate/toDate) مع اسم العميل إن عُرف وعدد الأدوار وآخر رسالة — لتختار منها محادثة أو أكثر تمررها في threadKeys لمحاكاة البرومبت عليها بعينها. query للبحث بالاسم أو الرقم.

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

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

اشتراكات التقرير الأسبوعي: من يستلم أي نطاق وهل اشتراكه مفعّل.

الصلاحية المطلوبة لموظّف الربط: reports.weekly.subscribe

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

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

التقارير الأسبوعية المولَّدة: النطاق والأسبوع ومتى قُرئت.

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

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

يبدأ محاكاة حقيقية لمسودة برومبت لبيب: يعيد توليد رد لبيب على محادثات العملاء الحقيقية في النطاق (range اليوم/أمس/7d/24h/48h/custom) أو في محادثات بعينها (threadKeys) بالمسودة عبر نفس مسار الإنتاج، ويقارن كل رد جديد بالرد الذي وصل العميل فعلا بمحكم أعمى. **تكلف من رصيد الذكاء الاصطناعي للحساب** — قدرها أولا بـ estimate_labeeb_prompt_simulation وأخبر المستخدم بالتكلفة قبل البدء. لا تحفظ المسودة ولا ترسل شيئا للعملاء. تعمل في الخلفية دقائق؛ اقرأ النتيجة بـ get_labeeb_prompt_simulation.

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

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

تعديل إعدادات لبيب: مرر section وvalues بالحقول المراد تغييرها فقط — وما لا ترسله لا يمس. persona: displayName tone dialect replyLength disclosure emojiLevel. selling: priceTiming questionDensity. limits: fuMaxPerLead fuQuietStartHour fuQuietEndHour fuRespectOptOut fuSkipWhenAssigned. handoff: يلزمه situation ثم isEnabled assignConversation assigneeUserIds assigneeUserIdsPostSale sendReassurance reassuranceText cooldownMinutes dailyCap slaMinutes slaEscalateToUserIds. powers: يلزمه toolKey وisEnabled. trial: replyTriggerEnabled replyTriggerMsgCount successStage successAssign successAssigneeIds. model: modelKey من الكتالوج. branches: بلا id ينشئ فرعا ومعه id يعدله، وحقوله name city phone address workingHours mapsUrl isActive sortOrder notes، والحذف بتمرير id مع delete صواب. rules: بلا id ينشئ قاعدة وتولد بوضع مراقبة ما لم تمرر mode بقيمة active، وحقولها name outcome targetStage fromStage detectDescription examplePhrases counterExamplePhrases priority isActive stopFollowUps sendFarewell successAssign successAssigneeIds، والحذف بتمرير id مع delete صواب. اقرأ الإعدادات أولا لترى القيم المسموحة.

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

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

ابحث عن أدوات إضافية في النظام بالعربية حين لا تجد بين أدواتك الحالية ما ينجز الطلب (ما بعد البيع، الرواتب، المنتجات، قواعد الأتمتة، الفرص، الأداء، الهيكل الإداري…). الأدوات المطابقة **تُتاح لك فوراً** فاستدعِها في ردّك التالي. لا تستدعِها إن كانت أدواتك الحالية تكفي.

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

تقرير المستشار عن نفسه خلال فترة: عدد الطلبات وأزمنتها وتكلفتها، الأدوات التي فشلت ولماذا، حالات المهام، ونسبة الملاحظات التي وسمها المستخدم «غير دقيقة» (مقياس دقّتي الفعلي).

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

تقرير استهلاك الذكاء الاصطناعي للشركة خلال فترة: الإجمالي وبحسب الوكيل. days الافتراضي 30.

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

أكثر شاشات النظام فتحاً في مؤسستي خلال فترة (الافتراضي 30 يوماً): المسار وعدد الفتحات وعدد المستخدمين المختلفين وآخر مرّة.

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

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

نظرة عامة على وضع المستخدم الآن: عدّادات الأهداف السنوية والشهرية والمشاريع النشطة ومهامه المفتوحة، مع التاريخ الحالي.

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

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

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

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

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

احفظ حقيقة أو قراراً أو تفضيلاً **دائماً** عن المستخدم أو الشركة ذكره في المحادثة وسينفع في محادثات قادمة (مثل: «قرّرنا تأجيل كذا»، «أحمد يفضّل التقارير مختصرة»). لا تحفظ تفاصيل عابرة ولا أرقاماً متغيّرة ولا ما يمكن قراءته بالأدوات. جملة واحدة موجزة.

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