Alerte

O alertă trimite un mesaj pe Discord sau pe email când se întâmplă ceva: o cerere așteaptă, un film ajunge în Bibliotecă, o verificare de sănătate se strică. Ai nevoie de permisiunea Change settings (schimbă setările).

Adaugă o alertă

1. Deschide Settings > Alerts (Setări > Alerte) și apasă Add an Alert (adaugă o alertă).
2. Dă-i un Name (nume) și alege un Kind (tip): Discord sau email.
3. Completează câmpurile tipului ales (vezi Tipuri).
4. La When to send (când se trimite), debifează momentele pe care nu le vrei. Toate pornesc bifate; All of these (toate acestea) și None of these (niciuna dintre acestea) merg pe un grup întreg.
5. Lasă Send messages (trimite mesaje) pornit și apasă Save (salvează).
6. Apasă Send a test (trimite un test) pe card. Ar trebui să vezi mesajul sosind și cardul arătând Last sent (ultima trimitere).

Tipuri

Discord

În Discord, deschide setările canalului, apoi Integrations > Webhooks și copiază linkul. Lipește-l în Discord link; începe cu https://discord.com/. Oamenii care și-au adăugat ID-ul de utilizator Discord la cont sunt menționați în mesajele despre cererile lor.

Email

Câmp	Ce scrii
Mail server (server de email), Port	Serverul tău de email
Security (securitate)	STARTTLS (port 587), TLS (port 465) sau None (fără). None doar pentru un server de email din propria rețea
From address (adresa expeditorului)	Adresa expeditorului
Mail username (utilizator email), Mail password (parolă email)	Contul de email
Staff addresses (adresele echipei)	Una sau mai multe, separate prin virgule

Mesajele despre o cerere ajung la cei care au făcut-o, la adresa contului lor. Tot restul ajunge la adresele echipei.

Telegram, ntfy, Gotify, Pushover și webhook-urile sunt funcții reținute în această versiune. Vezi Funcții reținute.

Alegeri

Când se trimite

Moment	Ajunge la	Când
New request (cerere nouă)	Echipă	Un film, un serial sau un artist așteaptă aprobarea
Approved (aprobată)	Cei care cer	Cererea lor a fost aprobată
Declined (refuzată)	Cei care cer	Refuzată, cu nota ta
Ready (gata)	Cei care cer	Fișierele sunt în Bibliotecă
New episodes (episoade noi)	Cei care cer și urmăritorii	Cel mult 1 pe serial pe oră. Fiecare persoană le poate opri
New albums (albume noi)	Urmăritorii artistului	Cel mult 1 pe artist pe oră
Problem reported (problemă raportată)	Echipă	Cineva a raportat un titlu. Rapoartele sunt la /requests/reports
Problem fixed (problemă rezolvată)	Cel care a raportat	Cu răspunsul tău
Sent to download (trimis la descărcare)	Echipă	O variantă a fost trimisă unui program de descărcare
In the Library (în Bibliotecă)	Echipă	Fișierele au fost plasate, inclusiv o copie mai bună
Renamed (redenumit)	Echipă	Fișierele au primit nume noi
Added (adăugat)	Echipă	Un titlu a fost adăugat manual, dintr-o listă sau dintr-o cerere
Deleted (șters)	Echipă	Un film, un serial, un sezon sau niște episoade au ieșit din Bibliotecă
Health (sănătate)	Echipă	O verificare de sănătate s-a stricat sau a fost reparată
Needs a decision (cere o decizie)	Echipă	O descărcare sau un import are nevoie de tine

Pachete de sezon

Sub listă, Season packs (pachete de sezon) hotărăște ce trimite o descărcare cu multe episoade: One Alert for the pack (o alertă pentru pachet), cu o linie pe episod, sau One Alert per episode (o alertă pe episod).

Acces la rețeaua locală

Oprit implicit. Cât timp e oprit, alertele Discord merg doar la discord.com, iar celelalte tipuri doar la servere de pe internet; linkurile către acest aparat sau către rețeaua ta de acasă sunt refuzate, chiar și după o căutare de nume. Pornește-l pentru un server de email sau un receptor de acasă. Redirecționările nu sunt urmate niciodată.

Pune o alertă în pauză

Debifează Send messages. Cardul arată Off (oprit), iar alerta rămâne.

Parole și token-uri

Se salvează criptate, apoi apar ca Stored (salvat). Lasă câmpul gol ca să-l păstrezi. Dacă îndrepți o alertă spre alt server, scrii secretul din nou; un secret salvat nu merge niciodată în alt loc.

Dacă nu merge

Simptom:

Paste the Discord link (lipește linkul Discord)

Cauză: linkul nu începe cu https://discord.com/. Soluție: copiază din nou linkul webhook. Pentru un server de tip Discord de acasă, pornește Reach the local network (acces la rețeaua locală).

Simptom:

Points to the local network, which this Alert may not reach (duce la rețeaua locală, la care această alertă nu are voie)

Cauză: serverul e pe acest aparat sau în rețeaua ta de acasă. Soluție: pornește Reach the local network.

Simptom: Last try failed (ultima încercare a eșuat) cu un răspuns 401 sau 404. Cauză: linkul sau token-ul e greșit. Acestea nu se reîncearcă. Soluție: corectează-l și apasă Send a test.

Simptom: cel care a cerut nu a primit nimic. Cauză: contul lui nu are adresă de email sau ID de utilizator Discord, momentul e debifat sau a oprit episoadele noi. Soluție: verifică aceste trei lucruri.

Pentru experți

Reîncercări

Un timeout, un răspuns de tip „încetinește” sau o eroare de server se reîncearcă după 5 s, 30 s și 2 min. O așteptare mai lungă cerută de server este respectată, până la 5 min. Un refuz, cum ar fi un link greșit, nu se reîncearcă. Fiecare eșec adaugă în Istoric (History) un rând „Alert could not be sent”.

Tipuri reținute și câmpurile lor

Apar doar cu comutatorul alert_channels_more pornit.

Tip	Câmpuri
Telegram	Bot token de la @BotFather, Chat ID (ID de utilizator, grup sau canal, sau @channel). Scrie mai întâi botului sau adaugă-l în grup
ntfy	Server address (gol înseamnă ntfy.sh), Topic, opțional Access token. Oricine știe topicul îl poate citi
Gotify	Server address, App token
Pushover	User key (merg și cheile de grup), App token
Webhook (JSON)	Webhook link, opțional Secret, What the secret does

Ce primește un webhook

Un POST pe mesaj, Content-Type: application/json, cu aceste antete:

Antet	Valoare
X-HolyArrs-Event	Momentul, cum ar fi import sau test
X-HolyArrs-Delivery	ID aleatoriu pentru acest mesaj
X-HolyArrs-Timestamp	Cu Signs each message: secunde de la 1970
X-HolyArrs-Signature	Cu Signs each message: sha256= plus HMAC-SHA256 în hex din <timestamp>.<delivery>.<body>, cu cheia secretului tău
Authorization	Cu Is sent as a bearer token: Bearer <secret>

Cu Nothing, nu se trimite niciun secret. Când semnezi, refuză marcajele de timp vechi și ID-urile de livrare pe care le-ai mai văzut, ca un mesaj copiat să nu poată fi retrimis.

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

Alte câmpuri apar când se aplică: test, show și episodes, artist și tracks, report, people. people conține numele celor care cer, niciodată adrese. data conține motivele și căile din rândul din Istoric din spatele mesajului. Orice răspuns 2xx se socotește livrat.

Vezi și

• Verificări de sănătate
• Aprobarea cererilor
• Utilizatori și roluri