Avisos

Um aviso (Alert) envia uma mensagem no Discord ou por email quando algo acontece: um pedido fica à espera, chega um filme, uma verificação de saúde falha. Precisas da permissão Change settings (alterar definições).

Adicionar um aviso

1. Abre Settings > Alerts (Definições > avisos) e clica em Add an Alert (adicionar um aviso).
2. Dá-lhe um Name (nome) e escolhe um Kind (tipo): Discord ou email.
3. Preenche os campos do tipo (vê Tipos).
4. Em When to send (quando enviar), desassinala os momentos que não queres. Todos começam assinalados; All of these (todos estes) e None of these (nenhum destes) funcionam num grupo inteiro.
5. Deixa Send messages (enviar mensagens) ativado e clica em Save (guardar).
6. Clica em Send a test (enviar um teste) no cartão. Deves ver a mensagem chegar e o cartão mostrar Last sent (último envio).

Tipos

Discord

No Discord, abre as definições do canal, depois Integrations > Webhooks, e copia a ligação. Cola-a em Discord link (ligação do Discord); começa por https://discord.com/. As pessoas que adicionaram o ID de utilizador do Discord à conta são mencionadas nas mensagens sobre os pedidos delas.

Email

Campo	O que escrever
Mail server, Port	O teu servidor de email
Security	STARTTLS (porta 587), TLS (porta 465) ou None. None só para um servidor de email na tua própria rede
From address	O endereço do remetente
Mail username, Mail password	A conta de email
Staff addresses	Um ou mais, separados por vírgulas

As mensagens sobre um pedido vão para quem o fez, ao endereço da conta. Tudo o resto vai para os endereços da equipa.

O Telegram, o ntfy, o Gotify, o Pushover e os webhooks estão retidos nesta versão. Vê Funcionalidades retidas.

Opções

Quando enviar

Momento	Vai para	Quando
New request	Equipa	Um filme, uma série ou um artista espera aprovação
Approved	Quem pediu	O pedido deles foi aprovado
Declined	Quem pediu	Recusado, com a tua nota
Ready	Quem pediu	Os ficheiros estão na Biblioteca
New episodes	Quem pediu e seguidores	No máximo 1 por série por hora. Cada pessoa pode desativá-los
New albums	Seguidores do artista	No máximo 1 por artista por hora
Problem reported	Equipa	Alguém comunicou um problema com um título. As comunicações estão em /requests/reports
Problem fixed	Quem comunicou	Com a tua resposta
Sent to download	Equipa	Um lançamento foi para um gestor de transferências
In the Library	Equipa	Os ficheiros foram colocados, incluindo uma cópia melhor
Renamed	Equipa	Os ficheiros ficaram com nomes novos
Added	Equipa	Um título foi adicionado à mão, a partir de uma lista ou de um pedido
Deleted	Equipa	Um filme, série, temporada ou episódios saíram da Biblioteca
Health	Equipa	Uma verificação de saúde falhou ou ficou resolvida
Needs a decision	Equipa	Uma transferência ou importação precisa de ti

Packs de temporada

Por baixo da lista, Season packs (packs de temporada) decide o que uma transferência com muitos episódios envia: One Alert for the pack (um aviso para o pack), com uma linha por episódio, ou One Alert per episode (um aviso por episódio).

Aceder à rede local

Desativado por predefinição. Enquanto está desativado, os avisos do Discord só vão para discord.com e os outros tipos só para servidores da internet; as ligações para este computador ou para a tua rede de casa são recusadas, mesmo depois de uma consulta de nome. Ativa-o para um servidor de email ou recetor em casa. Os redirecionamentos nunca são seguidos.

Pôr um aviso em pausa

Desassinala Send messages. O cartão mostra Off e o aviso mantém-se.

Palavras-passe e tokens

Ficam guardados cifrados e depois aparecem como Stored (guardado). Deixa o campo vazio para o manter. Se apontares um aviso para outro servidor, escreves o segredo outra vez; um segredo guardado nunca vai para um destino novo.

Se não funcionar

Sintoma:

Paste the Discord link

Causa: a ligação não começa por https://discord.com/. Solução: copia outra vez a ligação do webhook. Para um servidor tipo Discord em casa, ativa Reach the local network (aceder à rede local).

Sintoma:

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

Causa: o servidor está neste computador ou na tua rede de casa. Solução: ativa Reach the local network.

Sintoma: Last try failed (última tentativa falhou) com uma resposta 401 ou 404. Causa: a ligação ou o token está errado. Estes não são repetidos. Solução: corrige-o e clica em Send a test.

Sintoma: quem fez o pedido não recebeu nada. Causa: não há endereço de email nem ID de utilizador do Discord na conta, o momento está desassinalado, ou a pessoa desativou os episódios novos. Solução: verifica estas três coisas.

Para especialistas

Novas tentativas

Um tempo limite excedido, uma resposta a pedir que abrandes ou um erro do servidor são repetidos ao fim de 5 s, 30 s e 2 min. Uma espera mais longa pedida pelo servidor é respeitada, até 5 min. Uma recusa, como uma ligação errada, não é repetida. Cada falha acrescenta uma linha “Alert could not be sent” ao Histórico.

Tipos retidos e os seus campos

Só aparecem com o interruptor alert_channels_more ativado.

Tipo	Campos
Telegram	Bot token do @BotFather, Chat ID (ID de utilizador, grupo ou canal, ou @channel). Envia primeiro uma mensagem ao bot ou adiciona-o ao grupo
ntfy	Server address (vazio significa ntfy.sh), Topic, Access token opcional. Quem souber o tópico pode lê-lo
Gotify	Server address, App token
Pushover	User key (as chaves de grupo funcionam), App token
Webhook (JSON)	Webhook link, Secret opcional, What the secret does

O que um webhook recebe

Um POST por mensagem, Content-Type: application/json, com estes cabeçalhos:

Cabeçalho	Valor
X-HolyArrs-Event	O momento, como import ou test
X-HolyArrs-Delivery	ID aleatório desta mensagem
X-HolyArrs-Timestamp	Com Signs each message: segundos desde 1970
X-HolyArrs-Signature	Com Signs each message: sha256= mais o HMAC-SHA256 em hexadecimal de <timestamp>.<delivery>.<body>, com a tua chave secreta
Authorization	Com Is sent as a bearer token: Bearer <secret>

Com Nothing, não é enviado nenhum segredo. Ao assinar, recusa timestamps antigos e IDs de entrega que já viste, para que uma mensagem copiada não possa ser repetida.

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

Outros campos aparecem quando se aplicam: test, show e episodes, artist e tracks, report, people. people tem nomes de quem pediu, nunca endereços. data tem os motivos e caminhos da linha do Histórico que está por trás da mensagem. Qualquer resposta 2xx conta como entregue.

Relacionado

• Verificações de saúde
• Aprovar pedidos
• Utilizadores e funções