Ir al contenido

Avisos

Configuración

Un Aviso envía un mensaje de Discord o email cuando pasa algo: una solicitud espera, llega una película, falla una comprobación de salud. Necesitas el permiso Change settings (cambiar ajustes).

  1. Abre Settings > Alerts (Ajustes > Avisos) y haz clic en Add an Alert (añadir un Aviso).
  2. Ponle un Name (nombre) y elige un Kind (tipo): Discord o email.
  3. Rellena los campos de ese tipo (consulta Tipos).
  4. En When to send (cuándo enviar), desmarca los momentos que no quieras. Todos empiezan marcados; All of these (todos estos) y None of these (ninguno de estos) actúan sobre un grupo entero.
  5. Deja Send messages (enviar mensajes) activado y haz clic en Save (guardar).
  6. Haz clic en Send a test (enviar una prueba) en la tarjeta. Deberías ver que llega el mensaje y que la tarjeta muestra Last sent (último envío).

En Discord, abre los ajustes del canal, luego Integrations > Webhooks (Integraciones > Webhooks), y copia el enlace. Pégalo en Discord link (enlace de Discord); empieza por https://discord.com/. A las personas que añadieron su ID de usuario de Discord a su cuenta se las menciona en los mensajes sobre sus solicitudes.

Campo Qué escribir
Mail server (servidor de correo), Port (puerto) Tu servidor de correo
Security (seguridad) STARTTLS (puerto 587), TLS (puerto 465) o None (ninguna). None solo para un servidor de correo en tu propia red
From address (dirección del remitente) La dirección del remitente
Mail username (usuario del correo), Mail password (contraseña del correo) La cuenta de correo
Staff addresses (direcciones de los responsables) Una o varias, separadas por comas

Los mensajes sobre una solicitud van a quienes la pidieron, a la dirección de su cuenta. Todo lo demás va a las direcciones de los responsables.

Telegram, ntfy, Gotify, Pushover y los webhooks están retenidos en esta versión. Consulta Funciones retenidas.

Momento Va a Cuándo
New request (solicitud nueva) Responsables Una película, serie o artista está pendiente de aprobación
Approved (aprobada) Solicitantes Su solicitud se aprobó
Declined (rechazada) Solicitantes Rechazada, con tu nota
Ready (lista) Solicitantes Los archivos están en la Biblioteca
New episodes (episodios nuevos) Solicitantes y seguidores Como máximo 1 por serie y hora. Cada persona puede desactivarlos
New albums (álbumes nuevos) Seguidores del artista Como máximo 1 por artista y hora
Problem reported (problema reportado) Responsables Alguien reportó un título. Los reportes están en /requests/reports
Problem fixed (problema resuelto) Quien lo reportó Con tu respuesta
Sent to download (enviado a descargar) Responsables Un lanzamiento se envió a un gestor de descargas
In the Library (en la Biblioteca) Responsables Se colocaron archivos, también una copia mejor
Renamed (renombrado) Responsables Los archivos recibieron nombres nuevos
Added (añadido) Responsables Se añadió un título a mano, desde una lista o desde una solicitud
Deleted (eliminado) Responsables Una película, serie, temporada o episodios salieron de la Biblioteca
Health (salud) Responsables Una comprobación de salud falló o se arregló
Needs a decision (requiere una decisión) Responsables Una descarga o importación te necesita

Packs de temporada

Enlace a Packs de temporada

Debajo de la lista, Season packs (packs de temporada) decide qué envía una descarga con muchos episodios: One Alert for the pack (un Aviso para el pack), con una línea por episodio, o One Alert per episode (un Aviso por episodio).

Acceso a la red local

Enlace a Acceso a la red local

Desactivado de forma predeterminada. Mientras está desactivado, los Avisos de Discord solo van a discord.com y los demás tipos solo a servidores de internet; los enlaces a este equipo o a tu red de casa se rechazan, incluso después de resolver un nombre. Actívalo para un servidor de correo o un receptor en casa. Las redirecciones nunca se siguen.

Poner un Aviso en pausa

Enlace a Poner un Aviso en pausa

Desmarca Send messages. La tarjeta muestra Off (desactivado) y el Aviso se conserva.

Contraseñas y tokens

Enlace a Contraseñas y tokens

Se guardan cifrados y luego se muestran como Stored (guardado). Deja el campo vacío para conservarlo. Si apuntas un Aviso a otro servidor, tienes que escribir el secreto de nuevo; un secreto guardado nunca va a un lugar nuevo.

Síntoma:

Paste the Discord link (pega el enlace de Discord)

Causa: el enlace no empieza por https://discord.com/. Solución: copia otra vez el enlace del webhook. Para un servidor parecido a Discord en casa, activa Reach the local network (acceso a la red local).

Síntoma:

Points to the local network, which this Alert may not reach (apunta a la red local, a la que este Aviso no puede acceder)

Causa: el servidor está en este equipo o en tu red de casa. Solución: activa Reach the local network.

Síntoma: Last try failed (el último intento falló) con una respuesta 401 o 404. Causa: el enlace o el token es incorrecto. Estos no se reintentan. Solución: corrígelo y haz clic en Send a test.

Síntoma: la persona que lo pidió no recibió nada. Causa: su cuenta no tiene dirección de email ni ID de usuario de Discord, el momento está desmarcado o desactivó los episodios nuevos. Solución: comprueba esas tres cosas.

Reintentos

Un tiempo de espera agotado, una respuesta que pide ir más despacio o un error del servidor se reintentan a los 5 s, 30 s y 2 min. Si el servidor pide una espera más larga, se respeta, hasta 5 min. Un rechazo, como un enlace incorrecto, no se reintenta. Cada fallo añade una fila “Alert could not be sent” (no se pudo enviar el Aviso) al Historial.

Tipos retenidos y sus campos

Solo se muestran con el interruptor alert_channels_more activado.

Tipo Campos
Telegram Bot token (token del bot) de @BotFather, Chat ID (ID del chat: ID de usuario, grupo o canal, o @channel). Escribe antes al bot o añádelo al grupo
ntfy Server address (dirección del servidor; vacío significa ntfy.sh), Topic (tema), Access token (token de acceso) opcional. Cualquiera que conozca el tema puede leerlo
Gotify Server address, App token (token de la app)
Pushover User key (clave de usuario; las claves de grupo funcionan), App token
Webhook (JSON) Webhook link (enlace del webhook), Secret (secreto) opcional, What the secret does (qué hace el secreto)
Qué recibe un webhook

Un POST por mensaje, Content-Type: application/json, con estas cabeceras:

Cabecera Valor
X-HolyArrs-Event El momento, como import o test
X-HolyArrs-Delivery ID aleatorio de este mensaje
X-HolyArrs-Timestamp Con Signs each message (firma cada mensaje): segundos desde 1970
X-HolyArrs-Signature Con Signs each message: sha256= más el HMAC-SHA256 en hexadecimal de <timestamp>.<delivery>.<body>, con tu secreto como clave
Authorization Con Is sent as a bearer token (se envía como bearer token): Bearer <secret>

Con Nothing (nada), no se envía ningún secreto. Si firmas, rechaza las marcas de tiempo antiguas y los ID de entrega que ya hayas visto, para que un mensaje copiado no se pueda reenviar.

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

Otros campos aparecen cuando corresponde: test, show y episodes, artist y tracks, report, people. people contiene los nombres de los solicitantes, nunca direcciones. data contiene los motivos y las rutas de la fila del Historial que originó el mensaje. Cualquier respuesta 2xx cuenta como entregado.

HolyArrs es gratis. Si te ahorró tiempo, dale una estrella en GitHub, patrocínalo o invítame a un café.