تكامل Telegram

احصل على تنبيهات Gurdx كرسائل Telegram في محادثة خاصة أو مجموعة أو قناة.

المتطلبات#

• حساب Telegram.
• رمز بوت من BotFather.
• معرّف المحادثة (chat ID) الوجهة.

الخطوة 1: إنشاء بوت#

1. في Telegram افتح محادثة مع @BotFather وأرسل /newbot.
2. اتبع الخطوات لاختيار الاسم واسم المستخدم.
3. انسخ رمز البوت، وهو يشبه 123456789:AAExampleTokenValue. تعامل معه كما تتعامل مع كلمة المرور.

الخطوة 2: معرفة معرّف المحادثة#

• محادثة خاصة: أرسل أي رسالة إلى البوت، ثم افتح https://api.telegram.org/bot<TOKEN>/getUpdates في المتصفح. قيمة chat.id هي معرّف المحادثة.
• مجموعة: أضف البوت إلى المجموعة وأرسل رسالة تشير إليه، ثم اقرأ getUpdates بالطريقة نفسها. معرّفات المجموعات عادةً أرقام سالبة.
• قناة: أضف البوت مشرفًا بصلاحية النشر. تبدأ معرّفات القنوات بـ -100.

الخطوة 3: إضافته في Gurdx#

1. في https://gurdx.cretip.com/app افتح الإعدادات ثم التكاملات وأضف تكاملًا من نوع Telegram.
2. أدخل رمز البوت ومعرّف المحادثة. يُخزَّن كلاهما مشفّرًا.
3. اختر أنواع الأحداث والحد الأدنى للخطورة.
4. احفظ وفعّل.

ما يستقبله Telegram#

يستدعي Gurdx الدالة sendMessage في Telegram مع تعطيل معاينة الروابط. والنص هو التنبيه القياسي:

🛡️ Gurdx — Spam email (My Shop)
Risk: 66.7/100
Subject: user@mailinator.com
User: user_1042
Time: 2026-10-06 12:14:22

اختبر البوت بنفسك#

يمكنك اختبار الرمز والمعرّف خارج Gurdx أولًا:

curl -X POST "https://api.telegram.org/bot<TOKEN>/sendMessage" \
  -d chat_id=<CHAT_ID> \
  -d text="Gurdx test"

استكشاف الأخطاء#

• chat not found: لم يتلقَّ البوت رسالة من تلك المحادثة قط، أو المعرّف خاطئ.
• bot was blocked أو Forbidden: ارفع الحظر عن البوت، أو أعد إضافته إلى المجموعة أو القناة بصلاحية النشر.
• لا تنبيهات إطلاقًا: تأكد أن التكامل مفعّل وأن حركة الوضع الحي تبلغ الحد الأدنى للخطورة. طلبات الوضع التجريبي لا تُنشئ أحداثًا.

Warning: أي شخص يملك رمز البوت يستطيع إرسال رسائل باسمه. إذا تسرّب فألغِه عبر BotFather بالأمر /revoke وحدّث التكامل.

يُعاد الإرسال الفاشل حتى 3 مرات بفاصل دقيقة. تابع مع نظرة عامة على التكاملات.