Nối chatbot vào website của bạn
Khách đang xem trang sản phẩm và có câu hỏi — đó là lúc dễ chốt đơn nhất. Kênh Website cho phép trang của bạn hỏi trợ lý và nhận trả lời ngay, kể cả trả lời nhả dần từng chữ.
Kênh Website là gì
Khác các kênh khác, ở đây không có nền tảng thứ ba nào đứng giữa. Website của bạn nói chuyện thẳng với hệ thống.
Mỗi kênh Website là một điểm cuối công khai riêng. Trang web của bạn gửi lên định danh phiên (một chuỗi bạn tự sinh và lưu ở trình duyệt khách) cùng nội dung khách gõ; hệ thống tạo hội thoại, cho trợ lý trả lời rồi trả kết quả về. Vì không phải chờ webhook của bên thứ ba nên trả lời về ngay trong cùng một lượt gọi, không có độ trễ hàng đợi.
Khách vào website thường ẩn danh. Định danh phiên chính là thứ giúp hệ thống nhận ra “vẫn là người này” khi họ quay lại, để trợ lý còn nhớ đoạn hội thoại trước.
Cần chuẩn bị gì
- Danh sách tên miền được phép
- Liệt kê đúng những địa chỉ sẽ gọi tới kênh này, ví dụ https://shop.vn và https://www.shop.vn. Đây là hàng rào chống người khác lấy mã kênh của bạn đem nhúng lên site của họ và tiêu tiền của bạn. Để trống thì mọi nơi đều gọi được — chỉ nên làm vậy lúc đang thử ở máy cá nhân.
- Một trợ lý đã dựng xong
- Kênh không gắn trợ lý thì tin vẫn về hộp thư nhưng không có ai trả lời tự động. Dựng trợ lý và nạp tài liệu trước, rồi mới nối kênh.
- Người biết lập trình phía website
- Phần này nói thẳng: hiện chưa có đoạn mã nhúng sẵn để dán vào trang. Bạn cần một người viết được đoạn JavaScript gọi API — với hầu hết website là việc của một buổi.
Các bước nối trong dashboard
- 1Vào Kênh và bấm kết nối kênh mới
Mở /dashboard/kenh, chọn loại kênh là Website.
- 2Đặt tên kênh
Tên nội bộ để bạn nhận ra trong hộp thư, ví dụ "Chat trên trang chủ". Khách không nhìn thấy tên này.
- 3Chọn trợ lý phụ trách
Trợ lý nào sẽ trả lời khách trên website. Có thể đổi sau mà không phải nối lại kênh.
- 4Khai tên miền được phép nhúng
Gõ các địa chỉ cách nhau bằng dấu phẩy. Nhớ khai cả bản có www và không có www nếu website bạn dùng cả hai.
- 5Lấy mã kênh ở trang chi tiết
Sau khi tạo, trang chi tiết kênh hiện đường dẫn API kèm mã kênh. Đưa đường dẫn đó cho người làm website của bạn.
Ba điểm cuối bạn sẽ dùng
Đều là điểm cuối công khai, không cần khoá API — vì thế danh sách tên miền được phép mới quan trọng đến vậy.
| Gửi tin, chờ trả lời | POST /widget/{channelId}/messages |
|---|---|
| Gửi tin, nhận trả lời nhả dần | POST /widget/{channelId}/stream |
| Lấy tin mới trong hội thoại | GET /widget/{channelId}/messages?conversationId=… |
Cách gửi giống nhau ở cả ba: định danh phiên, nội dung khách gõ, và tên khách nếu bạn biết (khách đã đăng nhập trên site của bạn chẳng hạn). Bản nhả dần trả về từng mẩu chữ để khung chat hiện dần như người đang gõ. Điểm cuối lấy tin mới dùng khi nhân viên trả lời tay từ hộp thư — trang web hỏi lại xem có tin mới chưa.
Chi tiết tham số và ví dụ có trong tài liệu dành cho lập trình viên.
Điều cần lưu ý
- Chỉ tin nhắn văn bản. Khách kéo thả ảnh vào khung chat thì phần đính kèm chưa được xử lý.
- Định danh phiên nên lưu ở trình duyệt khách và giữ nguyên giữa các lần vào trang, nếu không mỗi lần tải lại trang sẽ thành một khách mới và trợ lý mất ngữ cảnh.
- Danh sách tên miền để trống nghĩa là không chặn ai cả. Trước khi đưa website lên chạy thật, nhớ khai đúng tên miền của mình.
- Kênh chưa gắn trợ lý thì khách gửi tin vẫn vào hộp thư nhưng không có trả lời tự động — hữu ích nếu bạn muốn chỉ có người thật trực chat.
- Chuyển kênh sang tạm dừng khi cần bot im lặng: tin vẫn được ghi nhận, chỉ là trợ lý không chạy.
Nối thêm kênh khác
Mọi kênh đổ về cùng một hộp thư, dùng chung trợ lý và chung kho kiến thức. Nối thêm kênh không phải dựng lại bot từ đầu.