Webhooks
استقبال أحداث فورية من متاجر سلة الخاصة بك. تمكّن Webhooks مزامنة البيانات الفورية وتشغيل سير العمل الآلي.
كيف تعمل Webhooks
عند ربط متجر سلة بـ Syncaty، يتم تكوين webhooks تلقائياً. ترسل سلة إشعارات الأحداث إلى Syncaty كلما تغير شيء في متجرك، مما يحافظ على مزامنة بياناتك فورياً.
حدوث الحدث
يقوم عميل بطلب، أو يحدث ملفه الشخصي، أو يتغير منتج.
سلة ترسل Webhook
ترسل سلة فوراً طلب HTTP POST إلى Syncaty مع بيانات الحدث.
Syncaty يعالج
يتحقق Syncaty ويعالج ويحدث بياناتك وفقاً لذلك.
تحديث التحليلات
يتم إعادة حساب درجات RFM وتحليلات العملاء حسب الحاجة.
الأحداث المدعومة
| الحدث | الوصف | البيانات المتضمنة |
|---|---|---|
order.created | تم إنشاء طلب جديد | كائن الطلب الكامل مع العناصر |
order.updated | تم تحديث تفاصيل الطلب | كائن الطلب المحدث |
order.status.updated | تم تغيير حالة الطلب | الطلب مع الحالة الجديدة |
order.cancelled | تم إلغاء الطلب | كائن الطلب الملغي |
customer.created | تم تسجيل عميل جديد | كائن العميل الكامل |
customer.updated | تم تغيير معلومات العميل | كائن العميل المحدث |
product.created | تم إضافة منتج جديد | كائن المنتج الكامل |
product.updated | تم تغيير تفاصيل المنتج | كائن المنتج المحدث |
معالجة Webhook
يعالج Syncaty webhooks بشكل غير متزامن باستخدام نظام قائمة انتظار المهام:
توصيل مضمون
يتم وضع Webhooks في قائمة الانتظار ومعالجتها بشكل موثوق، حتى أثناء الحمل العالي.
معالجة سريعة
معظم webhooks تُعالج في ثوانٍ من الاستلام.
إعادة المحاولة التلقائية
يتم إعادة محاولة معالجة webhook الفاشلة تلقائياً مع تأخير.
التحقق من التوقيع
يتم التحقق من جميع webhooks باستخدام توقيعات HMAC للأمان.
مراقبة Webhooks
- عرض جميع مهام webhook وحالتها
- مشاهدة وقت المعالجة لكل webhook
- تحديد واستكشاف أخطاء webhooks الفاشلة
- عرض بيانات حمولة webhook للتصحيح
استكشاف الأخطاء
البيانات لا تتحدث؟
تحقق من قسم المهام لمهام webhook المعلقة أو الفاشلة. إذا كانت المهام في الانتظار، سيتم معالجتها قريباً. المهام الفاشلة قد تشير لمشكلة مؤقتة.
webhooks مفقودة؟
تأكد من أن متجر سلة متصل بشكل صحيح. يمكنك تشغيل مزامنة يدوية من إعدادات المتجر لجلب أي بيانات مفقودة.
درجات RFM قديمة؟
يعمل إعادة حساب RFM بعد webhooks الطلبات. لإعادة حساب كاملة، استخدم خيار "إعادة حساب التحليلات" في إعدادات المتجر.
ملاحظة
تكوين Webhook تلقائي. لا تحتاج لإعداد عناوين URL أو أسرار webhook يدوياً — يتولى Syncaty ذلك أثناء اتصال المتجر.