# 📥 CuCu Note: Tầm Nhìn "Inbound Event Receiver" (Trung Tâm Hứng Dữ Liệu)

Tài liệu này xác định vị thế mới của CuCu Note. Thay vì chỉ là một app ghi chú cá nhân, CuCu Note sẽ hoạt động như một **CRM Inbox (Hộp thư trung tâm)** để hứng mọi sự kiện, feedback từ các con Bot N8n và hệ thống bên ngoài. Ai cũng có thể đẩy dữ liệu vào đây thông qua Webhooks.

---

## 🏗️ 1. Các Trang (Pages/Views) Cần Phải Có Thêm

Để biến CuCu Note thành một phễu hứng data thực thụ, chúng ta cần bổ sung các giao diện (Pages) sau vào Frontend của hệ thống:

### A. Trang Quản Lý Nguồn Vào (Integrations / Webhooks Settings)
Đây là nơi Admin tạo ra các "cổng" để hứng dữ liệu.
- **Tạo Endpoint:** Nút `[+ Tạo nguồn mới]`. Hệ thống cấp ra 1 URL dạng `cucu.in/api/v1/hooks/{token}`.
- **Tùy biến Tên Nguồn:** Ví dụ "Chatbot Fanpage Canifa", "Chatbot Zalo", "Form Khiếu Nại".
- **Lịch sử Request (Logs):** Xem lại chi tiết data (JSON) đã được bắn vào Cổng này hôm nay. Nếu lỗi, dễ dàng debug.
- **Mapping Data (Tùy chọn nâng cao):** Cấu hình để hệ thống biết móc field `message` trong file JSON để làm nội dung Note, lấy field `customer_name` làm Title.

### B. Trang Hộp Thư Triage (Inbox / Triage View)
Timeline ghi chú hiện tại của Memos không phù hợp để xử lý dữ liệu dồn dập. Cần thêm một Tab độc lập gọi là **Inbox**.
- **Danh sách "Unread":** Mọi sự kiện từ Chatbot đẻ ra sẽ nằm tại đây với trạng thái Chưa Đọc.
- **Thao tác nhanh (Quick Actions):** Di chuột vào một Note hiển thị nút `[Đã xử lý (Check)]`, `[Bỏ qua]`. 
- **Mục tiêu:** Giúp nhân viên mỗi sáng mở ra thấy `20 Note Chưa đọc`, và xử lý dần cho kỳ hết để Inbox trống rỗng (Cảm giác vinh quang Zero-Inbox).

### C. Trang Quản Lý Người Dùng / Liên Hệ (Contacts Directory)
Khi hứng feedback, ta thường hứng kèm SĐT hoặc tên người dùng của khách hàng.
- Sinh ra một bến đỗ lưu trữ "Danh bạ khách hàng".
- **Giao diện:** Bấm vào sđt `090xxxx`, nó sẽ lọc (Filter) hiện ra tất cả các Feedback/Memos từ trước đến nay của đúng vị khách đó. Rất hữu ích cho chăm sóc khách hàng.

### D. Trang Cài Đặt Phân Luồng Tự Động (Rules Engine Page)
- Một luật (Rule) đơn giản: `Nếu [Nguồn = Chatbot Zalo] VÀ [Nội dung chứa từ "Hoàn tiền"] => Tự động gắn thẻ #hoan_tien VÀ set Priority = RED`.
- Trang này biến hệ thống thành một luồng chia việc cực kỳ trơn tru.

---

## 🚀 2. Kịch Bản Vận Hành Thực Tế

1. **Khách hàng** phàn nàn trên Fanpage Facebook.
2. **Chatbot (N8n/Forge)** gọi HTTP POST bắn dữ liệu về `CuCu Note Webhook URL`.
3. **Rules Engine** của CuCu Note tóm được JSON này, tự động đẻ ra 1 Memo, gài tag `#complaint` và ném vào mục **Inbox** của Workspace "Customer Service".
4. **Nhân viên CSKH** vào ca làm việc, mở trang **Inbox**, thấy Note báo màu cam. Đọc nội dung mà không cần mở Facebook.
5. Xử lý xong, nhân viên bấm `[Đã giải quyết]`. Note biến mất khỏi Inbox (được lưu vĩnh viễn vào kho lưu trữ chung). Inbox trở nên sạch sẽ.

---

## 📋 3. Task Kế Tiếp Cho Dev Team (Đề Xuất)

Nếu triển khai hướng này, thứ vô giá nhất và cần code ngay tắp lự là:
👉 **Xây dựng API Endpoint Inbound Webhook (`POST /hooks/{token}`)** bên backend để có lỗ hổng cho tụi Chatbot bắn data vào trước. Lúc đó ta mới tính chuyện hiển thị lên UI.
