Chuyển tới nội dung chính

Thông báo

Hộp thư cá nhân gửi đề cập, DM, chia sẻ, lỗi automation và nhắc nhở ngay cả khi trang đã đóng.

Popup trạng thái​

Các thông báo trạng thái ngắn, như khi một thay đổi đã được lưu hoặc một thao tác Git đã hoàn tất, xuất hiện gần đầu trang. Dùng nút Đóng để tắt popup bằng con trỏ hoặc bàn phím. Khi bạn di chuột lên popup, thông báo sẽ được giữ lại để bạn kịp đọc; đóng popup chỉ ẩn thông báo, còn thao tác bên dưới vẫn giữ nguyên trạng thái hiện tại.

Hộp thư​

Các hàng cơ sở dữ liệu được mã hóa; tối đa 500 và bản cũ bị xóa. Khóa nguồn loại bỏ trùng lặp. API RESTful liệt kê, đếm, đánh dấu và xóa.

Phân phối trực tiếp qua notify:<userId> và GET /api/notifications/events (SSE). Danh tính lấy từ phiên; SQL là nguồn sự thật.

Nguồn​

channel-dm, channel-mention (khi ai đó @mentions bạn trong channel hoặc trả lời tin nhắn), channel-invite, share, automation-failed, calendar-reminder, work-run-finished, work-run-attention, work-takeover, work-approval, system. Chỉ gửi cho user liên quan.

Thông báo cũng có thể kích hoạt automation: một automation với event trigger chạy mỗi khi một thông báo thuộc loại đã chọn đến chủ sở hữu, giới hạn bởi cooldown một phút cho mỗi automation.

Webhook​

  • URL chính xác; không redirect. Địa chỉ private/link-local bị từ chối trừ khi host có trong TOOLS_PRIVATE_NETWORK_ALLOWLIST.
  • Body chính xác được ký là X-Libre-Signature: sha256=<hmac>.
  • Chỉ type, title, ID và thời gian đi ra; không có nội dung message, prompt hay document.
  • Retry có giới hạn: 5xx được thử lại, 4xx kết thúc.
  • Type cụ thể hoặc *.

Push trên trình duyệt​

  • VAPID RFC 8292: ES256, cặp khóa mã hóa đã lưu hoặc VAPID_PUBLIC_KEY/VAPID_PRIVATE_KEY, liên hệ VAPID_SUBJECT.
  • RFC 8291: aes128gcm với khóa thiết bị.
  • Theo từng thiết bị và phiên; logout xóa đăng ký. Endpoint được mã hóa và phải là HTTPS công khai.
  • Retry có giới hạn; 404/410 xóa subscription.
  • Payload chứa tiêu đề, văn bản, type và liên kết.

Cần ứng dụng production và origin an toàn. Service worker cung cấp cài đặt và offline shell; API không được cache.

Email​

Email là kênh phân phối thứ ba, và là kênh duy nhất cần administrator thiết lập trước. Settings → Quản lý người dùng → Quyền truy cập và chính sách → Thông báo qua email giữ một máy chủ SMTP gửi thư: host, port, bảo mật kết nối (STARTTLS, TLS ngay từ đầu, hoặc none cho mạng đáng tin cậy), thông tin xác thực tùy chọn, địa chỉ người gửi, và URL công khai dùng cho các liên kết. Các biến môi trường SMTP_* trong Biến môi trường khởi tạo cùng những trường đó cho triển khai container; một giá trị đã lưu trong giao diện được ưu tiên hơn. Mật khẩu được lưu ở dạng mã hóa và không bao giờ trả về trình duyệt. Gửi thử gửi một tin nhắn đến chính địa chỉ của administrator (hoặc bất kỳ địa chỉ nào gõ vào) để chứng minh đường truyền hoạt động trước khi user dựa vào nó.

Quản trị viên cũng chọn mẫu email Sáng hoặc Tối và xem trước trước khi lưu. Sáng là mặc định. Thiết lập đã lưu áp dụng cho mọi thông báo và email thử trên phiên bản này, kể cả kết quả Markdown; nó độc lập với giao diện của từng người dùng. Bản xem trước hiển thị nội dung mẫu mà không kết nối SMTP, gửi thư hay đưa tác vụ vào hàng đợi. Chỉ quản trị viên mới có thể đọc hoặc thay đổi thiết lập hoặc yêu cầu xem trước. Các thiết lập dựng sẵn giữ cho văn bản, liên kết, khối mã và nút luôn dễ đọc; không chấp nhận mẫu HTML tùy chỉnh. Ứng dụng email vẫn có thể điều chỉnh màu theo cài đặt hiển thị riêng của chúng.

Một khi công tắc đã bật, mỗi user chọn thứ gì đến hộp thư của mình dưới Settings → Thông báo → Thông báo qua email:

  • Lượt nhắc trong kênh: một tin nhắn nhắc đến bạn trong channel, kèm bản xem trước và liên kết tới channel.
  • Kết quả tự động hóa: kết quả của mỗi lần chạy automation của bạn, thành công hay thất bại. Một chat run mang chính câu trả lời của assistant (tối đa vài nghìn ký tự); một Work run mang dòng trạng thái của task; một lần thất bại mang lỗi. Liên kết mở chat hoặc task tương ứng.

Cả hai công tắc đều tắt cho đến khi user tự bật, và chỉ hoạt động với tài khoản có địa chỉ email, do chính chủ tài khoản đặt lúc đăng ký hoặc administrator thêm dưới mục Users. Tin nhắn rời hệ thống qua cùng durable job runtime với Web Push, có giới hạn số lần thử lại cho lỗi relay tạm thời, và SMTP client là một cài đặt nhỏ tự viết (EHLO, STARTTLS, AUTH PLAIN hoặc LOGIN) không bao giờ gửi thông tin xác thực qua kết nối chưa mã hóa trừ khi chế độ được đặt rõ là none. Mỗi tin nhắn có một phần văn bản thường và một bản thay thế HTML theo phong cách website: wordmark Libre WebUI, một card chứa nội dung, một nút màu san hô dẫn tới đích, và một footer trỏ về Settings → Thông báo. Kết quả automation được render từ Markdown (heading, danh sách, in đậm/nghiêng, code, liên kết chỉ tới đích http(s)); mọi thứ khác bị escape, và ảnh ngoài duy nhất là logo phục vụ từ librewebui.org. Không theo dõi.

Giới hạn​

Chưa có cài đặt theo từng type; rời channel sẽ dừng thông báo của channel đó.