مساعد طيّار Telegram Premium

دَع الـ Agent الذكي الخاص بك يردّ على الرسائل المباشرة على الحساب الشخصي لمستخدم Telegram Premium. يرى جهات اتصاله ما يبدو وكأنه ردود مستخدم Premium نفسه — مثالي للمؤسّسين والمبدعين وروّاد الأعمال الفرديين والفرق الصغيرة الذين يراسلهم عملاؤهم مباشرةً على حساب Telegram الشخصي.

نظرة عامة

يوفّر مساعد طيّار Telegram Premium ما يلي:

• ردود ذكية تُرسَل من خلال business_connection الخاص بمستخدم Premium، فيبدو الرد وكأنه صادر منه
• ربط لكل مستخدم Premium — يمكن لروبوت واحد دعم عدّة مستخدمي Premium في المؤسّسة نفسها
• استلام يدوي تلقائي — عندما يكتب مستخدم Premium ردًا بنفسه، يتوقّف الروبوت مؤقتًا في تلك المحادثة لفترة منزلقة كي لا يتحدّث فوق محادثة حية
• مفتاح إيقاف على مستوى الاتصال لإسكات الروبوت عبر كل المستخدمين المرتبطين دون قطع الاتصال
• نسخ الملاحظات الصوتية وردود البثّ المباشر، مثل قناة Telegram العادية تمامًا

كيف يختلف عن Telegram العادي

يربط دمج Telegram العادي Agent بـ صندوق وارد الروبوت نفسه — يراسل مستخدموك النهائيون الروبوت مباشرةً على t.me/<bot>. مساعد طيّار Telegram Premium هو العكس: يردّ الروبوت على حساب Telegram الشخصي لشخص ما، معترضًا الرسائل المباشرة التي تصل إلى قائمة الدردشة العادية لذلك الشخص.

المتطلّبات المسبقة

• حساب Telegram مع Telegram Premium لكل مستخدم يريد أن يردّ الروبوت نيابةً عنه
• روبوت BotFather جديد — مخصّص لوضع Business (لا يمكن إعادة استخدامه من قِبل عملية دمج أخرى)
• Agent في Cuneiform Chat مُعدّ ومُختبَر بالفعل في الـ Playground

خطوات الإعداد

1. أنشئ روبوتًا مخصّصًا في BotFather

1. افتح Telegram، وابحث عن @BotFather، وأرسل /newbot
2. اختر اسمًا واسم مستخدم
3. انسخ رمز الروبوت (Bot Token)

2. فعّل وضع Business على الروبوت

هذه الخطوة هي ما يجعل الروبوت مؤهّلًا للرد على حساب مستخدم Premium. بدونها، يرى مستخدمو Premium “this bot doesn’t support Telegram Business yet” عند إضافته.

1. في BotFather، أرسل /mybots واختر روبوتك الجديد
2. اختر Bot Settings ← Business Mode
3. فعّله ON

3. اربط الروبوت في Cuneiform Chat

1. في Cuneiform Chat، افتح Integrations في الشريط الجانبي
2. اعثر على بطاقة Telegram Premium co-pilot
3. انقر على Connect Premium bot
4. اختر Agent الذي ينبغي أن يجيب على الرسائل المباشرة (يمكنك تغييره لاحقًا)
5. الصق رمز الروبوت وأرسله

4. يربط مستخدمو Premium حساباتهم الشخصية

يقوم كل مستخدم Premium يريد أن يردّ الروبوت نيابةً عنه بهذا مرة واحدة:

1. على بطاقة Telegram Premium، انقر على Link a Premium user — يظهر رمز صالح لمدة 10 دقائق (مع اختصار QR)
2. يفتح مستخدم Premium Telegram ← Settings ← Business ← Chatbots
3. يضيف اسم مستخدم روبوتك ويفعّله
4. يفتح رسالة مباشرة عادية مع الروبوت ويرسل /start <code>
5. يردّ الروبوت بتأكيد

بمجرد إتمام الربط، يحصل كل جهة اتصال تراسل مستخدم Premium على ردود ذكية — باستثناء عندما يكتب مستخدم Premium ردًا بنفسه (راجع الاستلام اليدوي أدناه).

الميزات

الردود على حساب مستخدم Premium

عندما تراسل جهة اتصال مستخدم Premium، يسلّم Telegram حدث business_message إلى الروبوت عبر business_connection الخاص بمستخدم Premium. يستدعي الروبوت الـ Agent، ثم يرسل الرد عبر الاتصال نفسه — فترى جهة الاتصال الرسالة في السلسلة الموجودة، منسوبةً إلى مستخدم Premium. لا تُنشأ محادثة روبوت جديدة من جانب جهة الاتصال.

الاستلام اليدوي التلقائي

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

هذا يعني أن مستخدم Premium ليس عليه أن يوقف الروبوت صراحةً عند قفزه إلى محادثة — فالروبوت ببساطة يتنحّى جانبًا.

مفتاح إيقاف على مستوى الاتصال

إذا أراد مستخدم Premium تعطيل الردود الذكية عبر كل المحادثات دون فكّ الربط:

1. افتح بطاقة Telegram Premium في Cuneiform Chat
2. فعّل Disable auto-reply

تبقى عملية الدمج متّصلة (لا حاجة لإعادة الربط) لكن الروبوت لا يردّ على أي شيء. أعد تفعيله لاستئناف العمل.

الملاحظات الصوتية والتنسيق الغني

تُنسَخ الملاحظات الصوتية من جهات الاتصال عبر Whisper ويُجاب عنها مثل الرسائل المكتوبة. تُعرض الردود بتنسيق MarkdownV2 مع النص الغامق والمائل وكتل الكود والروابط — نفس مجموعة الأدوات في قناة Telegram العادية.

خيارات الإعداد

الإعدادات لكل عملية دمج

عناصر التحكّم لكل رابط

يعرض كل صف لمستخدم Premium على البطاقة:

• الاسم المعروض للمستخدم المرتبط
• طابع زمني لآخر نشاط
• عنصر تحكّم للحذف لفكّ ربط ذلك المستخدم (يتوقّف الروبوت عن الرد نيابةً عنه؛ تعود جهات اتصاله إلى عدم رؤية أي شيء من الروبوت)

نصائح

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

مستخدم Premium يرى “this bot doesn’t support Telegram Business yet”

وضع Business غير مُفعّل على الروبوت. انتقل إلى BotFather ← /mybots ← روبوتك ← Bot Settings ← Business Mode ← فعّله ON، ثم اطلب من مستخدم Premium إعادة محاولة خطوة Settings ← Business ← Chatbots.

انتهت صلاحية رمز الربط

الرموز صالحة لمدة 10 دقائق. انقر على Link a Premium user مرة أخرى لإنشاء رمز جديد.

الروبوت يبقى صامتًا للجميع

تحقّق من تبديل Disable auto-reply على بطاقة الدمج — عندما يكون مفعّلًا، يتجاهل الروبوت كل مستخدم مرتبط. أعد تفعيله.

الروبوت يبقى صامتًا لجهة اتصال محدّدة

كتب مستخدم Premium ردًا في تلك المحادثة مؤخرًا ولا يزال توقّف الاستلام اليدوي نشطًا. انتظر حتى تنقضي الفترة المنزلقة، أو اطلب من مستخدم Premium التوقّف عن الكتابة في المحادثة.

ردود الروبوت تبدو خاطئة

ترى جهات اتصال مستخدم Premium تمامًا ما يولّده الـ Agent. إذا تسرّب شيء خارج الهوية التجارية أو خارج السياسة، أصلحه في موجّه الـ Agent وأدواته — إنه نفس الـ Agent الذي تستخدمه قناة Telegram، مع نفس الـ Playground للاختبار.

قطع الاتصال

لإزالة دمج Telegram Premium:

1. من Cuneiform Chat: Integrations ← بطاقة Telegram Premium co-pilot ← القائمة ثلاثية النقاط ← Delete

يزيل ذلك كل رابط لمستخدم Premium ويوقف الروبوت عن الرد. يبقى الروبوت نفسه في BotFather ما لم تحذفه من هناك.

ذات صلة

• Telegram — قناة Telegram العادية الموجّهة للعملاء (لصندوق وارد روبوت الـ Agent الخاص بك)
• Saba on Telegram — مساعد المنصّة الموجّه للمشغّلين (ميزة مختلفة، تعتمد أيضًا على Telegram)
• Telegram Storefront — Storefront مدمج داخل الروبوت لقناة Telegram العادية