Сповіщення

Сповіщення надсилає повідомлення в 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 (посилання Discord); воно починається з https://discord.com/. Люди, які додали свій Discord user ID у свій обліковий запис, згадуються в повідомленнях про їхні запити.

Електронна пошта

Поле	Що ввести
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 (встав посилання Discord)

Причина: посилання не починається з 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 user ID, момент без позначки або вона вимкнула нові серії. Рішення: перевір ці три речі.

Для досвідчених

Повторні спроби

Тайм-аут, відповідь про уповільнення або помилка сервера повторюються через 5 с, 30 с і 2 хв. Довше очікування, яке просить сервер, виконується до 5 хв. Відмова, наприклад через неправильне посилання, не повторюється. Кожна невдача додає в Історію рядок “Alert could not be sent” (сповіщення не вдалося надіслати).

Відкладені типи та їхні поля

Показуються лише з увімкненим перемикачем alert_channels_more.

Тип	Поля
Telegram	Bot token від @BotFather, Chat ID (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	Випадковий ID цього повідомлення
X-HolyArrs-Timestamp	З Signs each message (підписує кожне повідомлення): секунди від 1970 року
X-HolyArrs-Signature	З Signs each message: sha256= плюс hex HMAC-SHA256 від <timestamp>.<delivery>.<body> з твоїм секретом як ключем
Authorization	З Is sent as a bearer token (надсилається як bearer-токен): Bearer <secret>

З Nothing (нічого) секрет не надсилається. Коли підписуєш, відхиляй старі мітки часу та ID доставки, які вже бачив, щоб скопійоване повідомлення не можна було відтворити.

{
  "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 причини й шляхи з рядка Історії, що стоїть за повідомленням. Будь-яка відповідь 2xx вважається доставленою.

Пов’язане

• Перевірки справності
• Схвалення запитів
• Користувачі та ролі