إعداد إشعارات Mattermost باستخدام إضافة discourse-chat-integration

[Discourse]

تصف هذه الدليل كيفية إعداد مزود Mattermost المضمن في discourse-chat-integration.

التفعيل

يتم تضمين إضافة discourse-chat-integration مع منصة Discourse. لا يلزم تثبيت منفصل. للتفعيل، تأكد من أن إعداد الموقع chat_integration_enabled مفعل.

الإشعارات

إعداد Mattermost

يجب أن يكون خادم Mattermost قابلاً للوصول من خادم Discourse الخاص بك لربطهما. يُوصى باستخدام HTTPS، لكن HTTP يجب أن يعمل أيضًا.

1. في وحدة التحكم في النظام (System Console) في Mattermost، تحت التكاملات المخصصة (Custom Integrations)، تأكد من تفعيل الإعدادات التالية:

   • تفعيل الروابط الواردة (Enable Incoming Webhooks)
   • تفعيل إمكانية تجاوز أسماء المستخدمين من قبل التكاملات
   • تفعيل إمكانية تجاوز أيقونات الصور الشخصية من قبل التكاملات
   • تفعيل أوامر الشريحة المخصصة (Enable Custom Slash Commands) (إذا كنت تريد استخدام أوامر الشريحة)

2. سجّل الدخول إلى فريقك، انقر على اسمك في الزاوية العلوية اليسرى، ثم انقر على \u003ckbd\u003eالتكاملات\u003c/kbd\u003e

3. اختر \u003ckbd\u003erوابط الويب الواردة\u003c/kbd\u003e، ثم \u003ckbd\u003eإضافة رابط ويب وارد\u003c/kbd\u003e

4. أدخل "اسم العرض"، "الوصف"، واختر قناة عشوائية من القائمة (لا يهم أي قناة تختارها، فـ Discourse سيجري تجاوز هذا الإعداد)

\u003cimg src="//assets-meta-cdck-prod-meta.s3.dualstack.us-west-1.amazonaws.com/original/3X/d/a/da17356f254cb84e84738ffe8f4a0652de2f2677.png" height="200"\u003e

5. \u003ckbd\u003eحفظ\u003c/kbd\u003e

6. انسخ الرابط المقدم، ستحتاجه لاحقًا

إعداد Discourse

1. الصق الرابط الذي نسخته في إعداد الموقع chat_integration_mattermost_webhook_url

2. فعّل chat_integration_mattermost_enabled

3. قم بإعداد بعض "القواعد" لقنواتك، وفقًا لتعليمات discourse-chat-integration. تبدو معرفات القنوات مثل #town-square أو @davidtaylor.

4. انقر على \u003ckbd\u003eاختبار\u003c/kbd\u003e في إحدى القنوات للتحقق من أن كل شيء يعمل بشكل صحيح. يجب أن تستقبل رسالة مثل هذه:
   

   

أوامر الشريحة

تسمح أوامر الشريحة لك بإدارة قواعدك من داخل Mattermost. لجعلها تعمل:

1. إذا لم تكن قد فعلت ذلك بالفعل، فعّل تفعيل أوامر الشريحة المخصصة في وحدة التحكم في النظام (System Console) في Mattermost

2. سجّل الدخول إلى فريقك، انقر على اسمك في الزاوية العلوية اليسرى، ثم انقر على \u003ckbd\u003eالتكاملات\u003c/kbd\u003e

3. اختر \u003ckbd\u003eأوامر الشريحة\u003c/kbd\u003e، ثم \u003ckbd\u003eإضافة أمر شريحة\u003c/kbd\u003e

   • اسم العرض: Discourse
   • الوصف: إدارة قواعد إشعارات Discourse
   • كلمة تشغيل الأمر: discourse
   • رابط الطلب: \u003cyour-discourse-url\u003e/chat-integration/mattermost/command
   • طريقة الطلب: POST
   • اسم المستخدم في الاستجابة: Discourse
   • أيقونة الاستجابة: (اختياري: حدد رابط أيقونة)
   • الإكمال التلقائي:
   • تلميح الإكمال التلقائي: إدارة تكامل هذه القناة مع Discourse
   • وصف الإكمال التلقائي: [watch|follow|mute|delete|status|help]

4. \u003ckbd\u003eحفظ\u003c/kbd\u003e

5. انسخ "الرمز" المقدم، والصقه في إعدادات موقع Discourse تحت chat_integration_mattermost_incoming_webhook_token

6. جرّب إرسال /discourse help في قناة Mattermost الخاصة بك - يجب أن تحصل على رسالة تحتوي على قائمة بالأوامر الممكنة

[sam (Sam Saffron)]

I recommend you also post this on the mattermost Discourse to get more feedbacks

Integration with Discourse

and probably a dedicated topic.

(also I wish we warned communities about hideous looking oneboxes cause they are missing images)

[zogstrip]

@sam

also I wish we warned communities about hideous looking oneboxes cause they are missing images

I think we already do in the dashboard if they use the default images for the logos.

[david (David Taylor)]

Mattermost integration now supports slash commands (their implementation is built to be compatible with Slack’s)

I have also created a topic about it on the Mattermost forum, it can be found here:

[SOLVED] Discourse integration with Mattermost

[nommaz]

Hello! I am getting a broken image link to the right of the mattermost post. I tried to see the image url and it looks like an actual post instead of an image:

http://destek.hugin.com.tr/t/hugin-destek-topluluguna-hos-geldiniz/183/1

Is it intended to be the post author image I wonder?

Any tips on how to fix it?

[david (David Taylor)]

Hi @nommaz - sorry about that. It was indeed trying to load an image from the URL of the post, which clearly isn’t going to work

I’ve fixed it now, so if you update to the latest version of the plugin it should work as intended

Remove incorrect thumb_url from mattermost

[nommaz]

Hi David didnt work unfortunately

Are you sure it is not an issue with mattermost_provider.rb:68 ?

Thanks

Vedat

[david (David Taylor)]

Oops, I made the change in the slack provider instead of mattermost

Just added another commit to correct the error, so please can you give it another try

[nommaz]

Thanks! All set now

[Syscoincmt (Thomas)]

What’s up if I get a 422 error when trying (test) to hook to Mattermost?

[david (David Taylor)]

Make sure you copied the webhook URL correctly, and that there are no spaces before/after the URL. Is your mattermost server accessible to the internet? Or just an internal network?

[csmu (Keith John Hutchison - Ceiteach Seán Mac Úistin)]

@david

Paste the URL you copied into the chat_integration_mattermost_webhook_url

What’s the best way to handle multiple teams / multiple mattermost servers?

[Clint_Dovholuk]

لدي تكامل دردشة مع Mattermost ممكّن - لقد اشتركت في جميع فئات “المستوى الأعلى” التي يتم عرضها عبر الأمر “/discourse watch” ولكن المشاركات في “الفئات الفرعية” لم يتم التقاطها.

خذ هذه المشاركة: https://openziti.discourse.group/t/this-is-a-test-topic-in-the-sdks-category/271
يتم ترحيلها إلى Slack بشكل صحيح - ولكنها لا يتم ترحيلها إلى Mattermost. Slack قادر على الاشتراك في “جميع الفئات”. يبدو أن Mattermost غير قادر على ذلك.

لقد جربت كل الصيغ التي يمكنني التفكير فيها ولكن لم أوفق. أي نصائح؟؟

شكرا مقدما…

[Clint_Dovholuk]

@Clint_Dovholuk

عند تمكين التكامل مع mattermost - اشتركت في جميع الفئات “المستوى الأعلى” التي يتم عرضها عبر الأمر “/discourse watch” ولكن ص

@david - آسف على الإشارة ولكنني أفتقد منشورات discourse في تكامل الدردشة الخاص بي. هل هناك فرصة أنك لا تزال تتابع هذا الموضوع؟

[david (David Taylor)]

في الوقت الحالي، لا يتم تضمين الفئات الفرعية تلقائيًا عند “متابعة” فئة. ستحتاج إما إلى إضافة كل فئة فرعية فردية، أو استخدام خيار “كافة الفئات”.

[Clint_Dovholuk]

مرحباً، شكراً على الرد!!! سيكون ذلك رائعاً لو تمكنت من معرفة “كيف”. هل الفئات الوحيدة التي يبدو أن المكون الإضافي يتعرف عليها هي الفئات العلوية؟

لقد وجدت/جربت خيار “جميع الفئات” ولكنه لا يبدو أنه يعمل أيضاً؟ يا إلهي، أود حقاً أن أستخدم “الكل”، سيكون ذلك مثالياً… هل أنا “أفعل ذلك بشكل خاطئ”؟ انظر لقطة الشاشة أدناه

[Clint_Dovholuk]

@david

ستحتاج إما إلى إضافة كل فئة فرعية فردية، أو استخدام خيار “جميع الفئات”.

مرحباً @david… المشكلة في ما سبق هي أنني لا أستطيع معرفة كيفية الاشتراك في “فئة فرعية” ولا يبدو أن هناك “الكل” يمكنني استخدامه؟ أود حقًا حل هذه المشكلة.

شكرا!

[david (David Taylor)]

عذرًا على التأخير في الرد @Clint_Dovholuk!

باستخدام أوامر الشرطة المائلة، أعتقد أنه يمكنك مشاهدة جميع الفئات بهذا الشكل:

/discourse watch

ولكن أسهل طريقة لتكوين قواعد الإشعارات هي من لوحة تحكم مسؤول Discourse. هناك، يتم عرض جميع الخيارات بوضوح في واجهة المستخدم، لذلك لا داعي لمحاولة فهم بناء جملة “أمر الشرطة المائلة” الدقيق. تحقق من قسم ‘تكوين القواعد’ من وثائق المكون الإضافي لمزيد من المعلومات.

[Clint_Dovholuk]

شكرا @david.

لقد نشرت لقطة شاشة من الأمر المائل من قبل. أعيد نشرها هنا… يمكنك رؤية أن ‘الفئات الفرعية’ غير مدرجة في منشور أو منشورين أعلاه…

لقد جربت صفحة المسؤول من قبل ولكنها كانت تغلق القائمة المنسدلة فورًا عند استخدامها… ومع ذلك، بدا الضغط على ‘السهم لأسفل’ وكأنه يحرر ما أحتاجه.

أود حقًا خيار ‘الكل’. هل هذا مكون إضافي يمكنني تعديله/إصلاحه بطريقة ما؟؟ حاليًا يبدو الأمر هكذا

[david (David Taylor)]

@Clint_Dovholuk

يبدو الأمر هكذا الآن

للحصول على إشعارات لجميع المواضيع، أقترح حذف جميع هذه القواعد الخاصة بفئات معينة، ثم إضافة قاعدة واحدة لـ “جميع الفئات”.

@Clint_Dovholuk

لقد جربت صفحة المسؤول من قبل ولكنها كانت تغلق القائمة المنسدلة فورًا عند استخدامها…

هل يمكنك مشاركة المزيد من التفاصيل حول ما تراه هنا؟ ستكون بعض لقطات الشاشة أو مقطع فيديو رائعة!

عند تحرير “قاعدة”، يجب أن تكون قادرًا على استخدام القائمة المنسدلة للفئة لاختيار “(بدون فئة)”.

بمجرد الحفظ، يجب أن يبدو الأمر هكذا:

(“بدون فئة” في القائمة المنسدلة هو بالتأكيد وصف سيء لما يعنيه بالفعل. سأقوم بإصلاح ذلك)

@Clint_Dovholuk

لقد نشرت لقطة شاشة من الأمر المائل من قبل. أعيد نشرها هنا… يمكنك رؤية أن “الفئات الفرعية” غير مدرجة في منشور أو منشورين أعلاه…

أعتقد أن الفئات الفرعية محذوفة من نص المساعدة لتوفير المساحة. ولكن لا يزال بإمكانك الاشتراك في الفئات باستخدام “الاسم المختصر” الخاص بها (اسم الفئة الفرعية من عنوان URL). لذا في حالة #howto:admins هنا على Meta، سيكون /discourse watch admins.