نظرة عامة
يرشدك هذا الدليل خلال العملية الكاملة خطوة بخطوة. سواء كنت تبني أول تكامل لك أو تُوسّع نظامًا موجودًا، يجعل SocialHook ربط منصات مراسلة Meta ببنيتك التحتية أمرًا سهلًا.
البدء
أول ما تحتاجه هو حساب SocialHook. بمجرد الاتصال، ستتمكن من الوصول إلى تسليم webhook في الوقت الفعلي لـ Facebook وInstagram وWhatsApp — كل ذلك من لوحة تحكم واحدة.
المفاهيم الأساسية
فهم كيفية توجيه SocialHook للرسائل ضروري قبل البناء. كل رسالة واردة من أي منصة متصلة تُطبَّع في هيكل JSON متسق وتُسلَّم إلى نقطة نهاية webhook خلال 50ms.
يتضمن الـ payload دائمًا platform وevent وtimestamp ومحتوى الرسالة. معلومات المرسل تتفاوت حسب المنصة لكنها مضمّنة دائمًا.
التطبيق
يحتاج خادمك للرد بحالة 200 خلال 10 ثوانٍ. إذا لم يفعل، سيُعيد SocialHook محاولة التسليم حتى 3 مرات مع التراجع الأسي (5 ثوانٍ، 25 ثانية، 125 ثانية).
الأمان
تحقق دائمًا من رأس X-SocialHook-Signature قبل معالجة أي payload. يضمن هذا التوقيع HMAC-SHA256 أن الطلب جاء من SocialHook ولم يُعبث به.
الانطلاق
بمجرد اختبار تكامل webhook في بيئة مرحلية، حدّث إعداد SocialHook للإنتاج برابط نقطة النهاية المباشر.