Telegram

ربط PRX بـ Telegram باستخدام Bot API الرسمي مع دعم الرسائل المباشرة والمجموعات والاستجابات المتدفقة ومرفقات الوسائط.

المتطلبات الأساسية

• حساب Telegram
• رمز بوت من @BotFather
• معرّفات أو أسماء مستخدمي Telegram للمستخدمين المسموح بهم

الإعداد السريع

1. إنشاء بوت

1. افتح Telegram وراسل @BotFather
2. أرسل /newbot واتبع التعليمات لتسمية بوتك
3. انسخ رمز البوت (التنسيق: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)

2. الإعدادات

أضف ما يلي إلى ملف إعدادات PRX:

[channels_config.telegram]
bot_token = "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
allowed_users = ["123456789", "your_username"]

إذا تُرك allowed_users فارغًا، يدخل PRX وضع الاقتران ويولّد رمز ربط لمرة واحدة. أرسل /bind <code> من حساب Telegram الخاص بك للاقتران.

3. التحقق

prx channel doctor telegram

مرجع الإعدادات

الحقل	النوع	القيمة الافتراضية	الوصف
bot_token	String	مطلوب	رمز Telegram Bot API من @BotFather
allowed_users	[String]	[]	معرّفات أو أسماء مستخدمي Telegram. فارغ = وضع الاقتران. "*" = السماح للكل
stream_mode	String	"none"	وضع البث: "none"، "edit"، أو "typing". وضع التحرير يحدّث رسالة الاستجابة تدريجيًا
draft_update_interval_ms	u64	500	الحد الأدنى للفاصل (مللي ثانية) بين تحريرات المسودة لتجنب حدود الطلبات
interrupt_on_new_message	bool	false	عند التفعيل، تلغي رسالة جديدة من نفس المرسل الطلب الجاري
mention_only	bool	false	عند التفعيل، يرد فقط على الإشارات بـ @ في المجموعات. تُعالج الرسائل المباشرة دائمًا
ack_reactions	bool	موروث	تجاوز لإعداد ack_reactions العام. يعود إلى [channels_config].ack_reactions إذا لم يُعيَّن

الميزات

• الرسائل المباشرة ودردشات المجموعات -- يرد على الرسائل المباشرة ومحادثات المجموعات
• الاستجابات المتدفقة -- تحريرات الرسائل التدريجية تعرض الاستجابة أثناء توليدها
• وضع الاقتران -- ربط آمن برمز لمرة واحدة عندما لا يكون هناك مستخدمون مسموح بهم مضبوطون
• مرفقات الوسائط -- يعالج المستندات والصور والتعليقات التوضيحية
• تقسيم الرسائل الطويلة -- يقسّم الاستجابات تلقائيًا التي تتجاوز حد Telegram البالغ 4096 حرفًا عند حدود الكلمات
• ردود فعل الاستلام -- يتفاعل مع الرسائل الواردة لتأكيد الاستلام
• تفريغ الصوت -- يفرّغ الرسائل الصوتية عند ضبط تحويل الكلام إلى نص

القيود

• يحدّ Telegram الرسائل النصية بـ 4,096 حرفًا (يقسّم PRX الرسائل الأطول تلقائيًا)
• يُدخل استطلاع Bot API تأخيرًا طفيفًا مقارنة بوضع webhook
• لا يمكن للبوتات بدء المحادثات؛ يجب على المستخدمين مراسلة البوت أولاً
• تحميل الملفات محدود بـ 50 ميجابايت عبر Bot API

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

البوت لا يرد على الرسائل

• تحقق من صحة رمز البوت باستخدام prx channel doctor telegram
• تأكد أن معرّف أو اسم مستخدم المرسل موجود في allowed_users
• إذا كان allowed_users فارغًا، استخدم /bind <code> للاقتران أولاً

أخطاء حد الطلبات أثناء البث

• زِد draft_update_interval_ms (مثلاً إلى 1000 أو أعلى)
• يفرض Telegram حدود طلبات لكل دردشة على تحريرات الرسائل

البوت يرد في الرسائل المباشرة لكن ليس في المجموعات

• تأكد أن mention_only معيّن على false، أو أشر إلى البوت بـ @
• في BotFather، عطّل وضع "Group Privacy" حتى يتمكن البوت من رؤية جميع رسائل المجموعة