أرسل أحداث العروض إلى نظام إدارة العملاء لديك
احصل على استدعاء موقّع فوري عندما يطّلع العميل على عرض أو يقبله أو يرفضه — لتبقى أنظمتك متوافقة دون أن يعيد أحد إدخال أي شيء.
ما ستتعلمه
- ✓إضافة نقطة نهاية واختيار الأحداث
- ✓الحفاظ على أمان مفتاح التوقيع
- ✓التحقق من أن الطلب صادر فعلاً من CueQuote
- ✓اكتشاف نقطة نهاية توقفت عن العمل
أضف نقطة النهاية
افتح الإعدادات وابحث عن «الويب هوك». اضغط «إضافة نقطة نهاية» والصق رابط https الذي يجب أن يستقبل الأحداث. حدّد الأحداث التي تهمك — يبدأ معظم الناس بـ proposal.accepted، لأنه الحدث الجدير بإبلاغ نظام إدارة العملاء به.
نصيحة احترافية: الويب هوك متاح في خطة Business. يجب أن يكون الرابط https؛ أما http العادي فمرفوض.
انسخ مفتاح التوقيع
بمجرد إنشاء نقطة النهاية سيظهر لك مفتاح يبدأ بـ whsec_. انسخه الآن إلى متغيرات البيئة لديك — فهو يُعرض مرة واحدة فقط ولا توجد طريقة لعرضه ثانية.
نصيحة احترافية: فقدته؟ احذف نقطة النهاية وأضفها من جديد. ستحصل على مفتاح جديد.
تحقق من التوقيع
يحمل كل طلب ترويسة X-CueQuote-Signature تتضمن طابعاً زمنياً وقيمة HMAC-SHA256 لذلك الطابع مع المحتوى الخام، موقّعة بمفتاحك. أعد حسابها وقارنها قبل أن تثق بأي شيء. بدون هذا التحقق، يمكن لأي شخص يعرف رابطك أن يرسل إليك عروضاً مزيفة.
نصيحة احترافية: احسب التجزئة على بايتات المحتوى الخام. تحليل JSON ثم إعادة تسلسله يغيّر البايتات ولن يتطابق التوقيع أبداً — وهذا أكثر الأخطاء شيوعاً.
ردّ بسرعة
أعد أي حالة 2xx بمجرد قبولك للحمولة، ثم نفّذ العمل البطيء بعد ذلك. نتوقف بعد ١٠ ثوانٍ، ويُسجَّل انتهاء المهلة كفشل.
نصيحة احترافية: اعتبر معالجك غير متأثر بالتكرار — اعتمد على معرّف العرض والحدث بدل افتراض وصول كل حدث مرة واحدة تماماً.
راقب حالات الفشل
في الإعدادات، تعرض كل نقطة نهاية عدد عمليات الإرسال التي استقبلتها خلال آخر ٧ أيام وكم منها فشل. الشارة الحمراء «فشل» تعني أن نقطة النهاية أعادت خطأ أو تجاوزت المهلة.
نصيحة احترافية: يستحق الأمر نظرة من حين لآخر: عندما يتعطل تكامل CRM بصمت، لا شيء آخر يخبرك — تتوقف العروض عن الوصول ببساطة.