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).
Añadir un Aviso
Enlace a Añadir un Aviso- Abre Settings > Alerts (Ajustes > Avisos) y haz clic en Add an Alert (añadir un Aviso).
- Ponle un Name (nombre) y elige un Kind (tipo): Discord o email.
- Rellena los campos de ese tipo (consulta Tipos).
- 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.
- Deja Send messages (enviar mensajes) activado y haz clic en Save (guardar).
- 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).
Tipos
Enlace a TiposDiscord
Enlace a DiscordEn 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.
Opciones
Enlace a OpcionesCuándo enviar
Enlace a Cuándo enviar| 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 temporadaDebajo 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 localDesactivado 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 pausaDesmarca Send messages. La tarjeta muestra Off (desactivado) y el Aviso se conserva.
Contraseñas y tokens
Enlace a Contraseñas y tokensSe 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.
Si no funciona
Enlace a Si no funcionaSí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.
Para expertos
Enlace a Para expertosReintentos
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.
Relacionado
Enlace a RelacionadoHolyArrs es gratis. Si te ahorró tiempo, dale una estrella en GitHub, patrocínalo o invítame a un café.