ما هو الوضع المضمن في تيليجرام؟
بالإضافة إلى قدرة البوت على الرد على أي طلب مباشرة في محادثة شخصية أو مجموعة، يمكنك باستخدام الوضع المضمن الوصول إلى البوت بشكل عام في محادثة أو مجموعة أو قناة.
للاتصال ببوت يحتوي على الوضع المضمن،只需 أدخل @*اسم البوت* في حقل الرسالة.
أبرز وأشهر مثال على بوت يعمل في الوضع المضمن هو @gif، والذي يمكنك من خلاله اختيار وإرسال صور متحركة:
سيعمل بوت @gif في أي محادثة.
كيف يتم تفعيل الوضع المضمن؟
لكي يعمل البوت في الوضع المضمن، تحتاج إلى تفعيل هذا الخيار في إعدادات البوت في BotFather.
اختر البوت المطلوب وانتقل إلى إعدادات البوت.
ثم اختر الوضع المضمن
هنا تحتاج إلى تفعيل الوضع المضمن إذا لم يكن مفعلاً.
كيف يتم تغيير النص التوجيهي؟
إذا رغبت، يمكنك تغيير النص التوجيهي الذي يظهر قبل إدخال استعلام البحث. بشكل افتراضي، هو بحث…
لتغييره، انقر على زر تعديل النص التوجيهي المضمن:
حدد محتوى النص التوجيهي بدقة.
كيف يتم تكوين نتائج الإخراج
بعد النقر على خيار من القائمة في الوضع المضمن، سيتم إرسال رسالة موضحة في رأس الخيار المحدد، ويمكنك ضبط رد الفعل في القمع لهذه القيمة.
لتحديد البيانات المراد إخراجها في الوضع المضمن، تحتاج إلى تعيين المتغير inline_bot. في الوضع المضمن، يتم البحث عن القيم في المتغير inline_bot في الوقت الفعلي تقريبًا.
يمكن تحديد البيانات في المتغير بثلاث طرق. دعنا ننظر من الأبسط إلى أقصى الإعدادات.
مصفوفة مع بيانات نصية
على سبيل المثال، سيتم البحث عبر مصفوفة من المنتجات.
يتم تحديد المتغير inline_bot في إعدادات المشروع. يطابق البحث أي متغير مصفوفة يحتوي على العبارة المدخلة.
عند إدخال '@اسم__البوت__الخاص__بك' والأحرف الأولى من الأوامر، تظهر قائمة بالقيم التي حددتها في متغير المشروع.
بعد النقر على العنصر المطلوب، سيتم إرسال رسالة من المستخدم إلى البوت، ويمكنك تكوين رد الفعل في البوت.
يبدو تكوين الكتلة كما يلي:
بيانات نموذجية:
["حليب", "خبز", "معكرونة", "شوكولاتة", "بيض", "زبدة", "كعكة", "شاي", "خضروات", "فواكه"]
الإخراج في حالة عدم وجود تصفية
يمكنك تعيين مفتاح فارغ وتعيينه مصفوفة من القيم الصغيرة أو مصفوفة من القواميس. سيقوم البوت بالوصول إلى القاموس باستخدام مفتاح فارغ وإخراج أزرار بقيم من المصفوفة المعينة.
زر مضمن مع قيمة البحث المحددة
يرجى الملاحظة!
الأزرار المضمنة في تيليجرام ليست استدعاءات.
إذا كنت بحاجة إلى تلقي استدعاءات، فاقرأ عن أزرار الاستدعاء في تيليجرام.
الزر يعمل فقط في تيليجرام.
لتعيين عبارة بحث، أضف المعامل inline_query إلى الزر المضمن بقيمة يتم إدراجها تلقائيًا في الاستعلام.
يوصى باستخدام هذا الخيار للوضع المضمن، حيث سيساعد في تجنب الأخطاء والعمل بشكل أسرع.
على سبيل المثال، أضف ثلاثة أزرار تطابق المثال من الفصل السابق.
[{"line":0,"index_in_line":0,"text":"عرض القائمة","type":"inline","inline_query":"menu"},{"line":0,"index_in_line":1,"text":"مقالات","type":"inline","inline_query":"posts"},{"line":2,"index_in_line":0,"text":"قائمة المنتجات","type":"inline","inline_query":"products"}]
عند النقر على زر، على سبيل المثال، مقالة، سيتم عرض قائمة الأزرار التي تم العثور عليها (عند الإضافة، حددت "inline_query":"posts" لهذا الزر):
يتم أخذ الخيارات من متغير معين، كما هو موضح أعلاه في قسم "قاموس مع قائمة":
ملاحظات
- يمكن تعيين المتغير inline_bot ليس فقط في المتغيرات العامة، ولكن أيضًا كمتغير بسيط، ولكن في هذه الحالة يجب وضع قيمته بين علامتي اقتباس مفردة.
مثال في حقل الآلة الحاسبة:
inline_bot = '["حليب", "خبز", "معكرونة", "شوكولاتة", "بيض", "زبدة", "عجينة منتفخة", "شاي", "خضروات", "فواكه", "#{aa}"]'
يمكنك أيضًا تمرير أي قيمة كمتغير لتكوين أكثر مرونة.
على سبيل المثال، خيار بسيط في مصفوفة:
