Webhook
نظرة عامة
فيما يلي شرح عملي يركز على الأعمال لنوع المستند Webhook، مع ربطه مباشرة بعمليات الشركة اليومية واستخدامه التجاري.
ما هو استخدام نوع المستند Webhook في عمليات الأعمال؟
يُستخدم Webhook لربط دفاتر مع أنظمة أو خدمات أخرى تعمل خارج النظام، بحيث يتم تبادل المعلومات تلقائياً وفي الوقت المناسب دون تدخل يدوي.
بمعنى أبسط:
Webhook هو وسيلة لجعل دفاتر يُبلِغ أنظمة أخرى فور حدوث شيء مهم في العمل، مثل:
- إنشاء فاتورة
- اعتماد طلب
- تسجيل دفعة
- تحديث حالة عميل أو معاملة
هذا يوفّر وقت الموظفين، يقلل الأخطاء، ويضمن أن جميع الأنظمة المستخدمة في الشركة تعمل بانسجام.
المتطلبات الأساسية قبل استخدام Webhook
قبل البدء باستخدام Webhook، يجب التأكد من الآتي من منظور الأعمال:
وجود نظام خارجي
مثل:- نظام محاسبي آخر
- منصة تجارة إلكترونية
- نظام توصيل
- بوابة دفع
- نظام تقارير أو ذكاء أعمال
تحديد الأحداث المهمة للأعمال
يجب تحديد:- متى نحتاج أن يعرف النظام الآخر بما يحدث في دفاتر؟
- ما الحدث الذي يستحق الإشعار الفوري؟
وضوح المسؤوليات
- من المسؤول عن متابعة التكامل؟
- من يتأكد أن البيانات تصل بشكل صحيح؟
موافقة إدارية
لأن Webhook يتعامل مع بيانات أعمال حساسة مثل الفواتير والمدفوعات.
سير العمل النموذجي لـ Webhook في سياق الأعمال
سير العمل المعتاد يكون كالتالي:
حدوث حدث داخل دفاتر
مثال:- اعتماد فاتورة
- تسجيل دفعة
- تغيير حالة طلب
تنشيط Webhook تلقائياً
عند هذا الحدث، يقوم Webhook بالعمل فوراً.إرسال معلومات الحدث إلى النظام الآخر
مثل:- تفاصيل الفاتورة
- رقم العميل
- المبلغ
- الحالة الجديدة
استجابة النظام الآخر
النظام الخارجي قد:- يسجل العملية
- يبدأ إجراء جديد (شحن، إشعار عميل، تحديث حساب)
استمرار العمل دون تدخل يدوي
لا حاجة لإعادة إدخال البيانات أو إرسال بريد أو متابعة يدوية.
السيناريوهات التجارية الرئيسية التي يكون فيها Webhook ضرورياً
يصبح Webhook أداة أساسية في الحالات التالية:
1. التجارة الإلكترونية
- عند تأكيد طلب في المتجر الإلكتروني
- يتم تلقائياً إنشاء فاتورة أو تحديث حالة الطلب في دفاتر
2. المدفوعات والتحصيل
- عند تسجيل دفعة في نظام دفع خارجي
- يتم تحديث حالة الفاتورة في دفاتر فوراً
3. العمليات المالية والتقارير
- إرسال بيانات فورية إلى نظام تقارير أو إدارة عليا
- دون انتظار نهاية اليوم أو الشهر
4. إدارة العملاء
- عند تحديث بيانات عميل في دفاتر
- يتم مزامنتها مباشرة مع نظام خدمة العملاء أو التسويق
5. الشركات التي تعتمد على عدة أنظمة
- Webhook هو العمود الفقري للتكامل بين هذه الأنظمة
اعتبارات مهمة للمستخدمين
عند استخدام Webhook، يجب الانتباه إلى ما يلي:
اختر الأحداث بعناية
لا داعي لإرسال كل شيء، فقط ما يؤثر على القرار أو العملية.تابع النتائج بانتظام
تأكد أن الأنظمة الأخرى تستقبل البيانات وتتعامل معها بشكل صحيح.حافظ على سرية البيانات
لأن Webhook قد ينقل معلومات مالية أو بيانات عملاء.ابدأ بشكل بسيط
من الأفضل البدء بحدث واحد مهم، ثم التوسع تدريجياً.اعتبره جزءاً من سير العمل، لا مجرد إعداد
Webhook هو أداة استراتيجية لتحسين سرعة ودقة العمل.
خلاصة
نوع المستند Webhook في دفاتر هو وسيلة ذكية لجعل أنظمة عملك “تتحدث مع بعضها” تلقائياً. استخدامه بشكل صحيح يرفع كفاءة العمليات، يقلل العمل اليدوي، ويمنح الإدارة رؤية أسرع وأكثر دقة لما يحدث في الأعمال.
المعلومات الأساسية
- الوحدة: التكاملات
- نوع المستند: أخرى
الحقول
| اسم الحقل | التسمية | النوع | مطلوب | الخيارات | الوصف |
|---|---|---|---|---|---|
| webhook_doctype | نوع الوثيقة | رابط | ✓ | نوع الوثيقة | نوع المستند في دفاتر الذي يطلق الويب هوك |
| webhook_docevent | حدث دوك | حدد | أدخلبعد, onupdate, onsubmit, oncancel, on_t... | الحدث التشغيلي الذي يفعّل إرسال الويب هوك | |
| enabled | مفعّل | التحقق من | - | تفعيل أو إيقاف الويب هوك لهذا الإعداد | |
| condition | الحالة | نص صغير | - | شرط أعمال لتحديد متى يتم الإرسال | |
| html_condition | html_condition | HTML | Condition Examples: ,أمثلة إرشادية لكتابة شروط الأعمال |
| |
| request_url | طلب عنوان ورل | نص صغير | ✓ | - | عنوان الخدمة الخارجية لاستقبال الطلب |
| isdynamicurl | Is Dynamic URL? | التحقق من | - | تحديد ما إذا كان العنوان يتغير ديناميكياً | |
| timeout | Request Timeout | الباحث | - | الحد الأقصى لانتظار استجابة الطلب | |
| backgroundjobsqueue | Background Jobs Queue | Autocomplete | - | طابور تنفيذ الويب هوك في الخلفية | |
| request_method | طريقة الطلب | حدد | ✓ | POST, PUT, DELETE | طريقة إرسال الطلب إلى النظام الخارجي |
| request_structure | طلب هيكل | حدد | نموذج URL المشفرة, JSON | تنسيق بيانات الطلب المرسلة | |
| enable_security | تمكين الأمن | التحقق من | - | تفعيل حماية التوقيع والأمان للويب هوك | |
| webhook_secret | كلمة المرور للويبهوك | كلمة مرور | - | مفتاح سري للتحقق من مصدر الطلب | |
| webhook_headers | الترويسات | جدول | Webhook Header | رؤوس مخصصة مضافة إلى طلب الويب هوك | |
| webhook_data | البيانات | جدول | Webhook Data | البيانات الحقلية المرسلة مع الطلب | |
| webhook_json | طلب JSON الجسم | رمز | Jinja | نص JSON مخصص لجسم الطلب | |
| preview_document | حدد المستند | الارتباط الحيوي | webhook_doctype | اختيار مستند لمعاينة بيانات الإرسال | |
| meets_condition | هل تفي بالشرط؟ | البيانات | - | يوضح ما إذا كان المستند يحقق الشرط | |
| previewrequestbody | Request Body | رمز | - | معاينة جسم الطلب قبل الإرسال |
الجداول الفرعية
الترويسات (رأس ويبهوك)
| اسم الحقل | التسمية | النوع | مطلوب | الخيارات | الوصف |
|---|---|---|---|---|---|
| key | مفتاح | نص صغير | - | اسم رأس الويب هوك المستخدم لإرسال البيانات | |
| value | القيمة | نص صغير | - | قيمة رأس الويب هوك المرسلة مع الطلب |
البيانات (بيانات ويبهوك)
| اسم الحقل | التسمية | النوع | مطلوب | الخيارات | الوصف |
|---|---|---|---|---|---|
| fieldname | اسم الحقل | حدد | ✓ | - | اسم الحقل المستهدف لبيانات الويب هوك في دفاتر |
| key | مفتاح | البيانات | ✓ | - | المفتاح الفريد لتعريف سجل بيانات الويب هوك في دفاتر |
الصلاحيات
| الدور | قراءة | كتابة | إنشاء | حذف | إرسال | إلغاء |
|---|---|---|---|---|---|---|
| System Manager | ✓ | ✓ | ✓ | ✓ |
أنواع المستندات ذات الصلة
| نوع المستند | العلاقة | الوحدة |
|---|---|---|
| Webhook Request Log | مرتبط من | التكاملات |