Kiến trúc tích hợp
Nền tảng cung cấp hai kênh để đưa Agent tới khách hàng cuối. Hai kênh dùng chung một bộ Agent, một kho tri thức và một lịch sử hội thoại; chúng chỉ khác nhau ở chỗ ai sở hữu giao diện chat.Kênh Live Chat
Chúng tôi cung cấp sẵn giao diện chat. Bạn dán một đoạn mã nhúng vào website, hoặc gọi SDK trong ứng dụng di động.
Kênh API
Bạn giữ nguyên giao diện chat sẵn có. Tin nhắn của khách được đẩy tới chúng tôi qua webhook; câu trả lời gửi ngược lại webhook của bạn bằng callback.
Mở tab Channels
Mở Agent, chọn tab Channels trên thanh điều hướng của Agent. Đầu trang hiển thị dòng mô tả “Where this agent serves, and which version is running”.
Live channels
Con số Live channels cho biết đang có bao nhiêu kênh thực sự phục vụ người dùng. Khi con số bằng 0, nghĩa là chưa có kênh nào chạy, dù bạn đã cấu hình kênh hay chưa. Nút Go to Build đưa bạn trở lại tab Dựng Agent để xuất bản phiên bản đầu tiên.Agent Workspace
Khối Agent Workspace cho biết Agent đang mở cho những ai trong Workspace. Khi Agent chưa từng được xuất bản, khối này ở trạng thái rỗng với dòng nhắc: “No published version yet. Publish a version on the Build tab first, then come back here to open it to people.” Sau khi xuất bản, khối này hiển thị phạm vi chia sẻ đã chọn (chỉ mình bạn, công ty hoặc phòng ban, hoặc cộng đồng FPT AI Agent) và phiên bản đang phục vụ. Xem thêm ở trang Xuất bản.Kênh ngoài
Khối External channels liệt kê các kênh bên ngoài Workspace kèm trạng thái cấu hình.
Web widget
Live chat trên website. Trạng thái ban đầu: Not configured.
API
Gọi trực tiếp từ hệ thống của bạn. Trạng thái ban đầu: Not configured.
Zalo
Official Account. Trạng thái ban đầu: Not configured.
Kênh chưa mở
Khối Not available yet liệt kê các kênh nhắn tin đang trong lộ trình phát triển. Các kênh này hiển thị để bạn hình dung lộ trình, chưa bấm cấu hình được.Messenger
Trang Facebook trả lời khách bằng Agent.
Số WhatsApp Business trả lời khách bằng Agent.
Telegram
Bot Telegram trả lời khách bằng Agent.
Thêm một kênh triển khai
1
Chọn kênh cần cấu hình
Trong khối External channels, bấm vào kênh đang ở trạng thái Not configured.
2
Điền thông tin cấu hình
Mỗi kênh có bộ thông tin riêng. Xem Kênh Live Chat hoặc Kênh Zalo.
3
Lưu cấu hình
Bấm Save configuration với Web widget, hoặc Connect với Zalo. Trạng thái kênh chuyển từ Not configured sang đã cấu hình.
4
Bật kênh khi xuất bản
Quay lại tab Dựng Agent, bấm Publish, tích kênh vừa cấu hình trong phần External channels rồi xuất bản.
Chọn phiên bản phục vụ cho từng kênh
Mỗi kênh có thể chạy một phiên bản khác nhau. Ví dụ bạn có thể để website chạy phiên bản ổn định v1.0.1 trong khi Zalo đã chạy v1.0.2.
1
Mở kênh cần đổi phiên bản
Trong tab Channels, bấm vào kênh đang chạy.
2
Mở danh sách phiên bản
Bấm nút chọn phiên bản phát hành. Danh sách liệt kê mọi phiên bản đã xuất bản, kèm ngày phát hành và ghi chú.
3
Chọn phiên bản muốn phục vụ
Phiên bản đang chạy được đánh dấu Đang phục vụ. Chọn phiên bản khác nếu muốn đổi.
4
Xác nhận
Bấm nút phát hành để áp dụng. Bấm Hủy nếu chỉ muốn xem.
Sửa cấu hình một kênh
Bấm vào kênh đã cấu hình để mở lại bảng thiết lập. Sửa các trường cần đổi rồi lưu lại. Với Web widget, thay đổi giao diện widget có hiệu lực ngay ở mọi nơi đã nhúng mã, không cần nhúng lại.Tài liệu tích hợp kỹ thuật
Trang này hướng dẫn bật và quản lý kênh trong Console. Khi đội kỹ thuật cần nhúng sâu vào hệ thống của bạn, xem bộ tài liệu tích hợp:Kênh Live Chat
Mã nhúng, tùy biến widget, chia sẻ qua đường dẫn và Visitor API cho bên tự xây giao diện.
SDK di động
Đưa khung chat vào ứng dụng Android và iOS.
Tích hợp API
Webhook, ký HMAC, callback, đọc lại lịch sử hội thoại và khóa API.
Phụ lục kỹ thuật
Bảng mã lỗi, bảng giới hạn hệ thống và danh mục kiểm tra trước Production.
Ngắt một kênh
Có hai cách dừng phục vụ trên một kênh:Tắt kênh khi xuất bản
Mở hộp thoại Publish, bỏ tích kênh đó trong phần External channels rồi xuất bản. Cấu hình của kênh vẫn được giữ, chỉ ngừng phục vụ.
Ngắt kết nối hẳn
Mở bảng cấu hình của kênh và ngắt kết nối. Cách này xóa thông tin kết nối, khi cần dùng lại bạn phải nhập lại từ đầu.
Sau khi ngắt, con số Live channels ở đầu trang giảm tương ứng. Hãy kiểm tra lại con số này mỗi lần thay đổi để chắc chắn Agent đang phục vụ đúng nơi bạn muốn.