اتصال به Slack

اتصال Slack کانال‌های تیم شما را از کار روی وظیفه‌ها باخبر نگه می‌دارد. مدیر فضای کاری نشانی Incoming Webhook یک کانال را در تسکیـ اضافه می‌کند و مشخص می‌کند آن کانال از کدام رویدادها و کدام پروژه‌ها خبر بگیرد. از آن پس با هر رویداد انتخاب‌شده، یک کارت کوتاه در همان کانال منتشر می‌شود. این اتصال یک‌طرفه است و تسکیـ هیچ پیامی از فضای کاری Slack شما نمی‌خواند.

دو قابلیت جدا: این راهنما دربارهٔ «فید کانال» است که به‌روزرسانی‌های فضای کاری را در کانال‌های Slack منتشر می‌کند. ساختن وظیفه از داخل Slack، دستورهای اسلش، برگهٔ App Home و اعلان‌های شخصی کار «ربات Slack تسکیـ» است که در راهنمای ربات تسکیـ در Slack و Discord توضیح داده شده است.

پیش از شروع

• فقط مالک یا مدیر فضای کاری می‌تواند کانال اضافه، ویرایش یا حذف کند. سایر اعضا در برگهٔ «فضای کاری» پیامی می‌بینند که برای مدیریت اتصال‌های فضای کاری به دسترسی مدیر نیاز است.
• در Slack باید بتوانید یک اپ بسازید یا اپی را که قبلاً ساخته‌اید ویرایش کنید. اگر فضای کاری Slack شما نصب اپ را محدود کرده باشد، ممکن است به تأیید مدیر Slack نیاز داشته باشید.
• هر Incoming Webhook فقط به یک کانال پیام می‌فرستد؛ برای هر کانالی که می‌خواهید خبر بگیرد، یک وب‌هوک جداگانه بسازید.
• برای این اتصال هیچ Team ID، Signing Secret یا توکنی لازم نیست؛ فقط نشانی وب‌هوک.

ساخت Incoming Webhook در Slack

1. در مرورگر به api.slack.com/apps بروید و یک اپ تازه بسازید یا اپ خودتان را باز کنید.
2. در تنظیمات اپ، بخش Incoming Webhooks را باز کنید و آن را روشن کنید.
3. روی Add New Webhook to Workspace بزنید، کانال مقصد را انتخاب کنید و اجازه دهید.
4. نشانی ساخته‌شده را که با https://hooks.slack.com/services/ شروع می‌شود کپی کنید.

افزودن کانال در تسکیـ

1. در تنظیمات، «مرکز اپ‌ها» را باز کنید و Slack را انتخاب کنید.
2. به برگهٔ «فضای کاری» بروید و در بخش «فرستادن به‌روزرسانی وظایف به کانال‌های Slack» روی «افزودن کانال» بزنید.
3. نشانی کپی‌شده را در فیلد «نشانی Incoming Webhook» بچسبانید و اگر بخواهید یک «نام کانال» مثل #releases بنویسید تا کانال‌ها را در فهرست از هم تشخیص دهید.
4. زیر «این رویدادها فرستاده شوند» رویدادهای موردنظر را تیک بزنید. زیر «از این پروژه‌ها» گزینهٔ «همهٔ پروژه‌ها» را نگه دارید یا فقط پروژه‌های مشخصی را انتخاب کنید.
5. روی «افزودن» بزنید. تسکیـ پیش از ذخیره، بدون فرستادن هیچ پیامی، وب‌هوک را نزد Slack بررسی می‌کند. اگر Slack آن را نشناسد، کانال ذخیره نمی‌شود و پیام خطا نمایش داده می‌شود.

اولین کانالی که اضافه کنید، اتصال Slack فضای کاری را می‌سازد و کارت آن در برگهٔ «فضای کاری» دیده می‌شود. می‌توانید هر تعداد کانال اضافه کنید و هر کانال رویدادها و پروژه‌های خودش را داشته باشد؛ مثلاً یک کانال فقط وظیفه‌های تکمیل‌شدهٔ پروژهٔ انتشار را بشنود و کانال دیگری وظیفه‌های عقب‌افتادهٔ همهٔ پروژه‌ها را. یک نشانی را نمی‌توان دو بار اضافه کرد.

رویدادهایی که می‌توانید بفرستید

• وظیفهٔ جدید — وقتی وظیفه‌ای در یکی از پروژه‌های انتخاب‌شده ساخته شود.
• تغییر وضعیت — وقتی وضعیت وظیفه عوض شود.
• تکمیل وظیفه — وقتی وظیفه به وضعیت انجام‌شده برسد.
• افزودن مسئول — وقتی مسئولی به وظیفه اضافه شود.
• دیدگاه جدید — وقتی کسی روی وظیفه دیدگاه بگذارد.
• وظیفهٔ عقب‌افتاده — وقتی موعد وظیفه بگذرد و کار هنوز باز باشد.

برای کانال تازه، «وظیفهٔ جدید»، «تکمیل وظیفه» و «وظیفهٔ عقب‌افتاده» از پیش انتخاب شده‌اند. اگر هم «تغییر وضعیت» و هم «تکمیل وظیفه» را انتخاب کرده باشید، تمام شدن یک وظیفه فقط یک پیام «تکمیل وظیفه» می‌سازد، نه دو پیام.

پیام‌ها در Slack چه شکلی دارند

هر پیام یک کارت کوتاه است: نام رویداد، کلید و عنوان وظیفه به‌صورت پیوندی به همان وظیفه در تسکیـ، و در صورت وجود، وضعیت، مسئول و پروژه. متن کارت به زبان مدیری نوشته می‌شود که آن کانال را اضافه کرده است. پیوند وظیفه فقط برای کسانی باز می‌شود که در تسکیـ به آن وظیفه دسترسی دارند.

متن ایمن: متن وظیفه‌ها پیش از ارسال خنثی می‌شود. اگر کسی در عنوان یک وظیفه @channel بنویسد، کل کانال صدا زده نمی‌شود.

آزمایش و سلامت هر کانال

• در فهرست کانال‌ها، دکمهٔ «فرستادن پیام آزمایشی» یک کارت نمونه به همان کانال می‌فرستد تا مطمئن شوید همه‌چیز درست کار می‌کند.
• زیر هر کانال، زمان «آخرین تحویل» یا دلیل مشکل دیده می‌شود. نقطهٔ سبز یعنی کانال سالم است، نارنجی یعنی تحویل پیام‌های اخیر با مشکل روبه‌رو شده و قرمز یعنی وب‌هوک از کار افتاده است.
• اگر وب‌هوک در Slack حذف شود، کانالش بایگانی شود یا اپ آن از Slack برداشته شود، تسکیـ فرستادن به همان کانال را متوقف می‌کند و دلیلش را کنار آن نشان می‌دهد. کانال‌های دیگر بدون تغییر به کارشان ادامه می‌دهند.
• اگر بعداً پیام آزمایشی با موفقیت تحویل شود، آن کانال دوباره فعال می‌شود. در غیر این صورت در Slack وب‌هوک تازه‌ای بسازید و آن را دوباره اضافه کنید.
• با دکمهٔ «ویرایش» می‌توانید نام، رویدادها و پروژه‌های یک کانال را تغییر دهید. خود نشانی وب‌هوک ویرایش‌شدنی نیست؛ برای عوض کردن آن، کانال را حذف کنید و نشانی تازه را اضافه کنید.

امنیت و حریم خصوصی

• نشانی Incoming Webhook مثل یک کلید است: هرکس آن را داشته باشد می‌تواند در آن کانال پیام بگذارد. تسکیـ آن را رمزنگاری‌شده نگه می‌دارد و پس از ذخیره فقط شکل پوشیدهٔ آن را نشان می‌دهد.
• تسکیـ فقط نشانی‌هایی را می‌پذیرد که روی hooks.slack.com باشند.
• تسکیـ هیچ پیامی از فضای کاری Slack شما نمی‌خواند؛ تنها کاری که با این نشانی می‌کند فرستادن کارت به کانال است.
• حذف کانال در تسکیـ فرستادن را متوقف می‌کند، اما وب‌هوک را در Slack پاک نمی‌کند. برای باطل کردن کامل نشانی، آن را در بخش Incoming Webhooks اپ Slack هم حذف کنید.
• «قطع اتصال» از کارت اتصال Slack در برگهٔ «فضای کاری»، فرستادن به همهٔ کانال‌ها را متوقف می‌کند.

ربات Slack تسکیـ

اگر ربات Slack روی سرور تسکیـ شما راه‌اندازی شده باشد، در همین صفحه کارتی دربارهٔ ربات Slack تسکیـ می‌بینید. ربات قابلیتی شخصی است: هر عضو با نوشتن /taskie link در Slack حسابش را وصل می‌کند و پس از آن می‌تواند در Slack وظیفه بسازد و اعلان‌های خودش را بگیرد. اگر این کارت را نمی‌بینید، ربات روی سرور شما فعال نیست. جزئیات دستورها در ربات تسکیـ در Slack و Discord آمده است.

اگر قبلاً Slack را با Signing Secret وصل کرده بودید

نسخهٔ قبلی این اتصال با Team ID و Signing Secret قرار بود پیام‌های Slack را دریافت کند و به وظیفه‌ها لینک کند. آن روش کنار گذاشته شده است: اتصال‌های قدیمی خاموش شده‌اند، نشانی دریافت آن دیگر پیامی نمی‌پذیرد و رونوشت پیام‌های Slack که ذخیره کرده بود پاک شده است. لینک‌هایی که پیش‌تر به وظیفه‌ها اضافه شده بودند باقی می‌مانند، اما پیام‌های تازهٔ Slack دیگر خودکار به وظیفه لینک نمی‌شوند. می‌توانید Event Subscriptions اپ قدیمی را هم در Slack خاموش کنید و برای اعلام خبر وظایف، یک کانال را با روش بالا اضافه کنید.

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

• چسباندن نشانی Workflow Builder یا هر نشانی دیگری به‌جای Incoming Webhook؛ فقط نشانی‌هایی پذیرفته می‌شوند که با https://hooks.slack.com/services/ شروع شوند.
• انتخاب نکردن هیچ رویدادی؛ تا دست‌کم یک رویداد انتخاب نشود، دکمهٔ «افزودن» فعال نمی‌شود.
• انتظار پیام از پروژه‌ای که در «از این پروژه‌ها» انتخاب نشده است؛ وقتی پروژه‌ها را محدود کرده‌اید، فقط رویدادهای همان پروژه‌ها فرستاده می‌شوند.
• انتظار ساختن وظیفه با نوشتن پیام در کانال؛ فید کانال فقط خبر می‌فرستد. برای کار با وظیفه‌ها از داخل Slack، ربات Slack تسکیـ را به کار ببرید.

گام بعدی: برای فرستادن همین رویدادها به Discord، راهنمای اتصال به Discord را ببینید. برای رساندن رویدادهای وظیفه به سرویس‌های دیگر از راه Zap، اتصال به Zapier را مرور کنید.