Известия

Известието изпраща съобщение в 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 и webhooks са задържани в тази версия. Виж Задържани функции.

Възможности

Кога да се изпраща

Момент	При кого отива	Кога
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 s, 30 s и 2 min. По-дълго изчакване, поискано от сървъра, се спазва, до 5 min. Отказ, например грешна връзка, не се опитва повторно. Всяка неуспешна доставка добавя ред „Alert could not be sent“ (известието не можа да бъде изпратено) в Историята.

Задържани видове и техните полета

Показват се само при включен превключвател alert_channels_more.

Вид	Полета
Telegram	Bot token от @BotFather, Chat ID (ID на потребител, група или канал, или @channel). Първо пиши на бота или го добави в групата
ntfy	Server address (празно означава ntfy.sh), Topic, по избор Access token. Всеки, който знае темата, може да я чете
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= плюс шестнадесетичен HMAC-SHA256 на <timestamp>.<delivery>.<body>, с твоята тайна като ключ
Authorization	При Is sent as a bearer token: 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 се брои за доставено.

Свързано

• Проверки на здравето
• Одобряване на заявки
• Потребители и роли