Telegram

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

إذا كان خيار الإنشاء عبر رمز QR متاحًا في موصل Telegram، فاخترْه، ثم امسح رمز QR أو اختر فتح Telegram، واضغط إنشاء بوت في بوت الإعداد. عُد إلى Make Agent Fast، وراجع اسم مستخدم البوت، ثم اختر ربط هذا البوت. لا حاجة إلى نسخ أي رمز مميز. تنتهي صلاحية الإعداد بعد 15 دقيقة، ويمكنك إلغاؤه وإعادة بدئه.

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

يقترح نموذج الإنشاء الاسم المعروض لوكيلك واسم مستخدم بالصيغة maf_<agent>_<random>_bot. يمكن تعديل كليهما؛ فالجزء العشوائي يقلل من تعارض الأسماء، لكن Telegram هو من يجري فحص التوفر النهائي. لا تتم إعادة تسمية البوتات الموجودة.

بعد الإنشاء، يرسل بوت الإعداد زر ربط هذا البوت الذي يفتح صفحة مراجعة الربط الموثّقة الخاصة بوكيلك. إنشاء البوت وحده لا يربطه. وبعد نجاح التأكيد، يوصلك فتح البوت إلى المحادثة لإجراء الاختبار. يعيد الأمر /start أو /help عرض الإعداد النشط، أو يُظهر أزرار لوحة التحكم والدليل.

إنشاء بوت وإعداده يدويًا#

اتبع Introduction to Bots الرسمي من Telegram وBotFather guide:

1. افتح حساب @BotFather الموثّق في Telegram.
2. نفّذ الأمر /newbot، واختر اسمًا معروضًا، ثم اختر اسم مستخدم فريدًا ينتهي بـ bot.
3. انسخ رمز البوت المميز. أي شخص يملك هذا الرمز يتحكم في البوت.
4. اختياريًا، اضبط الصورة والوصف ونص "حول" ومساعدة الأوامر المحلية في BotFather قبل الإطلاق.

هذا الرمز مخصص لواجهة Telegram Bot API؛ وهو ليس رمز تسجيل دخول إلى Telegram ولا API ID ولا API hash.

الربط في Make Agent Fast#

افتح صفحة القنوات الخاصة بالوكيل، واختر Telegram، والصق رمز البوت المميز، وحدّد ما إذا كان ينبغي نطق الردود المدعومة صوتيًا أيضًا، ثم اختر ربط.

يستدعي Make Agent Fast الدالة getMe في Telegram للتحقق من الرمز المميز وعرض اسم مستخدم البوت. ثم يستدعي setWebhook مع عنوان URL العام عبر HTTPS الخاص بالموصل، ورمز تحقق سري، وأنواع التحديثات المقبولة message وcallback_query وmy_chat_member. لا يتم تجاهل التحديثات المعلقة الموجودة.

لا تلزم عادةً أي خطوة يدوية لضبط webhook. أوقف أي خدمة polling قبل الربط. وإذا كان للبوت مستقبِل webhook آخر، فراجع استبداله وأكّده؛ فـ Make Agent Fast لا يستحوذ عليه بصمت. يمكن لوكيل واحد الرد عبر ما يصل إلى خمسة بوتات Telegram في الوقت نفسه؛ ويُعد كل بوت ربطًا مستقلًا. وحفظ بوت مختلف يضيف ربطًا جديدًا بدلًا من استبدال الربط الحالي. أما البوت المرتبط بوكيل آخر فيجب فصله هناك أولًا.

اختبار المحادثة#

1. افتح رابط t.me الخاص بالبوت من حساب Telegram لا يعود للمالك.
2. اختر Start؛ فالبوتات لا تستطيع بدء محادثة مع مستخدم.
3. أرسل سؤالًا نصيًا يعتمد على المعرفة.
4. أرسل رسالة صوتية إذا كان الصوت مفعّلًا.
5. تأكد من وصول الردود، ومن تغيّر آخر رسالة، ومن ظهور المحادثة في المحادثات.

الرسائل الخاصة عامة افتراضيًا: لا يحتاج الزوار إلى موافقة المالك. أما الردود في المجموعات فهي متوقفة إلى أن يفعّل المالك الرد في المجموعات عند الإشارة إلى البوت أو الرد على رسالته. ويظل وضع الخصوصية (Privacy Mode) في Telegram وأذونات المجموعة ساريين. اختبر الرسائل المباشرة أولًا.

سلوك الصوت#

يدعم Telegram في هذا الموصل الصوت الوارد والصوت الصادر. يتم تنزيل الرسائل الصوتية الواردة وتحويلها إلى نص قبل أن يعالجها الوكيل. وعند تفعيل الرد بالصوت وتوفر مزوّد للكلام، يرسل Make Agent Fast ردًا صوتيًا إضافة إلى النص. وإذا فشل تحويل الصوت إلى نص أو توليد الكلام، فاطلب من المستخدم إعادة المحاولة بالنص وافحص خطأ الموصل.

تغيير الرمز المميز أو التعطيل أو الإزالة#

إذا تعرّض الرمز المميز للكشف، فأنشئ رمزًا جديدًا أو ألغِ القديم في BotFather فورًا، ثم حدّث الموصل بالرمز البديل واختبر مجددًا. تحديث بيانات الاعتماد للبوت نفسه يحافظ على إعداداته وعلى حالة الإيقاف المؤقت. أما استبداله ببوت مختلف فيتطلب تأكيدًا ويُبقي سجل البوت السابق منفصلًا.

يؤدي التعطيل إلى إيقاف الردود محليًا، بينما تؤدي الإزالة إلى أرشفة الربط مع الاحتفاظ بسجله. لا يحذف أي منهما بوت Telegram ولا يستدعي deleteWebhook، إذ قد يعطّل ذلك مستقبِلًا أحدث. تتجاهل الروابط المؤرشفة الرسائل الواردة. يمكن للبوتات المنشأة بالإعداد السريع تحديث بيانات اعتمادها بعد أحداث دورة حياة المدير، لكن البوت الموقوف مؤقتًا يبقى موقوفًا، وتغيير الملكية يعطّل الربط إلى حين مراجعته.

استكشاف الأخطاء وإصلاحها#

لا تلصق أبدًا رمزًا مميزًا فعّالًا في الوثائق أو الشيفرة المصدرية أو أدوات التحليلات أو لقطات شاشة الدعم.