Thiết lập trợ lý đầu tiên

Truy cập trang đăng ký và tạo tài khoản bằng email. Hệ thống tự động khởi tạo một tổ chức. Toàn bộ tài nguyên phát sinh về sau gồm trợ lý, kho tri thức, kênh, ví và khoá API đều thuộc về tổ chức chứ không thuộc về tài khoản cá nhân, nhờ đó việc bổ sung thành viên sau này không phải thiết lập lại từ đầu.

Sau khi đăng nhập, bạn được chuyển tới màn hình /dashboard. Ví đã có sẵn credits dùng thử nên không cần nạp tiền để hoàn thành hướng dẫn này.

Truy cập /dashboard/agents và chọn tạo mới tại /dashboard/agents/moi. Biểu mẫu yêu cầu khai báo các thông tin quyết định chất lượng trả lời:

Đây là bước quyết định độ chính xác của câu trả lời. Truy cập /dashboard/kien-thuc, tạo một kho với tên theo chủ đề, ví dụ “Chính sách và sản phẩm”, sau đó mở kho để bổ sung tài liệu. Hệ thống hỗ trợ hai phương thức nạp:

• Khai báo địa chỉ URL: hệ thống tự tải trang, trích xuất nội dung và lập chỉ mục.
• Nhập trực tiếp văn bản: phù hợp với bảng giá, giờ hoạt động và chính sách đổi trả, những nội dung chưa được công bố trên website.

Mỗi tài liệu được xử lý qua hàng đợi nên trạng thái chuyển dần trước khi hiển thị số đoạn đã phân tách. Tài liệu xử lý thất bại, chẳng hạn do liên kết không truy cập được hoặc trang chặn truy cập tự động, sẽ hiển thị thông báo ngay tại dòng tương ứng kèm tuỳ chọn nạp lại.

Sau khi nạp xong, quay lại trợ lý ở bước 2, chọn kho vừa tạo tại trường Kho tri thức và lưu lại.

Truy cập /dashboard/kenh, chọn kết nối và xác định loại kênh. Mỗi loại yêu cầu thông tin khác nhau vì cơ chế xác thực của từng nền tảng không giống nhau:

Kênh có thủ tục nhanh nhất để kiểm thử là Telegram: nhắn tin cho @BotFather, nhập lệnh /newbot và khai báo token vào biểu mẫu. Sau khi lưu, trang chi tiết kênh hiển thị địa chỉ webhook tương ứng. Toàn bộ thông tin xác thực vừa khai báo đã được mã hoá trước khi lưu vào cơ sở dữ liệu.

Bước cuối cùng là gán trợ lý cho kênh. Kênh chưa gắn trợ lý vẫn ghi nhận tin nhắn nhưng không có phản hồi tự động.

Gửi cho trợ lý một câu hỏi thường gặp nhất từ khách hàng, sau đó mở /dashboard/hoi-thoai để xem toàn bộ hội thoại, nội dung trợ lý đã trả lời, tài liệu được trích dẫn và trạng thái chuyển tiếp cho nhân viên nếu có.

Chi phí được theo dõi tại /dashboard/vi, ghi nhận từng lượt gọi model kèm số token đầu vào, đầu ra và số tiền đã trừ. Nếu chi phí chưa đạt kỳ vọng, bạn có thể giảm nhiệt độ hoặc chuyển sang model có chi phí thấp hơn rồi kiểm thử lại. Việc đổi model không làm mất dữ liệu hội thoại.

Cách nhanh nhất là sử dụng đoạn mã nhúng có sẵn. Trang chi tiết kênh hiển thị đầy đủ thẻ script kèm mã kênh, bạn chỉ cần chèn vào trước thẻ đóng body của website.

<script
  src="https://cdn.chattudong.com/widget.js"
  data-channel="ch_xxxxxxxx"
  data-title="Hỗ trợ khách hàng"
  data-greeting="Xin chào, chúng tôi có thể hỗ trợ gì cho bạn?"
  defer
></script>

Trường hợp doanh nghiệp muốn tự xây dựng giao diện, kênh loại web_widget cung cấp API công khai gọi trực tiếp được từ trình duyệt. Hệ thống kiểm soát truy cập theo danh sách allowedOrigins khai báo khi tạo kênh, vì vậy cần điền đúng tên miền thực tế thay vì để trống.

POST https://api.chattudong.com/widget/{channelId}/messages
Content-Type: application/json

{
  "sessionId": "định-danh-phiên-do-website-tự-sinh",
  "message": "Cửa hàng mở cửa lúc mấy giờ?",
  "visitorName": "Khách truy cập website"
}

Để hiển thị câu trả lời theo luồng, sử dụng POST /widget/{channelId}/stream. Endpoint này trả về SSE với các sự kiện meta, delta, done và kết thúc bằng [DONE]. Ngoài ra, GET /widget/{channelId}/messages?conversationId=… cho phép lấy tin nhắn mới khi nhân viên trả lời thủ công.

• Gọi model từ hệ thống backend của doanh nghiệp: API Reference và SDK và thư viện.
• Doanh nghiệp đã có khoá OpenAI hoặc Anthropic riêng: hướng dẫn BYOK. Khi sử dụng khoá riêng, chúng tôi không thu phí model.
• Tự xây dựng luồng tiếp nhận tin nhắn từ nền tảng: Webhooks.