روبوت دردشة AI على Telegram: للمجموعات والرسائل الخاصة دون برمجة

يمكن لروبوت دردشة AI على Telegram الإجابة عن الأسئلة من معرفة نشاطك داخل مجموعة أو محادثة خاصة. يربط Quickchat AI وكيل AI Agent بمنصة Telegram عبر روبوت مشترك: أضفه إلى مجموعة، وأكّد الاتصال في لوحة التحكم، ليتمكن الأعضاء من سؤاله بالإشارة إليه. لا يحتاج هذا المسار إلى كود أو رمز من BotFather.

نبني في هذا الدليل Saltmarsh Sailing School، وهي مدرسة خيالية لها مجموعة أعضاء واستفسارات خاصة. يستخدم وكيلان معلومات المدرسة نفسها: يجيب Saltmarsh Group عن الأسئلة العامة، بينما يعالج Saltmarsh Sailing School طلبات الدروس التجريبية الخاصة ويستعين بموظف لطلبات الاسترداد. الطلب استفسار يراجعه المكتب، وليس حجزًا مؤكّدًا.

يفصل الوكيلان مسؤولية المحادثات. لا يملك وكيل المجموعة Action للتحويل أو تسجيل الطلبات؛ ويتولى الوكيل الخاص الاستفسارات وردود الموظفين.

اتبع المسار التالي. إضافة Google Sheets اختيارية؛ يمكنك إكمال الردود والتحويل إلى الموظفين أولًا.

نزّل حزمة Saltmarsh لـTelegram للحصول على المعرفة وMain Prompt وإعداد Action ومعايير التقييم ورسائل الاختبار نفسها. هذه ملفات قابلة للتحرير للخطوات التالية، وليست استيرادًا للوكيل بنقرة واحدة. تبقى مواد العرض القابلة للنسخ ولقطات الشاشة باللغة الإنجليزية.

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

تحتاج حساب Quickchat AI ووكيلين وحساب Telegram يملك صلاحية إضافة روبوت إلى مجموعة اختبار. وتتطلب خطوة تسجيل الطلبات الاختيارية حساب Google يمكنه منح صلاحية Google Sheets.

1. أنشئ حساب Quickchat AI وأكمل التحقق من البريد إن طُلب. تدعم Free التعلّم الشخصي غير التجاري. تُطبّق الخطط لكل Agent، لذا يحتاج النشاط التجاري الذي يستخدم الوكيلين إلى تغطية تجارية مناسبة لكليهما. يستهلك Preview وSimulation رصيد AI. راجع الخطط الحالية.
2. أنشئ مجموعة Telegram باسم Saltmarsh Members. استخدم مجموعة اختبار لفحص الإشارات والصمت والرسائل اللاحقة قبل دعوة العملاء.
3. استخدم حسابك في Telegram لاتباع الخطوات، بما فيها رسائل الزائر. ويمكنك أيضًا تشغيل Inbox في Quickchat AI. قبل دعوة العملاء، اطلب من زميل التحقق من التجربة عبر حساب آخر.
4. فك ضغط الحزمة. احتفظ بمعلومات المدرسة النموذجية معًا، واستبدلها بسياساتك المتحقق منها قبل النشر.

تعرض لقطات Quickchat App تطبيقًا يعمل محليًا بإعداد Saltmarsh الخيالي؛ وتُعرّف بيانات اختبار الاتصال في التعليقات المصاحبة. تعرض لقطات Telegram وGoogle Sheets الردود الفعلية للتجربة المتصلة والاستفسار المحفوظ. قُصّت تفاصيل الحساب الشخصي أو أُخفيت بوضوح. استخدم قائمة الفحص النهائية لتكرار الاختبارات بمعرفتك وحساباتك المتصلة.

الخطوة 1: كيف تعلّم روبوت Telegram معلومات نشاطك؟

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

الأسعار والسياسات حقائق المصدر. الاختصار والتعامل مع عدم اليقين والتوجيه تعليمات.

أنشئ Agent وأضف معرفته

1. في حساب جديد، اختر Set up manually. وفي حساب موجود، اختر Add new AI Agent أولًا، ثم المسار اليدوي.
2. في Identity، أدخل Saltmarsh Group في Name your AI Agent. الصق ملف group-main-prompt.txt من الحزمة في Describe what you want your agent to do.
3. تابع الإعداد دون ربط تطبيقات خارجية بعد. أكمل خطوة الخطة، واستخدم Skip for now إن كنت تبدأ بحساب التعلّم.
4. افتح Knowledge Base > Add Article. أدخل Courses and trial enquiries في Create custom article، واختر Create article، والصق saltmarsh-courses.txt في Content ثم Save.
5. كرر مع Weather, parking and personal enquiries باستخدام saltmarsh-policies.txt. انتظر ظهور Ready على المقالتين.
6. افتح Actions & MCPs في Saltmarsh Group. أبقِ Human Handoff معطّلًا ولا تضف Action طلب الدرس التجريبي.
7. اختر Add new AI Agent وكرر الإعداد اليدوي لـSaltmarsh Sailing School باستخدام main-prompt.txt وملفَي المعرفة نفسيهما. يعالج هذا الوكيل الثاني المحادثات الخاصة. اختر الوكيل المقصود في مبدّل الحساب قبل تعديل إعداداته.

يوضّح مصدران قصيران الحقائق المتاحة للوكيل. حالة Ready هي نقطة التحقق قبل اختبار المعرفة.

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

اضبط Main Prompt وافحص إجابة

1. افتح Identity > Main Prompt في كل Agent وافحص تعليمات Saltmarsh المناسبة له. تعليمات المجموعة تجيب عن الأسئلة العامة وتشير إلى الرابط الخاص المثبّت في المجموعة؛ والتعليمات الخاصة تجمع الطلبات وتستخدم Human Handoff.
2. افتح AI Preview واسأل How much is Start Sailing?. تحقق من ذكر يومين وEUR 240.
3. اسأل Do you rent wetsuits?. تحقق من اعتراف الإجابة بنقص المعلومات.

تحدد تعليمات الوكيل الخاص جمع المعلومات والتحويل. يستخدم وكيل المجموعة تعليمات منفصلة مع تعطيل الإجرائين.

لقطتان مقتطعتان من إعدادات وكيل المجموعة الحقيقية. يستطيع إجابة أسئلة المعرفة، لكنه لا يملك Action للتسجيل أو التحويل.

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

الخطوة 2: كيف تضيف روبوت AI إلى مجموعة Telegram؟

افتح External Apps > Telegram، وأضف الروبوت المشترك إلى المجموعة، ثم عد إلى Quickchat AI واختر Confirm للمجموعة. يبقى Agent صامتًا فيها حتى تؤكدها.

الانضمام إلى Telegram والتأكيد في Quickchat AI خطوتان منفصلتان.

1. اختر Saltmarsh Group في مبدّل الوكلاء. افتح External Apps، واختر Telegram، وابحث عن Quickchat AI bot.
2. اختر Add to a Telegram group. في Telegram، اختر Saltmarsh Members ووافق على إضافة الروبوت.
3. عد إلى Quickchat AI. تحت Waiting for your confirmation، افحص اسم المجموعة ومعلومات Added by.
4. اختر Confirm للمجموعة المطلوبة. يجب أن تنتقل إلى Connected chats مع تشغيل مفتاح التفعيل.
5. في Telegram، اكتب @ واختر الروبوت من قائمة الإشارات. اسأل How much is Start Sailing?. اسم الروبوت المشترك عادة @QuickchatAI_bot؛ استخدم الاسم الفعلي الظاهر في مجموعتك.
6. رد مباشرة على الإجابة بـWhat should I bring?. ثم أرسل رسالة مستقلة دون إشارة: Does anyone know the gate code?. ينبغي أن يجيب الروبوت عن الرد المباشر ويصمت أمام الرسالة العادية.

اختر Saltmarsh Members في Telegram، ثم عد إلى Quickchat AI لتأكيد الاتصال.

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

تلقت المجموعة المؤكدة الإجابة المتوقعة عن الدورة. أشر إلى الروبوت باسم المستخدم الفعلي له.

يمكنك الرد على رسالة الروبوت دون إشارة أخرى. تسرد الإجابة معلومات المعدات الواردة في المصادر.

التأكيد مهم لأن بيانات الدعوة تظهر في المجموعة. يتطلب Quickchat AI قرارًا من جهة الحساب قبل اعتبار المجموعة وجهة للوكيل. لا تؤكد مجموعة لا تعرفها. يشرح مرجع اتصال Telegram هذا الحد أيضًا.

أكمل التأكيد قبل مغادرة الإعداد. إذا غادر الروبوت مجموعة غير مؤكدة، فأنشئ رابط Add to a Telegram group جديدًا، وأضفه مرة أخرى، ثم أكّد المجموعة المعلّقة فورًا في Quickchat AI. لا تُغني إضافة الروبوت عبر البحث عن الأعضاء في Telegram عن مسار الاتصال هذا.

تعرض شارة Admin حالة الروبوت في Telegram. ليست مطلوبة لردود الروبوت المشترك المعتادة. وجعله مشرفًا لا يغيّر قاعدة الرد على الإشارات أو الردود المباشرة فقط.

الخطوة 3: كيف تفعّل محادثات Telegram الخاصة؟

فعّل Direct message link وشارك عنوان URL الذي تم توليده كاملًا. يختار الرابط وكيلك داخل الروبوت المشترك، ليتمكن العملاء من السؤال على الخاص دون إضافته إلى مجموعة.

المجموعة محادثة مشتركة. انقل التفاصيل الشخصية والتحويل إلى الموظفين إلى الرسائل الخاصة.

1. اختر الوكيل الخاص Saltmarsh Sailing School. افتح External Apps > Telegram وفعّل Direct message link. اترك اتصالات المجموعات فارغة.
2. انسخ الرابط الناتج. احتفظ بمعامل start=؛ الرابط الأساسي للروبوت المشترك لا يحدد وكيلك.
3. افتحه في Telegram واضغط Start إذا طُلب.
4. اسأل How much is Start Sailing? دون الإشارة إلى الروبوت. تحقق من إجابة المدرسة وابحث عن المحادثة في Inbox.
5. ثبّت الرابط في رسالة الترحيب بالمجموعة ليجده الناس قبل مشاركة معلومات شخصية.

استخدم الرابط المولّد لوكيلك. الإعداد المحلي المعروض ليس إيصال تسليم حقيقيًا في Telegram.

سلّم Telegram رسالة ترحيب Saltmarsh بعد Start. افحص إجابة من المعرفة بعد ذلك؛ التحية وحدها لا تختبر استرجاع المعلومات.

جزآن مقتطعان من شاشة Telegram نفسها يعرضان الدعوة المثبّتة. حُذفت قيمة start من رابط العرض؛ ثبّت رابطك الكامل الذي تم توليده.

ترتبط المحادثة الخاصة مع الروبوت المشترك بوكيل واحد في كل مرة. فتح رابط وكيل آخر قد يبدّل هذا الارتباط. لهوية Telegram خاصة بك وسلسلة محادثة مستقلة، استخدم مسار الروبوت الخاص.

إيقاف Direct message link يمنع الاتصالات الجديدة عبره. لإيقاف محادثة متصلة بالفعل، استخدم مفتاحها أو Disconnect. تعامل مع الرابط كمدخل عام، لا كقيد للوصول إلى معرفة سرية.

الخطوة 4: كيف تحفظ طلب تجربة في Google Sheets؟

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

الناتج طلب يتابعه موظف. لا يحجز مكانًا ولا يحدد سعر التجربة.

اربط Sheets واضبط Action واحدًا

1. على Saltmarsh Sailing School، افتح Actions & MCPs > Add Action > Google Sheets واختر Connect Google Sheets. سجّل الدخول إلى حساب Google المقصود ووافق على الوصول المطلوب.
2. افتح جدول Quickchat Leads الناتج. أبقِ اسم علامة التبويب Leads لأن عنوان Action يستهدفها.
3. استبدل صف العناوين بهذا الترتيب: Name، Preferred weekday، Sailing experience، Conversation link، Channel.
4. افتح Actions & MCPs وعدّل Action المولّد log_lead_to_google_sheet. استخدم الإعداد أدناه. غيّر المعاملات ومحتوى الطلب وعناوين الجدول معًا لتتطابق المواضع.

API Action Name

Record trial-lesson request

What to ask the user first

اضبط المعاملات الثلاثة على No default واحذف معاملي البريد والاستفسار الافتراضيين. هذه الحقول هي الأسئلة الوحيدة في هذا الإعداد. اسم مستخدم Telegram اختياري وليس حقل اتصال إلزاميًا موثوقًا؛ رابط المحادثة المسجّل يتيح للموظفين العودة إلى الطلب.

الطريقة والعنوان: احتفظ بعنوان POST الناتج. فهو يتضمن معرّف جدولك وعلامة Leads وvalueInputOption=RAW. لا يوجد معرّف جدول مؤقت تحتاج إلى تعبئته.

الترويسات: احتفظ بإعداد التكامل.

في تبويب Body ضمن API Endpoint، استخدم:

{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}

استخدم Add AI Data لإدراج شرائح المعاملات ومتغيرات المحادثة عند الحاجة. تأتي القيم الثلاث الأولى من المحادثة، ويزوّد Quickchat AI القيمتين الأخيرتين.

API Action Description

In a private chat only, call this once when the person has requested a trial lesson and provided their name, preferred weekday and sailing experience. Ask for the next missing required field before calling. Do not call it for general course questions, in groups, or to confirm a booking. A successful call records an enquiry for the office; it does not reserve a place.

افتح Advanced settings > Run only when وأضف telegram_chat_type equals private. استخدم مفتاح البيانات الوصفية وحده دون metadata_ أو أقواس معقوفة. يمنع ذلك إرسال HTTP لرسالة مجموعة حتى لو حاول النموذج. يشرح مرجع شروط التنفيذ هذا الفحص.

اضبط Response filter على $.updates.updatedRows لإرجاع عدد الصفوف بدل استجابة مزوّد غير ضرورية. أبقِ Action مفعّلًا.

المفتاح هو telegram_chat_type وحده. يُفحص الشرط قبل إرسال الطلب.

إعداد محلي للطلب. يجب أن يأتي عنوان Sheets وتفويض OAuth من اتصال Google الخاص بك.

افحص الصف ثم الطلب غير المكتمل

أرسل الرسالة التالية عبر رابط Telegram الخاص بالوكيل:

I am Alex Morgan. I want a trial on Tuesday. I am a beginner.

افحص المواضع الثلاثة: يصف الرد طلبًا، وتعرض بطاقة Action في Inbox القيم المقدّمة، وتحتوي علامة Leads الحقيقية على الصف المطابق. لا يثبت الرد المطمئن ولا تقييم Simulation المرتفع أن Google Sheets تلقّى عملية كتابة.

سجّل Agent الاسم المقدّم وتفضيل يوم الثلاثاء ومستوى المبتدئ. ما زال توفر الموعد والسعر الدقيق بحاجة إلى تأكيد المكتب.

تعرض اللقطتان تفاصيل الصف المحفوظ نفسه لتبقى أعمدته الخمسة مقروءة. أُخفي رابط المحادثة الخاص بالحساب، وبقيت القيم الأربع الأخرى دون تغيير.

ابدأ اختبارًا منفصلًا بـI would like a trial lesson. ينبغي أن يسأل Agent عن الحقول الناقصة، سؤالًا واحدًا في كل مرة، قبل تنفيذ Action. جرّب أيضًا How much is Start Sailing?؛ يجب ألا ينشئ السؤال العام صفًا. تطلب التعليمات كتابة واحدة لكل طلب، لكن إعداد الإلحاق ليس نظام حجز يمنع أثر التكرار. افحص الصفوف المكررة قبل استخدامه لاستقبال الطلبات فعليًا.

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

اضبط Human Handoff ثم تحقق من إسناد المحادثة في Inbox. عبارة «سيرد المكتب» في التعليمات لا تنقل المسؤولية أو توقف AI وحدها.

تغيير الإسناد هو نقطة التحقق. دع الموظف ينهي الحالة، وافحص العودة إلى AI على حدة.

1. اختر Saltmarsh Sailing School، وافتح Actions & MCPs > Human Handoff وفعّله. أبقِ هذا Action متوقفًا على Saltmarsh Group.
2. تحت Handoff Rules، اختر +. أدخل Private enquiries في Rule Name، والصق handoff-rule.txt في Description، وشغّل State. تبدأ الصفوف الجديدة غير مفعّلة. تشمل القاعدة الاسترداد والشكاوى وطلب شخص وقبول مساعدة بشرية على هذا الوكيل الخاص.
3. أفرغ Keywords وعطّل القواعد المسبقة لهذا المثال، واترك القاعدة المخصصة الوحيدة نشطة ثم احفظ. عزل المجموعة يأتي من تعطيل Human Handoff على وكيل المجموعة المنفصل؛ وتصف القاعدة متى يحوّل الوكيل الخاص.
4. اضبط Confirmation على I have passed this private conversation to the Saltmarsh office. A member of staff can reply here. اضبط Human Agents’ availability حسب ساعات التغطية الفعلية، واكتب رسالة صادقة لخارج الدوام.
5. من محادثة Telegram الخاصة، أرسل I want a refund for last week. Can I speak to a person?.
6. في Inbox، ابحث عن المحادثة وافحص الإسناد، واختر Assign to me، ثم أرسل Hi, I’m Alex from the office. I’ll review your request. تأكد من وصولها إلى Telegram.
7. أرسل رسالة عميل أخرى بينما يملك الموظف المحادثة. يجب أن يبقى AI صامتًا. دع الموظف ينهي الحالة ويحلّها في Inbox. تعامل مع إعادتها إلى AI كاختبار مستقل.

State للقاعدة المخصصة يعمل. المحفّزات المسبقة متوقفة، فتبقى قاعدة واحدة للمراجعة.

فعّل طلب Telegram الفعلي Handoff. جرى التحقق من إسناد Inbox ورسالة الموظف الصادرة كلٍّ على حدة.

في الفحص الفعلي، انتقلت المحادثة إلى Unassigned، جاهزة ليتولاها شخص. اختار الموظف Assign to me، وأرسل رد المكتب، وقبله Telegram. تعرض اللقطة أعلاه رد التحويل، ولا تعرض رسالة الموظف اللاحقة. افحص الإسناد والتسليم معًا عند تكرار الاختبار.

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

الخطوة 6: كيف تختبر روبوت Telegram كاملًا؟

استخدم Testing لفحوص ردود قابلة للتكرار، ثم تحقق من مسارات Telegram الحقيقية والآثار الخارجية كلًا على حدة. قد يجيب النموذج بشكل صحيح مع وجود خلل في اتصال المجموعة أو الكتابة إلى الجدول أو تسليم رد الموظف.

افحص النظام المسؤول عن النتيجة: المعرفة للحقائق، وسجلات Action للطلبات، وSheets للصفوف، وTelegram للتسليم.

شغّل مجموعة بيانات ردود قابلة للتكرار

1. افتح Testing، وأنشئ مجموعة باسم Saltmarsh: knowledge checks، واختر Paste messages.
2. الصق simulation-messages.txt. احتفظ بفواصل --- في سطر مستقل بين الحالات.
3. افتح Evaluation criteria، والصق evaluation-criteria.txt من الحزمة ثم احفظ.
4. اختر Run > Start Run، ثم افحص الردود الفردية إلى جانب الدرجات.

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

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

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

ماذا غيّرت الاختبارات المحلية؟

استخدم التصميم الأول وكيلًا واحدًا للمدخلين. أظهر اختبار محلي أن طلب استرداد في المجموعة يحوّل المحادثة المشتركة إلى Human Handoff. فصلنا الوكيلين وعطّلنا Handoff وActions تسجيل الطلبات على وكيل المجموعة. عند تكرار فحصَي الاسترداد والتجربة في المجموعة، وُجّه المستخدم إلى الرابط الخاص المثبّت مع بقاء المحادثة مسندة إلى AI. لهذا تستخدم الخطوة 1 الإعدادات، إلى جانب التعليمات، للفصل بين المحادثتين.

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

عند غياب المعرفة، تكون الإجابة «لا أستطيع التأكيد». لا تخاطب رسالة رمز البوابة المنفصلة الروبوت، ولا يظهر لها رد في هذه اللقطة.

أنتج طلب التجربة الخاص الفعلي استدعاءً ناجحًا واحدًا لـSheets Action بالقيم Alex Morgan وTuesday وbeginner. أعاد Google الرمز HTTP 200 وصفًا واحدًا محدّثًا؛ واحتوى الصف المحفوظ أيضًا على رابط المحادثة والقناة telegram. لم يرسل اختبار Action منفصل ببيانات وصفية لمحادثة مجموعة أي طلب HTTP. افحص الطلب الخاص المقبول وسياق المجموعة المرفوض معًا عند تعديل شرط التنفيذ.

افحص القناة وآثارها الخارجية

استخدم test-matrix.csv الفارغ في الحزمة لتسجيل ملاحظاتك. تعرض اللقطات أعلاه النتائج الموضّحة، ويشمل الجدول أيضًا فحوصًا تنفّذها بإعدادك الخاص. سجّل الوقت المنقضي عند اختبار الصمت، وافصل تولّي الموظف عن أي عودة لاحقة إلى AI.

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

متى تنشئ روبوتك الخاص باستخدام BotFather؟

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

اختر الهوية وسلوك الرسائل المطلوبين قبل إضافة روبوت ثانٍ.

1. افتح حساب BotFather الموثّق في Telegram وأرسل /newbot.
2. اختر اسم عرض ثم اسم مستخدم متاحًا ينتهي بـbot. يعيد BotFather رمزًا. احتفظ به سرًا.
3. اختر Saltmarsh Group إذا كان هذا البوت سينضم إلى مجموعة. أبقِ Saltmarsh Sailing School مخصصًا للمحادثات الخاصة فقط. في External Apps > Telegram، افتح Your own bot واختر Connect to Telegram.
4. الصق الرمز في Bot Token وأكمل الاتصال. تأكد من تشغيل Enable your own bot.
5. افتح رابط Telegram للروبوت وأرسل /start، ثم سؤال سعر الدورة نفسه.
6. لاستقبال الرسائل العادية، استخدم /setprivacy في BotFather، واختر روبوتك ثم Disable، وأزله من مجموعة الاختبار وأعد إضافته. يستقبل الروبوت المشرف أيضًا الرسائل العادية. تشرح وثائق وضع الخصوصية قواعد التسليم.

الصق الرمز في Bot Token فقط. يظهر الحقل فارغًا حتى لا تُنشر بيانات اعتماد.

ضع الروبوت المشترك وروبوتك في مجموعتين منفصلتين. تشغيلهما معًا قد ينتج ردودًا مكررة. لتثبيت الإعلانات أو إدارة الأعضاء، اتبع دليل إدارة مجموعات Telegram المنفصل، بما فيه شروط Actions الخاصة بالمشرفين.

هل يستطيع ChatGPT أو Claude المساعدة في إعداد روبوت Telegram؟

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

اربط إضافة Quickchat AI لـChatGPT أو موصل Claude، ثم أرفق ملفات الحزمة مع هذه التعليمات:

Use my connected Quickchat AI account to create two Agents from the attached kit: Saltmarsh Group with group-main-prompt.txt and Saltmarsh Sailing School with main-prompt.txt. Add both knowledge files to each. Keep Actions and Human Handoff off on Saltmarsh Group. Prepare the supplied knowledge-test dataset. Check the tools available in this client before changing settings. Show me the configuration and ask before running credit-consuming tests or writing to Google Sheets. Where supported, enable only Saltmarsh Sailing School's shared-bot direct-message link and return the complete link. Leave group selection, dashboard confirmation, BotFather setup, Google OAuth and unsupported settings for me, with exact dashboard steps. Report what was configured, what was actually tested and what remains to verify in Telegram.

تختلف الأدوات حسب التطبيق وصلاحيات الحساب. اتبع مرجع إعداد إدارة الحساب لتسجيل الدخول. يربط ذلك المساعد بحساب Quickchat AI؛ ولا يحوّل محادثتك الشخصية في ChatGPT أو Claude إلى خادم مستضاف للروبوت.

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

افحص الاتصال ومسار الرسالة قبل إعادة كتابة التعليمات. لهذه الأعراض أسباب مختلفة.

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

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

إعداد Saltmarsh القابل للنسخ

هذه هي حقائق المصادر والتعليمات كاملة كما يستخدمها الدليل. يتضمن التنزيل أيضًا إعداد Action ومعايير التقييم والاختبارات.

وكيل المجموعة: Main Prompt

الصق التالي في Identity > Main Prompt على Saltmarsh Group. أبقِ Human Handoff وActions المخصصة معطّلة لهذا الوكيل.

You answer general questions in the Saltmarsh Sailing School members' group. Use only the Knowledge Base and keep each reply to two or three sentences. Do not add facts or requirements the sources do not contain. If a fact is missing, say that you cannot confirm it.

For trial requests, refunds, complaints, personal details or a request for a person, direct the member to the school's private link pinned in the group; do not invent a link. Do not collect personal details in this group. You cannot record requests, confirm bookings, approve refunds or transfer a conversation to staff. Do not claim you did any of these things. The private Agent records an enquiry; it cannot check live availability or confirm a trial. Only the office confirms availability and price.

الوكيل الخاص: Main Prompt

الصق التالي في Identity > Main Prompt على Saltmarsh Sailing School. اجعل اسم Action مطابقًا للإعداد.

You are the private-chat assistant of Saltmarsh Sailing School. Answer school questions from the Knowledge Base. Do not add plausible details that are not in the sources, including extra clothing or footwear requirements. Keep replies to two or three sentences and ask at most one question per message. If a fact is missing, say that you cannot confirm it; do not invent dates, availability, gate codes or wetsuit rental. Explain weather policy without claiming to know the current forecast.

When a person requests a trial lesson, collect their name, preferred weekday and sailing experience. Ask for only the next missing field. When all three are present, use Record trial-lesson request once. Say the request was recorded only after the Action succeeds. Explain that the office still needs to confirm availability and price; never say a lesson is booked. If the Action is unavailable or fails, say the request has not been recorded and offer a person.

Use Human Handoff for a current unresolved refund request, complaint or explicit request for a person. After a staff member has resolved the enquiry and returned the conversation to AI, answer new general questions normally; do not hand off again solely because an earlier message mentioned a refund or asked for a person. Do not approve refunds or promise a response time. For a missing fact, say what is unknown and offer a person; do not treat uncertainty as a negative answer about the service.

المعرفة: الدورات وطلبات التجربة

الصق التالي في حقل Content للمقالة الأولى.

Saltmarsh Sailing School demonstration information

This fictional school is used only for a tutorial. It contains no real customer data.

Start Sailing is a two-day course costing EUR 240. Day Skipper theory runs across five evenings and costs EUR 310. A private lesson lasts 90 minutes and costs EUR 95.

Courses run from April to October. Course dates are published on the school's website one month ahead. This source does not contain the next available date or live availability.

Bring a waterproof jacket, non-marking shoes and a change of clothes. The school provides buoyancy aids.

A trial-lesson request is an enquiry, not a confirmed booking. The office needs the person's name, preferred weekday and sailing experience, then confirms availability and price. Do not collect payment details. Do not infer a trial price from the private-lesson price.

المعرفة: السياسات ومعلومات الأعضاء

الصق التالي في حقل Content للمقالة الثانية.

Saltmarsh Sailing School demonstration policies

If the forecast shows more than 25 knots of wind or thunderstorms, the session moves to the next available date at no extra cost. The instructor decides on the morning of the session. This source is a policy, not a live weather forecast or a cancellation decision.

Parking is free at the clubhouse. The gate code is sent to enrolled students the day before their course. The code itself is not in this Knowledge Base.

Refunds and complaints are handled by the office. An AI answer cannot approve a refund. A member of staff must decide each case.

The Telegram members' group is for general questions. Trial requests, refunds and other personal details belong in a private conversation with the school's Agent, opened from the school's direct-message link.

قاعدة Human Handoff

الصق التالي تحت Human Handoff > Handoff Rules واضبط التوفر الفعلي.

Transfer this private conversation to a person when the visitor has a current unresolved refund request, complaint, explicit request for a person, or accepts an offer of human help. After a staff member resolves the enquiry and returns it to AI, earlier refund or handoff messages must not trigger a new transfer for a general course question. Explain that a staff member can review the case here without approving a refund or promising a response time. This Agent is used only for private enquiries; the separate group Agent has Human Handoff disabled.

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

كيف أضيف روبوت دردشة AI إلى مجموعة Telegram؟

في Quickchat AI، افتح External Apps، واختر Telegram ثم Add to a Telegram group. اختر مجموعتك في Telegram، ثم عد إلى Quickchat AI واضغط Confirm. يستطيع الأعضاء السؤال بالإشارة إلى الروبوت المشترك أو الرد على إحدى رسائله.

هل يجيب روبوت AI على Telegram عن كل رسالة؟

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

هل أحتاج BotFather أو رمز روبوت Telegram؟

لا تحتاج BotFather أو رمزًا للروبوت المشترك ورابطه الخاص. أنشئ روبوتك باستخدام BotFather عندما تحتاج اسمًا وصورة مخصصين أو Actions تستدعي Telegram Bot API. تعمل Actions المعتادة لـGoogle Sheets مع الروبوت المشترك.

هل يستطيع العملاء مراسلة الروبوت على الخاص؟

نعم. فعّل Direct message link في Quickchat AI وشارك الرابط الناتج كاملًا. يفتحه العميل ويضغط Start إن طُلب. يختار الرابط وكيلك داخل الروبوت المشترك. إيقافه يمنع الاتصالات الجديدة؛ وللمحادثات الخاصة الموجودة عناصر منفصلة للتفعيل وقطع الاتصال.

هل روبوت AI على Telegram مجاني؟

إنشاء روبوت في BotFather لا يضيف خدمة AI بحد ذاته. يقدم Quickchat AI خطة Free للتعلّم الشخصي غير التجاري مع حصة محدودة من رصيد AI. يحتاج النشر التجاري خطة مدفوعة. تستهلك الردود وPreview وSimulation الرصيد، وقد تكون للخدمات الخارجية تكاليفها.

هل يدعم Telegram روبوتات AI؟

يدعم Telegram روبوتات AI من أطراف ثالثة وتكاملات AI. يربط هذا الدليل Agent من Quickchat AI يجيب من معرفة نشاطك. ينشئ BotFather هوية الروبوت؛ ولا يقدّم تلك المعرفة أو يضبط سير دعم العملاء.

هل يفهم الروبوت الصور والملفات؟

يمكن لتكامل Telegram استقبال الصور وتحليل محتواها المرئي. قد تصل ملفات أخرى كمرفقات، لكن محتوياتها لا تُقرأ تلقائيًا. اختبر أنواع الملفات التي يستخدمها عملاؤك وافحص Telegram وInbox معًا.

هل يمكن إنشاء روبوت شخصية أو تقمص أدوار على Telegram؟

نعم. يمكن لاتصال Telegram نفسه خدمة Agent بهوية شخصية وتعليمات مناسبة. يستخدم هذا الدليل مثال دعم تجاري؛ أما Agent تقمص الأدوار فيحتاج تعليماته واختباراته الخاصة.