اتصال به Slack

اتصال Slack در تسکیـ گفتگوهای مهم را به کارهای قابل پیگیری وصل می‌کند. وقتی رویدادهای Slack برای فضای کاری ثبت شوند، پیام‌های امضاشده دریافت می‌شوند و اگر متن پیام شناسهٔ وظیفه داشته باشد، همان پیام به وظیفه لینک می‌شود.

دامنهٔ نسخه فعلی: این نسخه روی دریافت امن رویدادهای پیام و لینک خودکار پیام به وظیفه تمرکز دارد. ارسال اعلان‌های تسکی به کانال‌های Slack، ساخت یا ویرایش وظیفه از داخل Slack، پیش‌نمایش لینک‌های تسکی در Slack، پیش‌نمایش غنی لینک‌های Slack داخل تسکیـ، Connected Search، Slash Command و اتصال OAuth شخصی در فازهای بعدی اضافه می‌شوند.

پیش از شروع

• فقط مالک یا مدیر فضای کاری می‌تواند اتصال Slack فضای کاری را بسازد یا قطع کند.
• در Slack باید یک اپ با Events API فعال داشته باشید و endpoint تسکیـ را به‌عنوان Request URL ثبت کنید.
• برای بررسی امضا، مقدار Signing Secret همان اپ Slack لازم است.
• شناسهٔ تیم Slack مثل T123ABC456 در فیلد «شناسه تیم Slack» ذخیره می‌شود.
• اتصال شخصی، عملیات تعاملی و ارسال پیام از تسکیـ به Slack در نسخه فعلی فعال نیستند.

ساخت اتصال فضای کاری

1. در تنظیمات اپ Slack، بخش Event Subscriptions را فعال کنید.
2. نشانی دریافت رویداد Slack در تسکیـ را به‌عنوان Request URL وارد کنید و مطمئن شوید درخواست url_verification با Signing Secret معتبر پاسخ می‌گیرد.
3. رویدادهای پیام موردنیاز مثل message.channels را برای اپ Slack فعال کنید.
4. در مرکز اپ‌های تسکیـ، Slack را باز کنید و تب «فضای کاری» را انتخاب کنید.
5. Team ID، Signing Secret، توکن اختیاری و برچسب اتصال را وارد کنید و اتصال را ذخیره کنید.

امنیت امضا: تسکیـ مقدار X-Slack-Signature و X-Slack-Request-Timestamp را با الگوریتم رسمی Slack بررسی می‌کند و درخواست‌های قدیمی‌تر از پنج دقیقه یا با امضای نامعتبر را رد می‌کند. هدر امضا و Signing Secret در payload تحویل وب‌هوک ذخیره نمی‌شوند.

لینک خودکار پیام به وظیفه

برای لینک خودکار، شناسهٔ وظیفه را در متن پیام Slack بنویسید. شکل‌های زیر پشتیبانی می‌شوند:

• TASK-12 — نوشتن مستقیم شناسه.
• #TASK-12 — با پیشوند #.
• CU-TASK-12 — با پیشوند CU-.
• #9fq2b1 — شناسهٔ هش‌شدهٔ وظیفه، فقط با پیشوند # یا CU-.

برای نمونه، پیام TASK-31 please review the launch notes به وظیفهٔ TASK-31 لینک می‌شود و در بخش لینک‌های متصل وظیفه دیده خواهد شد.

وضعیت وظیفه و دستورهای وضعیت

Slack در نسخه فعلی وضعیت وظیفه را تغییر نمی‌دهد. اگر عبارت TASK-31[Done] را در پیام بنویسید، پیام به وظیفه لینک می‌شود اما وضعیت وظیفه تغییر نمی‌کند. تغییر وضعیت خودکار فعلاً برای رویدادهای GitHub و GitLab فعال است.

مدیریت و قطع اتصال

وضعیت اتصال و زمان آخرین رویداد در تب «یکپارچه‌سازی» تنظیمات فضای کاری دیده می‌شود. مالک یا مدیر می‌تواند اتصال را از تسکیـ قطع کند. برای توقف کامل ارسال رویداد، تنظیمات Event Subscriptions اپ Slack را هم غیرفعال یا حذف کنید.

اشتباه‌های رایج

• وارد کردن Channel ID به‌جای Team ID؛ مقدار اتصال باید شناسهٔ تیم Slack باشد.
• استفاده از Signing Secret اشتباه یا قدیمی؛ تسکیـ در این حالت درخواست را با پاسخ 403 رد می‌کند.
• فراموش کردن subscribe به رویدادهای پیام در Slack؛ بدون رویداد پیام، لینک خودکار ساخته نمی‌شود.
• انتظار ساخت وظیفه از Slack یا ارسال اعلان به کانال؛ این قابلیت‌ها هنوز در نسخه فعلی فعال نیستند.
• انتظار تغییر وضعیت با کروشهٔ وضعیت؛ Slack فقط لینک می‌کند و وضعیت را تغییر نمی‌دهد.

گام بعدی: برای اتصال فایل‌های ابری، راهنمای اتصال به Dropbox را ببینید. برای تغییر وضعیت خودکار با کار توسعه، اتصال به GitHub و اتصال به GitLab را مرور کنید.