إنشاء خطاف ويب
- انتقل إلى الإعدادات → APIs & Webhooks → Webhooks
- انقر على + إنشاء خطاف ويب
- أدخل عنوان URL لخطاف الويب الخاص بك (يجب أن يكون قابلاً للوصول علنًا)
- انقر على حفظ
إدارة خطافات الويب
تحرير: انقر على خطاف الويب → تحديث عنوان URL → حفظ حذف: انقر على خطاف الويب → حذف → تأكيدالأحداث
يرسل Twenty خطافات الويب لأنواع الأحداث التالية:
يتم إرسال جميع أنواع الأحداث إلى عنوان URL لخطاف الويب الخاص بك. قد تتم إضافة تصفية الأحداث في الإصدارات المستقبلية.
تنسيق الحمولة
يرسل كل خطاف ويب طلب HTTP من نوع POST يتضمن جسمًا بصيغة JSON:استجب بحالة HTTP 2xx (200-299) لتأكيد الاستلام. تُسجَّل الاستجابات غير 2xx كإخفاقات في التسليم.
التحقق من صحة خطاف الويب
يقوم Twenty بتوقيع كل طلب خطاف ويب لأغراض الأمان. تحقّق من التواقيع للتأكد من أن الطلبات أصيلة.الرؤوس
خطوات التحقق
- احصل على الطابع الزمني من
X-Twenty-Webhook-Timestamp - أنشئ السلسلة:
{timestamp}:{JSON payload} - احسب HMAC SHA256 باستخدام سر خطاف الويب الخاص بك
- قارِن مع
X-Twenty-Webhook-Signature
مثال (Node.js)
خطافات الويب مقابل سير العمل
لاستقبال البيانات الخارجية، راجع إعداد مشغّل خطاف الويب.