Tổng quan tích hợp
Hai cách đưa trợ lý AI của Aivigo vào sản phẩm của bạn và cách chọn cách phù hợp.
Aivigo AI Agent nhận câu nói (chữ, giọng nói hoặc thao tác bấm nút) của người dùng, hiểu ý định, gọi hệ thống nghiệp vụ (tìm sản phẩm, tạo đơn, tra khuyến mãi…) và trả lời kèm các khối giao diện có cấu trúc. Bạn tích hợp theo một trong hai cách:
Voicebox (nhúng widget)
Dán một thẻ script là có bong bóng chat + giọng nói trên web, hoặc mở trang chat trong WebView của app. Nhanh nhất, không cần tự vẽ giao diện.
Core API (/agent/process)
Backend của bạn gọi REST/SSE bằng API key và tự hiển thị kết quả. Dành cho app native, POS, CRM, chatbot server-to-server.
Chọn cách tích hợp
| Tình huống | Nên dùng |
|---|---|
| Website bất kỳ, muốn bong bóng chat góc màn hình | Voicebox — thẻ script |
| Khung chat cố định trong trang (trang hỗ trợ, dashboard) | Voicebox — inline / Web Component |
| App iOS / Android / React Native / Flutter | Voicebox — WebView |
| App native muốn tự vẽ giao diện chat | Voicebox REST + SSE |
| Hệ thống backend (CRM, POS, Zalo OA, tổng đài) gọi trợ lý | Core API |
Không để lộ API key
API key ak_… chỉ dùng ở server. Trên trình duyệt và app di động, hãy dùng Voicebox — widget nhận khoá công khai
vb_…, không cần API key.
Địa chỉ dịch vụ
| Dịch vụ | Production | Mô tả |
|---|---|---|
| Core API | https://api.aivigo.tech/api/v1 | /agent/process, lịch sử phiên, lượng dùng |
| Voicebox | https://voicebox.aivigo.tech | Widget voicebox.js, trang chat, REST /v1/widgets/… |
| Cổng đối tác | https://partner.aivigo.tech | Tạo API key, voicebox, theo dõi chi phí |
| Tài liệu kỹ thuật + Sandbox | https://docs.aivigo.tech | Đặc tả OpenAPI và thử gọi API trực tiếp |
Quy trình tích hợp
Đăng ký tài khoản đối tác — Sandbox được cấp tự động sau khi xác minh email (hướng dẫn).
Tạo API key Sandbox ak_test_… hoặc tạo Voicebox trên Cổng đối tác.
Gọi thử theo Bắt đầu nhanh — Sandbox dùng hệ thống nghiệp vụ mô phỏng, không phát sinh chi phí.
Hoàn thiện danh tính người dùng, xử lý lỗi, giới hạn lưu lượng (checklist).
Đăng ký Go-Live — sau khi được duyệt, tạo khoá ak_live_… và chuyển sang Production.