إصلاح وصول الوكلاء: مفاتيح API وروابط الموصل والويب هوك والموافقات
جارٍ تحميل حالة التقدم…
المفتاح ضاع أو ما يشتغل؟ افتح الإعدادات > وصول الوكلاء، فعّل الوصول (للمالك)، ثم أصدر المفتاح أو دوّره أو أبطله. المفتاح الكامل يظهر مرة واحدة.
النتيجة
يتصل وكيل الذكاء الاصطناعي بمفتاح أو رابط يعمل، وترى ما قام به، وتُعالَج الإجراءات التي تحتاج موافقة.
آخر مراجعة
2026-10-24 · Support
قبل أن تبدأ
- دور مالك أو مشرف. المالك فقط يفعّل وصول الوكلاء ويوافق على الإفصاح ويشتري الأرصدة.
افتح مساحة العمل الصحيحة
- 1سجّل الدخول وافتح لوحة التحكم.
- 2اختر الإعدادات، ثم اضغط زر وصول الوكلاء بجانب تبويبات الإعدادات (هو زر وليس تبويباً).
- 3إذا كان دورك للعرض فقط فستظهر رسالة «وصول الوكلاء غير متاح لدورك»؛ اطلب من المالك.
أصلح المفتاح أو الرابط أو الموافقة
- 1المالك: إذا كان الوصول معطّلاً فاضغط تفعيل وصول الوكيل، وحدّد «أفهم وأوافق على تفعيل وصول الوكيل» ثم أكّد. لن يعمل ما يلي قبل أن يصبح مفعّلاً.
- 2ضمن عملاء الوكلاء المتصلين افتح العميل (أو اضغط عميل جديد) ثم إصدار مفتاح جديد. ضمن «ماذا تريد أن تصدر» اختر مفتاح API (لـ Claude Code وCodex والأدوات التي ترسل ترويسة Authorization) أو رابط موصل (لـ Claude Cowork وموصلات claude.ai المخصصة)، واختر اختياراً سريعاً مثل القراءة فقط، ثم اضغط إصدار المفتاح.
- 3انسخ المفتاح أو الرابط فوراً من «انسخ هذا المفتاح الآن» ثم اضغط «تم، لقد حفظته». يظهر مرة واحدة فقط ولا تستطيع Mawidi عرضه مجدداً؛ إن ضاع فأصدر مفتاحاً جديداً وأبطل القديم.
- 4لتغيير مفتاح اضغط تدوير واختر «إبقاء المفتاح القديم يعمل لمدة 7 أيام» للتغيير الاعتيادي، أو «إيقاف المفتاح القديم الآن» إذا تسرّب (أو اضغط إبطال وهو فوري ولا يمكن التراجع عنه). التدوير يقلّص الصلاحيات فقط؛ أصدر مفتاحاً جديداً لتوسيعها.
- 5الموافقات: اضغط «مراجعة الإجراءات التي تنتظر موافقتك» (تظهر شارة صغيرة بعددها عند وجود إجراءات منتظرة)، واقرأ «ما الذي سيحدث»، ثم «الموافقة والتنفيذ» أو «رفض». يستطيع المالك والمشرف الموافقة؛ والإجراءات المالية تحتاج المالك مع تأكيد الهوية.
ويب هوك الوكيل والأرصدة وقراءة النصوص (هذه الشاشة فقط)
- 1ويب هوك الوكيل موجود في الإعدادات > وصول الوكلاء داخل كل عميل: افتح العميل وابحث عن بطاقة الويب هوك الصادر. يرسل تحديثات الحجوزات وإلغاءاتها إلى عنوان HTTPS الخاص بك. أما ويب هوك Zapier وMake وجداول Google وأحداث الطلبات فهو نظام آخر ضمن الإعدادات > التكاملات (راجع دليل الويب هوك الصادر).
- 2إضافة نقطة استقبال: أدخل عنوان https:// بدون اسم مستخدم أو كلمة مرور أو معاملات استعلام، واختر تحديث حجز و/أو إلغاء حجز، واضغط إنشاء نقطة استقبال، وانسخ مفتاح التوقيع من «انسخ مفتاح التوقيع الآن». يظهر مرة واحدة؛ استخدمه للتحقق من ترويسة X-Mawidi-Signature، واضغط تدوير المفتاح إن ضاع.
- 3حالة «متوقفة بعد إخفاقات متكررة» تعني أن نظامك المستقبِل كان يفشل باستمرار: أصلح نظامك أولاً ثم اضغط استئناف. تبقى أزرار الإيقاف المؤقت وتدوير المفتاح والحذف متاحة حتى لو كان وصول الوكلاء معطّلاً.
- 4الأرصدة: تعرض بطاقة أرصدة الوكيل الأرصدة المتاحة، وللمالك زر شراء أرصدة لكل باقة (تُفتح صفحة دفع Stripe). تظهر البطاقة فقط عندما يكون شراء الأرصدة متاحاً لحسابك. تُخصم الأرصدة عند تنفيذ الإجراء لا أثناء انتظاره الموافقة.
- 5إذا ظهر تنبيه «تغيّر إفصاح وصول الوكلاء» فعلى المالك الضغط على مراجعة النص والموافقة ثم أوافق على النص المحدّث. حتى ذلك الحين تبقى المفاتيح الحالية تعمل لكن لا يمكن إصدار إلا مفاتيح للقراءة فقط.
- 6قراءة النصوص: حيث تعرض حسابك بطاقة مساعد الذكاء الاصطناعي في المتصفح، فالمالك وحده يفعّل قراءة نصوص المحادثات (حدّد الموافقة ثم اضغط تفعيل قراءة نصوص المحادثات)، ويستطيع المالك أو المشرف إيقافها. هي معطّلة افتراضياً.
تحقق قبل التواصل مع الدعم
- 1دوّن الصفحة (وصول الوكلاء أو عميل أو الويب هوك الصادر أو المراجعات) ونص الرسالة كما ظهر والوقت واسم العميل واسم المفتاح أو آخر أحرفه الظاهرة في عمود المفتاح. لا ترسل المفتاح الكامل أو الرابط أو مفتاح التوقيع أبداً.
كيف تعرف أنه نجح
- • يظهر العميل نشطاً، وحفظ الوكيل المفتاح أو الرابط، ويتحدّث وقت آخر استخدام.
إذا حدثت مشكلة
- ضاع المفتاح أو أغلقت نافذة «انسخ هذا المفتاح الآن»: لا يظهر المفتاح الكامل مرة أخرى؛ أصدر مفتاحاً جديداً ضمن العميل، وحدّث الوكيل، ثم أبطل المفتاح القديم.
- الوكيل كان يعمل وفجأة وقف: افحص حالة العميل. إذا كانت معلّق (يحدث لكل العملاء عند إيقاف وصول الوكلاء) فيعيد المالك تفعيل الوصول ثم يضغط إعادة تفعيل على العميل؛ إعادة تفعيل الوصول لا تعيد العملاء المعلّقين تلقائياً.
- رابط الموصل يظهر «متوقف (غير مستخدم منذ 30 يومًا)»: الرابط الذي لا يُستخدم لمدة 30 يوماً يتوقف عن العمل؛ أصدر رابط موصل جديداً وأعطه للمساعد.
- «إنشاء مفتاح أو استبداله يتطلب منك تأكيد هويتك مرة أخرى»: أعد المحاولة وأكمل خطوة التحقق.
- «إصدار مفتاح يستطيع تعديل البيانات أو يحتاج إلى موافقات يتطلب أولًا أن يوافق المالك على الإفصاح المحدّث»: يضغط المالك مراجعة النص والموافقة في التنبيه؛ ويمكن إصدار مفاتيح القراءة فقط في الأثناء.
- «وصل هذا العميل إلى الحد الأقصى ... مفاتيح نشطة» أو «الحد الأقصى لعدد عملاء الوكلاء»: أبطل مفتاحاً لا تستخدمه أو أعد استخدام عميل موجود؛ رفع حد العملاء يتم من فريق Mawidi، فأرسل الصفحة والرسالة في تذكرة دعم.
- «وصول الوكلاء غير متاح للشركات الجديدة حاليًا»: فريق Mawidi وحده يفتح الوصول لشركتك؛ أرسل تذكرة دعم باسم شركتك وهذه الرسالة.
- ويب هوك الوكيل يظهر «متوقفة بعد إخفاقات متكررة» أو يرتفع عدد الإخفاقات المتتالية: تأكد أن عنوانك يردّ باستجابة ناجحة ثم اضغط استئناف؛ وإذا كان العنوان خاطئاً فاحذفه وأضف الصحيح.
- أخطاء مثل «لم يُقبل هذا الرابط» (يجب أن يبدأ بـ https:// وبلا معاملات استعلام ولا عنوان داخلي): استخدم عنواناً عاماً بـ https بدون اسم مستخدم أو كلمة مرور أو ? أو #؛ ويُسمح فقط بمنفذ HTTPS الافتراضي أو 8443.
- فشلت الموافقة برسالة «لا يمكن تنفيذ هذا الإجراء الآن. لا يزال الطلب بالانتظار»: يبقى في القائمة تحت «بالانتظار» فأعد «الموافقة والتنفيذ» لاحقاً؛ أما «الموافقة على الإجراءات المالية متاحة لمالك المؤسسة فقط» فاطلب من المالك.
- لا يظهر زر شراء أرصدة: شراء الأرصدة غير متاح لحسابك، أو لست المالك، أو وصول الوكلاء معطّل؛ وإذا ظهرت عملية شراء «بانتظار الدفع» فتظهر الأرصدة بعد تأكيد Stripe.