الوثائق / Workspace

Amargi Workspace

Amargi Workspace هي طبقة الهوية الموحّدة والمُشغّل لعائلة منتجات Amargi. كل منتج (Reach وAgents وEscalate وMail وMeet وRemote) يستخدم Workspace لمصادقة المستخدمين وإصدار الرموز والفتح بنقرة واحدة.

آخر تحديث: 2026-05-17

نظرة عامة

Amargi Workspace هي طبقة الهوية الموحّدة والمُشغّل لعائلة منتجات Amargi. كل منتج (Reach وAgents وEscalate وMail وMeet وRemote) يستخدم Workspace لـ:

مصادقة المستخدمين (البريد الإلكتروني وكلمة المرور، مع 2FA اختياري).
إصدار رموز JWT يستهلكها كل منتج.
إدارة عضوية المؤسسات والأدوار.
توفير المُشغّل الذي يفتح كل منتج بنقرة واحدة.

يخزّن Workspace فقط بيانات الهوية (البريد، تجزئة كلمة المرور، 2FA، الجلسات، عضوية المؤسسة). لا يخزّن أي بيانات منتج (رسائل WhatsApp، تذاكر، تشغيلات وكلاء، فكل ذلك يوجد في قاعدة بيانات المنتج الخاصة به مع تطبيق عزل المستأجرين).

بدء سريع

1سجّل في signin.amargicreative.com وتحقّق من بريدك الإلكتروني.
2أنشئ مساحة عمل (تُنشأ تلقائياً عند التسجيل الأول، اختر اسم العمل).
3ادعُ زملاء الفريق من Settings ثم Team. كل زميل يحصل على رابط دعوة مباشر.
4افتح المُشغّل في app.amargicreative.com للوصول إلى منتجاتك المتّصلة.
5فعّل 2FA من Settings ثم Security. مطلوب للحسابات التي تستخدم منتجات Meta (Reach وEscalate).

مفاهيم رئيسية

المستخدم ومساحة العمل والمؤسسة

المستخدم (User) هو حساب فردي، مُحدّد بالبريد الإلكتروني. المؤسسة (Organization) هي الكيان القانوني والفوترة، عادة شركتك. مساحة العمل (Workspace) هي حاوية تشغيلية داخل المؤسسة، معظم العملاء لديهم مساحة عمل واحدة لكل مؤسسة؛ الفِرَق الكبيرة قد تستخدم العديد منها (لكل فرع، علامة تجارية، إلخ.). الموارد (WABAs، الوكلاء، التذاكر) تنتمي إلى مساحة عمل، لا مباشرة إلى مؤسسة.

الأدوار

الأدوار على مستوى مساحة العمل، يمكن أن يكون نفس المستخدم Admin في مساحة عمل واحدة وViewer في أخرى. الأدوار الخاصة بالمنتج (مثل وكيل Reach يستطيع الإرسال) موجودة لكل منتج، اقرأ وثائق المنتج لكل منها.

Owner: تحكّم كامل (الفوترة، تعليق، حذف).
Admin: إعدادات المنتج، إدارة الفريق، لا فوترة.
Member: مستخدم تشغيلي يومي (إرسال الرسائل، فتح التذاكر).
Viewer: وصول للقراءة فقط، مفيد للمراجعين الخارجيّين.

JWT و JWKS

Workspace يُصدر JWT يُوقّع بـ RS256. المفتاح العام مُتاح في نقطة نهاية JWKS قياسية على https://signin.amargicreative.com/.well-known/jwks.json. يجب أن تتحقّق كل منتجات Amargi (وأي تكامل خارجي تكتبه) من توقيع الرموز ضد JWKS قبل قبول الطلب. مُطالبات JWT تشمل:

sub: معرّف المستخدم (UUID).
org: معرّف المؤسسة النشطة.
workspace: معرّف مساحة العمل النشطة.
role: الدور على مستوى مساحة العمل.
iss: https://signin.amargicreative.com
aud: amargi-platform (مشترك عبر كل المنتجات).

الجلسات والكوكيز

يحتفظ Workspace بكوكيين على النطاق الجذر .amargicreative.com بحيث تشارك كل المنتجات الفرعية الجلسة. الكوكيز:

amargi_workspace_access: JWT قصير الأمد (15 دقيقة) يُرسَل في كل طلب.
amargi_workspace_refresh: رمز تحديث طويل الأمد (30 يوماً) يُستخدم تلقائياً لتجديد رمز الوصول.

مهام شائعة

دعوة زميل فريق

Settings ثم Team ثم Invite.
أدخل البريد الإلكتروني، اختر الدور.
انسخ رابط الدعوة أو اترك Workspace يُرسله بالبريد.
الزميل يقبل، يُنشئ حساباً، ينضمّ إلى مساحة العمل تلقائياً.

إنشاء مفتاح API

Settings ثم API Keys ثم New Key.
أعطِ اسماً وصفياً واختر النطاقات (read، write).
انسخ الرمز فوراً، لن يُعرَض مرة أخرى.
استخدمه كـ Authorization: Bearer <key> في طلبات API الخاصة بك.

تفعيل 2FA

Settings ثم Security ثم Enable 2FA.
امسح رمز QR بتطبيق المصادقة (Google Authenticator، 1Password، إلخ.).
احفظ رموز النسخ الاحتياطي في مكان آمن.
أكّد بإدخال رمز TOTP حالي.

إلغاء جلسة

Settings ثم Sessions يعرض كل الجلسات النشطة مع IP والمتصفّح وآخر ظهور.
اضغط Revoke بجانب أي جلسة لا تتعرّفها.
تُلغى الرموز فوراً، تخرج تلك الجلسة عند الطلب التالي.

مرجع API

نقاط نهاية المصادقة العامة

لا تحتاج JWT للوصول إليها.

POST/api/auth/signupإنشاء حساب جديد.

POST/api/auth/loginتسجيل الدخول، يُعيد الكوكيز.

POST/api/auth/logoutمسح الكوكيز وإلغاء رمز التحديث.

POST/api/auth/refreshتجديد رمز الوصول من رمز التحديث (يحدث تلقائياً).

GET/.well-known/jwks.jsonمفتاح JWKS العام للتحقّق من توقيع JWT.

نقاط نهاية API محميّة بـ JWT

تحتاج كوكي amargi_workspace_access أو رأس Authorization Bearer.

GET/api/meالملف الشخصي للمستخدم الحالي وعضويّات المؤسسة.

GET/api/organizations/:id/membersقائمة أعضاء المؤسسة.

POST/api/organizations/:id/invitesدعوة عضو.

POST/api/api-keysإنشاء مفتاح API جديد.

الحصول على المساعدة

دعم البريد الإلكتروني على contact@amargicreative.com. لمشكلة في الفوترة أو حذف الحساب، راجع دليل الحذف. لموقف الخصوصية والتشفير، راجع صفحة موقف الخصوصية.

contact@amargicreative.com دليل الحذف موقف الخصوصية

وثائق ذات صلة

Reach Agents Escalate Widget كل الوثائق

جاهز للبناء على Workspace؟

تحدّث إلينا عن الهوية وSSO وكيف يربط Workspace فريقك بكل منتج من Amargi. أو اطلب الوصول ونجهّزك.

تحدّث إلينا اطلب الوصول

Amargi Workspace

آخر تحديث: 2026-05-17