كيفية إنشاء روبوت Telegram باستخدام BotFather وإضافة الذكاء الاصطناعي

Piotr Grudzień
تاريخ النشر مدة القراءة: 16 دقائق
إنشاء روبوت Telegram باستخدام BotFather وQuickchat AI بجانب محادثة Fernway فعلية تعرض إجابات عن الدورات ومرفق PDF وردًا من موظف

لـ إنشاء روبوت Telegram، افتح BotFather وأرسل /newbot واختر اسمًا واسم مستخدم، ثم انسخ رمز الروبوت إلى الخدمة التي ستشغله. نستخدم هنا Quickchat AI، التي تزود الروبوت بـ AI Agent يجيب اعتمادًا على معرفتك الخاصة، دون كتابة كود أو تشغيل خادم.

ستنشئ Fernway Languages، وهي مدرسة افتراضية لتعليم الإنجليزية عبر الإنترنت. يستطيع الطالب فتح روبوتها في Telegram، والتحقق من أسعار الدورات، والضغط على /schedule، وطلب دليل دورات بصيغة PDF، وطلب التحدث إلى شخص. تجري التجربة كاملة داخل محادثة الطالب في Telegram، بينما يدير فريقك المعرفة وActions والمحادثات في Quickchat AI.

روبوت Fernway Languages في Telegram يجيب عن أسعار الدورات ومواعيدها ثم يرسل دليل الدورات PDF المطلوب

الروبوت بعد اكتماله في Telegram. تأتي إجابات الدورات من معرفته، ويصل الدليل كمرفق PDF فعلي.

يمتد الإعداد الأساسي من إنشاء الروبوت إلى اختبار ردوده. ثم أضف إرسال PDF والتحويل إلى موظف. يوضح قسم المجموعات كيفية إبقاء سلوك الردود متوقعًا في محادثة مشتركة.

نزّل حزمة إعداد Fernway للحصول على المعرفة وMain Prompt وقائمة الأوامر وورقة الاختبار والصورة الشخصية وملف PDF نموذجي. الملفات أمثلة قابلة للتعديل واللصق في لوحة التحكم، وليست أداة لاستيراد Agent تلقائيًا.

تظل لقطات الشاشة وتسميات الواجهة ومواد المثال القابلة للنسخ باللغة الإنجليزية لتتمكن من إعادة تنفيذ المثال المعروض بدقة.

ما الذي تحتاج إليه لإنشاء روبوت Telegram دون برمجة؟

تحتاج إلى حساب Telegram وحساب Quickchat AI وروبوت جديد للتجربة. ينشئ BotFather هوية Telegram، وتشغّل Quickchat AI الوكيل خلفها.

  1. سجّل الدخول إلى Telegram على الهاتف أو الحاسوب. استخدم BotFather الرسمي المرتبط في الخطوة 1، وليس حسابًا مشابه الاسم.
  2. أنشئ حساب Quickchat AI وأكمل التحقق من البريد الإلكتروني إذا طُلب منك ذلك. تدعم خطة Free التعلم الشخصي غير التجاري ضمن حصتها المتاحة. استخدم خطة تجارية للنشر الفعلي في الأعمال. تستهلك ردود الذكاء الاصطناعي وSimulation Testing الرصيد؛ راجع الخطط والحصص الحالية.
  3. اترك التطبيقين مفتوحين. استخدم روبوت اختبار جديدًا كي لا تغيّر التجربة قناة دعم قائمة. يفيد حساب Telegram ثانٍ في فحص تجربة الزائر لأول مرة.

لا تفرض Telegram رسومًا لتسجيل روبوت. للخدمة التي تولّد إجابات الذكاء الاصطناعي حصتها الخاصة. لا تحتاج في هذا الإعداد إلى مفتاح API منفصل للنموذج.

ما دور BotFather وما دور الذكاء الاصطناعي؟

يدير BotFather هوية الروبوت وإعداداته. يقرر الوكيل المتصل كيفية الإجابة باستخدام معرفته وتعليماته. إنشاء الروبوت وحده لا يزوّده بمعلومات الدورات أو ببرنامج يستجيب للرسائل.

مخطط يفصل إعدادات هوية BotFather عن رسائل Telegram وإجابات Quickchat AI تسلّم Telegram رسالة الطالب إلى الخدمة المتصلة. يعود رد الوكيل إلى المحادثة نفسها.

الجزءما تضبطهما يراه الطالب
BotFatherالاسم واسم المستخدم والصورة والوصف وقائمة الأوامر ووضع الخصوصيةهوية الروبوت ومداخل التفاعل معه
Quickchat AIKnowledge Base وMain Prompt ورسالة الترحيب وActionsإجابات الدورات وملف PDF المطلوب والتحويل إلى موظف
فريقكمعلومات دقيقة عن الدورات ومتابعة Inboxرد بشري عندما تحتاج المحادثة إليه

الخطوة 1: كيف تنشئ روبوت Telegram في BotFather؟

أرسل /newbot إلى BotFather الرسمي، ثم قدّم اسم عرض واسم مستخدم فريدًا.

  1. افتح @BotFather في Telegram واختر Start.
  2. أرسل /newbot.
  3. عندما يُطلب الاسم، أرسل Fernway Languages. هذا هو اسم العرض الذي يراه الطلاب.
  4. عندما يُطلب اسم المستخدم، اختر مثلًا fernway_lessons_yourname_bot. استبدل yourname بلاحقة فريدة. استخدم من 5 إلى 32 حرفًا لاتينيًا أو رقمًا أو شرطة سفلية؛ لا تميّز أسماء المستخدمين بين الأحرف الكبيرة والصغيرة. لهذا الإعداد المجاني المعتاد، استخدم اسمًا ينتهي بـ bot. إن كان محجوزًا، جرّب لاحقة أخرى. يتيح BotFather نهايات أخرى أيضًا لحسابات Premium المؤهلة.
  5. يعيد BotFather رابط الروبوت ورمز المصادقة الخاص به. احتفظ بالرابط لفتح محادثة الطلاب. أبقِ الرمز سريًا لاستخدامه في الخطوة 4.

تكفي واجهة الأوامر لهذا الدليل. قد يوفر BotFather أيضًا Mini App لإدارة الروبوتات؛ استخدم الأوامر أدناه إذا اختلفت شاشتك.

محادثة BotFather الموثّق تعرض أمر newbot واسم Fernway Languages وتأكيد الإنشاء، مع حجب اسم المستخدم وبيانات الاعتماد

ينشئ BotFather الهوية ويعيد الرابط وبيانات الاعتماد. حُجب اسم مستخدم الاختبار وبيانات الاعتماد كاملة.

أين تجد رمز روبوت Telegram؟

أرسل /mybots إلى BotFather، واختر روبوتك، وافتح API Token. يصادق الرمز على الطلبات المنفذة باسم ذلك الروبوت. الصقه في حقل بيانات الاعتماد المخصص في الخدمة فقط، ولا تضعه في تعليمات الوكيل أو المعرفة أو محادثة دعم أو لقطة شاشة.

إذا انكشف الرمز، أرسل /revoke إلى BotFather واختر الروبوت واحصل على البديل. حدّث الخدمة المتصلة بالرمز الجديد واختبر ردًا. تتوقف بيانات الاعتماد القديمة عن العمل؛ تغيير اسم الروبوت أو حذف لقطة شاشة لا يبطلها.

للـ webhook وجهة واحدة. قد يؤدي ربط الروبوت نفسه بخدمة أخرى إلى استبدال webhook الذي يسلّم الرسائل الواردة إلى Quickchat AI. يمكن لخدمات منفصلة إجراء طلبات API صادرة بالرمز نفسه، لكنها لا تتلقى تلقائيًا نسخة من كل تحديث وارد. تمنع Telegram أيضًا الاستقصاء باستخدام getUpdates عند تثبيت webhook. استخدم روبوتًا منفصلًا لمسار استقبال مستقل. تشرح وثائق تسليم التحديثات في Telegram الآليتين.

الخطوة 2: كيف تضيف صورة ووصفًا وقائمة أوامر؟

استخدم أوامر الملف الشخصي في BotFather ليتمكن الطالب من تمييز الروبوت قبل إرسال رسالته الأولى. بعد كل أمر، اختر روبوتك وأرسل القيمة التالية.

أرسل إلى BotFatherثم قدّمموضع الظهور
/setnameFernway Languagesاسم العرض في Telegram
/setuserpicارفع fernway-avatar.png من الحزمةصورة الملف الشخصي
/setdescriptionالوصف أدناهالمقدمة قبل بدء المحادثة
/setabouttextنص الملف الشخصي القصير أدناهملف الروبوت ومعاينة الرابط المشترك
/setcommandsقائمة الأوامر أدناهالقائمة التي يضغطها الطلاب في المحادثة

Description (حتى 512 محرفًا):

Ask Fernway Languages about English courses, prices and weekly class times. Request the course guide or ask to speak to the team. This is a fictional school built for a tutorial.

About text (حتى 120 محرفًا):

English courses, prices and class times. A fictional school for a Quickchat AI tutorial.

قائمة الأوامر: الصق الأسطر الأربعة معًا. لا تبدأ أسماء الأوامر بشرطة مائلة في هذه القائمة لدى BotFather.

prices - Course prices
schedule - Weekly class times
trial - Request a free trial lesson
help - Talk to a person

افتح ملف الروبوت للتحقق من اسمه وصورته ونصه التعريفي. افتح المحادثة قبل اختيار Start للتحقق من المقدمة. تشرح Telegram الإعدادات في دليل BotFather.

بعد ربط الروبوت في الخطوة 4 واختيار Start، افتح قائمة الأوامر وافحص العناصر الأربعة. حافظ على فواصل الأسطر عند لصق القائمة في BotFather، وإلا قد تصبح عناصر متعددة وصفًا طويلًا لأمر واحد.

قائمة أوامر Fernway Languages في Telegram تعرض prices وschedule وtrial وhelp أسفل رسالة الترحيب المضبوطة

تتضمن القائمة المكتملة أربعة عناصر منفصلة. تُضبط التحية فوقها في Quickchat AI في الخطوة 3.

مخطط أوامر يوضح إضافة BotFather لعنصر القائمة وإرسال Telegram لنص الأمر وتعريف Main Prompt لمعناه إضافة /schedule إلى القائمة لا تنفذ البحث عن المواعيد. تعلّم الخطوة التالية الوكيل معنى هذه الرسالة.

الخطوة 3: كيف تجعل روبوت Telegram يجيب من معرفتك؟

أنشئ Agent، وأضف حقائق المدرسة إلى Knowledge Base، ثم ضع قواعد الرد في Main Prompt. يسهل فصل الحقائق عن التعليمات تغيير السعر دون تغيير سلوك الروبوت.

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

أضف معلومات الدورات

  1. في Quickchat AI، أنشئ Agent جديدًا باسم Fernway Languages. اضبط الاسم نفسه في Identity.
  2. افتح Knowledge Base، واختر Add Article، واستخدم Fernway Languages course guide في Title.
  3. الصق المحتوى التالي في Content ثم اختر Save. انتظر انتهاء المعالجة وظهور Ready على المقالة. أكمل أي خطوة نشر أو تطبيق تظهر قبل اختبار القناة الفعلية.

محرر مقالة معرفة Fernway يعرض العنوان وأسعار الدورات ومواعيد الدروس الأسبوعية أضف الحقائق ضمن Knowledge Base. تتضمن المقالة الكاملة القابلة للنسخ أدناه سياسات التجربة والاسترداد وتحديد المستوى أيضًا.

انسخ مقالة معرفة Fernway
Fernway Languages is a fictional online English school used for this tutorial.

Courses
B1 English: EUR120 total for a four-week course. Classes are on Tuesdays and Thursdays, 18:00 to 19:00 UTC.
A2 English: EUR90 total for a four-week course. Classes are on Mondays and Wednesdays, 18:00 to 19:00 UTC.
Both courses meet online. Prices are for the complete four-week course, not per lesson.

Trial lessons
A free trial lesson lasts 20 minutes. Ask the student which course interests them and which day and time they prefer, including their time zone. A member of the Fernway team must confirm availability. The bot cannot book or confirm a trial lesson.

Refunds
Students can receive a full refund if they cancel at least 48 hours before their first class. The team reviews requests made later; no refund is promised for those requests.

Course brochure
The course guide contains the same course prices, weekly schedule, trial policy and refund policy. Send it only when the student asks for the brochure or course guide.

Placement
The team handles level placement. This knowledge base does not contain a placement-test score cutoff or rules that convert a test score into a course level. Do not invent a cutoff or interpret a student's score.

غياب حدّ درجات تحديد المستوى يوفر اختبارًا مفيدًا. يستطيع الوكيل الإجابة عن سعر B1 من مصدر، لكن يجب ألا يخترع الدرجة المطلوبة للالتحاق.

حدّد معنى الأوامر

افتح Identity، واختر بطاقة Main Prompt المعلّمة بـ Edit، والصق النص الكامل أدناه. اتركه يُحفظ تلقائيًا، ثم افتحه مجددًا للتحقق من النص المحفوظ.

صفحة Identity في Fernway Languages تعرض Name وبطاقة Main Prompt القابلة للتحرير افتح Main Prompt من Identity. تمنح قواعده أوامر Telegram معناها.

انسخ Main Prompt كاملًا
You are the Fernway Languages assistant. Help prospective students understand the English courses using the Knowledge Base.

Answer the student's question directly. Use plain text, short paragraphs and no Markdown tables. Keep routine answers under 100 words. State prices in EUR and class times in UTC unless the student explicitly asks for a conversion.

Treat /prices as a request for the course prices. Treat /schedule as a request for the weekly class times. Treat /trial as a request for a free trial lesson: explain that it lasts 20 minutes, ask for the preferred course, day, time and time zone, and make clear that the team must confirm availability. Treat /help as a request to speak to a person. These commands may include a bot username after an @ sign; apply the same rule to /prices@username, /schedule@username, /trial@username and /help@username.

Call send_course_brochure only when the student explicitly asks to receive the brochure or course guide. Do not call it for a price or schedule question alone. Do not ask for a chat ID, token or email address to send it. Say that the brochure was sent only after the action succeeds. If it fails, say that the file could not be sent and offer to explain the courses in the chat.

Use only the Knowledge Base for course facts and policies. If a requested fact is missing, say that the team will need to confirm it. Never invent placement-test cutoffs, available trial slots, bookings, refunds or course discounts.

If the student asks for a person, use Human Handoff. Do not promise an immediate response or pretend a staff member has already replied.

يتضمن هذا النص خطوتَي الدليل والتحويل الاختياريتين اللتين ستضبطهما لاحقًا. أكملهما قبل تقديم الروبوت كخدمة دعم طلاب متكاملة. يمكن للتعليمات طلب Action، لكنها لا تنشئه ولا تربط Telegram.

تكتسب الصيغ الموجّهة، مثل /schedule@your_bot، أهمية عند انضمام الروبوت إلى مجموعة. وتعليمات النص العادي مهمة أيضًا: تُرسل الردود المعتادة عبر هذا التكامل دون تنسيق Markdown الخاص بـ Telegram.

اضبط رسالة الترحيب

افتح Your Website، واختر تبويب Text Content، وعدّل Welcome message. يستخدم اتصال روبوت Telegram الخاص هذه التحية المشتركة أيضًا:

Welcome to Fernway Languages. I can help with our English courses, prices and class times. Try /prices, /schedule or /trial, or ask a question. Use /help to ask for a person.

حقل Welcome message يتضمن تحية Fernway واقتراحات الأوامر يوجد حقل Welcome message المشترك ضمن Your Website → Text Content؛ تستخدمه Telegram للأمر /start.

يرسل تكامل الروبوت الخاص هذه التحية المضبوطة عندما يرسل الزائر /start. وهي منفصلة عن وصف BotFather السابق للمحادثة وعن إجابة يولّدها الذكاء الاصطناعي لسؤال عن الدورات.

الخطوة 4: كيف تربط الرمز بـ Quickchat AI؟

اتصل عبر Your own bot لاستخدام هوية Telegram التي أنشأتها.

  1. افتح External Apps، واختر Telegram، ثم Your own bot.
  2. اختر Connect to Telegram، والصق رمز BotFather في Bot Token، ثم اختر Connect to Telegram داخل النافذة لإرساله.
  3. شغّل Enable your own bot، ثم اختر Save.
  4. افتح رابط t.me الخاص بالروبوت في Telegram. اختر Start أو أرسل /start للتحقق من التحية.

إعدادات Telegram في Quickchat AI تعرض روبوت Fernway المتصل ضمن Your own bot مع تشغيل Enable your own bot تعرض لوحة الاتصال الفعلي هوية الروبوت وحالة تفعيله. استخدم Your own bot للهوية المنشأة في BotFather.

نافذة Connect to Telegram في Quickchat AI مع حقل Bot Token فارغ أدخل بيانات الاعتماد في هذا الحقل. لا تتضمن اللقطة أي رمز عمدًا.

خيار Quickchat AI bot المشترك في لوحة التحكم إعداد مختلف. يوفر رابط محادثة خاصًا بالوكيل دون إنشاء روبوتك؛ يستخدم المسار الأساسي هويتك وبيانات اعتمادك. يغطي دليل روبوت محادثة Telegram بالذكاء الاصطناعي المسار المشترك.

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

الخطوة 5: كيف تختبر روبوت Telegram؟

افحص إجابة الوكيل والرسالة التي تصل إلى Telegram معًا. يختبر فحص لوحة التحكم منطق الرد، بينما تتحقق محادثة Telegram من القناة كاملة.

اختبر الإجابات في Quickchat AI

افتح Testing، واختر Create Dataset، وسمّه Fernway course answers، وأضف الرسائل التالية في صفوف منفصلة:

How much is the B1 English course?
/prices
/schedule
/schedule@fernway_demo_bot
/trial
I scored 62 on your placement test. Do I qualify for B1?

يستخدم صف الأمر الموجّه اسم مستخدم نموذجيًا لاختبار قاعدة التعليمات. في اختبار Telegram الفعلي، استخدم اسم مستخدم روبوتك الحقيقي.

ضمن Evaluation criteria، استخدم:

Fernway Languages is a fictional English school. B1 costs EUR120 total for four weeks and meets Tuesdays and Thursdays, 18:00 to 19:00 UTC. A2 costs EUR90 total for four weeks and meets Mondays and Wednesdays, 18:00 to 19:00 UTC. A free trial lasts 20 minutes and requires team confirmation; no booking may be claimed. Commands must be treated as requests for the corresponding information. No placement-score cutoff is known, so the Agent must not decide a level from a score. Replies should be brief, plain text and based on these facts. Evaluate reply content only. This test cannot verify Telegram delivery, a received PDF or human assignment.

اختر Run مع توفر رصيد الذكاء الاصطناعي. يبدأ كل صف محادثة مستقلة. لاختبار أسئلة المتابعة، استخدم محادثة مستمرة واحدة في AI Preview، ولا تعتبر الصف التالي دورًا لاحقًا في المحادثة نفسها.

ستة اختبارات Fernway Simulation مكتملة تعرض إجابات الأسعار والأوامر ونتيجة سؤال تحديد المستوى نتائج Simulation محلية فعلية. حصلت إجابة تحديد المستوى على تقييم أقل لأن المقيّم لم يستطع ملاحظة التحويل، بينما أكد Inbox تغيير الإسناد الحقيقي.

اختبر تجربة الطالب في Telegram

أرسل ما يلي في المحادثة الخاصة للروبوت الحقيقي، وانتظر كل رد. استخدم Inbox للعثور على السؤال والإجابة المقابلين.

اترك سؤال درجة تحديد المستوى للنهاية، بعد الخطوتين 6 و7. فقد يحوّل المحادثة إلى الموظفين ويوقف الردود الآلية مؤقتًا.

الرسالة أو الإجراءنتيجة النجاح
/startتظهر رسالة الترحيب المضبوطة
How much is the B1 English course?EUR120 للدورة الكاملة التي تستمر أربعة أسابيع
اضغط /schedule في القائمةجدولا الدورتين الأسبوعيان مع توضيح UTC
اضغط /trialطلب تجربة مدتها 20 دقيقة، مع ترك تأكيد التوفر للفريق
I scored 62 on your placement test. Do I qualify for B1?لا اختلاق لحدّ درجات أو قرار أهلية؛ يجب أن يؤكد الفريق

Fernway Languages في Telegram لا يحدد أهلية B1 اعتمادًا على درجة 62 في اختبار تحديد المستوى

يترك الرد الفعلي قرار المستوى للفريق. يظل الدليل ورد الموظف السابق ظاهرين في المحادثة نفسها.

Quickchat AI Inbox يعرض سؤال تحديد المستوى نفسه من Telegram وإجابة الوكيل ومحادثة Unassigned يعرض Inbox المقابل الإجابة وحالة Unassigned للمحادثة معًا.

في الاختبار الفعلي، لم يستنتج الوكيل مستوى من الدرجة. أظهر Inbox المحادثة بعد ذلك كـ Unassigned مع تفعيل تحويل Lack Of Knowledge. افحص الرد والإسناد منفصلين؛ لا يستطيع مقيّم الإجابة إثبات من يتولى المحادثة. نفّذ اختبار المستوى بعد بقية اختبارات المحادثة، أو اختر AI Agent من قائمة المسؤول في Inbox قبل استئناف الردود الآلية.

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

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

الخطوة 6: كيف تجعل الروبوت يرسل PDF؟

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

مخطط يوضح المصادر الثابتة الثلاثة لإجراء المستند: System Token وبيانات قناة المحادثة الحالية الوصفية ورابط PDF عام لا يقدّم الطالب رمزًا أو معرّف محادثة. لا يحتوي Action على معاملات يملؤها النموذج.

نزّل fernway-course-guide.pdf من الحزمة لفحص المثال. تستخدم الوصفة رابطه العام في هذا الموقع. لملفك الخاص، استخدم رابط HTTPS مباشرًا تستطيع Telegram جلبه دون تسجيل دخول، ويعيد PDF بنوع المحتوى الصحيح. اجعل المستندات المجلوبة بالرابط أقل من 20 MB. تميّز Telegram بين جلب الروابط ورفع الملفات في وثائق إرسال الملفات.

افتح Actions & MCPs، واختر Add Action، ثم منشئ API Action، واضبط الحقول التالية. إن اقترح المنشئ مسودة مولّدة، طابق الطلب الفعلي مع الوصفة قبل تفعيلها.

محرر API Action يعرض POST sendDocument ومرجع Telegram System Token وبيانات المحادثة الحالية في جسم JSON توضع شريحة الرمز في الرابط، وشريحة بيانات المحادثة في Body. رابط PDF ثابت.

API Action Name

send_course_brochure

What to ask the user first

FormatNameDescriptionRequired
دون معاملاتلا شيءاترك القسم فارغًا. تأتي قيم الطلب كلها من الاتصال أو الوصفة الثابتة.لا ينطبق

API Endpoint: method and URL

اختر POST وأدخل:

https://api.telegram.org/bot{{telegram_bot_token}}/sendDocument

استخدم Add AI Data لإدراج telegram_bot_token من System Tokens. هذا مرجع إلى بيانات اعتماد الروبوت المتصل، وليس موضعًا للصق الرمز نفسه.

Headers

المفتاحالقيمة
Content-Typeapplication/json

Body: الصق في تبويب Body الخاص بـ API Endpoint.

{
  "chat_id": "{{metadata_telegram_chat_id}}",
  "document": "https://quickchat.ai/blog-assets/tutorials/create-telegram-bot/fernway-course-guide.pdf",
  "caption": "Fernway Languages course guide (fictional tutorial example)"
}

أدرج telegram_chat_id من البيانات الوصفية للمحادثة عبر Add AI Data. صيغته القالبية هي {{metadata_telegram_chat_id}}. تضبطه قناة Telegram من المحادثة الواردة، لذلك يعود PDF إلى تلك المحادثة. اترك رابط المستند والتعليق ثابتين.

API Action Description

Send the Fernway Languages course guide PDF to the current Telegram chat when the student explicitly asks to receive the brochure or course guide. Do not call this action for a price, schedule or trial question alone. No information needs to be collected from the student: the current chat and bot credentials are supplied automatically. Call it once per explicit request. Confirm delivery only if the request succeeds.

احفظ Action وفعّله. يتضمن Main Prompt الكامل قاعدة الطلب الصريح بالفعل. تُوثّق طريقة Bot API في sendDocument.

تحقق من الملف، وليس من الرد وحده

  1. في Telegram، أرسل How much is the B1 English course?. تحقق من وصول السعر دون ملف لم تطلبه.
  2. أرسل Can you send me the brochure?.
  3. تأكد من وصول مرفق PDF وإمكانية فتحه كدليل دورات Fernway.
  4. في Inbox، افتح المحادثة ووسّع بطاقة Action المستدعى. من بطاقة Action ضمن Actions & MCPs، افتح View logs لفحص الطلب والنتيجة. يجب حجب الرمز قبل مشاركة لقطة شاشة.
  5. تأكد من أن الوجهة هي المحادثة الحالية وأن مستندًا واحدًا أُرسل لهذا الطلب.

في الاختبار الفعلي، أعاد send_course_brochure حالة HTTP 200 مع استجابة Telegram ok: true. تعرض اللقطة الافتتاحية مرفق fernway-course-guide.pdf الناتج في محادثة الطالب. تؤكد نتيجة الطلب والملف المستلم معًا نجاح التسليم؛ نص تأكيد الوكيل وحده لا يكفي.

نفّذ اختبار التسليم في Telegram. لا تملك محادثات Simulation سياق رمز روبوت Telegram الحقيقي. استخدم Simulation لفحص الإجابات، والمحادثة الفعلية للتحقق من تسليم الملف.

الخطوة 7: كيف تحوّل محادثة Telegram إلى شخص؟

فعّل Human Handoff كي يغيّر طلب التحدث إلى شخص المسؤول عن المحادثة، ثم اجعل زميلًا يرد من Inbox.

  1. افتح Actions & MCPs، وفعّل Human Handoff، واختر Edit Action.
  2. احتفظ بإعدادات Handoff Rules الافتراضية، مع تشغيل Media Message وUser Frustration وCustomer Support Suggestion وLack Of Knowledge، وإيقاف Irrelevant Advice. يربط Main Prompt الأمر /help بطلب شخص بالفعل؛ لا يضيف المثال قاعدة تحويل مخصصة.
  3. للتجربة الخاضعة للإشراف، اترك Human Agents’ availability معطّلًا وأبقِ زميلًا عند Inbox أثناء الاختبار. اترك Email notifications معطّلًا. هذه إعدادات المثال؛ عدم تقييد التحويل لا يعني توفر شخص دائمًا.
  4. قبل الإطلاق، فعّل جدول التوفر واضبط المنطقة الزمنية وساعات العمل لتطابق حضور الفريق الفعلي. عدّل رسالة خارج الدوام وفقًا لذلك.
  5. احفظ Action. في المحادثة الخاصة للروبوت، أرسل I want to talk to a person. وإذا طلب تأكيدًا فأجب Yes.
  6. في Inbox، تأكد من أن الذكاء الاصطناعي لم يعد مُسندًا. اختر Assign to me وأرسل Hi, this is Alex from Fernway. Which course would you like help with?. تحقق من وصول الرسالة إلى Telegram.
  7. أرسل رسالة طالب إضافية بينما يتولى الشخص المحادثة. تأكد من صمت الذكاء الاصطناعي. افتح قائمة المسؤول واختر AI Agent، ثم أرسل سؤالًا جديدًا عن الدورات للتحقق من عودة الردود الآلية.

محادثة Telegram فعلية في Quickchat AI Inbox مع طلب موظف وحالة Unassigned وزر Assign to me يترك الطلب المحادثة الفعلية بحالة Unassigned، جاهزة لزميل يختار Assign to me. يحتوي رد الدليل السابق أيضًا على مؤشر مطوي لاستدعاء Action.

دورة التحويل من إجابات الذكاء الاصطناعي عن الدورات إلى إيقاف الأتمتة ورد موظف من Inbox ثم إعادة الإسناد يبقى الطالب في Telegram. يحتاج التحويل الناجح إلى تغيير الإسناد ووصول رد بشري. اختر AI Agent من قائمة المسؤول عندما ينبغي استئناف الأتمتة.

محادثة Fernway في Telegram تعرض طلب شخص وتأكيد التحويل ورد المشغّل Alex ورسالة المتابعة من الطالب

يصل رد المشغّل من Inbox إلى محادثة Telegram نفسها. يستطيع الطالب المتابعة دون تغيير التطبيق.

Quickchat AI Inbox يعرض رد المشغّل ومتابعة الطالب وإعادة إسناد المحادثة إلى AI Agent بعد دور المشغّل، يعود الإسناد إلى AI Agent. تلقى سؤال المستوى التالي إجابة الذكاء الاصطناعي المعروضة في الخطوة 5.

قد يؤدي نقص معلومة إلى التحويل، كما حدث في اختبار المستوى المحلي. افحص النتيجتين منفصلتين: يجب ألا يخمّن الرد، وأي ادعاء بالتحويل يجب أن يغيّر المسؤول في Inbox. يشرح دليل Human Handoff التوفر والتوجيه بمزيد من التفصيل.

يضيف شرح التحويل من روبوت الدردشة إلى موظف اختبارات لطلبات خارج الدوام وللتأكد من استمرار الردود الآلية بعد إعادة الإسناد.

كيف يتصرف الروبوت داخل مجموعة Telegram؟

يتحكم وضع الخصوصية في رسائل المجموعة التي تسلّمها Telegram إلى الروبوت. يعالج اتصال الروبوت الخاص في Quickchat AI الرسائل التي يتلقاها، ولا يضيف مرشحًا مستقلًا للرد على الإشارات فقط.

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

لمجموعة صف ينبغي أن يجيب فيها الروبوت عن الطلبات المباشرة:

  1. أرسل /setjoingroups إلى BotFather، واختر الروبوت، وفعّل الانضمام إلى المجموعات إن كان معطّلًا.
  2. أرسل /setprivacy، واختر الروبوت ثم Enable. أبقه عضوًا عاديًا دون صلاحيات مشرف. إذا غيّرت الخصوصية بعد إضافته، فأزله وأعد إضافته لتطبيق الإعداد.
  3. أضف الروبوت إلى مجموعة اختبار صغيرة تتحكم بها.
  4. أرسل رسالة عادية مثل See everyone in class tomorrow.. ينبغي ألا ينتج عنها رد بهذا الإعداد.
  5. أرسل /schedule@your_bot بعد استبدال your_bot باسم المستخدم الفعلي. افحص إجابة المواعيد، ثم استخدم إيماءة Reply في Telegram على تلك الإجابة للسؤال What does B1 cost?.

قد يتأثر /schedule وحده بآخر روبوت وُجّه إليه أمر. ليست @mention النصية بديلًا موثوقًا للأمر الموجّه في وضع الخصوصية القياسي. استخدم الصيغ الصريحة في الاختبار أعلاه. راجع قواعد خصوصية Telegram.

BotFather يعرض تفعيل انضمام روبوت Fernway إلى المجموعات وإعدادات الخصوصية

إعداد BotFather المحفوظ هو Enable. نفّذ فحوص رسائل المجموعة بروبوتك الخاص للتحقق من التسليم في تلك المجموعة.

استخدم اختبار المجموعة المنفصل أدناه الروبوت المشترك @QuickchatAI_bot المتصل بوكيل Fernway نفسه. أجاب عن أمر مواعيد موجّه وسؤال سعر أُرسل بالرد على رسالة الروبوت. يوضح ذلك خيار الروبوت المشترك؛ تحققنا من روبوت Fernway الخاص في المحادثات الخاصة، ولذلك ما زال سلوكه في المجموعة يحتاج الفحوص أعلاه.

مجموعة Fernway Study Group مع روبوت Quickchat AI المشترك يجيب عن أمر مواعيد موجّه ورد يسأل عن سعر دورة B1

تستخدم هذه المجموعة الروبوت المشترك @QuickchatAI_bot. أما الهوية في لقطات المحادثات الخاصة فهي روبوت Fernway المخصص.

قد يؤدي إيقاف الخصوصية أو جعل الروبوت مشرفًا إلى وصول المناقشات العادية إلى الوكيل وزيادة الردود. بالنسبة للإشراف، يشرح دليل إدارة مجموعات Telegram الصلاحيات الإضافية وضوابط Action.

المجموعة كلها محادثة مشتركة واحدة. مكان الاستفسارات الشخصية المتعلقة بالدورات هو المحادثة الخاصة للروبوت. إذا فُعّل Human Handoff في المجموعة، يتوقف الذكاء الاصطناعي للمجموعة كلها حتى إعادة الإسناد؛ ولا ينشئ محادثة خاصة مستقلة لذلك الطالب.

لماذا لا يرد روبوت Telegram؟

ابدأ بأبسط اختبار في محادثة خاصة، ثم افحص الاتصال ونوع الرسالة. يضيف سلوك المجموعات وتسليم الملفات متطلبات منفصلة.

العَرَضما يجب فحصه
أنشأ BotFather الروبوت لكنه صامتأكمل اتصال الوكيل. لا يوفر BotFather منطق الرد.
لا توجد تحيةافتح الروبوت الصحيح وأرسل /start، وافحص Enable your own bot وWelcome message المضبوطة.
توقف بعد تجربة خدمة روبوت أخرىربما استبدلت الخدمة webhook. أعد اتصال الخدمة المطلوبة، واستخدم روبوتًا مستقلًا للمسار الآخر.
توقف بعد تبديل الرمزحدّث Bot Token بالبديل واحفظ الاتصال.
يرد في الخاص ولا يرد في المجموعةافحص عضوية المجموعة والخصوصية واسم المستخدم الحقيقي. جرّب /schedule@your_bot أو الرد على رسالة منه.
يرد على كل رسائل المجموعةافحص ما إذا كانت الخصوصية معطّلة أو كان الروبوت مشرفًا. عد إلى الإعداد الأقل إزعاجًا أعلاه.
يظهر الأمر في القائمة لكن الإجابة غير ذات صلةافحص قاعدة Main Prompt، بما فيها صيغة الأمر الموجّه. تسجيل القائمة وحده لا يحدد السلوك.
يقول إنه أرسل PDF لكن لا يظهر مرفقافحص استدعاء Action الفعلي ورابط PDF المباشر واستجابة Telegram. اختبر عبر Telegram مع تفعيل اتصال الروبوت الخاص.
يرد حتى التحويل ثم يتوقفافحص المسؤول في Inbox. تنتظر المحادثة البشرية أو غير المسندة موظفًا أو إعادة إسناد.
لا يستطيع الوكيل الإجابة أو تتوقف الاختباراتافحص الرصيد المتاح ومعالجة المعرفة وتفعيل الوكيل.
تعيد Telegram خطأ حدّ المعدلقلّل معدل الرسائل والتزم بفاصل إعادة المحاولة الذي تعيده Telegram.

قبل مشاركة الروبوت، كرر فحوص السعر والمعلومة المجهولة وPDF ورد الموظف في الخاص باستخدام محتواك الفعلي. استبدل جميع معلومات Fernway وروابطها بمعلوماتك. استخدم وثائق قناة Telegram لمرجع الإعداد الحالي للتكامل.

هل يستطيع ChatGPT أو Claude مساعدتك في بناء الروبوت؟

يستطيع عميل ذكاء اصطناعي متصل بحساب Quickchat AI إعداد Agent والمعرفة والتعليمات وActions ومجموعة الاختبار. تظل مسؤولًا عن إنشاء هوية Telegram في BotFather وإدخال رمزها عبر مسار الروبوت الخاص في لوحة التحكم.

اتصل عبر إدراج ChatGPT أو إدراج Claude الموثّق، باتباع تعليمات Manage with AI. أعطِ المساعد حزمة الإعداد وهذا الطلب:

Create a separate learning Agent named Fernway Languages from this tutorial kit. Do not change existing Agents. Set its display name and Identity name, add the knowledge article, and copy the Main Prompt and welcome message exactly. Configure send_course_brochure from action.json but leave it inactive. Use only the System Token reference, never ask me to paste my real Telegram token into chat. Create the Fernway course-answer dataset and evaluation criteria. Prepare Human Handoff using the default rules and show me the availability settings to review. Read back the saved configuration. Do not run tests, spend credits, send Telegram messages or activate Actions yet. List the remaining owner steps: create and configure the bot in BotFather, enter its token under Your own bot, review working hours, activate the Action and complete the real-channel checks. Do not use the shared Telegram connection as a substitute for my own bot.

اتصال إدارة الحساب المستخدم هنا منفصل عن إتاحة Agent كأداة MCP. يمكنه المساعدة في ضبط سير العمل، لكنه لا يغني عن فحص رد Telegram ومرفقه الفعليين.

الأسئلة الشائعة

كيف أنشئ روبوت Telegram دون برمجة؟

افتح BotFather الرسمي في Telegram وأرسل /newbot، واختر اسم عرض واسم مستخدم فريدًا ينتهي بـ bot. اربط الرمز الذي تحصل عليه بخدمة روبوتات مثل Quickchat AI. أضف معرفتك وتعليماتك، وفعّل الاتصال، ثم اختبر رسالة خاصة. ينشئ BotFather الهوية، وتوفر الخدمة المتصلة الإجابات.

هل إنشاء روبوت Telegram مجاني؟

تسجيل روبوت Telegram عبر BotFather مجاني. لدى Quickchat AI خطة Free للتعلم الشخصي غير التجاري مع حصة محدودة من رصيد الذكاء الاصطناعي. يحتاج النشر التجاري إلى خطة تجارية. تستهلك إجابات الذكاء الاصطناعي وSimulation Testing الرصيد؛ إنشاء هوية Telegram لا يشمل استخدامًا غير محدود للذكاء الاصطناعي.

أين أجد رمز روبوت Telegram الخاص بي؟

افتح BotFather الرسمي، وأرسل /mybots، واختر روبوتك ثم API Token. الصق بيانات الاعتماد في حقل Bot Token المخصص لدى خدمة الروبوت. لا تضعها في تعليمات أو مقالة معرفة أو مستودع عام أو لقطة شاشة.

ماذا أفعل إذا تسرب رمز روبوت Telegram؟

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

هل يمكنني ربط روبوت Telegram واحد بمنصتين؟

للروبوت وجهة webhook واحدة للتحديثات الواردة. إذا استبدلت المنصة الثانية هذا webhook، تتوقف الأولى عن استقبال التحديثات. تستطيع أنظمة متعددة إجراء طلبات API صادرة، لكن الرسائل الواردة لا تُنسخ تلقائيًا للمنصتين. استخدم روبوتات منفصلة لمسارات استقبال مستقلة.

كيف أضيف أوامر إلى روبوت Telegram؟

أرسل /setcommands إلى BotFather، واختر الروبوت، وقدّم زوجًا من الأمر والوصف في كل سطر دون شرطة مائلة في البداية. ينشئ هذا القائمة، لكن يجب تنفيذ السلوك أيضًا: يربط Main Prompt في هذا الدليل /prices و/schedule و/trial و/help بالإجابات أو Action المناسب.

لماذا يرد روبوت Telegram في الخاص ولا يرد في مجموعة؟

تأكد من انضمام الروبوت إلى المجموعة وجرّب أمرًا موجّهًا إلى اسم مستخدمه الحقيقي، مثل /schedule@your_bot، أو ردًا على إحدى رسائله. مع تفعيل الخصوصية، لا تُسلّم المحادثات العادية إلى روبوت ليس مشرفًا. الإشارة النصية ليست بديلًا موثوقًا للأمر الموجّه.

هل يمكنني إضافة الذكاء الاصطناعي أو ChatGPT إلى روبوت Telegram؟

يمكنك ربط روبوت BotFather بخدمة ذكاء اصطناعي. يستخدم هذا الدليل Quickchat AI Agent بمعرفته وMain Prompt وActions الخاصة به، ولا يربط محادثتك الشخصية في ChatGPT بـ Telegram. يستطيع مساعد متوافق لإدارة الحساب تجهيز الوكيل، بينما يكمل المالك اتصال الروبوت الخاص.

هل يستطيع هذا الروبوت الإجابة عن الرسائل الصوتية؟

لا ينسخ تكامل Telegram في Quickchat AI الملاحظات الصوتية إلى نص للوكيل حاليًا. قد يظهر مرفق صوتي في Inbox، لكن الدليل يعتمد على رسائل مكتوبة. اطلب من الطالب كتابة سؤاله أو اطلب من شخص مراجعة المرفق.

هل يؤتمت هذا حساب Telegram الشخصي؟

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

Quickchat AI Quickchat AI Ask Quickchat AI a question