1. TOOL
One Push
  • Tổng quan hệ thống
  • Bussiness Logic
    • Business Logic
    • HỆ THỐNG ĐIỀU PHỐI TIN NHẮN (PUSH ENGINE)
    • HỆ THỐNG ĐỒNG BỘ HEARTBEAT (REAL-TIME SYNC)
    • HỆ THỐNG ĐIỀU PHỐI TIN NHẮN (PUSH ENGINE)
  • Project
    • API
      • Tổng quan API
      • Hướng dẫn sử dụng
        • 1.1 Khởi tạo Website Tham gia
        • 1.2 Cấu hình Bots Telegram
        • 1.3 Quản lý Chiến dịch (Campaigns)
        • 1.4 Lên Lịch Gửi Tự Động
        • 1.5 Tương tác & Thống kê
        • 1.6 Quản lý Tài khoản (RBAC)
        • 1.7 Báo cáo Chi tiết Tin nhắn (Web & Telegram)
      • API
        • Widget nhúng Website
          • Đăng ký Subscriber mới / Nhật ký Heartbeat
          • Cập nhật trạng thái Seen/Read
          • Ghi nhận hiển thị Alert Popup
          • Lấy dữ liệu Alert cho website
        • Tracking & Tương tác
          • Ghi nhận lựa chọn Yes/No
        • Báo cáo & Thống kê
          • Thống kê người dùng Real-time
          • Phân tích tăng trưởng Subscriber
          • Dữ liệu bản đồ nhiệt Vị trí
          • Xuất báo cáo thông báo Excel
        • Lịch gửi Thông báo
          • Danh sách lịch gửi thông báo
          • Tạo lịch gửi mới
          • Bật/Tắt lịch gửi
        • Betting Tips
          • Lấy Tip bóng đá HOT nhất
          • Lấy dữ liệu Mock Tip (Test)
        • Telegram Integration
          • Danh sách Telegram Bot
          • Telegram Webhook Endpoint
        • Email Marketing
          • Tạo và gửi chiến dịch Email
        • Hệ thống & RBAC
          • Danh sách tài khoản Admin/Nhân viên
          • Danh sách vai trò (Roles)
        • Tiện ích & Files
          • Truy xuất nhật ký hệ thống (System Logs)
        • Chiến dịch (Campaigns)
          • Danh sách chiến dịch
        • Website Khách hàng (Clients)
          • Danh sách website khách hàng
        • Quản lý Thành viên (Subscribers)
          • Danh sách người đăng ký (Subscribers)
          • Xóa người nhận tin
      • Architecture
        • System Architecture (Kiến trúc Hệ thống)
        • Code Structure
        • Database Schema (Mô hình Dữ liệu)
      • Deployment
        • Local
        • Production
        • Development
    • TOOL
      • Tổng quan Tool
      • Hướng dẫn sử dụng
        • Hướng dẫn sử dụng — Novu Notification Infrastructure
      • Architecture
        • System Architecture
        • Code Structure
        • Database Schema
      • API
        • 👥 Subscribers
          • Tạo/Cập nhật Subscriber
          • Cập nhật Profile
        • 🗺️ Workflows
          • Lấy danh sách Workflow Templates
          • Chi tiết Workflow
        • 📂 Notification History
          • Lịch sử biến động Notification
        • 🎯 Topics
          • Tạo Topic mới
        • 📐 Layouts
          • Lấy danh sách Layout (Email/Web)
        • 💬 Messages
          • Tra cứu vết tin nhắn chi tiết (Low-level)
        • 🔌 Integrations
          • Danh sách nhà cung cấp (Providers)
        • 🚀 Events & Triggers
          • Kích hoạt thông báo (Workflows)
          • Kích hoạt hàng loạt (Bulk Trigger)
      • Deployment
        • Deployment
  • Schemas
    • NotificationWidget
    • TrackingStats
    • NotificationSchedule
  1. TOOL

Tổng quan Tool

Tài liệu Tổng quan Hệ thống Novu#

Novu
Mô tả chức năng, kiến trúc và quy trình vận hành của Hệ thống thông báo đa kênh Novu (Open-source Notification Infrastructure).

Intro#

Novu là hệ thống cơ sở hạ tầng thông báo nguồn mở mạnh mẽ dành cho các ứng dụng hiện đại. Nó giúp biến bài toán phân phối thông báo đa kênh (multi-channel delivery) phức tạp thành một nền tảng thống nhất duy nhất. Được thiết kế tối ưu cho lập trình viên, Novu cung cấp một API duy nhất để xử lý toàn bộ luồng giao tiếp với người dùng.
[!TIP]
Tích hợp Novu ngay vào hệ thống cho phép bạn "thuê ngoài" hoàn toàn bài toán về xử lý bất đồng bộ, gửi lại khi lỗi (Retry strategies) và quản lý thiết lập cá nhân người dùng.

Core Values#

Giá trịMô tả
⚡ API tích hợp duy nhấtGiao tiếp với toàn bộ các kênh (Email, SMS, Push, Web In-App, Chat) chỉ qua duy nhất một API.
🛡️ Workflow Engine linh hoạtKhông cần code cứng logic, hệ thống hỗ trợ kéo thả xây dựng luồng thông báo (Triggers, Delays, Digests).
🌐 Tích hợp hộp thư In-AppComponent UI Notification Center thời gian thực có thể nhúng dễ dàng vào Web/App (React, Vue,...).
📊 Quản lý PreferencesTích hợp sẵn trang tuỳ chỉnh giúp người dùng cuối (Subscriber) tự chọn kênh họ muốn nhận thông báo.

Architecture#

Hệ thống Novu được thiết kế nguyên khối (Monorepo) với khả năng mở rộng cực cao. Hình ảnh dưới đây minh hoạ luồng xử lý từ lúc Trigger đến khi bắn thông báo:

1. 🎯 Quản lý Workflow & Chiến dịch#

Trình soạn thảo No-Code: Giao diện chỉnh sửa Template thông báo mạnh mẽ (ví dụ: Email Block Editor).
Hệ thống xử lý Logic (Workflow Engine): Có khả năng thiết lập thời gian chờ (Delay), gom nhóm thông báo (Digest) làm giảm áp lực spam tới người nhận.

2. 🔄 Trung tâm Phân phối (Routing & Delivery API)#

API Gateway: Điểm tiếp nhận mọi sự kiện (Trigger) đến từ các nguồn.
Provider HUB: Khớp thông báo tới các "họng súng" (Integrations) phù hợp.

3. ⚙️ Bộ máy xử lý ngầm (Worker Engine)#

Hàng đợi bất đồng bộ (Background Queue): Sử dụng Redis + BullMQ đảm trách việc xếp hàng, xử lý song song hàng triệu Job gửi tin cùng lúc để làm Non-blocking I/O.
Render & Inject: Tổng hợp Data truyền vào (Payload) tự động chèn vào Template.

Channels#

Hệ thống hỗ trợ sẵn hàng chục nhà cung cấp khác nhau mà không phải viết thêm một dòng boilerplate nào:
Email Hỗ trợ hầu hết các đơn vị gửi mail chuyên dụng hiện nay.
SMS Bao phủ nền tảng tin nhắn toàn cầu.
Push Nhằm đẩy cảnh báo trên OS Mobile.
Chat Gửi thông báo vào kênh nhóm làm việc.
InApp Hệ thống Hộp thư đến Notification Center gắn ngay trên UI người dùng.
[!NOTE]
Các nhà cung cấp có thể được thiết lập tính năng Fallback (Ví dụ: Gửi Push thất bại thì tự động chuyển qua gửi Email).
Modified at 2026-03-30 15:33:15
Previous
Development
Next
Hướng dẫn sử dụng — Novu Notification Infrastructure
Built with