Slack

يُربط Slack بلصق Bot Token وSigning Secret الخاصّين بتطبيق Slack لديك وتفعيل Event Subscriptions، ولا يوجد OAuth بنقرة واحدة. عندئذٍ يردّ وكيلك على الرسائل المباشرة وعلى رسائل القنوات التي تُشير إليه عبر @، ويتابع المحادثة داخل سلاسل الرسائل، ويتعامل مع مرفقات الصور والصوت والملفات، لكنه لا يقرأ أو يجيب على الأحاديث العادية في القنوات، بل على ما يُوجَّه إليه فقط. وأمران يميّزان Slack عن معظم القنوات: فهو لا يستخدم كتلة إعدادات القنوات المشتركة، والاتصال نفسه يشغّل أيضًا عائلة أدوات Slack للقراءة فقط ضمن التكاملات.

قبل أن تبدأ

• تطبيق Slack في مساحة العمل التي تريد ربطها (أنشئ واحدًا من لوحة تطبيقات Slack).
• Bot Token وSigning Secret الخاصّان به، تلصق كليهما أثناء الإعداد.
• صلاحية تعديل Event Subscriptions وOAuth scopes لذلك التطبيق.
• يحتاج الـ bot token إلى نطاقَي chat:write وchat:write.public كي يتمكّن من الرد في القنوات التي لم يُدعَ إليها.

يمكنك ربط أكثر من مساحة عمل، فكل تطبيق Slack قناة قائمة بذاتها.

الربط

1. افتح تطبيق Slack الخاص بك (أو أنشئه) وانسخ Bot Token وSigning Secret.
2. في AnyBot، أضف قناة Slack والصق كليهما. يتحقّق AnyBot من الـ token فورًا، وأي token خاطئ يُرفض في الحال.
3. انسخ Webhook (Request) URL الذي يعطيك إياه AnyBot. وفي Event Subscriptions بتطبيق Slack لديك، فعّلها والصق الرابط في حقل Request URL، يتحقّق Slack منه تلقائيًا.
4. تحت Subscribe to bot events، أضف app_mention وmessage.im وmember_joined_channel، ثم احفظ وأعد تثبيت التطبيق.

على هذه القناة

• أين يردّ: الرسائل المباشرة (دائمًا) ورسائل القنوات التي تُشير إليه عبر @. وبمجرد أن يصبح جزءًا من سلسلة، يواصل الرد داخلها؛ أما الأحاديث العادية في القناة فيتجاهلها.
• عند إضافته إلى قناة: ينشر ترحيبًا قصيرًا يعرّف بنفسه ويوضّح أنه لا يجيب إلا على الإشارات عبر @.
• سلاسل الرسائل: تبقى الردود داخل السلسلة على الرسالة الأصلية.

إعدادات القناة

Slack لا يستخدم الكتلة المشتركة للردّ التلقائي / رسالة الترحيب / ساعات العمل / معدّل الردود التي تشترك فيها معظم القنوات. بل يُحدَّد سلوكه بالاتصال نفسه: يجيب على الرسائل المباشرة والإشارات عبر @، ويرحّب بالقناة عند إضافته إليها أول مرة. ولا توجد هنا علامة تبويب إعدادات خاصة بالقناة لضبطها، راجع إعدادات القنوات لمعرفة القنوات التي تشترك في تلك الكتلة ولماذا يقع Slack خارجها.

وهو أيضًا أداة: Slack للقراءة فقط

اتصال Slack نفسه يعمل كذلك بوصفه عائلة أدوات للقراءة فقط ضمن التكاملات. فبوصفها أدوات، يستطيع وكيلك سرد القنوات، وقراءة سجل القنوات وسلاسل الرسائل، والبحث عن المستخدمين، والبحث في الرسائل، لكنه لا ينشر عبرها أبدًا. ميّز بين الاثنين: القناة تتيح للوكيل أن يتحدّث في Slack (الرسائل المباشرة والإشارات عبر @)؛ والأدوات تتيح له أن يقرأ Slack أثناء تنفيذ مهمة. وربط Slack هنا يفعّل الاثنين معًا.

حلّ المشكلات

• الـ Request URL لا يجتاز التحقّق. تأكّد أن Signing Secret يطابق تطبيق Slack لديك وأن الرابط هو الرابط الحالي الذي يعرضه AnyBot. يردّ AnyBot على تحدّي التحقّق من Slack تلقائيًا، لذا فالفشل يعني عادةً مفتاحًا سرّيًا خاطئًا أو رابطًا قديمًا.
• الوكيل يتجاهل رسائل القناة. إنه لا يجيب إلا على الإشارات عبر @، تأكّد أنك أشرت إليه وأن app_mention مشترَك فيه. وللرد في قناة لم يُدعَ إليها قط، يحتاج الـ token إلى chat:write.public.
• الردود تعمل في الرسائل المباشرة لا في القنوات (أو العكس). تحقّق من الاشتراك في message.im (الرسائل المباشرة) وapp_mention (الإشارات) معًا ضمن bot events.
• إسقاط الأحداث. تُرفض طلبات Slack الأقدم من خمس دقائق كحماية من إعادة التشغيل، وقد يتسبّب في ذلك انحراف كبير في ساعة الخادم.
• جهات الاتصال تظهر كمعرّفات لا كأسماء. لا يُدرج Slack أسماء العرض في حمولة الحدث، لذا قد يعرض صندوق الوارد معرّف مستخدم Slack إلى أن يُترجَم.
• التعديلات والحذف لا تفعل شيئًا. يتخطّى المُهيّئ تعديلات الرسائل وحذفها والرسائل المنشورة من التطبيقات، وذلك بحسب التصميم.

الأسئلة الشائعة

هل يقرأ الوكيل كل شيء في Slack؟ لا، بوصفه قناة، لا يرى إلا الرسائل المباشرة والرسائل التي تُشير إليه عبر @.

هل يمكنني ربط أكثر من مساحة عمل؟ نعم، كل تطبيق Slack قناة قائمة بذاتها.

هل هذا مثل أدوات تكامل Slack؟ مرتبط بها لكنه منفصل: تلك الأدوات للقراءة فقط ولا تنشر أبدًا. راجع القسم أعلاه.

الخطوة التالية

• إعدادات القنوات، الكتلة المشتركة التي يقع Slack خارجها
• التكاملات، عائلة أدوات Slack للقراءة فقط التي يفعّلها هذا الاتصال أيضًا
• نظرة عامة على القنوات، 8 قنوات وصندوق الوارد الموحّد الواحد