Aivigo Hướng dẫn sử dụng

Voicebox & Widget

Tạo khung chat + giọng nói, lấy mã nhúng và thử nghiệm trước khi đưa cho khách.

Voicebox là khung chat có giọng nói dựng sẵn, nhúng vào website hoặc app chỉ bằng một đoạn mã. Mỗi voicebox gắn với một Ứng dụng và có khoá công khai vb_….

Tạo Voicebox

Vào Voicebox & Widget → Tạo Voicebox mới.

Điền:

  • Tên Voicebox — vd. Trợ lý Bán Hàng Website.
  • Ứng dụng mục tiêu (App) — App mà voicebox phục vụ.
  • Allowed Origins — các tên miền được phép hiển thị widget, phân tách bằng dấu phẩy, vd. https://shop.vn, https://www.shop.vn. Có thể dùng ký tự đại diện https://*.shop.vn.
Bấm tạo. Voicebox mới xuất hiện trong Danh sách Voicebox đã cấu hình kèm Voicebox Key.

Origin phải khớp chính xác

Origin gồm giao thức + tên miền (+ cổng nếu có), không có đường dẫn: https://shop.vn ✓ · shop.vn ✗ · https://shop.vn/home ✗. Trang không nằm trong danh sách sẽ không hiển thị widget.

Lấy mã nhúng

Ở dòng voicebox, bấm nút sao chép mã nhúng rồi dán vào trang web, ngay trước thẻ đóng body:

<script src="https://voicebox.aivigo.tech/widget/v1/voicebox.js" data-key="vb_xxx" async></script>

Gửi đoạn mã này cho đội web của bạn. Các cách nhúng khác (khung cố định, iframe, app di động, đăng nhập người dùng) xem Nhúng Voicebox trên website và Voicebox trên app di động.

Thử nghiệm Voicebox

Vào Thử nghiệm Voicebox (hoặc nút Thử nghiệm Widget):

Chọn Voicebox mục tiêu — màn hình hiện Voicebox Key và App ID tương ứng.

Chọn Hình thức kiểm thử:

  • Widget — widget thật như khách sẽ thấy; chọn Kích thước hiển thị (máy tính hoặc Mobile (380px)).
  • Console Chat — khung chat đơn giản gọi thẳng trợ lý, tiện để thử nhanh nhiều câu.

Gõ câu thử, vd. Tôi muốn tìm áo sơ mi nam, tra cứu đơn hàng #123, khuyến mãi hôm nay. Bấm Mở cửa sổ riêng để thử trên tab mới.

Mỗi lượt thử được tính vào lượng dùng và xuất hiện trong Lịch sử hội thoại.

Gợi ý trước khi đưa cho khách

  • Thử đủ các câu thường gặp của khách và luồng đặt đơn có bước xác nhận.
  • Khai báo cả origin staging để đội web kiểm tra; xoá localhost khỏi voicebox dùng thật.
  • Khách đã đăng nhập trên web của bạn? Cấu hình danh tính người dùng để trợ lý tra đúng đơn hàng của họ.
Sửa trang này trên GitLab

Trong trang này