Cảnh báo

Một cảnh báo gửi tin nhắn Discord hoặc email khi có việc xảy ra: một yêu cầu đang chờ, một phim lẻ về Thư viện, một kiểm tra tình trạng bị lỗi. Bạn cần quyền Change settings (đổi cài đặt).

Thêm một cảnh báo

1. Mở Settings > Alerts (Cài đặt > Cảnh báo) và chọn Add an Alert (thêm cảnh báo).
2. Đặt Name (tên) cho nó và chọn Kind (loại): Discord hoặc email.
3. Điền các trường của loại đó (xem Loại).
4. Ở When to send (khi nào gửi), bỏ đánh dấu những thời điểm bạn không muốn. Tất cả đều được đánh dấu sẵn; All of these (tất cả) và None of these (không cái nào) áp dụng cho cả một nhóm.
5. Để Send messages (gửi tin nhắn) bật và chọn Save (lưu).
6. Chọn Send a test (gửi thử) trên thẻ. Bạn sẽ thấy tin nhắn đến và thẻ hiện Last sent (lần gửi gần nhất).

Loại

Discord

Trong Discord, mở cài đặt kênh, rồi Integrations > Webhooks, và sao chép liên kết. Dán vào Discord link; liên kết bắt đầu bằng https://discord.com/. Những người đã thêm Discord user ID vào tài khoản của mình sẽ được nhắc tên trong các tin nhắn về yêu cầu của họ.

Email

Trường	Nhập gì
Mail server, Port	Máy chủ thư của bạn
Security	STARTTLS (cổng 587), TLS (cổng 465) hoặc None. Chỉ chọn None cho máy chủ thư trong mạng của bạn
From address	Địa chỉ người gửi
Mail username, Mail password	Tài khoản thư
Staff addresses	Một hoặc nhiều địa chỉ, ngăn cách bằng dấu phẩy

Tin nhắn về một yêu cầu được gửi đến những người đã yêu cầu, theo địa chỉ trong tài khoản của họ. Mọi tin nhắn khác gửi đến các địa chỉ nhân viên.

Telegram, ntfy, Gotify, Pushover và webhook là các tính năng chưa mở trong phiên bản này. Xem Tính năng chưa mở.

Lựa chọn

Khi nào gửi

Thời điểm	Gửi đến	Khi nào
New request	Nhân viên	Một phim lẻ, phim bộ hoặc nghệ sĩ đang chờ duyệt
Approved	Người yêu cầu	Yêu cầu của họ đã được duyệt
Declined	Người yêu cầu	Bị từ chối, kèm ghi chú của bạn
Ready	Người yêu cầu	Các tệp đã vào Thư viện
New episodes	Người yêu cầu và người theo dõi	Tối đa 1 lần mỗi phim bộ mỗi giờ. Mỗi người có thể tắt loại này
New albums	Người theo dõi nghệ sĩ	Tối đa 1 lần mỗi nghệ sĩ mỗi giờ
Problem reported	Nhân viên	Có người báo cáo một mục. Các báo cáo nằm ở /requests/reports
Problem fixed	Người báo cáo	Kèm câu trả lời của bạn
Sent to download	Nhân viên	Một bản phát hành đã được gửi đến trình tải xuống
In the Library	Nhân viên	Các tệp đã được đặt vào, kể cả một bản tốt hơn
Renamed	Nhân viên	Các tệp đã được đổi tên
Added	Nhân viên	Một mục được thêm thủ công, từ một danh sách hoặc từ một yêu cầu
Deleted	Nhân viên	Một phim lẻ, phim bộ, mùa hoặc các tập rời khỏi Thư viện
Health	Nhân viên	Một kiểm tra tình trạng bị lỗi hoặc đã được sửa
Needs a decision	Nhân viên	Một lượt tải xuống hoặc nhập cần đến bạn

Gói mùa

Bên dưới danh sách, Season packs (gói mùa) quyết định điều gì được gửi khi một lượt tải xuống có nhiều tập: One Alert for the pack (một cảnh báo cho cả gói), kèm một dòng cho mỗi tập, hoặc One Alert per episode (một cảnh báo cho mỗi tập).

Truy cập mạng nội bộ

Mặc định tắt. Khi tắt, cảnh báo Discord chỉ đi đến discord.com và các loại khác chỉ đi đến máy chủ trên internet; liên kết đến máy này hoặc mạng ở nhà bạn bị từ chối, kể cả sau khi tra tên. Hãy bật nếu bạn có máy chủ thư hoặc máy chủ nhận tin ở nhà. HolyArrs không bao giờ theo chuyển hướng.

Tạm dừng một cảnh báo

Bỏ đánh dấu Send messages. Thẻ hiện Off và cảnh báo vẫn còn đó.

Mật khẩu và token

Được lưu mã hóa và hiển thị là Stored (đã lưu). Để trống trường để giữ nguyên. Nếu bạn trỏ một cảnh báo sang máy chủ khác, bạn phải nhập lại bí mật; một bí mật đã lưu không bao giờ được gửi đến nơi mới.

Nếu không hoạt động

Triệu chứng:

Paste the Discord link

Nguyên nhân: liên kết không bắt đầu bằng https://discord.com/. Cách khắc phục: sao chép lại liên kết webhook. Với một máy chủ giống Discord ở nhà, hãy bật Reach the local network (truy cập mạng nội bộ).

Triệu chứng:

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

Nguyên nhân: máy chủ nằm trên máy này hoặc mạng ở nhà bạn. Cách khắc phục: bật Reach the local network.

Triệu chứng: Last try failed với câu trả lời 401 hoặc 404. Nguyên nhân: liên kết hoặc token bị sai. Các lỗi này không được thử lại. Cách khắc phục: sửa lại rồi chọn Send a test.

Triệu chứng: người đã yêu cầu không nhận được gì. Nguyên nhân: tài khoản của họ không có địa chỉ email hay Discord user ID, thời điểm đó đã bị bỏ đánh dấu, hoặc họ đã tắt tập mới. Cách khắc phục: kiểm tra ba điều đó.

Dành cho người dùng nâng cao

Thử lại

Hết thời gian chờ, câu trả lời yêu cầu giảm tốc hoặc lỗi máy chủ sẽ được thử lại sau 5 giây, 30 giây và 2 phút. Nếu máy chủ yêu cầu chờ lâu hơn thì HolyArrs tuân theo, tối đa 5 phút. Một lời từ chối, như liên kết sai, không được thử lại. Mỗi lần lỗi thêm một dòng “Alert could not be sent” vào Lịch sử.

Các loại chưa mở và các trường của chúng

Chỉ hiện khi công tắc alert_channels_more được bật.

Loại	Trường
Telegram	Bot token từ @BotFather, Chat ID (ID người dùng, nhóm hoặc kênh, hoặc @channel). Hãy nhắn cho bot hoặc thêm nó vào nhóm trước
ntfy	Server address (để trống nghĩa là ntfy.sh), Topic, tùy chọn Access token. Ai biết topic đều đọc được
Gotify	Server address, App token
Pushover	User key (khóa nhóm cũng dùng được), App token
Webhook (JSON)	Webhook link, tùy chọn Secret, What the secret does

Webhook nhận được gì

Một POST cho mỗi tin nhắn, Content-Type: application/json, với các header sau:

Header	Giá trị
X-HolyArrs-Event	Thời điểm, như import hoặc test
X-HolyArrs-Delivery	ID ngẫu nhiên cho tin nhắn này
X-HolyArrs-Timestamp	Với Signs each message: số giây kể từ năm 1970
X-HolyArrs-Signature	Với Signs each message: sha256= cộng HMAC-SHA256 dạng hex của <timestamp>.<delivery>.<body>, dùng bí mật của bạn làm khóa
Authorization	Với Is sent as a bearer token: Bearer <secret>

Với Nothing, không có bí mật nào được gửi. Khi dùng chữ ký, hãy từ chối các dấu thời gian cũ và các delivery ID bạn đã thấy, để một tin nhắn bị sao chép không thể bị phát lại.

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

Các trường khác xuất hiện khi phù hợp: test, show và episodes, artist và tracks, report, people. people chứa tên người yêu cầu, không bao giờ chứa địa chỉ. data chứa lý do và đường dẫn từ dòng Lịch sử đứng sau tin nhắn. Mọi câu trả lời 2xx đều được tính là đã gửi.

Liên quan

• Kiểm tra tình trạng
• Duyệt yêu cầu
• Người dùng và vai trò