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