Slack کو اپنے ورک اسپیس سے جوڑیں

آپ کیا بنائیں گے

اِس ٹیوٹوریل کے اختتام تک آپ کے پاس یہ سب ہوگا:

• آپ کے ورک اسپیس کے لیے بنائی گئی ایک Slack ایپ، جس کی درست اجازتیں اور ایونٹس پہلے سے سیٹ ہوں گے
• Slack اور Control Center کے درمیان ایک لائیو کنکشن
• آپ کا اپنا Slack اکاؤنٹ جو آپ کے Control Center صارف سے لنک ہوگا
• ایک ایجنٹ جو Slack تھریڈ میں آپ کو جواب دے گا، اور ایک سلیش کمانڈ سے درج کیا گیا ٹکٹ

پیشگی شرائط:

• آپ کا پہلا ورک اسپیس اور اپنا پہلا ایجنٹ بھیجیں مکمل ہوں — بغیر ایجنٹ والا ورک اسپیس Slack پیغام وصول تو کر سکتا ہے مگر جواب دینے والا کوئی نہیں ہوتا
• ورک اسپیس کے CEO ایجنٹ کے پاس ترتیبات → ورک اسپیس → ایجنٹس پر اڈاپٹر اور ماڈل سیٹ ہوں۔ برج CEO کو جگاتا ہے، اُس ایجنٹ کو نہیں جو آپ نے پچھلے ٹیوٹوریل میں کنفیگر کیا، اور بغیر اڈاپٹر والا ایجنٹ بلٹ اِن لوپ پر Anthropic کے ڈیفالٹ ماڈل کے ساتھ چلتا ہے۔
• Control Center ورک اسپیس میں owner یا admin کردار (چیٹ ایپ منسلک کرنا پورے ورک اسپیس کی طرف سے بات کرتا ہے)
• اپنے Slack ورک اسپیس میں ایپس بنانے اور انسٹال کرنے کی اجازت

یہاں کسی چیز کو عوامی ایڈریس، ٹنل یا اِن باؤنڈ پورٹ کی ضرورت نہیں۔ Control Center Socket Mode کے ذریعے Slack کو باہر کال کرتا ہے، چنانچہ یہ NAT کے پیچھے موجود لیپ ٹاپ سے بھی کام کرتا ہے۔

مرحلہ 1: Slack ایپ کنفیگریشن ٹوکن حاصل کریں

یہ واحد سیکرٹ ہے جو آپ کو خود ہاتھ سے لانا ہوگا۔ یہ 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 ہے
   • براہِ راست پیغامات: آن رہنے دیں تاکہ اراکین بوٹ کو DM بھیج سکیں
5. ایپ بنائیں پر کلک کریں

Control Center پوری ایپ ڈیفینیشن خود ترتیب دیتا ہے — Socket Mode آن، بوٹ کو درکار اسکوپس اور ایونٹ سبسکرپشنز، سلیش کمانڈ، Messages ٹیب — اور اسے Slack میں بنا دیتا ہے۔

مرحلہ 3: وہ دو مراحل مکمل کریں جو صرف Slack کر سکتا ہے

Slack کے پاس ایپ لیول ٹوکن بنانے یا ایپ انسٹال کرنے کے لیے کوئی API نہیں، چنانچہ ڈائیلاگ دونوں کام آپ کو لنک کی صورت میں دیتا ہے:

1. ایپ لیول ٹوکن بنائیں — Basic Information → App-Level Tokens کھولتا ہے۔ connections:write اسکوپ کے ساتھ ٹوکن بنائیں اور اسے کاپی کریں۔ یہ xapp- سے شروع ہوتا ہے
2. ایپ انسٹال کریں — Install App کھولتا ہے۔ اپنے ورک اسپیس میں انسٹال کریں، پھر بوٹ یوزر OAuth ٹوکن کاپی کریں۔ یہ 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 میں وہ کمانڈ ایک DM میں بوٹ کو بھیجیں
5. بوٹ جواب دیتا ہے “Linked — you are …”

یہ کوڈ ایک بار استعمال ہوتا ہے اور 15 منٹ میں ختم ہو جاتا ہے۔ اگر آپ کا Slack ای میل کسی ایسے Control Center صارف سے میل کھاتا ہے جو پہلے ہی اِس ورک اسپیس کا رکن ہے، تو برج پہلی بار بات کرنے پر آپ کو خودکار طور پر لنک کر دیتا ہے اور آپ یہ مرحلہ چھوڑ سکتے ہیں۔

اگر آپ یہ کام مکمل ہونے سے پہلے بوٹ کا ذکر کریں تو وہ انکار کرتا ہے اور وجہ بتاتا ہے۔ یہ تینوں انکار الگ الگ ہیں، چنانچہ دیکھیں کہ آپ کو کون سا ملا:

• غیر لنک شدہ بھیجنے والا: بوٹ آپ کو لنک کرنے کا طریقہ بتاتا ہے۔ اِس مرحلے پر واپس آ جائیں۔
• لنک شدہ، مگر اِس ورک اسپیس کا رکن نہیں: کسی ایڈمن سے کہیں کہ آپ کو دعوت دے۔
• صرف پڑھنے والے کردار کا رکن (viewer یا guest): بوٹ آپ کی طرف سے کام شروع نہیں کرے گا۔

مرحلہ 6: ایک ایجنٹ کو کسی کام پر لگائیں

1. Slack میں بوٹ کو کسی چینل میں مدعو کریں: /invite @control-center

2. کسی حقیقی درخواست کے ساتھ اُس کا ذکر کریں:

   @control-center api ریپو کے کھلے PRs کا خلاصہ کریں

برج:

1. اُس Slack تھریڈ کے لیے ایک Control Center اسپیس بناتا ہے، جس کا نام Slack چینل اور آپ کی درخواست سے لیا جاتا ہے
2. ورک اسپیس کے فرنٹ ڈور ایجنٹ کو جگاتا ہے (جب CEO ایجنٹ موجود ہو تو اُسے، ورنہ پہلے ایجنٹ کو)
3. ایجنٹ کا جواب لکھے جانے کے ساتھ ساتھ واپس Slack تھریڈ میں اسٹریم کرتا ہے

جاری رکھنے کے لیے اُسی Slack تھریڈ میں جواب دیں — مزید ذکر کی ضرورت نہیں، کیونکہ Slack تھریڈ اب برج شدہ ہے۔ یا چینل استعمال کرنے کے بجائے بوٹ کو DM بھیجیں؛ ہر DM گفتگو اپنا الگ Control Center اسپیس چلاتی ہے، جس کا ایک عنوان ہوتا ہے اور ایجنٹ کے کام کرنے کے دوران ایک “سوچ رہا ہے…” اسٹیٹس لائن۔

اسٹریمنگ کے لیے Slack کا اسٹریمنگ API درکار ہے، جو ہر پلان میں نہیں ہوتا۔ اگر آپ کی ایپ کو یہ مسترد کر دیا جائے تو برج پوری کنکشن کے لیے کوشش کرنا چھوڑ دیتا ہے اور اس کے بجائے ہر جواب ایک ہی پیغام میں بھیجتا ہے، اور چیٹ برجز کارڈ یہ دکھاتا ہے “اِس Slack ایپ کے لیے لائیو اسٹریمنگ آف ہے — جوابات ایک پیغام میں آتے ہیں۔” باقی سب کچھ ویسے ہی کام کرتا ہے۔

مرحلہ 7: Slack چھوڑے بغیر ٹکٹ درج کریں

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

بوٹ اُس ٹکٹ کی کلید کے ساتھ جواب دیتا ہے جو اُس نے درج کیا۔ یہ ٹکٹ ایک عام مقامی Control Center ٹکٹ ہے، جس کی اطلاع آپ نے دی اور جو کسی ایجنٹ کو تفویض کرنے کے لیے تیار ہے۔ /cc help وہ سب کچھ فہرست کرتا ہے جو یہ کمانڈ کر سکتی ہے۔

خلاصہ

آپ نے Control Center سے ایک Slack ایپ بنائی، اُسے ایک آؤٹ باؤنڈ ساکٹ پر منسلک کیا، اپنی Slack شناخت کو اپنے Control Center صارف سے لنک کیا اور ایک Slack تھریڈ سے ایجنٹ کو کام پر لگایا۔ Slack میں ہونے والا ہر واقعہ Control Center میں بھی موجود ہے: Slack تھریڈ ایک اسپیس ہے، جواب ایک ٹرانسکرپٹ ہے، ٹکٹ ایک ٹکٹ ہے۔

اگلا: Slack انضمام سیٹ کریں دستی طریقہ، ٹوکنز کی روٹیشن اور خرابیوں کا ازالہ بتاتا ہے۔ اس کے پیچھے والے ماڈل کے لیے چیٹ برجز پڑھیں۔