Telegram
إشعارات للمسؤولين عبر بوت Telegram. يتم اختيار المستلم بمعرّف الدردشة.
افتح Integrations → إضافة تكامل → Telegram. للاتصال المثبّت مسبقًا استخدم إعداد.
التحضير
- افتح @BotFather في Telegram وأرسل /newbot وحدّد الاسم وانسخ الرمز المميز (token) الصادر.
- أضف البوت إلى الدردشة أو القناة المستهدفة وامنحه صلاحية إرسال الرسائل؛ وللدردشة الشخصية أرسل رسالة إلى البوت أولًا.
- احصل على chat ID من كائن update في Bot API أو استخدم معرّف قناة مقبولًا، ثم أدخله في النموذج.
- للاتصال القياسي اترك عنوان API فارغًا: سيُستخدم https://api.telegram.org. ثم احفظ الإعدادات وتحقق من الاتصال.
المعلمات
| الحقل | النوع | الغرض وقواعد التعبئة |
|---|---|---|
| معرّف الدردشة | إعداد | معرّف المستلم من message.chat.id في Bot API؛ وبالنسبة إلى القناة تحدد Bot API الصيغة المقبولة. |
| عنوان Telegram API | إعداد | عنوان خدمة Telegram Bot API. يُترك الحقل فارغًا عادةً؛ ولا يُحدَّد عنوان الوكيل (proxy) إلا بتعليمات من المسؤول. |
| رمز البوت | سر | الرمز السري (token) الصادر عن @BotFather. لا تنشره، وألغِه عبر BotFather عند تسريبه. |
الحفظ والتعديل
املأ المعلمات وانقر «حفظ». عند إعادة الفتح لا تُعرض الأسرار: مؤشر وجود السر ليس قيمته. الحقل الفارغ لسر موجود يحتفظ بالقيمة السابقة؛ والقيمة الجديدة تستبدلها. بعد التعديل تحقق من الاتصال من جديد.
نوع Telegram متاح في كتالوج التكاملات الكامل.
التحقق من النتيجة
- تأكد من أن البوت يملك وصولًا إلى الدردشة المحددة وصلاحية إرسال الرسائل.
- نفّذ فحص الاتصال في MDM.
- تحقق من وصول إشعار اختباري مسموح به إلى الدردشة المطلوبة تحديدًا، ثم اربط القناة بقاعدة الإشعارات.
تعني الحالة «Configured» أن الإعدادات محفوظة. قيّم نتيجة فحص الاتصال ونتيجة العملية المستهدفة كلًّا على حدة. تتوفر تفاصيل الفحص في بطاقة الاتصال.
القيود والتبعيات
في الدردشة الشخصية يجب أن يبدأ المستخدم المحادثة مع البوت. نجاح تفويض البوت لا يؤكد الوصول إلى الدردشة المحددة. اترك endpoint فارغًا لـ Bot API القياسي؛ ويجب الاتفاق مع المسؤول على عنوان الوكيل (proxy).
عند عدم العمل
| العرض | ما يجب فحصه |
|---|---|
| يجتاز البوت التفويض لكن لا توجد رسالة | تحقق من chatId ومن عضوية البوت في المجموعة أو القناة وصلاحيات الإرسال. |
| Unauthorized | تحقق من الرمز ومن إلغائه في BotFather. |
| خطأ في الوصول إلى API | تحقق من وصول خادم MDM إلى الشبكة ومن endpoint الاختياري. |
تعليمات ذات صلة
وثائق المزوّد
آخر تحديث