القنوات

ما هي القنوات؟

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

المفاهيم الأساسية:

التهيئة لكل وكيل -- يتم تهيئة كل اتصال بقناة على مستوى الوكيل. يمكن توصيل وكيل واحد بـ Slack بينما يتعامل آخر مع Discord، أو يمكن توصيل وكيل واحد بعدة قنوات في وقت واحد.
ثنائي الاتجاه -- تدعم القنوات إرسال الرسائل واستقبالها. يمكن للوكلاء الرد على الرسائل الواردة أو إرسال رسائل صادرة أو كليهما معًا.
متعدد الحسابات -- يمكنك ربط حسابات متعددة لنفس نوع القناة (مثلاً، مساحتا عمل مختلفتان في Slack أو عدة عناوين بريد إلكتروني).

القنوات المدعومة

القناة	طريقة المصادقة	الميزات
Slack	OAuth	رسائل كاملة، قنوات، خيوط، تفاعلات، رفع ملفات
Discord	رمز البوت	رسائل الخادم، القنوات، الرسائل الخاصة، التضمينات، التفاعلات
WhatsApp	رمز QR	رسائل نصية، رسائل وسائط، دردشات جماعية
Telegram	رمز البوت	رسائل نصية، مجموعات، قنوات، لوحات مفاتيح مضمنة، مشاركة ملفات
Signal	تطبيق محلي	رسائل مشفرة من طرف إلى طرف، دردشات جماعية
Microsoft Teams	OAuth	فرق، قنوات، محادثات، بطاقات تكيفية، مشاركة ملفات
Google Chat	OAuth	مساحات، رسائل مباشرة، بطاقات، محادثات مترابطة
SMS	مفتاح API	إرسال واستقبال الرسائل النصية عبر موفرين مدعومين
البريد الإلكتروني / Gmail	OAuth	إرسال، استقبال، صياغة، رد، مرفقات، إدارة التصنيفات
Matrix	رمز	رسائل متشعبة، غرف، تشفير من طرف إلى طرف
Line	رمز	رسائل نصية، ملصقات، دردشات جماعية، قوائم غنية
Zalo	رمز	رسائل نصية، مشاركة وسائط
IRC	إعداد	اتصالات الخادم، القنوات، الرسائل الخاصة
iMessage	محلي	رسائل macOS الأصلية (تتطلب مضيفًا يعمل بـ macOS)

ربط قناة

تختلف عملية الاتصال اعتمادًا على طريقة المصادقة الخاصة بالقناة.

تدفق OAuth

يُستخدم من قِبل: Slack وMicrosoft Teams وGoogle Chat والبريد الإلكتروني / Gmail

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

بالنسبة للمنصات المحمولة، يتوفر خيار رمز QR. امسح رمز QR من هاتفك لإكمال التفويض دون الحاجة إلى تسجيل الدخول من متصفح سطح المكتب.

رمز البوت

يُستخدم من قِبل: Discord وTelegram

أنشئ بوتًا على المنصة المعنية:
- Discord -- أنشئ تطبيقًا في بوابة مطوري Discord وأنشئ رمز بوت.
- Telegram -- أرسل رسالة إلى @BotFather على Telegram لإنشاء بوت واستلام رمز.
افتح علامة تبويب القنوات الخاصة بالوكيل وانقر فوق اتصال بجوار القناة.
الصق رمز البوت في حقل الرمز.
انقر فوق حفظ لإنشاء الاتصال.

رمز QR

يُستخدم من قِبل: WhatsApp

افتح علامة تبويب القنوات الخاصة بالوكيل وانقر فوق اتصال بجوار WhatsApp.
سيظهر رمز QR على الشاشة.
افتح WhatsApp على هاتفك، وانتقل إلى الأجهزة المرتبطة، وامسح رمز QR.
يتم إنشاء الاتصال بمجرد تأكيد هاتفك للرابط.

مفتاح API

يُستخدم من قِبل: SMS

احصل على مفتاح API من موفر SMS الخاص بك (مثلاً Twilio أو Vonage).
افتح علامة تبويب القنوات الخاصة بالوكيل وانقر فوق اتصال بجوار SMS.
أدخل مفتاح API والحقول الإضافية المطلوبة (مثلاً رقم الهاتف ومعرّف الحساب).
انقر فوق حفظ لتفعيل القناة.

الرمز

يُستخدم من قِبل: Matrix وLine وZalo

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

إعداد الخادم

يُستخدم من قِبل: IRC

افتح علامة تبويب القنوات الخاصة بالوكيل وانقر فوق اتصال بجوار IRC.
أدخل عنوان الخادم والمنفذ واسم المستخدم (nickname) وكلمة مرور اختيارية.
حدد القنوات للانضمام إليها عند الاتصال.
انقر فوق حفظ للاتصال.

التطبيق المحلي

يُستخدم من قِبل: Signal وiMessage

تأكد من تثبيت التطبيق المطلوب وتشغيله على الجهاز المضيف:
- Signal -- يجب تثبيت Signal Desktop وربطه بحساب Signal الخاص بك.
- iMessage -- يتطلب مضيفًا يعمل بـ macOS مع تهيئة Messages.app.
افتح علامة تبويب القنوات الخاصة بالوكيل وانقر فوق اتصال بجوار القناة.
سيكتشف Neotask التطبيق المحلي وينشئ اتصالاً.
إذا لم يتم اكتشاف التطبيق، ستتم مطالبتك بتثبيته أو تهيئته.

اختبار الاتصال

بعد توصيل أي قناة، يُشغّل Neotask تلقائيًا مسبارًا لقياس الزمن الكامن للتحقق من الاتصال:

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

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

عمليات القناة

بمجرد توصيل القناة، يمكنك إدارتها من علامة تبويب القنوات الخاصة بالوكيل.

التفعيل / التعطيل

قم بتبديل القناة تشغيلاً أو إيقافًا دون قطع الاتصال. عند التعطيل:

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

اختبار الاتصال

قم بتشغيل اختبار اتصال عند الطلب للتحقق من إمكانية الوصول إلى القناة والاستجابة. يقوم الاختبار بـ:

إرسال طلب API خفيف الوزن إلى خدمة القناة.
قياس زمن الاستجابة ذهابًا وإيابًا بالميلي ثانية.
الإبلاغ عن النتيجة بـ متصل (مع زمن الاستجابة) أو فشل (مع تفاصيل الخطأ).

عرض زمن الاستجابة

تعرض كل قناة متصلة أحدث قراءة لزمن الاستجابة على علامة تبويب القنوات. يساعدك هذا على تحديد الاتصالات البطيئة أو المتدهورة بسرعة. يتم تحديث زمن الاستجابة:

تلقائيًا بعد كل اختبار اتصال.
بشكل دوري في الخلفية أثناء نشاط القناة.

قطع الاتصال / تسجيل الخروج

لإزالة اتصال قناة بالكامل:

انقر فوق قطع الاتصال بجوار القناة.
قم بتأكيد الإجراء في مربع الحوار.
يلغي Neotask بيانات الاعتماد المخزنة أو يتخلص منها (يتم إلغاء رموز OAuth على جانب الموفر حيثما كان مدعومًا).
تتم إزالة القناة من قائمة القنوات النشطة للوكيل.

لإعادة الاتصال بعد قطعه، اتبع خطوات الاتصال الأصلية مرة أخرى.