Tạo tiện ích web trong dashboard

Thiết lập tiện ích nhấp để trò chuyện cho trang web của bạn từ trang Tiện ích web — không cần gọi API.

Trang Tiện ích web (/dashboard/web-widgets) tạo và quản lý các khóa có thể xuất bản cung cấp năng lượng cho tiện ích giọng nói nhúng của ThunderPhone. Mọi thao tác mà phiên bản API của hướng dẫn này thực hiện bằng cURL, trang này thực hiện bằng biểu mẫu — đồng thời tạo mã nhúng cho bạn.

Tạo tiện ích#

1. Nhấp vào Tiện ích mới và chọn một chế độ
   • Chế độ tác nhân AI — tiện ích luôn chạy một tác nhân AI bạn chọn từ danh sách thả xuống. Đây là thiết lập đơn giản nhất.
   • Chế độ Webhook — trong mỗi phiên tiện ích, ThunderPhone gọi URL webhook của bạn và máy chủ của bạn trả về cấu hình tác nhân AI cho khách truy cập đó (định tuyến theo trang, người dùng đã đăng nhập, triển khai dần). Để trống URL để dùng webhook mặc định của tổ chức; khi nhập URL mới, bạn cũng có thể đặt URL đó làm mặc định cho tổ chức.
2. Liệt kê các miền được phép

   Cần có ít nhất một miền và trình duyệt chỉ có thể bắt đầu phiên từ các tên máy chủ bạn liệt kê. Ký tự đại diện cho miền con như *.example.com được phép (chúng khớp với miền con, không phải miền gốc); ký tự đại diện độc lập như * sẽ bị từ chối. Danh sách này ngăn việc tái sử dụng khóa của bạn một cách tùy tiện trên các trang khác nhưng không phải là xác thực: một script bên ngoài trình duyệt có thể gửi bất kỳ tiêu đề Origin nào. localhost không được tự động cho phép trong môi trường production; hãy thêm nó vào danh sách để kiểm thử cục bộ với API production.

3. Chọn các ghi đè từ trình duyệt

   Chọn từng cài đặt phiên mà trang của bạn gửi: Ngữ cảnh trang, Biến, Giọng nói, Ngôn ngữ. Tiện ích mới không chấp nhận cài đặt nào và yêu cầu phiên có kèm cài đặt đang tắt sẽ thất bại với 400. Khóa của bạn là công khai, vì vậy chỉ cho phép những gì bạn sử dụng. Xem Ghi đè từ trình duyệt.

4. Đặt tên, bật và tạo

   Nút chuyển Bật tiện ích kiểm soát việc khóa có chấp nhận phiên hay không — bạn có thể tạo tiện ích ở trạng thái tắt rồi bật khi ra mắt.

Lấy mã nhúng#

Ngay sau khi tạo (hoặc qua nút Nhúng của từng hàng), hộp thoại nhúng tạo mã sẵn sàng để dán với khóa có thể xuất bản của bạn đã được điền vào:

• React — đoạn mã <ThunderPhoneWidget /> cho ứng dụng dùng bundler.
• Thẻ script — cặp CDN <script> + stylesheet cho mọi trang web.

Hộp thoại cũng xem trước các tùy chọn giao diện cơ bản — tiêu đề, màu chính, vị trí góc và giao diện sáng/tối — rồi đưa các lựa chọn của bạn vào đoạn mã. Để xem tài liệu đầy đủ về prop, hook tạo kiểu và tùy chọn headless, hãy xem tài liệu SDK tiện ích.

Quản lý tiện ích từ danh sách#

Mỗi hàng có thể chỉnh sửa trực tiếp:

• Chế độ / Tác nhân AI — chuyển giữa chế độ tác nhân AI và webhook, hoặc thay đổi tác nhân AI, bằng các danh sách chọn trực tiếp.
• Miền — thêm hoặc xóa các miền được phép dưới dạng chip.
• Bật/tắt — một công tắc cho mỗi tiện ích; tiện ích bị tắt sẽ ngừng chấp nhận phiên ngay lập tức.
• Chuyển sang tổ chức — sao chép hoặc di chuyển tiện ích sang tổ chức khác mà bạn thuộc về (di chuyển sẽ xóa tiện ích ở đây).
• Xóa — thu hồi khóa có thể xuất bản; tiện ích ngừng hoạt động ngay lập tức trên mọi miền. Không thể hoàn tác thao tác này.

Các phiên tiện ích xuất hiện trong lịch sử cuộc gọi với cùng bản chép lời, bản ghi và chấm điểm như cuộc gọi điện thoại.

Bước tiếp theo#