اعتبارات معتبر در نیشن (n8n) برای وارد کردن اطلاعات حساب دیسکورد#
می‌توانید از این اطلاعات برای احراز هویت نودهای زیر استفاده کنید:
پیش‌نیازها#
- ایجاد حساب دیسکورد.
- برای اطلاعات مربوط به Bot و OAuth2:
- راه‌اندازی محیط توسعه محلی.
- ایجاد یک برنامه و کاربر ربات.
- برای اطلاعات مربوط به webhook، یک webhooks ایجاد کنید.
روش‌های احراز هویت پشتیبانی‌شده#
- ربات (Bot)
- OAuth2
- Webhook
مطمئن نیستید کدام روش مناسب است؟ برای راهنمایی بیشتر، به انتخاب روش احراز هویت مراجعه کنید.
منابع مرتبط#
برای اطلاعات بیشتر درباره سرویس، به مستندات توسعه‌دهنده دیسکورد مراجعه کنید.
استفاده از ربات#
در صورت تمایل به افزودن ربات به سرور دیسکورد خود با استفاده از توکن ربات، نه OAuth2، این روش را استفاده کنید.
برای پیکربندی این اعتبارنامه، نیاز دارید به:
- یک توکن ربات: که پس از ایجاد یک برنامه با ربات ساخته می‌شود.
برای ساختن برنامه و ربات و تولید توکن ربات:
- اگر قبلاً ندارید، در پورتال توسعه‌دهنده یک برنامه جدید بسازید.
- یک نام برای برنامه خود وارد کنید.
- بر روی ایجاد کلیک کنید.
- از منوی سمت چپ، گزینه ربات (Bot) را انتخاب کنید.
- در قسمت توکن، بر روی بازنشانی توکن کلیک کنید تا توکن جدید ربات ساخته شود.
- توکن را کپی کرده و در اطلاعات اعتبار نیشن وارد کنید.
- در بخش ربات > اختیارات دروازه‌ای دارای امتیاز، هر امتیاز امتیازی را که می‌خواهید رباتتان داشته باشد، اضافه کنید. برای اطلاعات بیشتر، به پیکربندی ربات مراجعه کنید. - نیشن پیشنهاد می‌کند فعال‌سازی نیت اعضای سرور: نیاز است برای اینکه ربات شما ایونت‌های زیر را دریافت کند، زیر شاخه GUILD_MEMBERS.
- در بخش نصب > زمینه‌های نصب، زمینه‌های مورد نظر ربات را انتخاب کنید: - برای برنامه‌های نصب‌شده در سرور، گزینه نصب در گرید (Guild Install). - برای برنامه‌های نصب‌شده توسط کاربر، گزینه نصب توسط کاربر (User Install). (کمتر رایج، اما ممکن است در تست‌ها مفید باشد) - برای اطلاعات بیشتر درباره این زمینه‌ها، به انتخاب زمینه‌های نصب مراجعه کنید.
- در صفحه نصب > لینک نصب، در صورت عدم انتخاب، گزینه لینک ارائه‌شده توسط دیسکورد را فعال کنید.
- در صفحه نصب، در قسمت تنظیمات پیش‌فرض نصب، دامنه‌های
applications.commandsوbotرا انتخاب کنید. برای اطلاعات بیشتر، به دامنه‌ها مراجعه کنید. - مجوزهای مناسب را در صفحه ربات > مجوزهای ربات اضافه کنید. برای اطلاعات بیشتر، به مجوزها مراجعه کنید. نیشن توصیه می‌کند این مجوزها را برای نود [دیسکورد]، از جمله: - مدیریت نقش‌ها - مدیریت کانال‌ها - خواندن پیام‌ها/ مشاهده کانال‌ها - ارسال پیام‌ها - ساخت موضوع‌های عمومی - ساخت موضوع‌های خصوصی - ارسال پیام در موضوع‌ها - ارسال پیام‌های TTS - مدیریت پیام‌ها - مدیریت موضوع‌ها - قرار دادن لینک‌ها - پیوست فایل‌ها - خواندن تاریخچه پیام‌ها - افزودن واکنش‌ها را فعال کنید.
- برنامه را به سرور یا سرور آزمایش خود اضافه کنید:
- به صفحه نصب > لینک نصب رفته و لینک موجود را کپی کنید.
- این لینک را در مرورگر خود پیست کرده و Enter بزنید.
- در پنجره نصب، گزینه اضافه کردن به سرور را انتخاب کنید.
- پس از افزودن برنامه به سرور، آن را در لیست اعضا مشاهده خواهید کرد.
این مراحل بر اساس عملکردهای اصلی برای راه‌اندازی اعتبار نیشن در نیشن (n8n) است. برای اطلاعات بیشتر درباره ساخت برنامه، به ایجاد برنامه در دیسکورد مراجعه کنید، بخصوص:
- گرفتن اعتبارنامه‌ها برای وارد کردن اطلاعات برنامه به محیط توسعه محلی.
- مدیریت تعاملات برای راهنمایی درباره راه‌اندازی نقطه‌های انتهای عمومی برای دستورات تعاملی
/slash.
استفاده از OAuth2#
در صورت تمایل به افزودن ربات به سرورهای دیسکورد با استفاده از روند OAuth2، که فرآیند نصب برنامه را ساده‌تر می‌کند، این روش را انتخاب کنید.
برای پیکربندی این اعتبارنامه، نیاز دارید به:
- یک شناسه کلاینت (Client ID)
- یک رمز کلاینت (Client Secret)
- انتخاب نحوه ارسال احراز هویت در هدر یا بدنه
- یک توکن ربات
برای جزئیات درباره ساخت برنامه و تولید توکن، همان مراحل استفاده از ربات را دنبال کنید.
سپس:
- توکن ربات تولید شده را کپی کنید و در اعتبار نیشن وارد کنید.
- صفحه OAuth2 در برنامه دیسکورد خود باز کرده و شناسه کلاینت و رمز کلاینت را وارد کنید. این موارد را در اعتبار نیشن خود اضافه کنید.
- از نیشن، لینک ریدایرکت OAuth را کپی کرده و در بخش OAuth2 > Redirects در برنامه دیسکورد وارد کنید. حتماً این تغییرات را ذخیره کنید.
استفاده از webhook#
برای پیکربندی این اعتبارنامه، نیاز دارید به:
- یک URL webhook: که پس از ساخت webhook ساخته می‌شود.
برای دریافت URL webhook، باید webhook بسازید و URL تولیدشده را کپی کنید:
- به تنظیمات سرور دیسکورد خود رفته و برگه یکپارچه‌سازی‌ها (Integrations) را باز کنید.
- بر روی ساخت Webhook کلیک کنید تا webhook جدید ساخته شود.
- یک نام مناسب برای webhook وارد کنید.
- روی آواتار کنار نام کلیک کرده و آواتار جدیدی آپلود کنید.
- در منوی کانال، کانالی که می‌خواهید webhook در آن پست کند را انتخاب کنید.
- بر روی کپی کردن URL webhook کلیک کنید و این URL را در اطلاعات اعتبار نیشن وارد کنید.
برای اطلاعات بیشتر، به مستندات ساخت Webhook دیسکورد مراجعه کنید.
انتخاب روش احراز هویت#
پایه‌ترین نصب، استفاده از Webhook است. در این حالت، شما Webhookها را در یک کانال روی سرور دیسکورد ساخته و اضافه می‌کنید، که می‌تواند پیام‌ها را در کانال ارسال کند. نیازی به کاربر ربات یا احراز هویت ندارد، ولی نمی‌تواند به درخواست‌ها یا فرمان‌های کاربر واکنش نشان دهد. اگر نیاز به روشی ساده برای ارسال پیام به کانال بدون تعامل یا بازخورد دارید، از Webhook استفاده کنید.
یک ربات (Bot)، یک قدم تعاملی بالاتر نسبت به Webhook است. ربات‌ها را به سرور دیسکورد (که در مستندسات API دیسکورد به عنوان guild شناخته می‌شود) یا به حساب‌های کاربری می‌افزایید. ربات‌های اضافه‌شده به سرور می‌توانند با کاربران در تمام کانال‌های سرور تعامل داشته باشند، کانال‌ها را مدیریت، پیام‌ها را ارسال و دریافت، فهرست کاربران را بازیابی و نقش‌های خود را تغییر دهند. اگر می‌خواهید یک فرآیند کاری تعاملی و چند مرحله‌ای ساخته و مدیریت کنید، از ربات استفاده کنید.
OAuth2 در اصل یک ربات است که از روند OAuth2 به جای توکن ربات استفاده می‌کند. مشابه ربات‌ها، این اعتبارنامه‌ها همان وظایف را انجام می‌دهند، ولی نصب آن‌ها بر روی سرور ساده‌تر است.