إعداد إشعارات Zulip باستخدام إضافة تكامل الدردشة

[Discourse]

يصف هذا #الدليل الإرشادي كيفية إعداد مزود Zulip المضمن في discourse-chat-integration.

إعداد Zulip

1. في إعداداتك الشخصية في Zulip، انتقل إلى Bots (البرامج الآلية)

2. انقر فوق Add a new bot (إضافة برنامج آلي جديد)

3. أدخل اسمًا وحدد Incoming webhook (خطاف ويب وارد) كـ bot type (نوع البرنامج الآلي)

4. انقر فوق Add (إضافة)

5. دوّن مفتاح واجهة برمجة التطبيقات (API Key) وعنوان البريد الإلكتروني، ستحتاجهما لاحقًا

إعداد Discourse

1. في إعدادات موقع Discourse الخاص بك، أدخل عنوان خادم Zulip الخاص بك في الإعداد chat_integration_zulip_server. تأكد من تضمين البروتوكول. (على سبيل المثال: https://chat.zulip.org)

2. الصق مفتاح واجهة برمجة التطبيقات الذي نسخته سابقًا في إعداد الموقع chat_integration_zulip_bot_api_key

3. الصق عنوان البريد الإلكتروني الذي نسخته سابقًا في إعداد الموقع chat_integration_zulip_bot_email_address

4. فعّل chat_integration_zulip_enabled

5. انتقل إلى علامة التبويب Plugins (الإضافات)، ثم Chat Integration (تكامل الدردشة)

6. انتقل إلى علامة التبويب Zulip، ثم Add Channel (إضافة قناة)

7. أدخل Stream (المجرى) الذي تريد إرسال الإشعارات إليه، وSubject (الموضوع) لإرفاقه بالرسائل

8. Save Channel (حفظ القناة)

9. استخدم زر Test (اختبار) على القناة التي أنشأتها للتو للتحقق من أن كل شيء يعمل. يجب أن ترى شيئًا كهذا:
   

   

10. قم بإعداد بعض “Rules” (القواعد) لقناتك، وفقًا لتعليمات discourse-chat-integration.

[OvermindDL1]

Would it be possible to have the discourse server be set to an entire stream on zulip, with a zulip topic matching a discourse category/topic and allowing posting back to Discourse messages to the appropriate zulip topic as either the zulip user themselves (if matching email address) or optionally as the bot user itself (would prefer using a matching discourse user by email, I use oidc for everything so it is all unified anyway, falling back to just posting as the bot itself with an appropriate ‘who said it’). It would be amazingly userful to respond to discourse threads while using the zulip-term terminal interface without needing to spool up a web browser (especially since I don’t have a GUI at times, only a pure console interface).

EDIT1: Also, are there any issues with this and running Zulip 2.0+?

EDIT2: Matching the user from discourse to zulip via email address would be possible as well, but it would need to become a System Bot in Zulip instead of just a General Bot as would be required to post messages back to Discourse, in terms of permissions needed (System bots are ‘above’ admin). Might be a useful optional ability though.