قبل أن تبدأ

التكاملات تربط النظام بما حوله: تطبيقاتكم، ومواقعكم، وأنظمة عملائكم. والقاعدة قبل أي ربط: اعرف الاتجاه — هل النظام يرسل عند وقوع حدث، أم أن طرفًا آخر يسأل النظام؟

الاتجاهان

الربط الصادر8 خطوات

كيفية إعداد ربط صادر

1. اذهب إلى: الإعدادات ← Webhook ← «جديد».
2. اختر نوع المستند والحدث الذي يشغّل الإرسال (بعد الإدراج، بعد الاعتماد، بعد التغيير…).
3. أدخل الرابط المستقبِل عند الطرف الآخر.
4. حدّد الحقول التي تُرسل — أرسل ما يلزم فقط لا المستند كاملًا.
5. أضف شرطًا يقيّد الإرسال بحالات معيّنة.
6. اضبط الترويسات والمفتاح السري ليتحقّق الطرف الآخر أن الطلب منكم فعلًا.
7. احفظ وفعّل، ثم اختبر بمستند تجريبي.

• ⚠ تنبيه — المفتاح السري ليس اختياريًا: بدونه أي جهة تعرف رابطكم تستطيع انتحال إرسال منكم. اضبطه من أول ربط.

الربط الوارد8 خطوات

مفتاح الوصول

1. أنشئ مستخدمًا مخصّصًا للتكامل — لا تستخدم حساب موظف.
2. امنحه أدوارًا محدودة بما يحتاجه فقط.
3. ولّد له مفتاح API وسرّه من ملف المستخدم.
4. سلّم المفتاح للطرف المطوّر عبر قناة آمنة.

قاعدة الأمان

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

البوابات

يوفّر النظام بوابات للعملاء والموردين تتيح لهم رؤية مستنداتهم وإدخال بياناتهم دون فتح النظام لهم. ويُنشأ لهم مستخدم من نوع «مستخدم الموقع» لا «مستخدم النظام» — فلا يصل إلى أي وحدة داخلية.

قبل أي مشروع تكامل5 خطوات

1. حدّد الاتجاه: صادر أم وارد.
2. حدّد الحدث بدقة: متى تحديدًا تُرسل البيانات؟
3. حدّد الحقول: ما الذي يحتاجه الطرف الآخر فعلًا؟
4. اتفق على معالجة الفشل: ماذا لو لم يستجب الطرف الآخر؟
5. اختبر على بيئة تجريبية قبل الإنتاج.

أسئلة متكررة