اعتبارات Slack
می‌توانید از این اعتبارنامه‌ها برای احراز هویت نودهای زیر استفاده کنید:
روش‌های پشتیبانی‌شده احراز هویت
منابع مرتبط
برای اطلاعات بیشتر در مورد سرویس، به مستندات API Slack مراجعه کنید.
استفاده از توکن دسترسی API
برای پیکربندی این اعتبار، نیاز به حساب Slack و:
برای تولید توکن دسترسی، یک برنامه Slack بسازید:
- صفحه برنامه‌های API Slack خود را باز کنید.
- گزینه ایجاد برنامه جدید > از صفر را انتخاب کنید.
- نام برنامه را وارد کنید.
- فضای کاری که در حال توسعه برنامه‌تان در آن هستید را انتخاب کنید.
- روی ایجاد برنامه کلیک کنید. جزئیات برنامه باز می‌شود.
- در منوی سمت چپ زیر ویژگی‌ها، گزینه OAuth و مجوزها را انتخاب کنید.
- در بخش محدوده‌ها، مجوزهای مناسب را برای برنامه خود انتخاب کنید. برای لیست مجوزهای پیشنهادی به محدوده‌ها مراجعه کنید.
- پس از افزودن مجوزها، به بخش توکن‌های OAuth بروید و گزینه نصب در فضای کاری را انتخاب کنید. برای انجام این عملیات باید مدیر فضای کاری Slack باشید.
- روی اجازه دادن کلیک کنید.
- توکن OAuth کاربر بات را کپی کرده و آن را به عنوان توکن دسترسی در اعتبار شما در n98n وارد کنید.
- اگر از این اعتبار برای نود نوتیفیکیشن Slack استفاده می‌کنید، مراحل پیکربندی نوتیفیکیشن Slack را برای تکمیل تنظیم برنامه دنبال کنید.
برای اطلاعات بیشتر، به راهنمای سریع API Slack مراجعه کنید.
پیکربندی نوتیفیکیشن Slack
برای استفاده از برنامه Slack با نود نوتیفیکیشن Slack:
- به ویژگی‌ها > اشتراک ایونت‌ها بروید.
- کنترل فعال‌سازی ایونت‌ها را فعال کنید.
- در n8n، آدرس وب‌هوک را کپی کنید و به عنوان آدرس درخواست در برنامه Slack خود وارد کنید.
/// یادداشت | آدرس درخواست
Slack تنها اجازه یک آدرس درخواست در هر برنامه را می‌دهد. اگر می‌خواهید جریان کار خود را آزمایش کنید، یکی از موارد زیر را انجام دهید:
- ابتدا با آدرس آزمایشی خود آزمایش کنید، سپس برنامه Slack خود را برای استفاده از آدرس تولید پس از تأیید صحت همه چیز تغییر دهید
- از آدرس تولید همراه با ثبت گزارش اجرای برنامه استفاده کنید.
///
- پس از تایید، ایونت‌های بات را برای اشتراک انتخاب کنید. از فیلد فعال‌سازی در n98n برای فیلتر کردن این درخواست‌ها استفاده کنید.
- برای استفاده از رویدادی که در لیست نیست، آن را به عنوان ایونت بات اضافه کنید و در نود n98n گزینه هر ایونت را انتخاب کنید.
برای اطلاعات بیشتر، به راهنمای سریع | پیکربندی برنامه برای گوش دادن به ایونت‌ها مراجعه کنید.
استفاده از OAuth2
نکته برای کاربران n98n کلود
کاربران کلود نیازی به ارائه جزئیات کانکشن ندارند. گزینه کانکشن حساب کاربری من را انتخاب کنید تا از طریق مرورگر خود ارتباط برقرار کنید.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67 | در صورت میزبانی خود n98n و نیاز به پیکربندی OAuth2 از ابتدا، نیاز به حساب [Slack](https://slack.com/){:target=_blank .external-link} و:
- یک **شناسه کلاینت**
- یک **رمز کلاینت**
برای دریافت هر دو، یک برنامه Slack بسازید:
1. صفحه [برنامه‌های API Slack](https://api.slack.com/apps){:target=_blank .external-link} خود را باز کنید.
2. گزینه **ایجاد برنامه جدید > از صفر** را انتخاب کنید.
3. نام برنامه را وارد کنید.
4. **فضای کاری** که در حال توسعه برنامه‌تان در آن هستید را انتخاب کنید.
5. روی **ایجاد برنامه** کلیک کنید. جزئیات برنامه باز می‌شود.
6. در **تنظیمات > اطلاعات پایه**، بخش **اعتبارات برنامه** را باز کنید.
7. شناسه کلاینت و رمز کلاینت را کپی کنید و آن‌ها را در فیلدهای مربوط در n98n جای دهید.
6. در منوی سمت چپ زیر **ویژگی‌ها**، گزینه **OAuth و مجوزها** را انتخاب کنید.
7. در بخش **آدرس‌های بازگرداندن**، گزینه **افزودن آدرس بازگردانی جدید** را انتخاب کنید.
8. آدرس بازگردانی OAuth دریافت‌شده از n98n را کپی کرده و به عنوان آدرس بازگردانی جدید در Slack وارد کنید.
9. روی **افزودن** کلیک کنید.
10. روی **ذخیره آدرس‌ها** کلیک کنید.
11. در بخش **محدوده‌ها**، مجوزهای مناسب را برای برنامه خود انتخاب کنید. برای لیست مجوزهای پیشنهادی به [محدوده‌ها](#scopes) مراجعه کنید.
13. پس از افزودن مجوزها، به بخش **توکن‌های OAuth** بروید و گزینه **نصب در فضای کاری** را انتخاب کنید. برای انجام این عملیات باید مدیر فضای کاری Slack باشید.
14. روی **اجازه دادن** کلیک کنید.
15. در این مرحله، باید بتوانید دکمه OAuth در اعتبار n98n خود را برای کانکشن انتخاب کنید.
برای اطلاعات بیشتر، به [راهنمای سریع Slack](https://api.slack.com/quickstart){:target=_blank .external-link} مراجعه کنید.همچنین، برای جزئیات بیشتر در مورد روند OAuth، به [مستندات نصب با OAuth](https://api.slack.com/authentication/oauth-v2){:target=_blank .external-link} مراجعه کنید.
## محدوده‌ها
محدوده‌ها تعیین می‌کنند برنامه چه مجوزهایی دارد.
* اگر می‌خواهید برنامه‌ی شما بر اساس مجوزهای کاربران مجاز به برنامه عمل کند، بخش **محدوده‌های توکن کاربر** را پر کنید.
* اگر در حال ساخت یک ربات هستید، مجوزهای لازم را در بخش **محدوده‌های توکن ربات** اضافه کنید.
در اینجا فهرست محدوده‌هایی که اعتبار OAuth نیاز دارد، آورده شده است که نقطه شروع خوبی است:
| **نام محدودیت** | **یادداشت‌ها** |
| --- | --- |
| `channels:read` | |
| `channels:write` | در حالت توکن ربات در دسترس نیست |
| `chat:write` | |
| `files:read` | |
| `files:write` | |
| `groups:read` | |
| `im:read` | |
| `mpim:read` | |
| `reactions:read` | |
| `reactions:write` | |
| `stars:read`| در حالت توکن ربات در دسترس نیست |
| `stars:write` | در حالت توکن ربات در دسترس نیست |
| `usergroups:read` | |
| `usergroups:write` | |
| `users.profile:read` | |
| `users.profile:write` | در حالت توکن ربات در دسترس نیست |
| `users:read` | |
## مسائل رایج
### توکن منقضی شده است
اسلک **چرخش توکن** را ارائه می‌دهد که می‌توانید آن را برای توکن‌های بات و کاربر فعال کنید. این ویژگی موجب می‌شود هر توکن پس از ۱۲ ساعت منقضی شود. در حالی که این قابلیت ممکن است برای آزمایش مفید باشد، اعتبارنامه‌های n98n که از توکن‌هایی با این ویژگی استفاده می‌کنند پس از انقضا شکست می‌خورند. اگر می‌خواهید اعتبارنامه‌های اسلک خود را در محیط تولید به کار ببرید، باید این ویژگی **خاموش** باشد.
برای بررسی اینکه آیا برنامه اسلک شما چرخش توکن فعال است یا خیر، به [مستندات API اسلک | چرخش توکن](https://api.slack.com/authentication/rotation){:target=_blank .external-link} مراجعه کنید.
/// نکته | اگر برنامه شما از چرخش توکن استفاده می‌کند
لطفاً توجه داشته باشید، اگر برنامه اسلک شما از چرخش توکن استفاده می‌کند، نمی‌توانید آن را دوباره خاموش کنید. در عوض، باید یک برنامه اسلک جدید با غیرفعال بودن چرخش توکن ایجاد کنید.
///
|