اربط Slack بمساحة عملك

ما الذي ستبنيه

في نهاية هذا الدرس يكون لديك:

• تطبيق Slack أُنشئ لمساحة عملك، بالأذونات والأحداث الصحيحة أصلًا
• اتصال مباشر بين Slack وControl Center
• حساب Slack الخاص بك مربوط بمستخدمك في Control Center
• وكيل يجيبك في خيط Slack، وتذكرة تُفتح بأمر شرطة مائلة

المتطلبات:

• إتمام مساحة عملك الأولى وأرسل وكيلك الأول — مساحة عمل بلا وكلاء تستطيع استقبال رسالة Slack، لكن لا أحد يجيبها
• لدى وكيل CEO في مساحة العمل محوّل ونموذج مضبوطان في الإعدادات ← مساحة العمل ← الوكلاء. يوقظ الجسر وكيل CEO، لا الوكيل الذي هيّأته في الدرس السابق، والوكيل بلا محوّل يعمل على الحلقة المضمّنة بالنموذج الافتراضي لدى Anthropic.
• دور owner أو admin في مساحة عمل Control Center (توصيل تطبيق دردشة يتحدث باسم مساحة العمل كلها)
• إذن بإنشاء التطبيقات وتثبيتها في مساحة عمل Slack

لا شيء هنا يحتاج إلى عنوان عام، أو نفق، أو منفذ وارد. يتصل Control Center نحو الخارج إلى Slack عبر Socket Mode، فيعمل هذا من حاسوب محمول خلف NAT.

الخطوة 1: الحصول على رمز وصول تكوين التطبيق

هذا السر الوحيد الذي تجلبه بنفسك. يتيح لـ Control Center إنشاء التطبيق وتحريره لاحقًا نيابةً عنك.

1. افتح api.slack.com/apps
2. مرّر إلى قسم رموز تكوين التطبيق في أسفل الصفحة
3. ولّد زوج رموز لمساحة عمل Slack الخاصة بك
4. انسخ رمز التحديث — يبدأ بـ xoxe-

الخطوة 2: إنشاء التطبيق من Control Center

1. في Control Center، انتقل إلى الإعدادات ← مساحة العمل ← عام وابحث عن بطاقة جسور الدردشة
2. في كتلة Slack، انقر أنشئ التطبيق نيابةً عني
3. الصق رمز وصول تكوين التطبيق
4. راجع الشكل الذي سيظهر به البوت:
   • اسم التطبيق: كيف يسرد Slack التطبيق، مثل Control Center · Acme
   • اسم البوت: ما يكتبه الأعضاء بعد @، مثل control-center
   • وصف قصير وما يقول البوت إنه يستطيع فعله
   • أمر الشرطة المائلة: cc افتراضيًا، فيكون الأمر /cc
   • الرسائل المباشرة: اتركها مفعّلة حتى يستطيع الأعضاء مراسلة البوت برسالة مباشرة
5. انقر إنشاء التطبيق

يؤلف Control Center تعريف التطبيق كاملًا — تفعيل Socket Mode، ونطاقات البوت واشتراكات الأحداث التي يحتاجها، وأمر الشرطة المائلة، وتبويب Messages — وينشئه في Slack.

الخطوة 3: إتمام الخطوتين اللتين لا يستطيعهما إلا Slack

لا واجهة لدى Slack لتوليد رمز على مستوى التطبيق أو لتثبيت تطبيق، فيسلّمك الحوار الخطوتين كلتيهما كرابطين:

1. أنشئ رمز وصول على مستوى التطبيق — يفتح Basic Information → App-Level Tokens. أنشئ رمزًا بنطاق connections:write وانسخه. يبدأ بـ xapp-
2. ثبّت التطبيق — يفتح Install App. ثبّته في مساحة العمل، ثم انسخ Bot User OAuth Token. يبدأ بـ xoxb-

أبقِ القيمتين للخطوة التالية.

الخطوة 4: الاتصال

1. عُد إلى الحوار، وانقر لصق بيانات الاعتماد
2. أدخل رمز وصول البوت (xoxb-…) ورمز وصول على مستوى التطبيق (xapp-…)
3. اترك رمز وصول تكوين التطبيق فارغًا — رمز الخطوة 1 مخزَّن أصلًا (دوّره Slack وحفظ Control Center القيمة الجديدة)
4. انقر اتصال

يتحقق Control Center من رمز البوت لدى Slack قبل أن يخزّن شيئًا، ثم يفتح المقبس. يعرض الصف الآن اسم البوت واسم مساحة عمل Slack مع وسم مباشر.

الخطوة 5: ربط حساب Slack الخاص بك

الاتصال يجعل البوت في المتناول، والربط يجعلك أنت معروفًا. إلى أن تُربَط هوية Slack الخاصة بك، لن يتصرف البوت بناءً على رسائلك — ولا ينسب رسالة أبدًا إلى من ثبّت التطبيق.

الربط شخصي، لذلك يعيش في صفحة غير الاتصال الذي يشمل مساحة العمل كلها.

1. انتقل إلى الإعدادات ← مساحة العمل ← الملف الشخصي والهوية وابحث عن بطاقة حسابات الدردشة المرتبطة
2. انقر ربط حسابي في Slack
3. انسخ الأمر الذي يعرضه، مثل /cc link K7M2QP
4. في Slack، أرسل هذا الأمر إلى البوت في رسالة مباشرة
5. يجيب البوت «Linked — you are …»

الرمز يُستخدم مرة واحدة، وتنتهي صلاحيته بعد 15 دقيقة. إن طابق بريدك في Slack مستخدم Control Center هو عضو أصلًا في مساحة العمل هذه، يربطك الجسر تلقائيًا في أول مرة تخاطبه، ويمكنك تخطي هذه الخطوة.

إن أشرت إلى البوت قبل إتمام ذلك، يرفض ويبيّن السبب. حالات الرفض الثلاث مختلفة، فاقرأ أيها وصلتك:

• حساب دردشة غير مربوط: يخبرك البوت كيف تربط نفسك. عُد إلى هذه الخطوة.
• حساب مربوط، وصاحبه ليس عضوًا في مساحة العمل هذه: اطلب من مسؤول أن يدعوك.
• عضو بدور للقراءة فقط (viewer أو guest): لن يبدأ البوت العمل نيابةً عنك.

الخطوة 6: توجيه وكيل إلى عمل

1. في Slack، ادعُ البوت إلى قناة: /invite @control-center

2. أشر إليه بطلب حقيقي:

   @control-center لخّص طلبات السحب المفتوحة في مستودع api

الجسر:

1. ينشئ مساحة في Control Center لخيط Slack ذاك، باسم قناة Slack وطلبك
2. يوقظ وكيل الاستقبال في مساحة العمل (وكيل CEO إن وُجد، وإلا الوكيل الأول)
3. يبث جواب الوكيل إلى خيط Slack أثناء كتابته

أجب في خيط Slack نفسه للمتابعة — لا حاجة إلى إشارات إضافية، لأن خيط Slack مربوط بالجسر الآن. أو راسل البوت برسالة مباشرة بدل القناة. كل محادثة مباشرة تقود مساحة Control Center خاصة بها، بعنوان وسطر حالة «جارٍ التفكير…» بينما يعمل الوكيل.

البث يحتاج واجهة البث لدى Slack، وليست متاحة في كل خطة. إن رُفض تطبيقك، يتوقف الجسر عن المحاولة طوال عمر الاتصال وينشر كل رد كرسالة واحدة، وتقرأ بطاقة جسور الدردشة «البث المباشر متوقف لتطبيق Slack هذا — تصل الردود كرسالة واحدة.» وكل ما عدا ذلك يعمل كما هو.

الخطوة 7: فتح تذكرة من غير مغادرة Slack

/cc ticket Fix the flaky login test | It fails on CI about once a day.

يجيب البوت بمفتاح التذكرة التي فتحها. التذكرة تذكرة محلية عادية في Control Center، وأنت من بلّغ عنها، وهي جاهزة للتعيين إلى وكيل. يسرد /cc help كل ما يستطيع الأمر فعله.

الخلاصة

أنشأت تطبيق Slack من Control Center، ووصلته عبر مقبس صادر، وربطت هوية Slack بمستخدمك في Control Center، ووجّهت وكيلًا من خيط Slack. كل ما حدث في Slack موجود أيضًا في Control Center: خيط Slack مساحة، والرد نسخة نصية، والتذكرة تذكرة.

التالي: إعداد تكامل Slack يغطي المسار اليدوي وتدوير الرموز واستكشاف الأخطاء. وللنموذج الذي يقوم عليه، اقرأ جسور الدردشة.