التوثيق / المنصة
نظرة عامة على التكاملات
ترسل التكاملات تنبيهات قصيرة مقروءة من Gurdx إلى الأدوات التي يتابعها فريقك، بينما تربط الـ Webhooks النظام بأنظمتك الخاصة.
طريقتان للإشعار#
| التكاملات | الـ Webhooks | |
|---|---|---|
| الوجهة | Slack وTelegram وDiscord | أي عنوان HTTPS تتحكم به |
| المحتوى | رسالة نصية قصيرة | JSON موقّع بالحدث كاملًا |
| الأنسب لـ | أشخاص يتابعون قناة | الأتمتة وخادمك |
| التوقيع | غير لازم | X-Gurdx-Signature |
كلتاهما تعتمدان على الأحداث نفسها. انظر الأحداث والتنبيهات لمعرفة ما يُنشئ الحدث، والـ Webhooks لصيغة JSON.
كيف يُعدّ التكامل#
لكل تكامل:
- نوع:
slackأوtelegramأوdiscord. - إعدادات: عنوان Webhook لـ Slack وDiscord، أو رمز البوت ومعرّف المحادثة لـ Telegram. وتُخزَّن مشفّرة.
- أنواع الأحداث المشترك بها، أو كل الأحداث.
- حد أدنى لدرجة الخطورة من 0 إلى 100. الأحداث الأقل منه لا تُرسل.
- مفتاح تفعيل لإيقافه مؤقتًا دون فقدان الإعداد.
أضف التكاملات من لوحة التحكم https://gurdx.cretip.com/app ضمن الإعدادات. يحتاج أعضاء الفريق إلى صلاحية «الإعدادات والتكاملات».
شكل الرسالة#
تتلقى كل التكاملات النص البسيط نفسه:
🛡️ Gurdx — Suspicious IP (My Shop)
Risk: 78.5/100
Subject: 203.0.113.42
Country: NL
User: user_1042
Time: 2026-10-06 12:14:22
يُحذف سطر IP إذا كان مطابقًا للموضوع، ويُتخطى أي حقل غير متوفر. ويظهر الوقت بتوقيت حسابك.
سلوك التسليم#
تُوضع الرسائل في قائمة الانتظار بعد الاستجابة. يُعاد الإرسال الفاشل حتى 3 مرات بفاصل دقيقة. لا تحمل التكاملات ترويسات التوقيع المستخدمة في الـ Webhooks، فحافظ على سرّية عناوين الوجهات والرموز.
اختيار القناة#
- Slack لقنوات الفريق عبر Incoming Webhook.
- Telegram لتنبيهات فورية على الجوال لشخص أو مجموعة.
- Discord لخوادم المجتمع أو العمليات.
- أدوات الأتمتة مثل Zapier وMake وn8n وIFTTT عبر مشغّل Webhook، حين تريد فتح تذكرة أو تحديث جدول أو استدعاء API آخر.
Tip: أنشئ تكاملين على نوع القناة نفسه: الأول بحد أدنى 50 للتدفق الكامل، والثاني بحد 80 موجّه إلى قناة المناوبة.
Note: التنبيهات إشارات ينظر فيها شخص، وليست أحكامًا آلية. قرّر في كودك ما الذي يُحظر.
وجدت خطأ؟ أخبرنا عبر صفحة التواصل. تواصل معنا