Phạm vi của màn hình Settings

• Quản lý các tiến trình lập chỉ mục và xử lý thông báo.
• Cấu hình hành vi chung của EzyOA.

flowchart TD
    Settings["EzyOA Settings"] --> Jobs["Tiến trình nền"]
    Settings --> Storage["Lưu trữ dữ liệu"]
    Settings --> Response["Phản hồi tự động"]
    Settings --> Commands["Lệnh thanh toán"]
    Settings --> Notification["Thông báo cho nhân viên"]

    Jobs --> UserIndex["Chỉ mục người dùng OA"]
    Jobs --> ServiceIndex["Chỉ mục dịch vụ OA"]
    Jobs --> MessageNotifier["Bộ thông báo tin nhắn mới"]

    Storage --> Avatar["Ảnh đại diện"]
    Storage --> RawPayload["Payload nguyên bản"]
    Storage --> IncomingMedia["Media nhận vào"]
    Storage --> ResponseMessage["Tin nhắn phản hồi"]
    Storage --> ResponseMedia["Media phản hồi"]

Phân quyền truy cập

• Quản trị viên đã đăng nhập.
• Tài khoản có quyền quản lý cài đặt EzyOA.

Các tiến trình nền

Chỉ mục người dùng OA

• Mã người dùng tại nhà cung cấp.
• Tên hiển thị.
• Số điện thoại.
• Email.

flowchart LR
    Users["Dữ liệu người dùng OA"] --> Indexer["Bộ lập chỉ mục"]
    Indexer --> Keywords["Mã OA, tên, điện thoại, email"]
    Keywords --> Search["Tìm kiếm trên trang quản trị"]

Chỉ mục dịch vụ OA

• Mã dịch vụ.
• Tên dịch vụ.
• App ID.
• UUID ứng dụng.

Bộ thông báo tin nhắn mới

flowchart TD
    Stored["Tin nhắn OA đã lưu"] --> Notifier["Bộ thông báo tin nhắn mới"]
    Notifier --> Valid{"Tin nhắn hợp lệ?"}
    Valid -- Không --> Ignore["Bỏ qua"]
    Valid -- Có --> Load["Lấy người dùng và dịch vụ OA"]
    Load --> Event["Phát sự kiện thông báo"]
    Event --> Staff["Thông báo cho nhân viên"]

• Tin nhắn tồn tại và có nội dung.
• Dịch vụ OA tương ứng vẫn tồn tại.
• Người gửi đã có hồ sơ người dùng OA.
• Nội dung vượt qua điều kiện thông báo đã cấu hình.

Quản trị viên OA mặc định

• Tạo kênh hội thoại.
• Ghi nhận người gửi tin nhắn.
• Duy trì lịch sử trao đổi trong hệ thống.

Tải ảnh đại diện người dùng OA

Khi bật

• Không phụ thuộc hoàn toàn vào URL bên ngoài.
• Ảnh vẫn có thể hiển thị nếu URL tạm thời hết hạn.
• Có thể áp dụng cơ chế quản lý media chung của EzyPlatform.

• Dung lượng lưu trữ.
• Băng thông tải ảnh.
• Thời gian xử lý khi tạo hoặc cập nhật người dùng.

Khi tắt

Lưu payload tin nhắn nguyên bản

Khi bật

• Điều tra lỗi tích hợp.
• Kiểm tra trường dữ liệu từ nhà cung cấp.
• Phân tích những loại webhook chưa được xử lý đầy đủ.
• Đối chiếu giữa dữ liệu gốc và hội thoại đã lưu.

Khi tắt

• Giảm dung lượng cơ sở dữ liệu.
• Hạn chế lưu dữ liệu không cần thiết.
• Giảm rủi ro giữ lại thông tin nhạy cảm từ webhook.

Lưu media của tin nhắn đến

• Hình ảnh.
• Tệp tin.
• Video.
• Các loại đính kèm được bộ xử lý của nền tảng hỗ trợ.

flowchart LR
    Webhook["Webhook có media"] --> Enabled{"Cho phép lưu media nhận vào?"}
    Enabled -- Có --> Extract["Trích xuất media"]
    Extract --> Save["Lưu cùng tin nhắn"]
    Enabled -- Không --> Text["Chỉ xử lý nội dung văn bản"]

Lưu tin nhắn phản hồi tự động

Khi bật

• Nhân viên có thể xem đầy đủ hai chiều hội thoại.
• Chatbot có thể sử dụng phản hồi trước đó làm ngữ cảnh.
• Hệ thống có thể xác định mẫu phản hồi gần nhất.
• Các kịch bản có thể hạn chế trả lời lặp lại.

Khi tắt

Lưu media của tin nhắn phản hồi

• Phản hồi có media.
• Phản hồi đã được gửi.
• Tính năng lưu tin nhắn phản hồi đang bật.

flowchart TD
    Sent["Phản hồi đã gửi"] --> SaveMessage{"Lưu tin nhắn phản hồi?"}
    SaveMessage -- Không --> End["Không lưu"]
    SaveMessage -- Có --> HasMedia{"Có media?"}
    HasMedia -- Không --> SaveText["Lưu nội dung"]
    HasMedia -- Có --> SaveMedia{"Cho phép lưu media phản hồi?"}
    SaveMedia -- Có --> SaveAll["Lưu nội dung và media"]
    SaveMedia -- Không --> SaveText

Bật phản hồi tự động

Khi bật

• Phản hồi theo quy tắc.
• Hướng dẫn công việc.
• Tra cứu thông tin.
• Chatbot.
• Kịch bản mở rộng do module khác cung cấp.

Khi tắt

• Nhận webhook.
• Xác thực tin nhắn.
• Tạo hoặc cập nhật người dùng OA.
• Lưu tin nhắn đến.
• Tạo kênh hội thoại.

sequenceDiagram
    participant U as Người dùng
    participant E as EzyOA
    participant D as Kho hội thoại
    participant S as Kịch bản phản hồi

    U->>E: Gửi tin nhắn
    E->>D: Lưu người dùng và tin nhắn

    alt Phản hồi tự động được bật
        E->>S: Yêu cầu tạo câu trả lời
        S-->>E: Nội dung phản hồi
        E-->>U: Gửi phản hồi
    else Phản hồi tự động bị tắt
        E-->>U: Không tự động trả lời
    end

Thời gian trì hoãn phản hồi cùng nội dung

300 giây

• Nếu nhân viên vừa gửi tin trong khoảng trì hoãn, hệ thống không tự động trả lời.
• Nếu phản hồi gần nhất là thông báo nhân viên sẽ tiếp nhận và vẫn còn trong khoảng trì hoãn, hệ thống không gửi lại.
• Nếu cùng loại phản hồi sắp được gửi lần nữa, kịch bản có thể chuyển sang một nội dung khác, chẳng hạn thông báo nhân viên sẽ trả lời.

flowchart TD
    Incoming["Tin nhắn mới"] --> Last["Đọc tin nhắn gần nhất"]
    Last --> Recent{"Nằm trong khoảng trì hoãn?"}
    Recent -- Không --> Respond["Tạo phản hồi bình thường"]
    Recent -- Có --> Admin{"Tin gần nhất từ nhân viên?"}
    Admin -- Có --> Skip["Không tự động phản hồi"]
    Admin -- Không --> Duplicate{"Phản hồi sắp gửi bị lặp?"}
    Duplicate -- Có --> Alternate["Dùng phản hồi thay thế hoặc bỏ qua"]
    Duplicate -- Không --> Respond

Các lệnh thanh toán

pay, qr, thanh toan

1. Tách chuỗi theo dấu phẩy.
2. Loại bỏ khoảng trắng ở đầu và cuối mỗi lệnh.
3. Lưu thành một tập hợp từ khóa.

pay
qr
thanh toan

Điều kiện thông báo tin nhắn OA

message

true

false

• true: cho phép phát thông báo.
• false: bỏ qua thông báo.

if (message.startsWith('/')) {
    false;
} else {
    true;
}

Điều kiện mặc định

• Tin nhắn bắt đầu bằng /.
• Tin nhắn có dạng số điện thoại.
• Chuỗi dài không chứa khoảng trắng, có khả năng là mã hoặc lệnh.

Khi để trống

Khi điều kiện bị lỗi lúc chạy

• Phát sinh lỗi.
• Không trả về giá trị.
• Trả về giá trị khác true.

Kiểm tra dữ liệu khi lưu

Lưu cấu hình

• Nút Save.
• Tổ hợp Ctrl + S trên Windows hoặc Linux.
• Tổ hợp Command + S trên macOS.
• Phím Enter khi đang nhập danh sách lệnh thanh toán.

• Bật hoặc tắt phản hồi tự động.
• Kịch bản phản hồi hiện tại.
• Thời gian trì hoãn phản hồi.

Quan hệ giữa các cài đặt

flowchart TD
    Auto["Bật phản hồi tự động"] --> Scenario["Chạy kịch bản phản hồi"]
    Scenario --> Send["Gửi câu trả lời"]
    Send --> SaveResponse{"Lưu phản hồi?"}
    SaveResponse -- Có --> History["Lưu vào lịch sử"]
    History --> SaveMedia{"Lưu media phản hồi?"}
    SaveMedia -- Có --> Media["Lưu media"]

    Incoming["Nhận tin nhắn"] --> SaveIncomingMedia{"Lưu media nhận vào?"}
    Incoming --> SaveRaw{"Lưu payload gốc?"}
    Incoming --> NotifyCondition["Kiểm tra điều kiện thông báo"]

• Tắt phản hồi tự động không làm ngừng nhận hoặc lưu tin nhắn.
• Lưu media phản hồi phụ thuộc vào việc lưu tin nhắn phản hồi.
• Tắt lưu payload gốc không làm mất nội dung đã chuẩn hóa.
• Điều kiện thông báo chỉ kiểm soát thông báo cho nhân viên, không kiểm soát việc lưu tin nhắn.
• Thời gian trì hoãn ảnh hưởng đến kịch bản phản hồi có sử dụng nó, không phải webhook.

Giá trị mặc định

Khuyến nghị cấu hình

Môi trường phát triển

• Lưu payload nguyên bản.
• Lưu media tin nhắn đến.
• Lưu tin nhắn phản hồi.
• Lưu media phản hồi.

Môi trường production

• Chỉ lưu payload gốc khi thực sự cần.
• Đánh giá dung lượng trước khi bật lưu media.
• Chọn quản trị viên mặc định còn hoạt động.
• Giữ thời gian chống phản hồi lặp ở mức hợp lý.
• Kiểm thử điều kiện thông báo với nhiều loại tin nhắn.
• Theo dõi tiến trình lập chỉ mục và thông báo.
• Xác định chính sách lưu trữ dữ liệu cá nhân.

Giới hạn cần lưu ý

• Tắt một tùy chọn không xóa dữ liệu đã lưu trước đó.
• Bật tải ảnh đại diện không tự động tải lại ảnh của toàn bộ người dùng cũ.
• Bật lưu media không bảo đảm mọi nền tảng hoặc loại tệp đều được hỗ trợ.
• Điều kiện thông báo chỉ nhận nội dung message, không phải toàn bộ payload webhook.
• Điều kiện thông báo là mã được thực thi phía máy chủ và chỉ nên được chỉnh sửa bởi quản trị viên tin cậy.
• Danh sách lệnh thanh toán không tự triển khai quy trình thanh toán.
• Thời gian trì hoãn phản hồi được áp dụng bởi kịch bản có hỗ trợ, không phải giới hạn chung ở tầng gửi tin.
• Các tiến trình lập chỉ mục và thông báo cần hoạt động thì tìm kiếm hoặc thông báo mới được cập nhật đầy đủ.
• Màn hình này không cấu hình dịch vụ OA mặc định; lựa chọn đó được thực hiện tại màn hình quản lý OA Services.
• Màn hình này cũng không chọn kịch bản riêng cho từng dịch vụ; phần đó nằm trên trang chi tiết OA Service.

Kết luận