Értesítések

Az értesítés (Alert) Discord- vagy e-mail-üzenetet küld, ha történik valami: egy kérés vár, megérkezik egy film, egy állapotellenőrzés hibát jelez. Ehhez a Change settings (beállítások módosítása) jogosultság kell.

Értesítés hozzáadása

1. Nyisd meg a Settings > Alerts részt (Beállítások > Értesítések), és kattints az Add an Alert (értesítés hozzáadása) gombra.
2. Adj neki Name (nevet), és válassz Kind (típust): Discord vagy e-mail.
3. Töltsd ki a típus mezőit (lásd: Típusok).
4. A When to send (mikor küldje) alatt vedd ki a pipát azokból a pillanatokból, amelyeket nem akarsz. Mind be van pipálva; az All of these (mind) és a None of these (egyik sem) egy egész csoportra működik.
5. Hagyd bekapcsolva a Send messages (üzenetek küldése) beállítást, és kattints a Save (mentés) gombra.
6. Kattints a kártyán a Send a test (teszt küldése) gombra. Látnod kell, hogy megérkezik az üzenet, és a kártyán megjelenik a Last sent (utoljára elküldve).

Típusok

Discord

A Discordban nyisd meg a csatorna beállításait, majd az Integrations > Webhooks részt, és másold ki a hivatkozást. Illeszd be a Discord link (Discord-hivatkozás) mezőbe; https://discord.com/ kezdetű. Azokat, akik megadták a Discord felhasználói azonosítójukat a fiókjukban, megemlíti a saját kéréseikről szóló üzenetekben.

E-mail

Mező	Mit írj be
Mail server (levelezőszerver), Port	A levelezőszervered
Security (biztonság)	STARTTLS (587-es port), TLS (465-ös port) vagy None (nincs). A None csak a saját hálózatodon lévő levelezőszervernél
From address (feladó címe)	A feladó címe
Mail username (levelezési felhasználónév), Mail password (levelezési jelszó)	A levelezési fiók
Staff addresses (üzemeltetői címek)	Egy vagy több, vesszővel elválasztva

A kérésekről szóló üzenetek azokhoz mennek, akik kérték, a fiókjuk címére. Minden más az üzemeltetői címekre megy.

A Telegram, az ntfy, a Gotify, a Pushover és a webhookok ebben a verzióban későbbre vannak halasztva. Lásd: Későbbre halasztott funkciók.

Lehetőségek

Mikor küldje

Pillanat	Kinek megy	Mikor
New request (új kérés)	Üzemeltetők	Egy film, sorozat vagy előadó jóváhagyásra vár
Approved (jóváhagyva)	Kérők	A kérésüket jóváhagyták
Declined (elutasítva)	Kérők	Elutasítva, a te megjegyzéseddel
Ready (kész)	Kérők	A fájlok a médiatárban vannak
New episodes (új epizódok)	Kérők és követők	Sorozatonként óránként legfeljebb 1. Mindenki kikapcsolhatja
New albums (új albumok)	Az előadó követői	Előadónként óránként legfeljebb 1
Problem reported (probléma bejelentve)	Üzemeltetők	Valaki bejelentett egy címet. A bejelentések a /requests/reports oldalon vannak
Problem fixed (probléma megoldva)	Bejelentő	A te válaszoddal
Sent to download (letöltésre küldve)	Üzemeltetők	Egy Release letöltőhöz került
In the Library (a médiatárban)	Üzemeltetők	Fájlok kerültek a helyükre, jobb másolat is
Renamed (átnevezve)	Üzemeltetők	A fájlok új nevet kaptak
Added (hozzáadva)	Üzemeltetők	Egy címet kézzel, listából vagy kérésből adtak hozzá
Deleted (törölve)	Üzemeltetők	Egy film, sorozat, évad vagy epizódok kikerültek a médiatárból
Health (működési állapot)	Üzemeltetők	Egy állapotellenőrzés hibát jelzett, vagy megjavult
Needs a decision (döntésre vár)	Üzemeltetők	Egy letöltésnél vagy importálásnál rád van szükség

Évadcsomagok

A lista alatt a Season packs (évadcsomagok) dönti el, mit küld egy sok epizódos letöltés: One Alert for the pack (egy értesítés a csomagról), epizódonként egy sorral, vagy One Alert per episode (epizódonként egy értesítés).

Elérés a helyi hálózaton

Alapértelmezés szerint ki van kapcsolva. Amíg ki van kapcsolva, a Discord-értesítések csak a discord.com-ra mennek, a többi típus csak internetes szerverekre; az erre a gépre vagy az otthoni hálózatra mutató hivatkozásokat elutasítja, névfeloldás után is. Kapcsold be, ha otthoni levelezőszervert vagy fogadót használsz. Az átirányításokat soha nem követi.

Értesítés szüneteltetése

Vedd ki a pipát a Send messages beállításból. A kártya Off (ki) állapotot mutat, és az értesítés megmarad.

Jelszavak és tokenek

Titkosítva tárolódnak, majd Stored (tárolva) felirattal jelennek meg. Hagyd üresen a mezőt, ha meg akarod tartani. Ha egy értesítést másik szerverre irányítasz, a titkot újra be kell írnod; egy tárolt titok soha nem megy új helyre.

Ha nem működik

Tünet:

Paste the Discord link (Illeszd be a Discord-hivatkozást)

Ok: a hivatkozás nem https://discord.com/ kezdetű. Megoldás: másold ki újra a webhook-hivatkozást. Otthoni, Discordhoz hasonló szervernél kapcsold be a Reach the local network (elérés a helyi hálózaton) beállítást.

Tünet:

Points to the local network, which this Alert may not reach (A helyi hálózatra mutat, amelyet ez az értesítés nem érhet el)

Ok: a szerver ezen a gépen vagy az otthoni hálózatodon van. Megoldás: kapcsold be a Reach the local network beállítást.

Tünet: Last try failed (az utolsó próba sikertelen) 401-es vagy 404-es válasszal. Ok: a hivatkozás vagy a token hibás. Ezeket nem próbálja újra. Megoldás: javítsd ki, és kattints a Send a test gombra.

Tünet: aki kérte, nem kapott semmit. Ok: nincs e-mail-cím vagy Discord felhasználói azonosító a fiókján, a pillanat nincs bepipálva, vagy kikapcsolta az új epizódokat. Megoldás: ellenőrizd ezt a hármat.

Haladóknak

Újrapróbálkozások

Időtúllépést, lassításra kérő választ vagy szerverhibát 5 mp, 30 mp és 2 perc után próbál újra. Ha a szerver hosszabb várakozást kér, azt betartja, legfeljebb 5 percig. Az elutasítást, például hibás hivatkozásnál, nem próbálja újra. Minden hiba egy „Alert could not be sent” (az értesítést nem lehetett elküldeni) sort ad az Előzményekhez.

Későbbre halasztott típusok és mezőik

Csak akkor látszik, ha az alert_channels_more kapcsoló be van kapcsolva.

Típus	Mezők
Telegram	Bot token a @BotFathertől, Chat ID (felhasználó, csoport vagy csatorna azonosítója, vagy @channel). Előbb írj a botnak, vagy add hozzá a csoporthoz
ntfy	Server address (üresen ntfy.sh), Topic, opcionális Access token. Aki ismeri a topicot, el tudja olvasni
Gotify	Server address, App token
Pushover	User key (a csoportkulcsok is működnek), App token
Webhook (JSON)	Webhook link, opcionális Secret, What the secret does

Mit kap egy webhook

Üzenetenként egy POST, Content-Type: application/json, ezekkel a fejlécekkel:

Fejléc	Érték
X-HolyArrs-Event	A pillanat, például import vagy test
X-HolyArrs-Delivery	Véletlen azonosító ehhez az üzenethez
X-HolyArrs-Timestamp	A Signs each message (minden üzenetet aláír) esetén: 1970 óta eltelt másodpercek
X-HolyArrs-Signature	A Signs each message esetén: sha256= plusz a <timestamp>.<delivery>.<body> hexadecimális HMAC-SHA256 értéke, kulcsként a te titkodat használva
Authorization	Az Is sent as a bearer token (bearer tokenként megy) esetén: Bearer <secret>

A Nothing (semmi) esetén nem megy titok. Aláírásnál utasítsd el a régi időbélyegeket és a már látott kézbesítési azonosítókat, hogy egy lemásolt üzenetet ne lehessen újra lejátszani.

{
  "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" }
}

Más mezők akkor jelennek meg, ha érvényesek: test, show és episodes, artist és tracks, report, people. A people a kérők neveit tartalmazza, e-mail-címeket soha. A data az üzenet mögötti Előzmények-sor okait és útvonalait tartalmazza. Bármilyen 2xx válasz kézbesítettnek számít.

Kapcsolódó oldalak

• Állapotellenőrzések
• Kérések jóváhagyása
• Felhasználók és szerepkörök