الويب هوك الصادر: أحداث مكتبك تصل إلى أنظمتك لحظة وقوعها

ما هو؟

صفحة «الربط مع أنظمتكم» تتيح للمالك تعريف روابط تستقبل أحداثاً بصيغة JSON من تسعة أنواع. لكل رابط اسم وأحداثه المختارة وسر توقيع خاص به، وكل طلب يحمل توقيعاً يتحقق منه نظامك. ما يصل يُسجَّل في سجل إرسال تراه، وما فشل يُعاد إرساله تلقائياً بجدول محدد.

لمن هو؟

• مكتب لديه نظام علاقات عملاء أو ERP أو لوحة تقارير ويريد أن تصله بيانات العملاء الجدد دون إدخال يدوي.
• شركة تطوير تريد أن يصل حجز الوحدة أو دفع العربون إلى نظامها المحاسبي.
• مدير يريد أن يتحرك نظام آخر عند تغيّر حالة عميل أو حجز معاينة.
• مكتب لديه مطوّر أو مزوّد يربط الأنظمة ويحتاج عقداً واضحاً للأحداث والتوقيع.

ما المشكلة التي يحلها؟

• البيانات تُدخل مرتين: مرة في إيفا كور ومرة في النظام الآخر.
• الاستعلام الدوري عن التغييرات بطيء ويضيّع التغيير الذي لم يُلتقط.
• لا طريقة للتأكد أن الطلب القادم فعلاً من إيفا كور وليس من جهة أخرى.
• عند تعطل نظامك لا تعرف أي الأحداث فُقدت.

كيف يعمل خطوة بخطوة؟

1. افتح «التكاملات» ثم «الربط مع أنظمتكم». الصفحة للمالك وحده.
2. اضغط لإضافة رابط: اكتب اسماً (حتى 80 حرفاً) والرابط الكامل بـ HTTPS، واختر الأحداث التي يستقبلها من التسعة: عميل جديد، تغيّر حالة عميل، إسناد عميل، حجز معاينة، إلغاء معاينة، حجز وحدة، دفع العربون، بيع الوحدة، انتهاء الحجز بلا بيع.
3. انسخ سر التوقيع الذي يبدأ بـ whsec_ الذي يظهر مرة واحدة فقط. إن ضاع، غيّره من «تغيير السر».
4. ضع السر في نظامك وأضف دالة التحقق: تقرأ ترويسة X-EvaCore-Signature التي فيها الوقت t والتوقيع v1، وتحسب HMAC بخوارزمية SHA-256 على الوقت والجسم الخام كما وصل. الدليل أسفل الصفحة فيه مثال Node.js جاهز، والمهلة المقبولة 5 دقائق.
5. اضغط «إرسال تجربة» لإرسال حدث اختباري فوراً وترى الاستجابة قبل أن تنتظر حدثاً حقيقياً.
6. عند وقوع حدث حقيقي يُرسل طلب POST بجسم يحوي المعرّف والنوع والوقت والبيانات، مع ترويسات X-EvaCore-Event وX-EvaCore-Delivery. يرسل النظام الأحداث المستحقة من مهمة خلفية تعمل بانتظام.
7. راقب سجل الإرسال: كل حدث بحالته (وصل، بانتظار المحاولة، توقف) ورمز HTTP وعدد المحاولات والمحاولة القادمة.
8. إن فشل الإرسال تُجدول إعادة المحاولة بعد دقيقة ثم 5 دقائق ثم 30 دقيقة ثم ساعتين ثم 6 ساعات ثم 24 ساعة. بعدها يتوقف الحدث ويمكنك الضغط على «إعادة الإرسال» من السجل.
9. إن فشل الرابط ثلاثة أيام متتالية دون نجاح يُوقَف الرابط ويصل المالك إشعار داخل التطبيق، وعلى واتساب إن كان له رقم. أصلح الرابط ثم فعّله من جديد.

ماذا يتضمن؟

• حتى 5 روابط للمكتب، لكل رابط أحداثه وسره، ويمكن إيقافه دون حذفه.
• تسعة أنواع أحداث في ثلاث مجموعات: العملاء، المعاينات، الحجوزات والعربون.
• توقيع HMAC بـ SHA-256 في ترويسة X-EvaCore-Signature، وسر يظهر مرة واحدة ويمكن تغييره.
• «إرسال تجربة» وسجل إرسال لآخر 100 عملية و«إعادة الإرسال».
• ست إعادات محاولة بفواصل تتزايد حتى 24 ساعة.
• إيقاف الرابط الفاشل بعد ثلاثة أيام وإشعار المالك.

السعر وما تدفعه لجهات أخرى

منتجات ذات صلة

إدارة عملاء المكتب العقاري عبر واتساب: دليل اختيار النظام