Danh sách dịch vụ OA

• Tìm kiếm theo tên hoặc mã dịch vụ.
• Lọc theo trạng thái.
• Lọc theo loại dịch vụ xử lý.
• Sắp xếp và duyệt danh sách theo phân trang.
• Mở trang chi tiết hoặc chỉnh sửa dịch vụ.
• Kích hoạt hoặc vô hiệu hóa dịch vụ.
• Chọn dịch vụ mặc định.

Thông tin cấu hình

Thông tin nhận diện

Thông tin ứng dụng

• App ID.
• UUID hoặc mã tài khoản ứng dụng.
• Phiên bản API.
• Client key.
• Secret key.
• Webhook secret.
• Code verifier và code challenge cho PKCE.

Địa chỉ dịch vụ

• URL trang dịch vụ hoặc trang OA.
• URL gốc của API nhà cung cấp.
• Webhook URL.
• Authentication callback URL.
• OAuth URL.

Cấu hình vận hành

• Kênh nhận thông báo.
• Mẫu thông báo dành cho nhân viên.
• Kịch bản phản hồi tin nhắn.
• Tham số riêng của kịch bản.
• Dịch vụ xử lý nền.
• Trạng thái kích hoạt.

Tạo dịch vụ mới

flowchart TD
    Start["Mở trang thêm dịch vụ"] --> Identity["Nhập mã và tên"]
    Identity --> Handler["Chọn dịch vụ xử lý"]
    Handler --> Credentials["Nhập thông tin ứng dụng và khóa"]
    Credentials --> Scenario["Chọn template và cấu hình vận hành"]
    Scenario --> Validate{"Dữ liệu hợp lệ?"}
    Validate -- Không --> Error["Hiển thị lỗi cần sửa"]
    Error --> Identity
    Validate -- Có --> Save["Lưu cấu hình"]
    Save --> Activate{"Kích hoạt ngay?"}
    Activate -- Có --> Integration["Đăng ký webhook hoặc OAuth"]
    Activate -- Không --> Draft["Giữ ở trạng thái chưa hoạt động"]

• Mã dịch vụ không được để trống.
• Mã dịch vụ không được trùng.
• Tên dịch vụ không được để trống.
• Tên dịch vụ không được trùng với dịch vụ khác.
• Dịch vụ tùy biến phải chọn một bộ xử lý nền hợp lệ.

Dịch vụ tích hợp sẵn và dịch vụ tùy biến

Dịch vụ xử lý nền: TELEGRAM_BOT

Các dịch vụ thực tế:
- TELEGRAM_SUPPORT
- TELEGRAM_SALES
- TELEGRAM_INTERNAL

flowchart LR
    Handler["Bộ xử lý Messenger"] --> PageA["Facebook Page A"]
    Handler --> PageB["Facebook Page B"]
    Handler --> PageC["Facebook Page C"]

    PageA --> SecretA["Thông tin xác thực A"]
    PageB --> SecretB["Thông tin xác thực B"]
    PageC --> SecretC["Thông tin xác thực C"]

Trạng thái dịch vụ

• Mã dịch vụ tồn tại.
• Có bộ xử lý tương ứng.
• Cấu hình đang ở trạng thái ACTIVATED.

stateDiagram-v2
    [*] --> INACTIVATED: Tạo nhưng chưa sẵn sàng
    INACTIVATED --> ACTIVATED: Kích hoạt
    ACTIVATED --> INACTIVATED: Vô hiệu hóa
    ACTIVATED --> ARCHIVED: Ngừng sử dụng
    INACTIVATED --> ARCHIVED: Lưu trữ

Dịch vụ mặc định

• Dịch vụ đã được cấu hình đầy đủ.
• Dịch vụ có thể gửi tin.
• Người nhận có định danh tương ứng trên kênh đó.
• Dịch vụ đáp ứng chính sách gửi tin của nhà cung cấp.

Trang chi tiết dịch vụ

• Thông tin nhận diện và trạng thái.
• Cấu hình ứng dụng.
• Webhook URL.
• Authentication callback URL.
• OAuth URL nếu được hỗ trợ.
• Kịch bản phản hồi đang sử dụng.
• Tham số của kịch bản.
• Mẫu tin nhắn và thông báo.
• Công cụ gửi thử.
• Danh sách người dùng OA.
• Danh sách nhân viên chăm sóc khách hàng.

Đăng ký webhook

sequenceDiagram
    participant A as Quản trị viên
    participant E as EzyOA
    participant P as Nhà cung cấp

    A->>E: Tạo và kích hoạt dịch vụ
    E-->>A: Hiển thị Webhook URL
    A->>P: Đăng ký Webhook URL
    P->>E: Gửi yêu cầu xác minh
    E->>E: Kiểm tra mã và trạng thái dịch vụ
    E->>E: Xác minh token hoặc chữ ký
    E-->>P: Trả kết quả xác minh
    P-->>A: Hoàn tất đăng ký webhook

Cấp quyền bằng OAuth

1. Nhà cung cấp chuyển trình duyệt về callback của EzyOA.
2. EzyOA xác định dịch vụ từ mã trên URL.
3. Bộ xử lý kiểm tra tham số callback.
4. Mã xác thực được đổi lấy token.
5. Token hoặc dữ liệu liên quan được lưu vào cấu hình bảo mật.
6. Trình duyệt được chuyển về trang chi tiết dịch vụ.

Quản lý kịch bản phản hồi

flowchart LR
    Service["Dịch vụ OA"] --> Scenario["Kịch bản phản hồi"]
    Scenario --> Parameters["Tham số riêng"]
    Scenario --> Rule["Luồng nghiệp vụ"]
    Scenario --> Chatbot["Chatbot"]
    Rule --> Response["Câu trả lời"]
    Chatbot --> Response

Mẫu thông báo cho nhân viên

• Tên thương hiệu.
• Nhóm hỗ trợ phụ trách.
• Đường dẫn tới hội thoại.
• Thông tin người gửi.
• Nội dung tin nhắn gần nhất.

Đồng bộ người theo dõi

• Khởi tạo danh sách người dùng sau khi kết nối OA.
• Bổ sung người dùng chưa từng gửi webhook tới hệ thống.
• Cập nhật dữ liệu phục vụ gửi tin hoặc chăm sóc khách hàng.

Gửi tin nhắn từ trang quản trị

• Mã người nhận.
• Nội dung văn bản.
• Media.
• Phương thức vận chuyển.
• Tùy chọn gửi cho tất cả người dùng.

• Tổng số lượt gửi.
• Số lượt thành công.
• Số lượt thất bại.

Gửi thông báo theo mẫu

• Mã người nhận.
• Mã template.
• Bộ tham số của template dưới dạng dữ liệu có cấu trúc.

• Người nhận không được để trống.
• Mã template không được để trống.
• Tham số phải có mặt.
• Tham số phải chuyển đổi được thành một đối tượng hợp lệ.

Bảo mật cấu hình

• Chỉ cấp quyền quản lý OA cho quản trị viên cần thiết.
• Không đưa khóa bí mật vào tài liệu công khai, log hoặc mã nguồn.
• Dùng thông tin xác thực riêng cho từng môi trường.
• Không dùng chung webhook secret cho nhiều dịch vụ.
• Thu hồi token khi dịch vụ không còn sử dụng.
• Cấp lại token ngay khi nghi ngờ bị lộ.
• Không gửi ảnh chụp màn hình có chứa token cho bên thứ ba.

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

• Tạo ứng dụng hoặc bot.
• Cấp đúng quyền API.
• Đăng ký webhook.
• Thực hiện OAuth.
• Đưa ứng dụng sang chế độ hoạt động.
• Xin duyệt quyền hoặc template nếu nền tảng yêu cầu.

Kết luận