مستندات نود فعال‌ساز Slack#
از نود فعال‌ساز Slack برای پاسخ به ایونت‌ها در Slack استفاده کنید و Slack را با برنامه‌های دیگر اینتگریشن نمایید. ن۸ن از پشتیبانی داخلی برای طیف گسترده‌ای از ایونت‌های Slack، از جمله پیام‌های جدید، واکنش‌ها و کانال‌های جدید، بهره‌مند است.
در این صفحه، فهرستی از رویدادهایی که نود فعال‌ساز Slack می‌تواند به آن‌ها پاسخ دهد و لینک‌هایی به منابع بیشتر خواهید یافت.
اعتبارات
اطلاعات احراز هویت برای این نود اینجا قابل دسترسی است.
نمونه‌ها و قالب‌ها
برای مثال‌های استفاده و قالب‌هایی که به شما کمک می‌کنند شروع کنید، به صفحه اینتگریشن‌های Slack در ن۸ن مراجعه نمایید.
ایونت‌ها#
- هر ایونت: این نود در هر ایونت در Slack فعال می‌شود.
- ارجاع برنده / برنامه: این نود هنگامی فعال می‌شود که ربات یا برنامه شما در یک کانال اشاره شده باشد.
- گذاشتن فایل عمومی: این نود هنگامی فعال می‌شود که فایلی عمومی شده باشد.
- اشتراک‌گذاری فایل: این نود زمانی فعال می‌شود که فایلی اشتراک‌گذاری شده در کانالی که برنامه در آن قرار دارد.
- ارسال پیام جدید در کانال: این نود هنگامی فعال می‌شود که پیام جدیدی در کانالی که برنامه در آن است، ارسال شود.
- ایجاد کانال عمومی جدید: این نود هنگامی فعال می‌شود که یک کانال عمومی جدید ایجاد شود.
- کاربر جدید: این نود زمانی فعال می‌شود که کاربر جدیدی به Slack اضافه شود.
- اضافه کردن واکنش: این نود زمانی فعال می‌شود که یک واکنش به پیامی که برنامه به آن اضافه شده است، اضافه شود.
پارامترها#
هنگامی که ایونت‌های فعال‌شده را تعیین کردید، از پارامترهای باقی‌مانده برای تعریف بیشتر رفتار نود استفاده کنید:
- همه فضای کاری را مراقبت کنید: آیا باید این نود برای تمامی کانال‌های فضای کاری و ایونت‌های ایونت‌های انتخاب‌شده نظارت کند (روشن است) یا خیر (خاموش است، پیش‌فرض).
هشدار
این، برای هر ایونت در هر کانالی که ربات یا برنامه شما در آن است، یک اجرا مصرف می‌کند. با احتیاط استفاده کنید!
- کانال برای مراقبت: کانالی را که نود باید برای ایونت‌های انتخاب‌شده مراقبت کند، انتخاب کنید. این پارامتر فقط در صورت عدم فعال‌سازی همه فضای کاری را مراقبت کن ظاهر می‌شود. می‌توانید یکی از گزینههای زیر را انتخاب کنید:
- از لیست: نود از اعتبار شما برای جستجوی لیستی از کانال‌های موجود در فضای کاری استافده می‌کند و می‌توانید کانال مورد نظر خود را انتخاب کنید.
- با شناسه: شناسه کانالی را که می‌خواهید مراقبت کنید وارد کنید. Slack شناسه کانال را در انتهای جزئیات کانال نشان می‌دهد و با یک کلیک کپی می‌شود.
- با URL: لینک کانال مورد نظر را وارد کنید، که باید به صورت
https://app.slack.com/client/<channel-address>باشد. - دانلود فایل‌ها: آیا فایل‌ها باید دانلود شوند و در خروجی نود استفاده شوند (روشن است) یا خیر (خاموش است، پیش‌فرض). این پارامتر را همراه با ایونت‌های گذاشتن فایل عمومی و اشتراک‌گذاری فایل استفاده نمایید.
گزینه‌ها#
می‌توانید رفتار نود را با افزودن گزینههای بیشتر، دقیق‌تر کنید:
- حل شناسه‌ها: آیا شناسه‌ها باید به نام مربوطه‌شان حل شوند و برگردانده شوند (روشن است) یا خیر (خاموش است، پیش‌فرض).
- نام کاربری‌ها یا شناسه‌هایی که باید نادیده گرفته شوند: نام کاربری‌ها را انتخاب کنید یا رشته‌ای جداشده با کاما از شناسه‌های کاربری رمزگذاری شده برای نادیده گرفتن ایونت‌ها وارد کنید. می‌توانید از لیست انتخاب کنید، یا شناسه‌ها را با استفاده از عبارت‌ها وارد نمایید.
منابع مرتبط#
ن۸ن یک نود برنامه برای Slack فراهم کرده است. می‌توانید مستندات نود اینجا بیابید.
نمایش نمونه‌های ورکفلو و محتوای مرتبط در وب‌سایت ن۸ن.
برای جزئیات مربوط به API آن‌ها، به مستندات Slack مراجعه کنید.
دسترسی‌های مورد نیاز#
برای استفاده از این نود، باید در Slack برنامه‌ای ایجاد کرده و اشتراک‌گذاری ایونت‌ها را فعال کنید. برای اطلاعات بیشتر، به اعتبارنامه‌های Slack | پیکربندی فعال‌ساز Slack مراجعه کنید.
باید مجوزهای مناسب را به برنامه Slack خود اضافه کنید تا این نود فعال شود.
حداقل نیاز به مجوزهای لیست گفتگوها و لیست کاربران دارید. برای لیست کامل مجوزها، به مجازها | اعتبارات Slack مراجعه کنید.
مشکلات رایج#
در اینجا چند خطای رایج و مشکلات مربوط به نود فعال‌ساز Slack و راه‌حل‌ها یا مراحل رفع آن‌ها آورده شده است.
ورکفلو فقط در حالت آزمایش یا تولید کار می‌کند#
Slack فقط به شما اجازه می‌دهد برای هر برنامه، یک webhook ثبت کنید. این بدان معناست که نمی‌توانید از URL آزمایشی به URL تولید تبدیل کرده و بدون پیکربندی مجدد، از آن استفاده کنید.
اگر سعی کنید ورفلو را در حالت آزمایشی که همچنین فعال است در محیط تولید آزمایش کنید، مشکل دارید. Slack تنها ایونت‌ها را به یکی از دو URL webhook ارسال می‌کند، بنابراین دیگری هرگز فعال نمی‌شود.
برای مقابله با این مشکل، می‌توانید هنگام آزمایش، ورفلو خود را غیرفعال کنید:
توقف ترافیک تولید
این موقت ورفلو تولید شما را برای آزمایش غیرفعال می‌کند. ورفلو زمانی فعال است که غیرفعال باشد و ترافیک تولید دریافت نخواهد کرد.
- به صفحه ورفلو خود بروید.
- سوئیچ فعال را در بالای صفحه خاموش کنید تا ورفلو موقتاً غیرفعال شود.
- آدرس درخواست در پیکربندی [فعال‌ساز Slack] خود را ویرایش کنید و از URL webhook آزمایشی به جای URL webhook تولید استفاده کنید.
- ورفلو خود را با URL webhook آزمایشی آزمایش کنید.
- پس از پایان آزمایش، آدرس درخواست را در پیکربندی [فعال‌ساز Slack] ویرایش کنید و از URL webhook تولید به جای URL آزمایشی استفاده کنید.
- دوباره سوئیچ غیرفعال را فعال کنید تا ورفلو مجدداً فعال شود. URL webhook تولید باید شروع به کار کند.
توکن منقضی شده است#
اسلک چرخش توکن را ارائه می‌دهد که می‌توانید آن را برای توکن‌های بات و کاربر فعال کنید. این ویژگی موجب می‌شود هر توکن پس از ۱۲ ساعت منقضی شود. در حالی که این قابلیت ممکن است برای آزمایش مفید باشد، اعتبارنامه‌های n98n که از توکن‌هایی با این ویژگی استفاده می‌کنند پس از انقضا شکست می‌خورند. اگر می‌خواهید اعتبارنامه‌های اسلک خود را در محیط تولید به کار ببرید، باید این ویژگی خاموش باشد.
برای بررسی اینکه آیا برنامه اسلک شما چرخش توکن فعال است یا خیر، به مستندات API اسلک | چرخش توکن مراجعه کنید.
/// نکته | اگر برنامه شما از چرخش توکن استفاده می‌کند لطفاً توجه داشته باشید، اگر برنامه اسلک شما از چرخش توکن استفاده می‌کند، نمی‌توانید آن را دوباره خاموش کنید. در عوض، باید یک برنامه اسلک جدید با غیرفعال بودن چرخش توکن ایجاد کنید. /// ```