Slack (أدوات للقراءة فقط)

عائلة أدوات Slack للقراءة فقط, سرد القنوات، وقراءة السجل والسلاسل، والبحث عن المستخدمين، والبحث في الرسائل. خاصّة بالمالك، ولا تنشر أبدًا.

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

الربط

لا شيء جديد لربطه هنا, فالأدوات تركب الاتصال نفسه الذي تستخدمه قناة Slack. فإذا كان Slack مربوطًا أصلًا كقناة، فأدوات القراءة متاحة؛ وإن لم يكن، فاربطه مرة واحدة فتُفعَّل الواجهتان معًا.

اتّبع ربط Slack كقناة, الصق Bot Token وSigning Secret الخاصَّين بتطبيق Slack لديك.
فعّل أدوات قراءة Slack للوكيل الذي ينبغي أن يستخدمها.
يستطيع الوكيل الآن قراءة Slack أثناء عمله على مهمة, ولا يزال غير قادر على النشر عبر هذه الأدوات.

المزلق الحقيقي: هذه الأدوات خاصّة بالمالك, فهي لا تعمل إلا على الواجهات الداخلية/الخاصة بالمالك (وكيل لوحة التحكم لديك)، ولا تعمل أبدًا لزائر موقع عامّ. والبحث يحتاج أكثر من رمز وكيل: إذ تتطلّب slack_search_messages رمزًا بنطاق مستخدم يحمل search:read. ومساحة العمل المربوطة برمز وكيل فقط تحصل على الأدوات الستّ الأخرى، لكن البحث يعيد خطأ واضحًا بأنه «يتطلّب رمز مستخدم».

الأدوات

الأداة	الوصول	النوع	ما تفعله
`slack_list_channels`	خاصة بالمالك	Read	يسرد القنوات العامة والخاصة التي يراها الوكيل, المعرّف والاسم والموضوع/الغرض وعدد الأعضاء وحالة الأرشفة. بترقيم صفحات بالمؤشّر.
`slack_channel_history`	خاصة بالمالك	Read	يقرأ الرسائل الأخيرة من قناة: المُرسِل والنص والطابع الزمني وبيانات السلسلة والتفاعلات. استخدم list_channels لإيجاد معرّف القناة.
`slack_thread_replies`	خاصة بالمالك	Read	يجلب الردود في سلسلة، انطلاقًا من الطابع الزمني للرسالة الأصل من سجل القناة.
`slack_channel_members`	خاصة بالمالك	Read	يسرد المشاركين في قناة، مع تحويل معرّفات المستخدمين إلى أسماء وعناوين بريد اختياريًا.
`slack_list_users`	خاصة بالمالك	Read	يسرد مستخدمي مساحة العمل, المعرّف والاسم والاسم الحقيقي والبريد عند توفّره ورايات الوكيل/المعطّل. بترقيم صفحات بالمؤشّر.
`slack_user_info`	خاصة بالمالك	Read	يبحث عن مستخدم واحد بمعرّفه: الاسم والبريد والمنطقة الزمنية والمسمّى الوظيفي والحالة.
`slack_search_messages`	خاصة بالمالك	Read	يبحث في الرسائل عبر مساحة العمل بمعدّلات مثل التقييد بقناة أو بمُرسِل. ويحتاج رمز مستخدم يحمل search:read.

هذا هو كامل السطح: فكل أداة أعلاه للقراءة فقط، ولا شيء هنا يكتب.

آمن للعموم مقابل خاصّ بالمالك

على خلاف البحث على الويب، لا شيء من أدوات Slack آمن للعموم. فكلٌّ منها خاصّ بالمالك, ولا يستطيع الوكيل الوصول إليها إلا على واجهة داخلية/خاصة بالمالك، ولا يشغّلها أبدًا زائر على وكيل عامّ. وهذا مقصود: فقنوات مساحة العمل وسجل الرسائل وعناوين بريد الأعضاء بيانات حسّاسة، ولذلك تُخفى استدعاءات الأدوات كذلك عن تدفّق المحادثة. وإذا أردت أن يتصرّف الوكيل في Slack أمام العموم, فيردّ على الرسائل المباشرة والإشارات بعلامة @, فتلك هي قناة Slack، وهي قدرة منفصلة.

مثال عملي

تسأل مساعد لوحة التحكم الخاص بك: «ماذا قرّرت قناة ‎#launch بشأن صفحة الأسعار الأسبوع الماضي؟» فيشغّل الوكيل slack_list_channels ليجد معرّف ‎#launch، ثم slack_channel_history لسحب الرسائل الأخيرة، ويتتبّع قرارًا داخل سلسلته بـslack_thread_replies، ثم يلخّص لك, قارئًا فقط، دون أن ينشر كلمة في Slack.

للقراءة فقط، بحكم التصميم

لا توجد أدوات كتابة في هذه العائلة. فالوكيل يستطيع السرد والقراءة والبحث، لكنه لا يستطيع النشر أو التعديل أو التفاعل أو الدعوة أو الأرشفة. وأي شيء ينبغي أن يقوله الوكيل في Slack يمرّ عبر القناة بدلًا من ذلك.

استكشاف الأخطاء

الأدوات لا تظهر. فهي خاصّة بالمالك, تأكّد من أنك على واجهة داخلية/خاصة بالمالك (لا قناة عامة) وأن Slack مربوط كقناة أولًا.
البحث يعيد «يتطلّب رمز مستخدم». فـslack_search_messages تحتاج رمزًا بنطاق مستخدم يحمل search:read؛ ومساحة العمل ذات رمز الوكيل فقط تستطيع استخدام الأدوات الستّ الأخرى دون البحث.
القنوات الخاصة مفقودة. فالوكيل لا يرى إلا القنوات التي هو عضو فيها, ادعُه إلى القناة الخاصة، ثم أعِد السرد.
الأعضاء يظهرون كمعرّفات لا أسماء. أبقِ تحويل الأسماء مفعّلًا في slack_channel_members، أو حوّل معرّفًا واحدًا بـslack_user_info, فـSlack لا يضمّن الأسماء دائمًا.

أسئلة شائعة

هل يستطيع الوكيل النشر عبر هذه الأدوات؟ لا, فهي للقراءة فقط تمامًا. والنشر مهمّة قناة Slack.

هل أربط Slack مرتين؟ لا. فاتصال Slack واحد يشغّل القناة وأدوات القراءة هذه معًا.

لماذا لا يستطيع وكيلي العامّ استخدامها؟ لأنها تكشف بيانات مساحة العمل، فهي خاصّة بالمالك بحكم التصميم ولا تعمل أبدًا لزائر.

قناة Slack, الاتصال الذي تتشاركه هذه الأدوات، وكيف يتحدّث الوكيل في Slack
API مخصّص, اربط أي نظام آخر بوكيلك
نظرة عامة على التكاملات, كل تطبيق قابل للربط وكل عائلة أدوات