Avisos

Un avís (Alert) envia un missatge de Discord o email quan passa alguna cosa: una sol·licitud espera, arriba una pel·lícula, falla una comprovació de salut. Necessites el permís Change settings (canviar paràmetres).

Afegeix un avís

1. Obre Settings > Alerts (Paràmetres > Avisos) i clica a Add an Alert (afegeix un avís).
2. Posa-li un Name (nom) i tria un Kind (tipus): Discord o email.
3. Omple els camps del tipus (mira Tipus).
4. A When to send (quan enviar), desmarca els moments que no vulguis. Tots comencen marcats; All of these (tots aquests) i None of these (cap d’aquests) funcionen en un grup sencer.
5. Deixa Send messages (enviar missatges) activat i clica a Save (desa).
6. Clica a Send a test (envia una prova) a la targeta. Hauries de veure que arriba el missatge i que la targeta mostra Last sent (últim enviament).

Tipus

Discord

A Discord, obre els paràmetres del canal, després Integrations > Webhooks, i copia l’enllaç. Enganxa’l a Discord link (enllaç de Discord); comença per https://discord.com/. Als missatges sobre les seves sol·licituds s’esmenten les persones que han afegit el seu ID d’usuari de Discord al compte.

Email

Camp	Què has d’escriure
Mail server, Port	El teu servidor de correu
Security	STARTTLS (port 587), TLS (port 465) o None. None només per a un servidor de correu a la teva pròpia xarxa
From address	L’adreça del remitent
Mail username, Mail password	El compte de correu
Staff addresses	Una o més, separades per comes

Els missatges sobre una sol·licitud van a les persones que l’han demanat, a l’adreça del seu compte. Tota la resta va a les adreces del personal.

Telegram, ntfy, Gotify, Pushover i els webhooks queden retinguts en aquesta versió. Mira Funcions retingudes.

Opcions

Quan enviar

Moment	Va a	Quan
New request	Personal	Una pel·lícula, sèrie o artista espera aprovació
Approved	Sol·licitants	S’ha aprovat la seva sol·licitud
Declined	Sol·licitants	Rebutjada, amb la teva nota
Ready	Sol·licitants	Els fitxers són a la Biblioteca
New episodes	Sol·licitants i seguidors	Com a màxim 1 per sèrie i hora. Cada persona els pot desactivar
New albums	Seguidors de l’artista	Com a màxim 1 per artista i hora
Problem reported	Personal	Algú ha informat d’un títol. Els informes són a /requests/reports
Problem fixed	Qui ha informat	Amb la teva resposta
Sent to download	Personal	Un llançament ha anat a un gestor de baixades
In the Library	Personal	S’han col·locat fitxers, incloent-hi una còpia millor
Renamed	Personal	Els fitxers han rebut noms nous
Added	Personal	S’ha afegit un títol a mà, des d’una llista o des d’una sol·licitud
Deleted	Personal	Una pel·lícula, sèrie, temporada o episodis han sortit de la Biblioteca
Health	Personal	Una comprovació de salut ha fallat o s’ha arreglat
Needs a decision	Personal	Una baixada o importació necessita que hi intervinguis

Paquets de temporada

A sota de la llista, Season packs (paquets de temporada) decideix què envia una baixada amb molts episodis: One Alert for the pack (un avís per al paquet), amb una línia per episodi, o One Alert per episode (un avís per episodi).

Accedeix a la xarxa local

Desactivat per defecte. Mentre està desactivat, els avisos de Discord van només a discord.com i els altres tipus només a servidors d’internet; els enllaços a aquest equip o a la xarxa de casa es rebutgen, fins i tot després d’una consulta de nom. Activa-ho per a un servidor de correu o receptor a casa. Les redireccions mai se segueixen.

Posa un avís en pausa

Desmarca Send messages. La targeta mostra Off i l’avís continua existint.

Contrasenyes i tokens

Es desen xifrats i després es mostren com a Stored (desat). Deixa el camp buit per mantenir-lo. Si apuntes un avís a un altre servidor, has de tornar a escriure el secret; un secret desat mai va a un lloc nou.

Si no funciona

Símptoma:

Paste the Discord link

Causa: l’enllaç no comença per https://discord.com/. Solució: copia de nou l’enllaç del webhook. Per a un servidor similar a Discord a casa, activa Reach the local network (accedir a la xarxa local).

Símptoma:

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

Causa: el servidor és en aquest equip o a la xarxa de casa. Solució: activa Reach the local network.

Símptoma: Last try failed (l’últim intent ha fallat) amb una resposta 401 o 404. Causa: l’enllaç o el token és incorrecte. No es tornen a provar. Solució: corregeix-lo i clica a Send a test.

Símptoma: la persona que ho ha demanat no ha rebut res. Causa: no hi ha cap adreça d’email ni ID d’usuari de Discord al seu compte, el moment està desmarcat, o ha desactivat els episodis nous. Solució: comprova aquestes tres coses.

Per a experts

Reintents

Un temps d’espera esgotat, una resposta que demana anar més a poc a poc o un error del servidor es torna a provar després de 5 s, 30 s i 2 min. Una espera més llarga demanada pel servidor es respecta, fins a 5 min. Un rebuig, com un enllaç incorrecte, no es torna a provar. Cada fallada afegeix una fila “Alert could not be sent” a l’Historial.

Tipus retinguts i els seus camps

Només es mostren amb l’interruptor alert_channels_more activat.

Tipus	Camps
Telegram	Bot token de @BotFather, Chat ID (ID d’usuari, grup o canal, o @channel). Escriu primer al bot o afegeix-lo al grup
ntfy	Server address (buit vol dir ntfy.sh), Topic, Access token opcional. Qualsevol persona que conegui el topic el pot llegir
Gotify	Server address, App token
Pushover	User key (les claus de grup funcionen), App token
Webhook (JSON)	Webhook link, Secret opcional, What the secret does

Què rep un webhook

Un POST per missatge, Content-Type: application/json, amb aquestes capçaleres:

Capçalera	Valor
X-HolyArrs-Event	El moment, com import o test
X-HolyArrs-Delivery	ID aleatori d’aquest missatge
X-HolyArrs-Timestamp	Amb Signs each message: segons des de 1970
X-HolyArrs-Signature	Amb Signs each message: sha256= més l’HMAC-SHA256 en hexadecimal de <timestamp>.<delivery>.<body>, amb el teu secret com a clau
Authorization	Amb Is sent as a bearer token: Bearer <secret>

Amb Nothing, no s’envia cap secret. Quan se signa, rebutja les marques de temps antigues i els ID d’enviament que ja has vist, perquè un missatge copiat no es pugui repetir.

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

Apareixen altres camps quan s’apliquen: test, show i episodes, artist i tracks, report, people. people conté noms de sol·licitants, mai adreces. data conté els motius i les rutes de la fila de l’Historial que hi ha darrere del missatge. Qualsevol resposta 2xx compta com a lliurat.

Relacionat

• Comprovacions de salut
• Aprovar sol·licituds
• Usuaris i rols