Thông báo Telegram & Zalo

TKHQ gửi cảnh báo vận hành qua Telegram — liên kết tài khoản Telegram cá nhân với tài khoản TKHQ để nhận, không cần tự tạo bot riêng. Kênh Zalo OA đang được phát triển.

Nhận cảnh báo quan trọng — DEM/DET sắp hết, báo giá sắp hết hạn, thanh toán quá hạn — qua Telegram sau khi liên kết. Route: /settings/notifications.

Kết nối Telegram

TKHQ dùng một bot thông báo chung của hệ thống — bạn liên kết tài khoản Telegram cá nhân vào đó, không cần tạo bot riêng hay nhập token/chat ID thủ công.

Các bước kết nối:

1. Vào /settings/notifications → tab Telegram → nhấn Kết nối.
2. Hệ thống mở Telegram (tab mới) tới bot thông báo của TKHQ — nhấn Start trong cửa sổ Telegram vừa mở.
3. Quay lại tab TKHQ — trạng thái tự chuyển sang Đã kết nối trong vài giây đến khoảng 2 phút (hệ thống tự kiểm tra định kỳ, không cần bấm thêm nút nào).
4. Chọn nhóm sự kiện muốn nhận qua Telegram (xem bảng bên dưới) → Lưu thay đổi.

Ngắt kết nối

Nhấn Ngắt kết nối trong tab Telegram bất kỳ lúc nào để dừng nhận thông báo qua kênh này — thông báo trong ứng dụng (in-app) không bị ảnh hưởng. Gõ /stop trong Telegram cũng có tác dụng tương tự.

Bộ sự kiện mặc định khi kết nối

Lần đầu kết nối, hệ thống bật sẵn một bộ sự kiện "vận hành quan trọng" — gồm hạn DEM/DET/lấy hàng/trả rỗng, giấy tờ xe sắp hết hạn, SLA, chứng từ AI xử lý xong, thanh toán, và báo giá (sắp hết hạn / im lặng nhiều ngày / vừa hết hạn). Bạn có thể tắt bớt nhóm không cần tại tab Telegram.

Cần liên kết mới nhận được

Cảnh báo Telegram chỉ gửi được sau khi tài khoản đã liên kết thành công (bước 1–3 ở trên). Nếu nhấn Kết nối mà không thấy chuyển sang trạng thái đã kết nối, thử lại hoặc liên hệ hỗ trợ — có thể do kênh Telegram của hệ thống đang tạm thời chưa sẵn sàng ở workspace của bạn.

🔍

Kết nối Telegram — liên kết tài khoản cá nhân, chọn nhóm sự kiện muốn nhận

Kết nối Zalo

Đang phát triển

Kênh Zalo OA chưa khả dụng — hiện chỉ Telegram gửi thông báo thật. Phần dưới mô tả cách kết nối dự kiến khi Zalo OA hoàn thiện.

Zalo OA cho phép gửi thông báo đến người dùng đã theo dõi (follow) trang OA của doanh nghiệp. Phù hợp cho doanh nghiệp SME sử dụng Zalo là kênh chính.

Yêu cầu:

Yêu cầu	Ghi chú
Tài khoản Zalo OA doanh nghiệp	Đăng ký tại oa.zalo.me
OA Access Token	Tạo tại Zalo Developer Console
Nhân viên đã follow OA	Mỗi người nhận phải follow OA mới nhận được tin

Các bước kết nối:

1. Tạo Zalo OA và lấy Access Token — Đăng nhập oa.zalo.me → tạo ứng dụng → vào Developer Console → tạo Access Token với quyền gửi tin nhắn.

2. Nhập vào TKHQ — Vào /settings/notifications → tab Zalo → nhập OA Access Token → lưu.

3. Liên kết Zalo ID với thành viên — Mỗi thành viên cần nhập Zalo User ID của mình trong /settings/profile → trường Zalo ID. Thông báo sẽ gửi cá nhân đến đúng người.

Giới hạn Zalo OA

Zalo OA chỉ gửi được tin nhắn template (ZNS) — không gửi tin tự do. Một số loại sự kiện có thể chưa hỗ trợ ZNS. Telegram được khuyến nghị cho thông báo vận hành real-time.

Danh sách sự kiện

Tất cả sự kiện gửi thông báo:

Sự kiện	Người nhận mặc định	Kênh
DEM còn 2 ngày	OPS + OWNER	Telegram + in-app
DET còn 2 ngày	OPS + OWNER	Telegram + in-app
Container GATE_OUT	OPS phụ trách	In-app
Tàu cập cảng (ETA thực tế)	OPS + OWNER	Telegram
Tờ khai được duyệt	OPS phụ trách	In-app + Telegram
Debit Note quá hạn 8 ngày	ACCOUNTANT + OWNER	Telegram
Debit Note quá hạn 30 ngày	OWNER (escalate)	Telegram
Quote được ACCEPTED	SALES phụ trách + OWNER	Telegram
Báo giá sắp hết hạn (còn hiệu lực)	SALES phụ trách + OWNER	Telegram
Báo giá im lặng nhiều ngày / vừa hết hạn	SALES phụ trách + OWNER	Telegram
Hợp đồng sắp hết hạn 30 ngày	SALES + OWNER	Telegram
Xe sắp hết đăng kiểm 30 ngày	OPS + ADMIN	Telegram
Cảnh báo vượt định mức xăng	OPS + OWNER	Telegram
Lead tồn pipeline > 30 ngày	ADMIN	Telegram (weekly)

DEM/DET là gì?

DEM (Demurrage) — phí lưu container tại cảng sau khi tàu cập, tính từ ngày DISCHARGED. DET (Detention) — phí lưu vỏ container ngoài bãi cảng sau khi GATE_OUT. Cả hai tích lũy theo ngày và có thể rất tốn kém nếu bỏ sót.

Bật/tắt thông báo

Cài đặt toggle per sự kiện:

Cài đặt	Phạm vi	Ai thay đổi được
Bật/tắt theo sự kiện	Toàn workspace	OWNER / ADMIN
Chọn kênh gửi (Telegram / Zalo)	Toàn workspace	OWNER / ADMIN
Thời gian im lặng (quiet hours)	Toàn workspace	OWNER / ADMIN
Bật/tắt thông báo cá nhân	Riêng từng user	Mọi thành viên

Các bước cấu hình:

1. Vào cài đặt thông báo — Vào /settings/notifications → tab Sự kiện. Thấy danh sách đầy đủ các loại thông báo.

2. Toggle từng sự kiện — Bật/tắt toggle bên cạnh tên sự kiện. Chọn kênh gửi: Telegram, Zalo, hoặc cả hai. Thay đổi có hiệu lực ngay — không cần restart.

3. Cấu hình quiet hours — Nhập giờ im lặng (ví dụ 22:00 – 07:00) để không bị làm phiền ngoài giờ làm việc. Thông báo trong khung giờ này sẽ gom lại và gửi vào 07:00 sáng hôm sau.

Thông báo cá nhân

Mỗi thành viên có thể tự bật/tắt thông báo in-app trong /settings/profile → tab Thông báo — không ảnh hưởng cài đặt chung của workspace.