Slack Notifications¶
فريقكم يعيش أصلًا داخل سلاك. ترسل إضافة Slack Notifications إلى كل شخص إشعارات Turbo EA الخاصة به بوصفها رسالة مباشرة في سلاك — مهمة أُسندت إليه، أو قرار ينتظر توقيعه، أو مخاطرة وقعت على عاتقه — مع زر يعيده مباشرة إلى البطاقة.
ويبقى القرار بيد كل شخص: إذ يظهر في إعدادات إشعاراته عمود سلاك إلى جانب «داخل التطبيق» و«البريد الإلكتروني»، يؤشّر فيه بدقة على أنواع الإشعارات التي يريد وصولها عبره. ولا شيء مفعَّل افتراضيًا.
لمحة سريعة¶
| الترخيص | تجارية — يلزم حق ترخيص موقّع |
| الحد الأدنى لإصدار Turbo EA | 2.89.1 |
| الصلاحية | ext.slack-notify.admin |
| تصاريح الوصول إلى البيانات | core.notifications.channel، core.users.read |
| هل تلزم إعادة تشغيل الواجهة الخلفية | نعم — تتضمن شيفرة للواجهة الخلفية |
| أين تظهر | الإدارة → الإعدادات → عمليات التكامل → سلاك · عمود سلاك في إعدادات الإشعارات لدى الجميع |
ولا يلزم سوى اتصال HTTPS صادر إلى slack.com — فلا عنوان وارد، ولا ردّ نداء
OAuth، ولا مراجعة في متجر سلاك. ولهذا تعمل الإضافة على النسخ المستضافة ذاتيًا أو
خلف جدار حماية.
الإعداد¶
افتحوا الإدارة → الإعدادات → عمليات التكامل واختاروا التبويب الفرعي سلاك. وتقودكم اللوحة عبر ثلاث خطوات مرقّمة.
1. أنشئوا تطبيق سلاك¶
تعرض اللوحة بيان تطبيق (manifest) جاهزًا. في سلاك اختاروا Create New App →
From a manifest، وحدّدوا مساحة العمل، والصقوا البيان (ثمة زر نسخ البيان)، ثم
اضغطوا Install to Workspace وانسخوا Bot User OAuth Token — وهو يبدأ بـ
xoxb-.
ويطلب البيان أربعة نطاقات للبوت لا غير:
| النطاق | الغرض |
|---|---|
chat:write |
إرسال الرسالة المباشرة |
im:write |
فتح المحادثة المباشرة مع شخص |
users:read |
قراءة دليل الأعضاء |
users:read.email |
ربط حساب Turbo EA بعضو في سلاك عبر البريد الإلكتروني |
اتركوا تدوير الرموز معطّلًا
يعطّل البيان عن قصد تدوير الرموز في سلاك. فتفعيله يجعل رمز البوت ينتهي كل 12 ساعة، وهو ما لا تستطيع هذه النسخة تجديده: فيتوقف التسليم مرتين يوميًا.
2. اربطوا مساحة العمل¶
| الحقل | ملاحظات |
|---|---|
| رمز OAuth الخاص بالبوت | الرمز xoxb-…. يُخزَّن مشفَّرًا؛ اتركوه فارغًا لاحقًا للإبقاء عليه |
| الاسم الظاهر في رسائل سلاك | Turbo EA افتراضيًا. ويُستخدم في زر الرسالة وتذييلها |
| تسليم الإشعارات إلى سلاك | مفعّل افتراضيًا — وهو مفتاح إيقاف مؤقت لا خطوة إعداد |
اضغطوا حفظ ثم اختبار الاتصال؛ فيؤكد وسم ظهور Connected to ….
3. اربطوا الأشخاص¶
تُربط الحسابات عبر عنوان البريد الإلكتروني أول مرة يستحق فيها شخص ما رسالة، وتُخزَّن النتيجة مؤقتًا. وتسرد بطاقة الأشخاص الجميع، مع تقديم الحالات الإشكالية، مع وسوم تبيّن من هو مرتبط ومن غير موجود في سلاك ومن لم يُفحص بعد.
ولمن يختلف عنوانه في سلاك عن بريده في Turbo EA، أدخلوا معرّف عضو سلاك الخاص به
(بالصيغة U01ABCDEF) واضغطوا حفظ — فالربط اليدوي يتقدم دائمًا على المطابقة عبر
البريد. ويثبت إرسال رسالة اختبار أن الربط يعمل من طرف إلى طرف. أما إفراغ الحقل
فيعيد الشخص إلى البحث بالبريد.
ويُعاد تلقائيًا مرة كل يوم فحصُ الأشخاص الذين لا يعرفهم سلاك، فمن ينضم إلى مساحة عمل سلاك بعد حصوله على حساب Turbo EA يُشمَل دون أي تدخل.
لا يُخزَّن سوى معرّفات الأعضاء
تخزّن الإضافة معرّفات أعضاء سلاك لا غير — أما عناوين البريد الإلكتروني فتبقى في Turbo EA.
ما يتحكم فيه كل شخص¶
ما إن تعمل الإضافة حتى يحصل الجميع على عمود سلاك في إعدادات الإشعارات، إلى جانب «داخل التطبيق» و«البريد الإلكتروني».
- كل نوع معطّل افتراضيًا. فلا يتلقى أحد رسالة في سلاك قبل أن يفعّل ذلك النوع لنفسه.
- ويخبر تذييلٌ أسفل الجدول كل شخص بما إذا كان حسابه مرتبطًا بسلاك، أو بأن عليه أن يطلب من أحد المديرين إجراء الربط.
- أما إعلان التحديث المقتصر على التطبيق فلا يُسلَّم في سلاك أبدًا.
فـ Turbo EA هي التي تقرر أنواع الإشعارات الموجودة ومن فعّلها؛ أما الإضافة فتنقل الرسالة فحسب.
كيف تبدو الرسالة¶
تتضمن الرسالة المباشرة في سلاك عنوان الإشعار بخط عريض، ثم نص الرسالة، وزرًا باسم Open in Turbo EA (بالاسم الذي أعددتموه) يقود إلى البطاقة أو الصفحة المعنية، وتذييلًا صغيرًا يذكر اسم التطبيق ونوع الإشعار.
والتسليم أحادي الاتجاه بصرامة — من Turbo EA إلى سلاك — وهو دائمًا رسالة مباشرة شخصية. ولا يُنشر أي شيء في قناة إطلاقًا.
متابعة التسليم¶
تعرض بطاقة سجل التسليم عدد الرسائل المنتظِرة والمرسَلة والفاشلة، إضافة إلى أحدث 50 سطرًا من السجل.
توضع الرسائل في طابور وتُرسل خلال ثوانٍ. وإذا حدّ سلاك من المعدل أو أعاد خطأ، أعادت الإضافة المحاولة بفواصل متزايدة واستسلمت بعد ست محاولات؛ أما الأعطال الدائمة — رمز مُبطَل، أو مستخدم محذوف، أو نطاق مفقود — فتتوقف فورًا بدل إهدار المحاولات. وتُحذف سطور الرسائل المسلَّمة بعد 14 يومًا.
وللطابور المتوقف سببان اثنان لا ثالث لهما، وتذكر اللوحة أيهما ينطبق:
- لا يوجد رمز بوت مخزَّن — الصقوا الرمز واحفظوا.
- التسليم معطّل — أعيدوا تفعيل تسليم الإشعارات إلى سلاك.
ويعيد إعادة محاولة الفاشلة إدراج كل ما استُسلم بشأنه في الطابور، ويعيد فحص الأشخاص الذين لم يعرفهم سلاك. وهو سبيل التعافي بعد انقطاع أو بعد تبديل رمز.
الصلاحيات¶
| الصلاحية | تتيح |
|---|---|
ext.slack-notify.admin |
إعداد الاتصال بمساحة العمل، وربط الأشخاص، وإرسال رسائل اختبار، وقراءة سجل التسليم، وإعادة محاولة الفاشل |
والتبويب الفرعي مخفي عن سائر الأشخاص. أما المستخدمون النهائيون فلا يحتاجون إلى أي صلاحية إضافية — إذ يكتفون بالتأشير في إعدادات إشعاراتهم الخاصة.
إذا انتهى الترخيص أو عُطِّلت الإضافة¶
يتوقف التسليم مؤقتًا ويختفي عمود سلاك من مربع الحوار، لكن تُحفظ جميع الإعدادات وجميع الاشتراكات. ويستأنف ترخيصٌ مُجدَّد التسليم. وينطبق الأمر نفسه على مفتاح تسليم الإشعارات إلى سلاك الذي يوقف التسليم مؤقتًا دون إلغاء تثبيت أي شيء: فالرسائل المنتظِرة تنتظر لا أكثر.
ورمز البوت مخزَّن مشفَّرًا ومستثنى من نقل مساحة العمل.
الحدود¶
- رسائل مباشرة فقط — فلا نشر في القنوات.
- لا أزرار تفاعلية. فإجراءات مثل وضع علامة منجَز أو اعتماد من داخل سلاك غير متاحة في هذه النسخة؛ بل تُحيل الرسالة إلى Turbo EA.
- لا رسائل مجمّعة — فكل إشعار رسالة قائمة بذاتها لا ملخّصًا مجمّعًا.
- لا تفعّلوا تدوير الرموز في سلاك (انظروا التحذير أعلاه).