أزرار تيليجرام لروبوتات المحادثة

نوصي بقراءة المقال الزر.

يمكنك استخدام أزرار الرد (الأزرار العادية أو أزرار لوحة المفاتيح) والأزرار المضمنة (الأزرار داخل النص) في تيليجرام.

هام: قيود الأزرار

يرجى الانتباه إلى قيود المنصة التالية عند إنشاء الأزرار:

• أزرار الرد (لوحة المفاتيح): بحد أقصى 12 زرًا في كل صف.
• الأزرار المضمنة: بحد أقصى 8 أزرار في كل صف.
• نص الزر: محدود بـ 32 حرفًا.
• لون الزر: لا يمكن تخصيصه. تستخدم الأزرار النمط الافتراضي للمنصة.

كيفية إنشاء زر في الكتلة

لإنشاء أي زر في روبوت المحادثة، انتقل إلى إعدادات الكتلة وانقر على علامة التبويب "الأزرار":

ثم ستفتح إعدادات إضافة الزر وتحريره. بعد ذلك، انقر على إضافة:

ستفتح نافذة إعدادات تسمح لك بتحديد تسمية الزر والإجراء والخيارات الإضافية.

أنواع الأزرار التالية متاحة فقط لروبوت تيليجرام:

• زر المشاركة – يسمح للمستخدمين بمشاركة المحتوى.
• زر رد الاتصال – يرسل استعلام رد اتصال صامت إلى الروبوت الخاص بك.
• تطبيق ويب تيليجرام – يفتح تطبيقًا مصغرًا (مثل أداة أو موقع ويب) داخل تيليجرام.
• تسجيل الدخول عبر تيليجرام – يسمح للمستخدمين بتسجيل الدخول عبر حساب تيليجرام الخاص بهم.

هناك أيضًا أزرار أخرى متاحة في تيليجرام، مثل الدفع، وطلب رقم الهاتف أو الموقع الجغرافي، وإرسال رابط.

زر المشاركة

عند إنشاء الزر، حدد "مشاركة (تيليجرام فقط)" واملأ الحقول (حقل نص إضافي اختياري):

يتيح لك هذا الزر إعادة توجيه المعلومات عن طريق تحديد جهة اتصال من قائمتك.

أدخل عنوان URL الذي ترغب في مشاركته في حقل "رابط المشاركة" الخاص بالزر.

بمجرد تحديد جهة اتصال، سيتم إرسال المحتوى من حقلي "رابط المشاركة" و "النص الإضافي". استخدم هذا لمشاركة روابط منشورات قنوات تيليجرام والمحتوى الآخر.

انتباه! قد لا يعمل بشكل صحيح على بعض أجهزة iOS.

زر تسجيل الدخول إلى موقع الويب

لكي يعمل زر تسجيل الدخول، يجب أولاً تفويض الروبوت الخاص بك للنطاق المستهدف. يتم هذا التكوين من خلال @BotFather.

خطوات التكوين:

1. افتح محادثة مع @BotFather.
2. حدد الروبوت الخاص بك من القائمة.
3. اختر إعدادات الروبوت > النطاق وأضف نطاق موقع الويب الخاص بك.

بعد ذلك، انتقل إلى زر النطاق:

ملاحظة: سيقرأ الزر تحرير النطاق إذا كان النطاق موجودًا، أو تعيين النطاق إذا كان بحاجة إلى الإضافة.

سيُطلب منك إعداد النطاق للروبوت الخاص بك:

تنسيق النطاق الصحيح:

أدخل نطاقك كـ mavibot.ai أو كـ yourdomain.com إذا كان لديك موقع ويب متصل بـ MaviBot.

الخطوة التالية:

بمجرد التحقق من نطاقك وتكوينه، يمكنك المتابعة لإنشاء زر التفويض.

في حقل النص، أدخل التسمية التي ستظهر على الزر.

ثم، قدم عنوان URL للصفحة في حقل الرابط حيث سيتم التفويض.

ستكون الحقول المتبقية مطلوبة إذا تم استخدام روبوت منفصل للتفويض (تحتاج إلى الحصول على إذن لإرسال الرسائل لهذا الروبوت): على وجه الخصوص، ستحتاج إلى تحديد اسم الروبوت.

إذا كنت بحاجة إلى أن تكون قادرًا على إرسال الرسائل من الروبوت المحدد، فتأكد من تحديد خانة الاختيار "طلب الإذن من المستخدم لإرسال الرسائل من الروبوت":

زر تسجيل الدخول عبر تيليجرام

زر رد الاتصال

زر رد الاتصال هو زر ملاحظات عندما يرى العميل شيئًا، وفي الروبوت نحصل على رد الاتصال الذي نحتاجه لتشغيل أي كتلة من مسار التحويل.

من السهل جدًا إنشاؤه: في حقل الأزرار، انقر على زر إضافة. في النموذج الذي يفتح، أدخل النص، وحدد النوع - زر رد الاتصال (تيليجرام) وأدخل نص رد الاتصال الذي يجب أن يعود عند النقر على الزر:

بصريًا، يبدو الزر كزر مضمن عادي:

بعد النقر على الزر، سترى رد الاتصال الذي تم تكوينه في بطاقة العميل:

من المهم!

لا يدعم تيليجرام أزرار لوحة المفاتيح لرد الاتصال.

يرجى الملاحظة!

إذا تم تحديد نوع الزر "رد الاتصال"، فسيتم عرض الزر كرد اتصال فقط إذا كان نص الزر مختلفًا عن نص رد الاتصال.

زر تطبيق ويب تيليجرام

يتيح لك هذا الزر فتح موقع الويب كتطبيق ويب في تيليجرام.

عند إضافة الزر، حدد تسميته، واختر نوع زر تطبيق ويب تيليجرام، وقدم الرابط إلى موقع الويب الذي سيفتح كتطبيق ويب:

• يمكنك تحديد رابط من خلال متغير:

استخدام متغير للرابط عملي للغاية عندما تتغير الصفحة المستهدفة أو عنوان موقع الويب بشكل متكرر.

كيف يعمل:

1. حدد متغيرًا (مثل landing_page_url) في إعدادات مشروعك.
2. قم بالإشارة إلى هذا المتغير (مثل #{landing_page_url}) في جميع أزرار تطبيق الويب عبر مساراتك.

الفائدة: بدلاً من تحديث عنوان URL يدويًا في كل كتلة زر فردية، تحتاج فقط إلى تغيير قيمة المتغير مرة واحدة في إعدادات المشروع، وسيتم تحديث جميع الأزرار تلقائيًا.

البديل: يمكنك بالطبع تحديد عنوان URL ثابت ومباشر في إعدادات الزر.

كيفية إنشاء أزرار لوظائف API تيليجرام

بينما قد يكون العمل مباشرة مع Telegram Bot API صعبًا، خاصة للمبتدئين، تقدم MaviBot بديلاً أكثر سهولة.

الطريقة: استخدام الكود المُنشأ

يمكنك استخدام كود الزر المُنشأ مسبقًا من الإعدادات المتقدمة، مما يلغي الحاجة إلى كتابة استدعاءات API يدويًا.

الخطوات:

1. انتقل إلى إعدادات الكتلة الخاصة بك وافتح قسم الأزرار.
2. استخدم الواجهة لإضافة وتكوين جميع الأزرار المطلوبة (النص، الروابط، الوظائف).
3. سيقوم النظام تلقائيًا بإنشاء كود API الصحيح لتيليجرام في الخلفية.

يسمح لك هذا الأسلوب بإنشاء لوحات مفاتيح معقدة بصريًا بينما تتعامل المنصة مع التنفيذ التقني الأساسي.

انقر على "الإعدادات المتقدمة" لعرض كود API المُنشأ لتيليجرام لأزرارك.

اختبر أزرارك، ثم انسخ الكود المُنشأ من الإعدادات المتقدمة إلى متغير مثل buttons.

ترسل هذه الوظيفة رسالة عبر API تيليجرام مع المعلمات التالية: tg_send_message (platform_id, text,client_message_id, reply_markup, sparse_mode, disable_web_page_preview, protect_content, disable_notification, message_thread_id, entities):

مرر متغير الأزرار إلى الوظيفة في معامل reply_markup:

ستظهر أزرارك في الدردشة بالتخطيط والنمط الذي حددته.

كيفية حذف أزرار الرد

بينما تختفي أزرار لوحة المفاتيح عادةً تلقائيًا، قد تظل مرئية في بعض الأحيان.

لمسح أزرار الرد المتبقية بالقوة، أدخل الكود التالي في حقل الإعدادات المتقدمة:

[{"buttons":[],"one_time":true,"index_in_line":0,"line":0}]

يخبر هذا التكوين الفارغ للزر تيليجرام بإخفاء لوحة المفاتيح المخصصة.

أزرار قائمة لوحة المفاتيح في تيليجرام

نوصي باستخدام هذه الميزة فقط للمستخدمين المتقدمين!

أزرار لوحة المفاتيح

لتتمكن من استخدام أزرار لوحة المفاتيح (الرد) كقائمة دائمة في تيليجرام، يكفي تعيين أي قيمة للمتغير tg_permanent_reply_buttons (يتم تعريف المتغير كثابت للمشروع).

المتغير: tg_permanent_reply_buttons

يمنحك تعيين المتغير tg_permanent_reply_buttons تحكمًا يدويًا كاملاً في رؤية لوحة مفاتيح الرد (الأزرار أسفل الرسالة). يتم تعطيل جميع سلوكيات الإخفاء التلقائي من قبل المنصة.

النطاق: ينطبق هذا الإعداد على جميع أزرار الرد التي تم إنشاؤها في الروبوت أثناء نشاط المتغير.

العودة إلى السلوك التلقائي

لاستعادة الإخفاء التلقائي القياسي للوحة المفاتيح:

1. قم بإزالة المتغير tg_permanent_reply_buttons من إعدادات مشروعك.
2. أعد إنشاء أي أزرار رد تم إنشاؤها أصلاً أثناء نشاط المتغير. تحتفظ الأزرار التي تم إنشاؤها تحت القاعدة "الدائمة" بهذه الحالة ويجب إعادة إنشائها لترث السلوك التلقائي الجديد.

كيفية إنشاء قائمة في تيليجرام

يمكن لمن أنشأ روبوت تيليجرام إنشاء مثل هذه القائمة.

للقيام بذلك، اكتب إلى Botfather في تيليجرام.

أدخل الأمر /mybots، وستفتح قائمة بروبوتاتك. اختر الذي تحتاجه. ستفتح لك قائمة. هنا تحتاج إلى تحديد تحرير الروبوت، ثم تحرير الأوامر.

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

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

عند النقر على زر القائمة، ستفتح قائمة بالأوامر التي تم تسجيلها مسبقًا في BotFather:

بعد ذلك، انتقل إلى Mavibot، وافتح المشروع المتصل به روبوت تيليجرام هذا.

أنشئ كتل البدء أو المشغل، واكتب الأوامر في الشروط، وفي حقل "نص الرسالة" — النصوص التي سيتم استلامها كرد.

مثال:

كيفية الجمع بين نوعين من الأزرار

أنشئ كتلة بزر رد (لوحة مفاتيح) تحتاج إلى تصورها.

أنشئ الكتلة التالية (مؤقت 0 ثانية) بأزرار مضمنة (أزرار في النص)، والتي يجب وضعها دون إزالة أزرار الرد. على سبيل المثال: [{"type": "inline", "text": "اسم الزر", "line": 0, "index_in_line": 0}]

إليك النتيجة:

هام: يجب عليك اتباع هذا الترتيب عند إضافة الأزرار في نفس الكتلة:

1. أولاً، أضف جميع أزرار الرد (لوحة المفاتيح).
2. ثم، أضف أي أزرار مضمنة.

إذا تم عكس هذا التسلسل، فستتم إزالة أزرار الرد عند إرسال كتلة الرسالة التالية.