Hướng Dẫn Cài Đặt & Sử Dụng OmniMention Cho Perfex CRM

OmniMention nâng tầm giao tiếp nội bộ trong Perfex CRM bằng cách cho phép gắn thẻ người dùng tức thì qua ký tự @ và liên kết dữ liệu CRM qua ký tự $ hoặc # trực tiếp trên trình soạn thảo TinyMCE, danh sách đầu việc và các khung thảo luận. Bài viết này sẽ hướng dẫn chi tiết quy trình cài đặt, cấu hình hệ thống, cách thức thao tác thực tế và quản lý trung tâm hoạt động cá nhân nhằm giúp doanh nghiệp của bạn xóa bỏ đứt gãy thông tin và tăng tốc độ xử lý công việc.

Điều Kiện Tiên Quyết & Khả Năng Tương Thích

Trước khi kích hoạt mô-đun OmniMention, hãy đảm bảo môi trường máy chủ của bạn đáp ứng các yêu cầu kỹ thuật sau:

Phiên Bản Perfex CRM: Từ phiên bản 3.0.0 trở lên (tương thích toàn diện với nhánh 3.0.x và 3.1.x).
Môi Trường PHP: Hỗ trợ đầy đủ từ PHP 7.4 đến PHP 8.3+.
Hệ Quản Trị Cơ Sở Dữ Liệu: MySQL 5.7+ hoặc MariaDB 10.3+ với cấu trúc bảng InnoDB.
Trình Soạn Thảo Hỗ Trợ: TinyMCE 4, TinyMCE 5 và TinyMCE 6, cùng với tất cả ô nhập textarea HTML5 tiêu chuẩn và cửa sổ popover AJAX động.

Quy Trình Cài Đặt Từng Bước

OmniMention tuân thủ cấu trúc đóng gói chuẩn của Perfex CRM và có thể cài đặt hoàn tất chỉ trong vòng 2 phút qua giao diện quản trị hoặc tải trực tiếp vào thư mục.

Phương Pháp 1: Tải Lên Qua Trang Quản Trị (Khuyên Dùng)

Đăng nhập vào trang Quản trị viên (Admin Panel) của Perfex CRM.
Điều hướng đến mục Cài đặt > Mô-đun (Setup > Modules) ở thanh menu bên trái.
Nhấp vào nút Tải lên mô-đun (Upload Module) ở góc trên bên phải màn hình.
Chọn tệp nén omnimention.zip từ máy tính của bạn.
Nhấp nút Cài đặt (Install). Sau khi quá trình tải lên hoàn tất, tìm kiếm OmniMention trong danh sách mô-đun và nhấp Kích hoạt (Activate).
Hệ thống cài đặt sẽ tự động chạy migration cơ sở dữ liệu, tạo các bảng chỉ mục phức hợp (tblomnimention_mentions, tblomnimention_entity_tags) và thiết lập cấu hình ma trận thông báo mặc định.

Phương Pháp 2: Tải Lên Thủ Công Qua Thư Mục Máy Chủ

Giải nén tệp omnimention.zip đã tải về trên máy tính cá nhân.
Tải toàn bộ thư mục omnimention lên máy chủ theo đúng đường dẫn: perfex_crm/modules/omnimention/
Đảm bảo phân quyền thư mục đạt chuẩn 755 và tệp tin là 644.
Truy cập Cài đặt > Mô-đun trong trang quản trị Perfex CRM và nhấp Kích hoạt.

Cấu Hình Hệ Thống & Tùy Chọn Toàn Cục

Sau khi kích hoạt, bạn có thể truy cập khu vực cấu hình tại Cài đặt > Cài đặt chung > OmniMention hoặc truy cập menu thanh bên tại @ OmniMention > Cài đặt:

Ký Tự Kích Hoạt Người Dùng: Mặc định là @. Bạn có thể thay đổi ký tự này tùy theo thói quen bàn phím của doanh nghiệp.
Ký Tự Kích Hoạt Bản Ghi CRM: Mặc định là $. Bạn cũng có thể dùng # để tra cứu bản ghi CRM trong mọi khung soạn thảo.
Lượt Nhắc Trên Cổng Khách Hàng: Cho phép hoặc chặn khách hàng đã đăng nhập gắn thẻ nhân viên và liên kết dữ liệu trong các phiếu hỗ trợ hoặc thảo luận dự án.
Hiển Thị Nút Trợ Giúp ('?'): Bật hoặc tắt biểu tượng dấu hỏi tròn xanh 18px đính kèm khung soạn thảo để người dùng mở bảng hướng dẫn nhanh.
Ma Trận Thông Báo: Bật hoặc tắt linh hoạt kênh thông báo chuông nội bộ và email tự động cho từng loại bản ghi CRM cụ thể.

Kiến Trúc Hệ Thống & Luồng Xử Lý Dữ Liệu

OmniMention xử lý việc bắt sự kiện giao diện và lưu trữ dữ liệu thông qua cấu trúc mô-đun phân tầng mạch lạc:

flowchart TD
    subgraph UI["User Interaction Layer"]
        A["TinyMCE Rich Text Editor"] 
        B["Standard Form Textareas"]
        C["Task Todo Items & Notes"]
        D["Smart '?' Guide Button"]
    end

    subgraph SEC["Security & Guard Layer"]
        S1["Staff Authentication Guard"]
        S2["Client Portal Permission Scope"]
        S3["Public Guest Decorator Mode"]
    end

    subgraph FE["OmniMention Frontend Engine"]
        K1["Keyup Interceptor (@, $, #)"]
        K2["Autocomplete Finder Panel"]
        K3["Token Inserter & HTML Badge Decorator"]
    end

    subgraph BE["Backend Controller & Model"]
        M1["Api::get_users() with Avatar Resolution"]
        M2["Api::get_entities() Across 8 Modules"]
        M3["Omnimention_model Parser & Cleaner"]
    end

    subgraph DISPATCH["Notification Dispatch"]
        N1["In-App Bell Alerts"]
        N2["Automated HTML Email Delivery"]
        N3["Notification Matrix Settings"]
    end

    subgraph DB["Composite Indexed Storage"]
        D1[("tblomnimention_mentions")]
        D2[("tblomnimention_entity_tags")]
        D3[("tblomnimention_settings")]
    end

    UI --> K1
    SEC -.-> FE
    K1 --> K2
    K2 --> M1
    K2 --> M2
    K2 --> K3
    K3 --> M3
    M3 --> N1
    M3 --> N2
    M3 --> D1
    M3 --> D2
    DISPATCH -.-> D3

Quy Trình Thao Tác Trong Thực Tế

1. Gắn Thẻ Thành Viên Với Ký Tự @

Bất cứ khi nào bạn cần lấy ý kiến của đồng nghiệp hay khách hàng, chỉ cần gõ @ trong ô mô tả công việc, câu trả lời phiếu hỗ trợ hay bình luận thảo luận:

Bảng Gợi Ý Tự Động: Một menu thả xuống thông minh xuất hiện ngay vị trí con trỏ chuột. Tiếp tục gõ tên, họ, email hoặc phòng ban để lọc nhanh kết quả.
Ảnh Đại Diện Chân Thực: Hiển thị ảnh đại diện thực của thành viên ngay trong bảng gợi ý và trên huy hiệu sau khi chèn, giúp nhận diện người dùng nhanh chóng.
Phân Biệt Quyền Rõ Ràng: Huy hiệu phân loại trực quan giữa Quản trị viên, Nhân viên và Khách hàng để tránh gắn thẻ nhầm đối tượng.
Mở Hồ Sơ Trực Tiếp: Nhấp chuột vào huy hiệu người dùng đã gắn để chuyển thẳng đến trang hồ sơ cá nhân của nhân sự đó.

2. Liên Kết Chéo Bản Ghi CRM Với Ký Tự $ Và

Thay vì phải mở nhiều tab trình duyệt để sao chép đường dẫn, hãy gõ $ hoặc # kèm từ khóa tìm kiếm để liên kết 8 thực thể CRM chính:

Công Việc (Tasks): Hiển thị tên công việc, trạng thái xử lý và độ khẩn cấp.
Dự Án (Projects): Hiển thị mã dự án, tên dự án, khách hàng và hạn chót bàn giao.
Phiếu Hỗ Trợ (Tickets): Dẫn chứng mã phiếu, chủ đề, phòng ban phụ trách và trạng thái.
Hóa Đơn (Invoices): Gắn thẻ số hóa đơn, tên công ty và tình trạng thanh toán (Đã thanh toán, Chưa thanh toán, Quá hạn).
Khách Hàng Tiềm Năng (Leads): Dẫn chứng tên đầu mối, công ty và giai đoạn bán hàng hiện tại.
Đề Xuất (Proposals): Hiển thị tiêu đề đề xuất, khách hàng và tổng giá trị hợp đồng.
Báo Giá (Estimates): Tham chiếu số hiệu báo giá, khách hàng và ngày hết hạn hiệu lực.
Hợp Đồng (Contracts): Liên kết chủ đề hợp đồng, đối tác và khoảng thời gian có hiệu lực.

Sơ đồ dưới đây minh họa toàn bộ vòng đời từ thao tác gõ phím đến khi thông báo được gửi đi thành công:

sequenceDiagram
    actor User as Staff Member
    participant Editor as TinyMCE / Textarea
    participant Engine as OmniMention JS Engine
    participant API as Backend API Endpoint
    participant DB as MySQL InnoDB Tables
    participant Notif as Notification Dispatcher
    actor Target as Tagged Colleague

    User->>Editor: Type '@' or '$'
    Editor->>Engine: Trigger Autocomplete Event
    Engine->>API: GET /omnimention/api/users or entities
    API->>DB: Query with Composite Index Lookup
    DB-->>API: Return Ranked Matches (Avatars, Badges)
    API-->>Engine: JSON Response
    Engine->>User: Display Autocomplete Finder Panel
    User->>Engine: Select Target Colleague / Record
    Engine->>Editor: Insert Badge Pill / Markdown Token
    User->>Editor: Submit Comment / Task Note
    Editor->>API: Post Content Payload
    API->>DB: Store Record & Differential Mentions
    API->>Notif: Trigger Notification Matrix
    Notif->>Target: In-App Bell Alert + Contextual Email

3. Cơ Chế Xử Lý Giữa TinyMCE Và Textarea Thuần

OmniMention tự động thay đổi phương thức chèn phù hợp với từng môi trường nhập văn bản:

Trên Trình Soạn Thảo TinyMCE: Các lượt tag được chèn dưới dạng huy hiệu HTML hoàn chỉnh có kèm hình ảnh đại diện và liên kết nhấp chuột.
Trên Ô Nhập Textarea & Đầu Việc Todo: Các lượt tag được lưu dưới dạng token Markdown chuẩn Option A (như [Nguyễn Văn A](staff:12) hay [INV-2026-004](invoice:4)). Khi người dùng tải lại trang, bộ giải mã OmniMention Decorator sẽ tự động chuyển các token này thành huy hiệu trực quan đẹp mắt mà không làm hỏng cấu trúc dữ liệu thô trong cơ sở dữ liệu MySQL.

4. Quản Lý Thảo Luận Tại Trung Tâm My Mentions

Không bao giờ bỏ lỡ các phản hồi hoặc nhiệm vụ được giao. Mở menu @ OmniMention > My Mentions trên thanh điều hướng bên trái:

Huy Hiệu Chưa Đọc Thời Gian Thực: Thể hiện trực tiếp số lượng lượt nhắc chưa xem ngay trên thanh menu chính.
Bộ Lọc Loại Bản Ghi: Phân loại dòng thời gian để chỉ xem các lượt tag phát sinh từ Công việc, Phiếu hỗ trợ, Dự án hay Hóa đơn.
Tra Cứu Từ Khóa Tức Thì: Tìm kiếm nội dung thảo luận nhanh chóng ngay phía client.
Hỗ Trợ Tiếng Việt Có Dấu Hoàn Hảo: Giải mã chuẩn UTF-8 giúp các câu văn tiếng Việt hiển thị rõ ràng, mượt mà và không bị sót ký tự mã hóa thô.
Xử Lý Hàng Loạt Nhanh Gọn: Đánh dấu đã đọc từng mục hoặc sử dụng nút "Đánh dấu tất cả đã đọc" với hộp thoại xác nhận SweetAlert2 chuyên nghiệp.

Kiến Trúc Chỉ Mục CSDL Phức Hợp Hiệu Năng Cao

OmniMention được thiết kế để duy trì tốc độ phản hồi dưới một mili-giây ngay cả trên các hệ thống Perfex CRM lớn có hàng trăm nghìn bản ghi hoạt động:

Đọc Dòng Thời Gian Không Cần Filesort: Chỉ mục phức hợp (target_type, target_id, id DESC) cho phép MySQL đọc tuần tự bản ghi mà không phải tạo bảng tạm trên đĩa cứng.
Quét Trực Tiếp Trên Bộ Nhớ RAM: Chỉ mục (rel_type, rel_id, comment_id, target_type, target_id) cho phép bộ quét phân tích lượt tag kiểm tra dữ liệu trực tiếp trong bộ nhớ đệm InnoDB Buffer Pool mà không cần đọc đĩa.
Chống Trùng Lặp Bản Ghi Tuyệt Đối: Ràng buộc duy nhất (source_rel_type, source_rel_id, tagged_entity_type, tagged_entity_id) đảm bảo tính toàn vẹn dữ liệu ngay tại tầng lõi cơ sở dữ liệu.

Bảo Mật & Cách Ly Khách Truy Cập Công Khai

Khi khách hàng bên ngoài mở xem các đường dẫn hợp đồng, đề xuất hoặc báo giá công khai, OmniMention sẽ tự động chuyển sang Chế độ Decorator thuần túy:

Toàn bộ API tìm kiếm và hộp thoại gợi ý tự động bị khóa hoàn toàn đối với khách chưa đăng nhập.
Biểu tượng dấu hỏi trợ giúp và bảng chọn người dùng được ẩn hoàn toàn.
Các liên kết nội bộ được làm sạch để dữ liệu doanh nghiệp của bạn luôn được bảo mật tuyệt đối.

Tối Ưu Hóa Hiệu Quả Làm Việc Nhóm Của Bạn

OmniMention xóa bỏ hoàn toàn khoảng cách trao đổi thông tin giữa các phòng ban. Hãy cài đặt mô-đun, thiết lập các tùy chọn phù hợp và trải nghiệm sự tiện lợi của giải pháp tag người dùng và liên kết dữ liệu CRM ngay trên hệ thống Perfex CRM của bạn hôm nay.

Hướng Dẫn Cài Đặt Và Sử Dụng OmniMention Cho Perfex CRM