اعلان‌ها

یک اعلان وقتی اتفاقی می‌افتد پیام Discord یا ایمیل می‌فرستد: درخواستی منتظر است، فیلمی رسیده، بررسی سلامت خراب شده. به دسترسی Change settings (تغییر تنظیمات) نیاز دارید.

افزودن یک اعلان

1. Settings > Alerts (تنظیمات > اعلان‌ها) را باز کنید و Add an Alert (افزودن یک اعلان) را انتخاب کنید.
2. یک Name (نام) بدهید و یک Kind (نوع) انتخاب کنید: Discord یا ایمیل.
3. فیلدهای آن نوع را پر کنید (نوع‌ها را ببینید).
4. زیر When to send (چه زمانی ارسال شود)، لحظه‌هایی را که نمی‌خواهید علامت بزنید تا برداشته شوند. همه در ابتدا علامت دارند؛ All of these (همهٔ این‌ها) و None of these (هیچ‌کدام از این‌ها) روی یک گروه کامل کار می‌کنند.
5. Send messages (ارسال پیام‌ها) را روشن بگذارید و Save (ذخیره) را انتخاب کنید.
6. روی کارت Send a test (ارسال آزمایشی) را انتخاب کنید. باید برسیدن پیام را ببینید و روی کارت Last sent (آخرین ارسال) نشان داده شود.

نوع‌ها

Discord

در Discord تنظیمات کانال را باز کنید، بعد Integrations > Webhooks را، و پیوند را کپی کنید. آن را در Discord link جای‌گذاری کنید؛ با https://discord.com/ شروع می‌شود. کسانی که شناسهٔ کاربری Discord خود را به حسابشان اضافه کرده‌اند، در پیام‌های مربوط به درخواست‌هایشان منشن می‌شوند.

ایمیل

فیلد	چه چیزی وارد کنید
Mail server، Port	سرور ایمیل شما
Security	STARTTLS (پورت 587)، TLS (پورت 465) یا None. None فقط برای سرور ایمیلی که در شبکهٔ خودتان است
From address	نشانی فرستنده
Mail username، Mail password	حساب ایمیل
Staff addresses	یک یا چند نشانی، جداشده با کاما

پیام‌های مربوط به یک درخواست به کسانی که درخواست داده‌اند می‌رود، به نشانی حسابشان. بقیهٔ پیام‌ها به نشانی‌های کادر مدیریت می‌رود.

Telegram، ntfy، Gotify، Pushover و webhookها در این نسخه نگه داشته شده‌اند. قابلیت‌های نگه‌داشته‌شده را ببینید.

گزینه‌ها

چه زمانی ارسال شود

لحظه	به چه کسی می‌رود	چه موقع
New request	کادر مدیریت	فیلم، سریال یا هنرمندی منتظر تأیید است
Approved	درخواست‌دهنده‌ها	درخواستشان تأیید شد
Declined	درخواست‌دهنده‌ها	رد شد، همراه با یادداشت شما
Ready	درخواست‌دهنده‌ها	فایل‌ها در کتابخانه‌اند
New episodes	درخواست‌دهنده‌ها و دنبال‌کننده‌ها	حداکثر 1 پیام برای هر سریال در هر ساعت. هر نفر می‌تواند این را خاموش کند
New albums	دنبال‌کنندگان هنرمند	حداکثر 1 پیام برای هر هنرمند در هر ساعت
Problem reported	کادر مدیریت	کسی دربارهٔ عنوانی گزارش داده. گزارش‌ها در /requests/reports هستند
Problem fixed	گزارش‌دهنده	همراه با پاسخ شما
Sent to download	کادر مدیریت	یک ریلیز به دانلودر رفت
In the Library	کادر مدیریت	فایل‌ها جای گرفتند، از جمله یک نسخهٔ بهتر
Renamed	کادر مدیریت	فایل‌ها نام تازه گرفتند
Added	کادر مدیریت	عنوانی دستی، از یک فهرست یا از یک درخواست اضافه شد
Deleted	کادر مدیریت	فیلم، سریال، فصل یا قسمت‌هایی از کتابخانه رفتند
Health	کادر مدیریت	یک بررسی سلامت خراب شد یا درست شد
Needs a decision	کادر مدیریت	یک دانلود یا ورود به تصمیم شما نیاز دارد

بسته‌های فصل

زیر فهرست، Season packs (بسته‌های فصل) تعیین می‌کند یک دانلود با چند قسمت چه چیزی بفرستد: One Alert for the pack (یک اعلان برای کل بسته)، با یک خط برای هر قسمت، یا One Alert per episode (یک اعلان برای هر قسمت).

رسیدن به شبکهٔ محلی

به‌طور پیش‌فرض خاموش است. تا وقتی خاموش است، اعلان‌های Discord فقط به discord.com می‌روند و نوع‌های دیگر فقط به سرورهای اینترنتی؛ پیوند به این رایانه یا شبکهٔ خانگی شما رد می‌شود، حتی بعد از جست‌وجوی نام. برای سرور ایمیل یا گیرنده‌ای که در خانه دارید روشنش کنید. ریدایرکت‌ها هرگز دنبال نمی‌شوند.

متوقف کردن یک اعلان

علامت Send messages را بردارید. کارت Off را نشان می‌دهد و اعلان می‌ماند.

گذرواژه‌ها و توکن‌ها

رمزگذاری‌شده ذخیره می‌شوند و بعد با Stored نشان داده می‌شوند. برای نگه داشتن آن، فیلد را خالی بگذارید. اگر اعلان را به سرور دیگری وصل کنید باید مقدار محرمانه را دوباره وارد کنید؛ مقدار محرمانهٔ ذخیره‌شده هرگز به مقصد تازه فرستاده نمی‌شود.

اگر کار نکرد

نشانه:

Paste the Discord link

علت: پیوند با https://discord.com/ شروع نمی‌شود. راه‌حل: پیوند webhook را دوباره کپی کنید. برای سروری شبیه Discord در خانه، Reach the local network را روشن کنید.

نشانه:

Points to the local network, which this Alert may not reach

علت: سرور روی همین رایانه یا شبکهٔ خانگی شما است. راه‌حل: Reach the local network را روشن کنید.

نشانه: Last try failed با پاسخ 401 یا 404. علت: پیوند یا توکن اشتباه است. این‌ها دوباره تلاش نمی‌شوند. راه‌حل: درستش کنید و Send a test را انتخاب کنید.

نشانه: کسی که درخواست داده بود چیزی نگرفت. علت: حسابش نشانی ایمیل یا شناسهٔ کاربری Discord ندارد، آن لحظه علامت‌دار نیست، یا او قسمت‌های جدید را خاموش کرده است. راه‌حل: این سه مورد را بررسی کنید.

برای حرفه‌ای‌ها

تلاش دوباره

اگر زمان تمام شود، پاسخ «آهسته‌تر» بیاید یا خطای سرور رخ دهد، بعد از 5 ثانیه، 30 ثانیه و 2 دقیقه دوباره تلاش می‌شود. اگر سرور انتظار طولانی‌تری بخواهد رعایت می‌شود، تا 5 دقیقه. رد شدن، مثل پیوند اشتباه، دوباره تلاش نمی‌شود. هر شکست یک ردیف «Alert could not be sent» به History اضافه می‌کند.

نوع‌های نگه‌داشته‌شده و فیلدهایشان

فقط وقتی کلید alert_channels_more روشن باشد نشان داده می‌شود.

نوع	فیلدها
Telegram	Bot token از @BotFather، Chat ID (شناسهٔ کاربر، گروه یا کانال، یا @channel). اول به بات پیام بدهید یا آن را به گروه اضافه کنید
ntfy	Server address (خالی یعنی ntfy.sh)، Topic، Access token اختیاری. هر کسی که topic را بداند می‌تواند آن را بخواند
Gotify	Server address، App token
Pushover	User key (کلیدهای گروه هم کار می‌کنند)، App token
Webhook (JSON)	Webhook link، Secret اختیاری، What the secret does

یک webhook چه چیزی دریافت می‌کند

برای هر پیام یک POST با Content-Type: application/json و این هدرها:

هدر	مقدار
X-HolyArrs-Event	لحظه، مثل import یا test
X-HolyArrs-Delivery	شناسهٔ تصادفی این پیام
X-HolyArrs-Timestamp	با Signs each message: ثانیه‌ها از 1970
X-HolyArrs-Signature	با Signs each message: sha256= به‌اضافهٔ HMAC-SHA256 به‌صورت hex از <timestamp>.<delivery>.<body>، با کلید محرمانهٔ شما
Authorization	با Is sent as a bearer token: Bearer <secret>

با Nothing هیچ مقدار محرمانه‌ای فرستاده نمی‌شود. هنگام امضا، زمان‌های قدیمی و شناسه‌های ارسالی را که دیده‌اید رد کنید، تا پیام کپی‌شده دوباره پخش نشود.

{
  "moment": "import",
  "event_kind": "import_done",
  "subject": "In the Library: Arrival (2016)",
  "text": "Import done: 1 placed by hardlink",
  "at": "2025-01-01T18:04:11Z",
  "movie": { "id": 12, "name": "Arrival", "year": 2016, "tmdb": "329865", "imdb": "tt2543164" },
  "data": { "from": "/downloads/Arrival.2016.1080p" }
}

فیلدهای دیگر در صورت کاربرد می‌آیند: test، show و episodes، artist و tracks، report، people. people نام درخواست‌دهنده‌ها را دارد، نه نشانی‌هایشان را. data دلیل‌ها و مسیرهای ردیف History پشت پیام را دارد. هر پاسخ 2xx یعنی تحویل شد.

صفحه‌های مرتبط

• بررسی‌های سلامت
• تأیید درخواست‌ها
• کاربران و نقش‌ها