Telegram

قم بتوصيل وكيل Triggerfish الخاص بك بـ Telegram حتى تتمكن من التفاعل معه من أي جهاز تستخدم فيه Telegram. يستخدم المحوّل إطار عمل grammY للتواصل مع Telegram Bot API.

الإعداد

الخطوة 1: إنشاء بوت

1. افتح Telegram وابحث عن @BotFather
2. أرسل /newbot
3. اختر اسم عرض للبوت (مثل "My Triggerfish")
4. اختر اسم مستخدم للبوت (يجب أن ينتهي بـ bot، مثل my_triggerfish_bot)
5. سيرد BotFather بـ رمز البوت -- انسخه

حافظ على سرية الرمز رمز البوت يمنح تحكماً كاملاً في

بوتك. لا تقم بإيداعه في التحكم بالمصادر أو مشاركته علنياً. يخزنه Triggerfish في سلسلة مفاتيح نظام التشغيل. :::

الخطوة 2: الحصول على معرّف مستخدم Telegram

يحتاج Triggerfish إلى معرّفك الرقمي للتحقق من أن الرسائل منك. يمكن تغيير أسماء مستخدمي Telegram وهي غير موثوقة للهوية -- المعرّف الرقمي دائم ومُعيّن من خوادم Telegram، لذا لا يمكن تزويره.

1. ابحث عن @getmyid_bot على Telegram
2. أرسل له أي رسالة
3. يرد بمعرّف المستخدم الخاص بك (رقم مثل 8019881968)

الخطوة 3: إضافة القناة

شغّل الإعداد التفاعلي:

triggerfish config add-channel telegram

يطلب هذا رمز البوت ومعرّف المستخدم ومستوى التصنيف، ثم يكتب التكوين في triggerfish.yaml ويعرض إعادة تشغيل الخادم.

يمكنك أيضاً إضافته يدوياً:

channels:
  telegram:
    # botToken مخزّن في سلسلة مفاتيح نظام التشغيل
    ownerId: 8019881968
    classification: INTERNAL

الخيار	النوع	مطلوب	الوصف
botToken	string	نعم	رمز Bot API من @BotFather
ownerId	number	نعم	معرّف مستخدم Telegram الرقمي الخاص بك
classification	string	لا	سقف التصنيف (الافتراضي: INTERNAL)

الخطوة 4: ابدأ المحادثة

بعد إعادة تشغيل الخادم، افتح البوت في Telegram وأرسل /start. سيرحب البوت بك لتأكيد أن الاتصال فعّال. يمكنك بعدها الدردشة مع وكيلك مباشرة.

سلوك التصنيف

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

كيف يعمل لكل رسالة:

• أنت ترسل رسالة للبوت (معرّف المستخدم يطابق ownerId): تستخدم الجلسة سقف القناة. مع الافتراضي INTERNAL، يمكن لوكيلك مشاركة بيانات المستوى الداخلي معك.
• شخص آخر يرسل رسالة للبوت: جلسته تُلوّث تلقائياً بـ PUBLIC بغض النظر عن تصنيف القناة. قاعدة عدم الكتابة لأسفل تمنع أي بيانات داخلية من الوصول إلى جلسته.

هذا يعني أن بوت Telegram واحداً يتعامل بأمان مع محادثات المالك وغير المالك. يتم فحص الهوية في الكود قبل أن يرى LLM الرسالة -- لا يمكن لـ LLM التأثير عليه.

تصنيف القناة	رسائل المالك	رسائل غير المالك
PUBLIC	PUBLIC	PUBLIC
INTERNAL (افتراضي)	حتى INTERNAL	PUBLIC
CONFIDENTIAL	حتى CONFIDENTIAL	PUBLIC
RESTRICTED	حتى RESTRICTED	PUBLIC

انظر نظام التصنيف للنموذج الكامل و الجلسات والتلوث لكيفية عمل تصعيد التلوث.

هوية المالك

يحدد Triggerfish حالة المالك بمقارنة معرّف مستخدم Telegram الرقمي للمرسل مع ownerId المُعدّ. يتم هذا الفحص في الكود قبل أن يرى LLM الرسالة:

• تطابق -- تُوسم الرسالة كمالك ويمكنها الوصول إلى بيانات حتى سقف تصنيف القناة
• عدم تطابق -- تُوسم الرسالة بتلوث PUBLIC، وقاعدة عدم الكتابة لأسفل تمنع أي بيانات مصنّفة من التدفق إلى تلك الجلسة

عيّن معرّف المالك دائماً بدون ownerId، يعامل Triggerfish

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

تقسيم الرسائل

لدى Telegram حد 4,096 حرف للرسالة. عندما يولّد وكيلك رداً أطول من هذا، يقسمه Triggerfish تلقائياً إلى رسائل متعددة. يقسم المُقسّم عند أسطر جديدة أو مسافات لسهولة القراءة -- يتجنب قطع الكلمات أو الجمل من المنتصف.

أنواع الرسائل المدعومة

يتعامل محوّل Telegram حالياً مع:

• الرسائل النصية -- دعم إرسال واستقبال كامل
• الردود الطويلة -- تُقسّم تلقائياً لتناسب حدود Telegram

مؤشرات الكتابة

عندما يعالج وكيلك طلباً، يعرض البوت "typing..." في دردشة Telegram. يعمل المؤشر أثناء توليد LLM للرد ويختفي عند إرسال الرد.

تغيير التصنيف

لرفع أو خفض سقف التصنيف:

triggerfish config add-channel telegram
# اختر الكتابة فوق التكوين الموجود عند الطلب

أو عدّل triggerfish.yaml مباشرة:

channels:
  telegram:
    # botToken مخزّن في سلسلة مفاتيح نظام التشغيل
    ownerId: 8019881968
    classification: CONFIDENTIAL

المستويات الصالحة: PUBLIC، INTERNAL، CONFIDENTIAL، RESTRICTED.

أعد تشغيل الخادم بعد التغيير: triggerfish stop && triggerfish start