Alertas

Um Alerta envia uma mensagem pelo Discord ou por e-mail quando algo acontece: um pedido aguarda, um filme chega, uma verificação de saúde falha. Você precisa da permissão Change settings (alterar configurações).

Adicionar um Alerta

1. Abra Settings > Alerts (Configurações > Alertas) e clique em Add an Alert (adicionar um Alerta).
2. Dê um nome em Name (nome) e escolha um tipo em Kind (tipo): Discord ou e-mail.
3. Preencha os campos do tipo (veja Tipos).
4. Em When to send (quando enviar), desmarque os momentos que você não quer. Todos começam marcados; All of these (todos estes) e None of these (nenhum destes) valem para um grupo inteiro.
5. Deixe Send messages (enviar mensagens) ativado e clique em Save (salvar).
6. Clique em Send a test (enviar um teste) no cartão. Você deve ver a mensagem chegar e o cartão mostrar Last sent (último envio).

Tipos

Discord

No Discord, abra as configurações do canal, depois Integrations > Webhooks (Integrações > Webhooks), e copie o link. Cole em Discord link (link do Discord); ele começa com https://discord.com/. As pessoas que adicionaram o ID de usuário do Discord à conta são mencionadas nas mensagens sobre os pedidos delas.

E-mail

Campo	O que digitar
Mail server (servidor de e-mail), Port (porta)	Seu servidor de e-mail
Security (segurança)	STARTTLS (porta 587), TLS (porta 465) ou None. None só para um servidor de e-mail na sua própria rede
From address (endereço do remetente)	O endereço de quem envia
Mail username (usuário do e-mail), Mail password (senha do e-mail)	A conta de e-mail
Staff addresses (endereços da equipe)	Um ou mais, separados por vírgulas

As mensagens sobre um pedido vão para as pessoas que pediram, no endereço da conta delas. Todo o resto vai para os endereços da equipe.

Telegram, ntfy, Gotify, Pushover e webhooks estão retidos nesta versão. Veja Recursos retidos.

Opções

Quando enviar

Momento	Vai para	Quando
New request (novo pedido)	Equipe	Um filme, uma série ou um artista aguarda aprovação
Approved (aprovado)	Quem pediu	O pedido da pessoa foi aprovado
Declined (recusado)	Quem pediu	Recusado, com a sua nota
Ready (pronto)	Quem pediu	Os arquivos estão na Biblioteca
New episodes (novos episódios)	Quem pediu e quem segue	No máximo 1 por série por hora. Cada pessoa pode desativar estes
New albums (novos álbuns)	Quem segue o artista	No máximo 1 por artista por hora
Problem reported (problema relatado)	Equipe	Alguém relatou um problema em um título. Os relatos ficam em /requests/reports
Problem fixed (problema resolvido)	Quem relatou	Com a sua resposta
Sent to download (enviado para download)	Equipe	Um lançamento foi para um gerenciador de downloads
In the Library (na Biblioteca)	Equipe	Os arquivos foram colocados, inclusive uma cópia melhor
Renamed (renomeado)	Equipe	Os arquivos ganharam nomes novos
Added (adicionado)	Equipe	Um título foi adicionado à mão, por uma lista ou por um pedido
Deleted (excluído)	Equipe	Um filme, uma série, uma temporada ou episódios saíram da Biblioteca
Health (saúde)	Equipe	Uma verificação de saúde falhou ou foi resolvida
Needs a decision (precisa de uma decisão)	Equipe	Um download ou uma importação precisa de você

Pacotes de temporada

Abaixo da lista, Season packs (pacotes de temporada) decide o que um download com muitos episódios envia: One Alert for the pack (um Alerta para o pacote), com uma linha por episódio, ou One Alert per episode (um Alerta por episódio).

Alcançar a rede local

Desativado por padrão. Enquanto está desativado, os Alertas do Discord vão só para discord.com e os outros tipos só para servidores da internet; links para este computador ou para a sua rede de casa são recusados, mesmo depois de uma consulta de nome. Ative para um servidor de e-mail ou um receptor em casa. Redirecionamentos nunca são seguidos.

Pausar um Alerta

Desmarque Send messages. O cartão mostra Off (desativado) e o Alerta continua lá.

Senhas e tokens

São salvos criptografados e depois aparecem como Stored (salvo). Deixe o campo vazio para manter o valor. Se você apontar um Alerta para outro servidor, digita o segredo de novo; um segredo salvo nunca vai para um lugar novo.

Se não funcionar

Sintoma:

Paste the Discord link (cole o link do Discord)

Causa: o link não começa com https://discord.com/. Solução: copie o link do webhook de novo. Para um servidor parecido com o Discord em casa, ative Reach the local network (alcançar a rede local).

Sintoma:

Points to the local network, which this Alert may not reach (aponta para a rede local, que este Alerta não pode alcançar)

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

Sintoma: Last try failed (a última tentativa falhou) com uma resposta 401 ou 404. Causa: o link ou o token está errado. Esses casos não têm nova tentativa. Solução: corrija e clique em Send a test.

Sintoma: a pessoa que pediu não recebeu nada. Causa: a conta dela não tem endereço de e-mail nem ID de usuário do Discord, o momento está desmarcado ou ela desativou os novos episódios. Solução: confira esses três pontos.

Para especialistas

Novas tentativas

Depois de um tempo esgotado, de uma resposta pedindo para ir mais devagar ou de um erro do servidor, o HolyArrs tenta de novo após 5 s, 30 s e 2 min. Uma espera maior pedida pelo servidor é respeitada, até 5 min. Uma recusa, como um link errado, não tem nova tentativa. Cada falha adiciona uma linha “Alert could not be sent” (o Alerta não pôde ser enviado) ao Histórico.

Tipos retidos e seus campos

Aparecem só com a chave alert_channels_more ativada.

Tipo	Campos
Telegram	Bot token (token do bot) do @BotFather, Chat ID (ID do chat: ID de usuário, grupo ou canal, ou @channel). Mande uma mensagem ao bot ou adicione o bot ao grupo antes
ntfy	Server address (endereço do servidor; vazio significa ntfy.sh), Topic (tópico), Access token (token de acesso) opcional. Qualquer pessoa que saiba o tópico consegue ler
Gotify	Server address, App token (token do app)
Pushover	User key (chave do usuário; chaves de grupo funcionam), App token
Webhook (JSON)	Webhook link (link do webhook), Secret (segredo) opcional, What the secret does (o que o segredo faz)

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 (assina cada mensagem): segundos desde 1970
X-HolyArrs-Signature	Com Signs each message: sha256= mais o HMAC-SHA256 em hexadecimal de <timestamp>.<delivery>.<body>, usando o seu segredo como chave
Authorization	Com Is sent as a bearer token (é enviado como bearer token): Bearer <secret>

Com Nothing (nada), nenhum segredo é enviado. Ao assinar, recuse timestamps antigos e IDs de entrega que você já viu, para que uma mensagem copiada não possa ser reenviada.

{
  "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 fazem sentido: test, show e episodes, artist e tracks, report, people. people traz os nomes de quem pediu, nunca endereços. data traz os motivos e os caminhos da linha do Histórico que gerou a mensagem. Qualquer resposta 2xx conta como entregue.

Relacionados

• Verificações de saúde
• Aprovar pedidos
• Usuários e funções