--- name: creta-zalohub-agent description: "Trợ lý Tương tác & Giao tiếp Zalo Hai Chiều CRETA ZaloHub. Hỗ trợ gửi tin nhắn nhóm tự động gắn tiền tố [Agent Name], gửi ảnh album, tệp tin báo giá, tra cứu hội thoại và tìm kiếm báo giá nhà cung cấp. Triggers on 'zalohub', 'nhắn tin zalo', 'gửi tin zalo', 'gửi ảnh zalo', 'gửi file zalo', 'group zalo', 'kho nhiên zalo', 'báo cáo daily zalo', 'hub.besen.vn'." --- # 💬 CRETA ZALOHUB AGENT SKILL RUNBOOK Kỹ năng điều phối, gửi thông báo và đọc tin nhắn Zalo hai chiều cho AI Agent thông qua cổng **ZaloHub Bot API** (`https://hub.besen.vn/mcp`). --- ## 🏛️ 1. NGUYÊN TẮC BẮT BUỘC KHI GỬI TIN QUA ALTA VÕ 1. **Quy chuẩn Tiền Tố Định Danh (Agent Prefix):** * Mọi tin nhắn gửi vào nhóm Zalo hoặc chat cá nhân **bắt buộc** phải có định danh Agent trong ngoặc vuông: `[] - ` * *Ví dụ:* `[CRETA Manager] - Đã chốt xong 4 camera Imou giao về GHTK Đông Anh.` * Không bao giờ giả mạo là tin nhắn người thật gõ nếu là bot tự động gửi. 2. **Quy định Tag Tên Thông Minh:** * Hệ thống tự động nhận diện cú pháp `@Tên` (vd: `@Hạo Nhiên`, `@Trang`) hoặc `@All` để làm sáng tag màu xanh trong Zalo. 3. **Phân biệt 2 Cụm ZaloHub:** * **`primary` (Mặc định):** Tài khoản Alta Võ (`+84932032732`), chuyên gửi thông báo vào các nhóm nội bộ (Kho Nhiên, Báo Cáo Daily, Phiếu Giao Vận, Ngọc Hoàng). * **`creta`:** Cụm CSKH (3 nick Trang, Huyền, Creta), chuyên nhận tin nhắn khách hàng thợ và nhóm NCC. --- ## 👥 2. DANH MỤC CÁC NHÓM CHAT NỘI BỘ QUAN TRỌNG | Tên Nhóm | Conversation ID | Vai Trò & Nội Dung Trao Đổi | | :--- | :--- | :--- | | **KHO NHIÊN** | `group:7126456734168005230` | Điều phối xuất kho, giục soạn hàng, xác nhận chành xe/Grab. | | **BÁO CÁO DAILY** | `group:814918401462205127` | Báo cáo doanh thu, tiến độ task và tổng hợp cuối ngày. | | **CRETA TICKET** | `group:4830922705932416898` | Xử lý sự cố kỹ thuật, khiếu nại khách hàng theo SLA. | | **PHIẾU GIAO VẬN** | `group:1096811808991349168` | Biên nhận giao nhận hàng, mã vận đơn Chành xe / GHTK. | | **CRETA - TỔNG HỢP**| `group:1017991170422083752` | Thông tin nội bộ công ty. | | **CRETA - CNM** | `group:2900076444936251831` | Nhóm báo giá & đặt hàng nhà cung cấp CNM/DSS. | --- ## ⚡ 3. CÁC KỊCH BẢN TỰ ĐỘNG HÓA THỰC CHIẾN ### KỊCH BẢN 1: BÁO CÁO TIẾN ĐỘ VÀO GROUP KHO NHIÊN * **Yêu cầu:** *"Báo vào nhóm Kho Nhiên là đơn hàng HD021958 đã đóng gói xong, chuẩn bị xe đi trước 11h30."* * **Hành động của Agent:** * Gọi `zalo_send_message` với: * `conversationId`: `"group:7126456734168005230"` * `agentName`: `"CRETA Kho"` * `text`: `"Đơn hàng HD021958 đã đóng gói xong, @Hạo Nhiên chuẩn bị xe đi trước 11h30 kịp chuyến chành xe nghen anh!"` ### KỊCH BẢN 2: GỬI ẢNH BIÊN NHẬN / PHIẾU BẢO HÀNH * **Yêu cầu:** *"Gửi ảnh phiếu giao vận vừa scan vào nhóm Phiếu Giao Vận."* * **Hành động của Agent:** * Gọi `zalo_send_images` với `images: ["/path/to/phieu_giao_hang.jpg"]`, `caption: "Biên nhận chành xe đi Phan Rang"`. ### KỊCH BẢN 3: ĐỌC TIN NHẮN BÁO GIÁ NHÀ CUNG CẤP * **Yêu cầu:** *"Đọc 10 tin nhắn gần nhất bên nhóm CNM xem họ báo giá mã camera Imou A32 bao nhiêu."* * **Hành động của Agent:** * Gọi `zalo_read_messages({ conversationId: "group:2900076444936251831", limit: 10 })`. * Phân tích nội dung tin nhắn và trích xuất giá vốn NCC cho Admin. --- ## 🛠️ 4. DANH MỤC CÔNG CỤ MCP HỖ TRỢ (`zalo_*`) * `zalo_whoami`: Xem danh tính phiên làm việc và tài khoản bot Zalo. * `zalo_send_message`: Gửi tin nhắn văn bản (tự động prefix `[Agent] - ...`). * `zalo_send_images`: Gửi ảnh hoặc album chùm ảnh kèm caption. * `zalo_send_file`: Gửi tệp đính kèm (PDF, DOCX, XLSX). * `zalo_list_conversations`: Danh sách nhóm chat và hội thoại gần nhất. * `zalo_read_messages`: Đọc tin nhắn mới nhất trong cuộc trò chuyện. * `zalo_get_group_members`: Danh sách thành viên trong nhóm. * `zalo_find_user`: Tra cứu tài khoản Zalo qua Số điện thoại. --- # Quy Chuẩn Giao Tiếp & Điều Phối Nội Bộ Qua Bot Alta Võ ## 1. Định Danh & Quyền Hạn - Tài khoản Bot Alta Võ đại diện cho trợ lý kỹ thuật số của Văn phòng Điều phối CRETA. - Tất cả Agent tham gia vận hành (CRETA Manager, CRETA Kho, CRETA Tech, Sales Quoter) đều sử dụng hạ tầng này để phát thông báo tới nhân sự thực tế. ## 2. Quy Tắc Soạn Thảo Tin Nhắn 1. **Rõ ràng và súc tích:** Đọc lướt 3 giây là nắm được sự việc. 2. **Luôn có mã tham chiếu:** Nếu liên quan đơn hàng phải có mã `HDxxxxx`, nếu liên quan bảo hành phải có mã `BHxxxxx`, nếu liên quan ticket phải có mã `CV3-xxxxx`. 3. **Chỉ định người xử lý:** Tag `@Tên` của người chịu trách nhiệm trực tiếp để họ nhận thông báo rung chuông trên điện thoại. 4. **Không spam:** Gom thông báo thành cụm, tránh gửi từng dòng lắt nhắt gây phiền toái cho nhân viên đang thi công. --- # Danh Bạ Các Nhóm Chat & Nhân Sự CRETA ## 1. Danh Sách Nhóm Chat - **KHO NHIÊN:** `group:7126456734168005230` - Thành viên: Hạo Nhiên (Trưởng kho/Kỹ thuật), Lâm Võ, Trang, Huyền. - Canh giờ xe: **11h30 trưa** và **16h30 chiều**. - **BÁO CÁO DAILY:** `group:814918401462205127` - Nhận báo cáo doanh thu, công nợ và tổng kết ngày. - **CRETA TICKET:** `group:4830922705932416898` - Nơi điều tra và thẩm định ticket sự cố khách hàng. - **PHIẾU GIAO VẬN:** `group:1096811808991349168` - Nơi lưu trữ ảnh chụp biên nhận giao hàng, phiếu gửi chành xe. - **CRETA - CNM:** `group:2900076444936251831` - Nhóm đặt hàng thiết bị Dahua/Imou nhà cung cấp CNM. - **CRETA - THIÊN ÂN:** `group:2755822591702017814` - Nhóm báo giá & bảo hành thiết bị Hikvision/Ezviz. ## 2. Nhân Sự Trọng Tâm - **Lâm Võ (Sếp Lâm):** Điều hành chung, duyệt giá đặc biệt. - **Hạo Nhiên:** Quản lý kho, xử lý đơn hàng, điều phối giao nhận. - **Lê Hữu:** Kỹ thuật hiện trường, lắp đặt camera, cấu hình mạng. - **Trang:** Bán hàng, chốt đơn thợ, theo dõi ship. - **Huyền:** Hành chính, kế toán thu tiền, đối soát nhà cung cấp. --- # Kịch Bản Mẫu Giao Tiếp Qua ZaloHub ## Mẫu 1: Báo đơn hàng gấp cho Kho ``` [CRETA Kho] - Đơn hàng HD021960 của khách Anh Hùng Điện Lạnh cần đi gấp trước 11h30. Chi tiết: 2 Camera Imou A32EP + 2 Thẻ Hiksemi 64GB. @Hạo Nhiên ưu tiên đóng gói giúp em nhé! ``` ## Mẫu 2: Báo cáo kết quả giao hàng kèm ảnh ``` [CRETA Giao Vận] - Đã bàn giao xong đơn hàng cho chành xe Tô Châu đi Cần Thơ. Mã vận đơn: TC-889921 Người nhận: Camera Minh Khang (0909xxxxxx) Đã đính kèm ảnh biên nhận vào nhóm Phiếu Giao Vận. ```