Tổng quan tích hợp

KOPA chỉ tốt khi có dữ liệu thật. Phần này giải thích các loại connector, cách bảo mật, và lifecycle.

Loại connector#

KOPA hỗ trợ 5 nhóm:

1. Banking — ngân hàng, ví điện tử, gateway thanh toán.
2. E-invoice — hóa đơn điện tử Misa, FPT, VNPT, Viettel.
3. POS — KiotViet, Sapo, iPos, Haravan.
4. Spreadsheets — Excel, Google Sheets.
5. Notifications — Telegram, Zalo, Email, Slack.

Plus các connector chuyên biệt cho ngành (F&B, retail, sản xuất, dịch vụ ủy thác).

Bảo mật#

KOPA tuân thủ:

• OAuth 2.0 — không lưu mật khẩu, chỉ lưu token.
• Read-only mặc định — không có quyền chuyển tiền, gửi hóa đơn thay bạn (trừ khi bạn explicit cấp quyền).
• Token rotation — refresh tự động, lưu encrypted at rest (AES-256).
• IP whitelisting — token chỉ dùng từ IP của KOPA service (production).
• Audit log — mọi tool call qua connector đều log.

Lifecycle connector#

[Add] → [OAuth/Token] → [Test] → [Connected]
                ↓                       ↓
             [Failed]              [Token expires?]
                ↓                       ↓
           [Re-auth]              [Auto-refresh]
                                        ↓
                                   [Renewed] / [Needs auth]

Trạng thái:

• 🟢 Connected — hoạt động.
• 🟡 Needs auth — token hết hạn, bấm để re-auth.
• 🔴 Error — lỗi (xem log).
• ⚪ Disabled — tắt thủ công.

Quản lý connector#

Vào Cài đặt → Connectors để xem tất cả. Mỗi dòng có:

• Icon provider.
• Tên + ID.
• Trạng thái.
• Lần đồng bộ cuối.
• Action: Test / Re-auth / Disable / Delete.

Cấu hình lịch đồng bộ#

Mỗi connector có:

• Đồng bộ thủ công — chỉ pull khi bấm.
• 15 phút — pull mỗi 15 phút.
• 1 giờ — pull mỗi giờ.
• Real-time webhook — pull ngay khi có event (chỉ cho provider hỗ trợ).

Các trang con#

• Ngân hàng (VCB, BIDV, MB...)
• Hóa đơn điện tử
• POS (KiotViet, Sapo, iPos)
• Excel & Google Sheets
• Telegram, Zalo, Email

Khi nào cần connector?#

• Bắt buộc: ít nhất 1 connector ngân hàng (để dòng tiền chính xác).
• Khuyến nghị: hóa đơn điện tử (giảm 90% việc nhập tay).
• Tùy chọn: POS (cho retail/F&B), spreadsheet (cho payroll/AR/AP custom).

Yêu cầu connector mới#

Nếu provider bạn dùng chưa có sẵn:

• Vào Cài đặt → Connectors → Yêu cầu connector mới.
• Mô tả provider + use case.
• KOPA team đánh giá và lên roadmap.

Hoặc bạn có thể dùng MCP custom để tự build connector — xem API & MCP.