Giới thiệu

Kích hoạt thông báo và tin nhắn tự động dựa trên các sự kiện của hệ thống.

🎯 Mô-đun này làm gì?

Mô-đun Events cho phép bạn thiết lập thông báo tự động được kích hoạt khi có điều gì đó xảy ra trong hệ thống của bạn - như gửi email khi sản phẩm có hàng trở lại, hoặc thông báo đẩy khi đơn hàng được giao.

Hãy coi đây là hệ thống tự động thông báo của bạn - bạn xác định kích hoạt (điều gì xảy ra) và hành động (ai được thông báo và như thế nào).

📖 Giải thích đơn giản

Hãy tưởng tượng bạn đang điều hành một cửa hàng trực tuyến và muốn giữ cho người dùng được thông báo:

📦 Đơn hàng đã được đặt → Gửi email xác nhận
🚚 Đơn hàng đã được giao → Gửi thông báo đẩy với thông tin theo dõi
✅ Sản phẩm có hàng trở lại → Thông báo cho người dùng đã yêu cầu cảnh báo
💳 Thanh toán đã được nhận → Gửi email biên nhận
🎉 Khuyến mãi mới → Gửi email marketing cho người đăng ký
⚠️ Mật khẩu đã được thay đổi → Gửi cảnh báo bảo mật

Thay vì mã hóa thủ công từng thông báo:

✅ Cấu hình sự kiện trong bảng điều khiển quản trị OneEntry
✅ Định nghĩa các kích hoạt (điều gì xảy ra)
✅ Thiết lập các hành động (thông báo cần gửi)
✅ Tùy chỉnh tin nhắn theo từng sự kiện
✅ Theo dõi việc gửi và mức độ tương tác

Ví dụ thực tế:

Không có Mô-đun Events (thủ công):
- Người dùng đăng ký → Viết mã để gửi email ❌
- Sản phẩm được bổ sung → Viết mã để thông báo cho người dùng ❌
- Mỗi sự kiện cần mã tùy chỉnh ❌

Với Mô-đun Events (tự động):
- Cấu hình sự kiện "Người dùng đã đăng ký" → Tự động gửi email chào mừng ✅
- Cấu hình sự kiện "Sản phẩm đã được bổ sung" → Tự động thông báo cho danh sách chờ ✅
- Tất cả sự kiện được quản lý ở một nơi ✅

✨ Khái niệm chính

Sự kiện là gì?

Một sự kiện là điều gì đó xảy ra trong hệ thống của bạn có thể kích hoạt thông báo:

Kích hoạt - Hành động bắt đầu sự kiện (ví dụ: "đơn hàng đã được đặt")
Thông báo - Những gì người dùng nhận được (email, thông báo đẩy, tin nhắn socket)
Người nhận - Ai được thông báo (người dùng cụ thể, tất cả người dùng, quản trị viên)
Mẫu - Nội dung tin nhắn

Các loại sự kiện

OneEntry hỗ trợ các loại kích hoạt khác nhau:

Loại Kích Hoạt	Khi Nào Nó Kích Hoạt	Ví dụ
Thay đổi trạng thái	Trạng thái thực thể thay đổi	Sản phẩm: Hết hàng → Có hàng
Thực thể được tạo	Mục mới được thêm vào	Đơn hàng mới, đăng ký người dùng mới
Thực thể được cập nhật	Mục được sửa đổi	Hồ sơ được cập nhật, trạng thái đơn hàng thay đổi
Kích hoạt tùy chỉnh	Kích hoạt thủ công từ mã	Gửi bản tin, bắt đầu khuyến mãi

Kênh thông báo

Ba cách để thông báo cho người dùng:

Kênh	Mô tả	Tốt nhất cho
Email	Gửi tin nhắn email	Xác nhận đơn hàng, biên nhận, bản tin
Thông báo đẩy	Cảnh báo trên di động/trình duyệt	Cập nhật thời gian thực, cảnh báo khẩn cấp
Socket.IO	Tin nhắn websocket thời gian thực	Cập nhật trực tiếp, trò chuyện, đồng bộ ngay lập tức

Quy trình sự kiện

1. Có điều gì đó xảy ra (Kích hoạt)
   ↓
2. Sự kiện phát hiện kích hoạt
   ↓
3. Sự kiện kiểm tra các điều kiện (nếu có)
   ↓
4. Sự kiện gửi thông báo
   ↓
5. Người dùng nhận tin nhắn

📋 Những điều bạn cần biết

Kích hoạt sự kiện phổ biến

Các sự kiện điển hình bạn có thể thiết lập:

Thương mại điện tử:

Đơn hàng đã được đặt
Đơn hàng đã được giao
Đơn hàng đã được giao
Thanh toán đã được nhận
Sản phẩm có hàng trở lại
Cảnh báo giảm giá

Quản lý người dùng:

Người dùng đã đăng ký
Email đã được xác minh
Mật khẩu đã được thay đổi
Hồ sơ đã được cập nhật
Tài khoản đã bị xóa

Nội dung:

Bài viết mới được xuất bản
Bình luận được thêm vào
Nội dung đã được phê duyệt
Đăng ký đã được gia hạn

Biến mẫu

Sử dụng các biến giữ chỗ trong các mẫu thông báo

📊 Bảng tham khảo nhanh - Các phương thức phổ biến

Phương thức	Chức năng
getAllSubscriptions()	Lấy tất cả các đăng ký
subscribeByMarker()	Đăng ký sự kiện cụ thể theo dấu hiệu
unsubscribeByMarker()	Hủy đăng ký sự kiện cụ thể theo dấu hiệu

Lưu ý: Các sự kiện được cấu hình trong bảng điều khiển quản trị OneEntry. SDK chỉ đọc - sử dụng nó để lấy thông tin sự kiện, không tạo sự kiện.

❓ Câu hỏi thường gặp (FAQ)

Làm thế nào để tôi tạo hoặc chỉnh sửa sự kiện?

Các sự kiện được quản lý trong bảng điều khiển quản trị OneEntry:

Đăng nhập vào quản trị OneEntry
Đi đến phần Sự kiện
Tạo hoặc chỉnh sửa sự kiện
Cấu hình các kích hoạt, kênh và mẫu
Kích hoạt sự kiện

SDK chỉ đọc - sử dụng nó để lấy thông tin sự kiện, không tạo sự kiện.

Sự khác biệt giữa Thông báo đẩy và Socket.IO là gì?

Thông báo đẩy - Gửi đến thiết bị (hoạt động ngay cả khi ứng dụng đã đóng)

Xuất hiện trong trung tâm thông báo
Người dùng có thể nhấn để mở ứng dụng
Tốt nhất cho: Cảnh báo quan trọng, nhắc nhở
Socket.IO - Tin nhắn websocket thời gian thực (chỉ khi ứng dụng đang mở)
- Gửi ngay lập tức đến các khách hàng kết nối
- Cập nhật trực tiếp mà không cần làm mới
- Tốt nhất cho: Dữ liệu trực tiếp, trò chuyện, hợp tác

Tôi có thể kích hoạt thủ công một sự kiện từ mã của mình không?

SDK không hỗ trợ các kích hoạt thủ công. Các sự kiện được kích hoạt tự động dựa trên các kích hoạt đã cấu hình trong OneEntry.

Tôi có thể tùy chỉnh các mẫu email không?

Có! Trong bảng điều khiển quản trị OneEntry:

Mẫu email HTML
Tùy chỉnh kiểu dáng
Hỗ trợ đa ngôn ngữ
Kiểm tra trước khi kích hoạt

Điều gì xảy ra nếu một sự kiện không gửi được?

OneEntry xử lý việc thử lại và ghi log:

Các email không gửi được sẽ được xếp hàng để thử lại
Các thông báo đẩy không gửi được sẽ được ghi log
Kiểm tra nhật ký sự kiện trong bảng điều khiển quản trị
Cấu hình các tùy chọn dự phòng

Tôi có thể sử dụng nội dung phong phú trong các thông báo không?

Email - Hỗ trợ HTML đầy đủ (hình ảnh, liên kết, kiểu dáng)
Thông báo đẩy - Tiêu đề + văn bản thân + hình ảnh tùy chọn
Socket.IO - Bất kỳ cấu trúc dữ liệu JSON nào

Sự khác biệt giữa Sự kiện và Gửi biểu mẫu là gì?

Sự kiện - Thông báo tự động được kích hoạt bởi hệ thống
Biểu mẫu - Dữ liệu do người dùng gửi mà bạn thu thập

Ví dụ:

Sự kiện: "Người dùng đã đăng ký" → Tự động gửi email chào mừng
Biểu mẫu: Người dùng điền vào biểu mẫu liên hệ → Bạn nhận được thông tin gửi

💡 Lưu ý quan trọng

📬 Kênh thông báo

Trong nền tảng OneEntry, có ba cách để tương tác với người dùng của hệ thống thông qua mô-đun "Events":

📧 Email - Gửi tin nhắn email với nội dung HTML phong phú
📱 Thông báo đẩy - Gửi cảnh báo thời gian thực đến di động/trình duyệt
🔌 Socket.IO - Gửi tin nhắn websocket ngay lập tức đến các khách hàng kết nối

Các sự kiện là Chỉ Đọc trong SDK

Nhớ: SDK chỉ để đọc các sự kiện, không phải để tạo chúng.

Quy ước đặt tên sự kiện

Sử dụng các dấu hiệu rõ ràng, mô tả:

✅ Dấu hiệu tốt:
- order_confirmed
- product_back_in_stock
- user_registered
- payment_failed
- password_reset_requested

❌ Dấu hiệu xấu:
- event1
- notification
- email_event
- test

🎓 Thực hành tốt nhất

Sử dụng các dấu hiệu sự kiện mô tả
Kiểm tra các sự kiện trước khi kích hoạt
Cung cấp các giá trị dự phòng cho các biến
Theo dõi nhật ký sự kiện thường xuyên
Vô hiệu hóa các sự kiện không sử dụng
Sử dụng các kênh phù hợp (email cho biên nhận, thông báo đẩy cho sự khẩn cấp)
Địa phương hóa các tin nhắn sự kiện
Xử lý các sự kiện bị thiếu/không hoạt động một cách nhẹ nhàng

Thêm thông tin về giao diện người dùng của mô-đun https://doc.oneentry.cloud/docs/events/introduction

Định nghĩa của mô-đun Events


const { Events } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

🔗 Tài liệu liên quan

Mô-đun Người dùng - Quản lý người dùng nhận thông báo
Mô-đun Biểu mẫu - Thu thập dữ liệu biểu mẫu so với các sự kiện tự động kích hoạt
Mô-đun Quản trị viên - Quản lý ai cấu hình các sự kiện

Giới thiệu

🎯 Mô-đun này làm gì?​

📖 Giải thích đơn giản​

✨ Khái niệm chính​

Sự kiện là gì?​

Các loại sự kiện​

Kênh thông báo​

Quy trình sự kiện​

📋 Những điều bạn cần biết​

Kích hoạt sự kiện phổ biến​

Biến mẫu​

📊 Bảng tham khảo nhanh - Các phương thức phổ biến​

❓ Câu hỏi thường gặp (FAQ)​

Làm thế nào để tôi tạo hoặc chỉnh sửa sự kiện?​

Sự khác biệt giữa Thông báo đẩy và Socket.IO là gì?​

Tôi có thể kích hoạt thủ công một sự kiện từ mã của mình không?​

Tôi có thể tùy chỉnh các mẫu email không?​

Điều gì xảy ra nếu một sự kiện không gửi được?​

Tôi có thể sử dụng nội dung phong phú trong các thông báo không?​

Sự khác biệt giữa Sự kiện và Gửi biểu mẫu là gì?​

💡 Lưu ý quan trọng​

📬 Kênh thông báo​

Các sự kiện là Chỉ Đọc trong SDK​

Quy ước đặt tên sự kiện​

🎓 Thực hành tốt nhất​

Định nghĩa của mô-đun Events​

🔗 Tài liệu liên quan​