متطلبات وقيود تيليجرام
1. حدود الرسائل
- رسالة نصية فقط: بحد أقصى 4,096 حرفًا.
- رسالة تحتوي على صورة: بحد أقصى 1,024 حرفًا (لصورة بحجم 1080×1080 بكسل).
2. متطلبات الصور
- التنسيق: يُفضل الصور المربعة.
- الحجم الأمثل: 900×900 بكسل، بحد أقصى 5 ميجابايت.
3. متطلبات الملفات
واجهة برمجة تطبيقات تيليجرام لها متطلبات محددة للملفات المرفوعة:
- يمكن للبوتات إرسال ملفات يصل حجمها إلى 2 جيجابايت.
- يمكنك استخدام file_id للعمل مع الملفات المرفوعة سابقًا. في هذه الحالة، تتبع حدود الملفات وثائق تيليجرام.
- يمكن إرسال الملفات باستخدام URL (يقوم البوت بتنزيلها وإرسالها):
- الصور: ≤ 5 ميجابايت
- الملفات الأخرى: ≤ 20 ميجابايت
- تنطبق حدود مختلفة للنشر:
- الصور: 10 ميجابايت
- الملفات الأخرى: 2 جيجابايت
إنشاء بوت تيليجرام
يتم إنشاء بوت تيليجرام من خلال BotFather، نظام إدارة البوتات الرسمي في تيليجرام. تتيح لك هذه الأداة الموثقة (المشار إليها بعلامة اختيار زرقاء) إنشاء بوت دون أي معرفة برمجية وتحميك من المقلدين المحتالين.
خطوات الإنشاء:
- ابدأ محادثة مع BotFather.
- أرسل الأمر:
/newbot - اختر اسمًا لبوتك (هذا هو الاسم المعروض للمستخدمين).
-
اختر اسم مستخدم لبوتك. يجب أن ينتهي بـ
botأو_bot(مثل:my_test_bot).
إذا كان اسم المستخدم متاحًا، سيرسل لك BotFather رسالة تأكيد تحتوي على "رمز مميز" (token)—وهو مفتاح فريد للوصول إلى واجهة برمجة التطبيقات.
هام: هذا الرمز المميز هو كلمة مرور لبوتك. احفظه بأمان ولا تشاركه أبدًا مع أي شخص.
انتقل إلى قسم المراسلات (Messengers)، واختر تيليجرام، والصق الرمز المميز لبوتك في الحقل المقدم.
انقر على زر تم (Done) لإكمال إعداد البوت وتفعيل الاتصال بمشروعك.
العمل مع مجموعات/قنوات تيليجرام
معلومات مفيدة
مجموعة تيليجرام هي قناة اتصال بين المشاركين: يمكن لجميع المشاركين الكتابة فيها.
قناة تيليجرام هي وسيلة اتصال أحادية الاتجاه. يمكن للمالك أو المسؤولين فقط إرسال الرسائل، بينما يمكن لباقي المشاركين فقط عرضها وترك تعليقات.
كيفية إضافة بوت إلى مجموعة/قناة تيليجرام
هذه الميزة للبوت مضمنة في BotFather:
الخطوة 1. اذهب إلى إعدادات البوت:
الخطوة 2. انقر على "السماح للمجموعات؟ (Allow Groups?)"
الخطوة 3. يجب أن تكون الحالة مفعلة.
إضافة بوت كمسؤول في مجموعة/قناة
لأتمتة العمل في الدردشات والقنوات، تحتاج إلى إضافة بوتك الخاص كمسؤول.
كيف تفعل ذلك؟
الخطوة 1. اذهب إلى إدارة المجموعة/القناة واختر علامة التبويب المسؤولين (Administrators)
الخطوة 2. انقر على زر "إضافة مسؤول (Add Admin)".
الخطوة 3. أدخل اسم مستخدم بوتك في مربع البحث.
الخطوة 4. للوظائف الكاملة، تأكد من أن البوت لديه صلاحيات قراءة وحذف الرسائل.
المتغيرات للعمل في الدردشات
يرجى الملاحظة!
حفظ المتغيرات في الدردشات الجماعية لأحداث مثل الانضمام إلى الدردشة، الخروج من الدردشة، إعجاب جديد، إلخ غير متاح.
ستكون المتغيرات متاحة فقط داخل الكتلة التي عملت. يمكنك إخراج هذه المتغيرات في الكتلة لتتبع العمل.
هذا لن يؤثر على عمل روبوتات الدردشة بأي شكل، ولن يكون من الممكن تتبع من دخل/خرج في قسم العملاء.
- متغيرات تحتوي على معلومات عن كاتب الرسالة
message_from - معرف كاتب الرسالة
message_from_name - اسم كاتب الرسالة
message_from_username - اسم المستخدم لكاتب الرسالة في تيليجرام
- متغيرات تحتوي على معلومات عن الرسالة المعاد توجيهها
reply_message_id - رقم الرسالة التي يتم إعادة توجيهها
reply_from - من هو كاتب الرسالة المعاد توجيهها
reply_from_name - اسم الشخص الذي يتم إعادة توجيه رسالته
reply_from_username - اسم المستخدم للشخص الذي يتم إعادة توجيه رسالته
reply_from_chat_id - رقم الحوار الذي تمت إعادة توجيه الرسالة منه
- الإضافة والإزالة من مجموعة
في هذه الحالة، يتم تشغيل ردود النداء new_chat_member و left_chat_member (لا يتم حفظ المتغيرات في بطاقة العميل):
chat_member_name - اسم المستخدم
chat_member_username - اسم المستخدم (اللقب)
chat_member_id - رقم المستخدم
ردود النداء في تيليجرام
client_unsubscribed - العميل ألغى الاشتراك، حظر البوت
client_returned - العميل ألغى حظر البوت
ردود النداء في المجموعات/القنوات
new_chat_member - تمت إضافة مستخدم جديد
left_chat_member - غادر المستخدم القناة
kicked_chat_member - تم حذف المستخدم بواسطة المسؤول
chat_join_request - تم استلام طلب للإضافة إلى القناة
edited_channel_post - تم تعديل المنشور على القناة (edited_channel_post + تاريخ ووقت التعديل)
يتم عرض ردود النداء في قسم العملاء (Clients)
bot_added_to_group - تمت إضافة بوت إلى الدردشة (لا يهم أي بوت، سوف يستجيب لأي بوت، حتى لو تمت إضافة البوت المتصل إلى المجموعة نفسها)؛
bot_left_group - رد نداء مماثل لإزالة البوت من القناة؛
new_like - أعجب بالمنشور
like_deleted - حذف إعجاب من المنشور
الرقم في رد النداء (new_like; like_deleted) هو معرف الرسالة التي تم الرد عليها أو إزالتها.
يرجى الملاحظة!
- ردود النداء للتفاعلات لا تظهر في قنوات تيليجرام! ردود النداء للتفاعلات تأتي فقط في المجموعات.
- إذا وضع شخص عدة إعجابات، ثم حذف واحدة منها، لا يظهر أي منها تم حذفه.
عند ظهور ردود النداء مع التفاعلات في المجموعات، تكون المتغيرات متاحة في الكتلة:
reaction_on_message_id - يحتوي على معرف الرسالة التي تم الرد عليها
reaction_from - معرف من كان هناك تفاعل
message_from_username - اسم المستخدم الذي كان هناك تفاعل (إن وجد)
reaction_from_name - اسم من كان هناك تفاعل
أيضًا، إذا رد تيليجرام على رسالة، فإن المتغير reply_text في البطاقة سيحتوي على النص الكامل للرسالة التي تم الرد عليها.
إذا تم إرسال رسالة كرد (اقتباس لرسالة سابقة)، سيقوم النظام أيضًا بإنشاء المتغير tg_quote، الذي يحتوي على النص المقتبس.
ردود النداء مع التعزيز (boost)
- chat_boost_from user #{id_user} - أعطى تعزيزًا للدردشة (أو القناة):
عند تشغيل رد النداء هذا، يتم إنشاء المتغيرات:
- remove_boost_from user #{id_user} - أخذوا التعزيز من الدردشة (أو القناة):
عند تشغيل رد النداء هذا، يتم إنشاء المتغيرات:
- chat_boost from giveaway - صدر أثناء سحب النجوم في القناة
- remove_chat_boost from giveaway - انتهت فترة التعزيز لسحب النجوم في القناة
كيفية أتمتة إزالة الإشعارات النظامية في المجموعات
لحذف جميع الرسائل النظامية تلقائيًا، يكفي تعيين أي قيمة للمتغير del_tg_system_messages (يمكن أن يكون المتغير إما ثابت مشروع أو متغير معاملة) وإعطاء البوت إذن حذف الرسائل.
يمكن استخدام المتغير del_tg_system_messages فقط في المجموعات. في القنوات، لن يؤدي تعيين أي قيمة لهذا المتغير إلى أي نتيجة.
صلاحيات المسؤول في إعدادات مجموعة تيليجرام
تتم إزالة الأنواع التالية من الإشعارات النظامية:
- تم تغيير اسم المجموعة
- تم تغيير صورة المجموعة
- تم حذف صورة المجموعة
- تم تثبيت الرسالة
- انضم المستخدم إلى المجموعة
- غادر المستخدم المجموعة
إذا كنت تريد حذف أنواع محددة فقط من الإشعارات النظامية، فبدلاً من المتغير del_tg_system_messages، قم بإنشاء المتغير del_tg_chosen_messages ووضع فيه مصفوفة بأنواع الإشعارات المراد حذفها، مفصولة بفواصل.
يرجى الملاحظة!
هذه المتغيرات ستعمل فقط لمجموعات تيليجرام، وليس للقنوات.
خيارات الإشعارات النظامية:
- 'new_chat_member' – انضم المستخدم إلى المجموعة،
- 'left_chat_member' – غادر المستخدم المجموعة،
- 'pinned_message' – تم تثبيت الرسالة،
- 'delete_chat_photo' – تم حذف صورة المجموعة،
- 'new_chat_photo' – تم تغيير صورة المجموعة،
- 'new_chat_title' – تم تغيير اسم المجموعة
على سبيل المثال، تحتاج إلى حذف جميع أنواع الرسائل النظامية باستثناء الانضمام إلى المجموعة؛ ثم تحتاج إلى إضافة جميع أنواع ردود النداء إلى متغير المشروع (ثابت) باستثناء "new_chat_member".
يرجى الملاحظة!
حذف الإشعارات النظامية لن يؤثر على ردود النداء. سيتم حذف الرسالة النظامية فقط من حوار تيليجرام.
المنتدى في تيليجرام
المنتدى هو مجموعة حيث يمكنك إنشاء مواضيع منفصلة للنقاش. يمكنك استخدام الوظائف القياسية في المنتدى: إرفاق ملفات الوسائط، نشر استطلاعات الرأي، وإعداد الإشعارات. يمكنك أيضًا تثبيت الرسائل وإضافة بوتات فردية لكل دردشة.
الغرض الأساسي من المنتدى هو تنظيم الاتصال داخل مجتمع كبير.
في دردشة جماعية قياسية بها العديد من المشاركين، يصبح متابعة المحادثات والعثور على الرسائل ذات الصلة أمرًا صعبًا. تحل المنتديات هذه المشكلة من خلال تنظيم المناقشات في سلاسل موضوعية مخصصة. هذا يقسم المجتمع تلقائيًا حسب الموضوع والاهتمام، مما يجعل الاتصال أكثر تركيزًا وقابلية للإدارة.
يمكن لمالك المجموعة فقط إنشاء موضوع إذا كان هناك أكثر من 100 عضو في المجموعة. إذا كانت المجموعة مرتبطة بقناة، فلن تتمكن من إنشاء موضوع. يتم تمكين المواضيع في إعدادات المجموعة:
كمسؤول، يمكنك إنشاء موضوع في إعدادات مجموعة المنتدى:
بعد توصيل المواضيع (Topics)، سيتغير الصورة الرمزية من دائرية إلى مربعة، مما يسمح لك بتمييز المنتدى عن دردشات تيليجرام الأخرى:
كيفية تكوين حزمة عميل تيليجرام مع موقع ويب؟
اقرأ المزيد حول كيفية ربط عميل تيليجرام وعميل من موقع الويب بعد الدفع الناجح هنا.