Cách thêm Asyntai AI Chatbot vào Umbraco
Hướng dẫn từng bước cho các trang web Umbraco CMS
Bước 1: Lấy Mã Nhúng của Bạn
Đầu tiên, đi đến Bảng điều khiển Asyntai và cuộn xuống phần "Mã Nhúng". Sao chép mã nhúng duy nhất của bạn sẽ trông như thế này:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Lưu ý: Mã ở trên chỉ là ví dụ. Bạn phải sao chép mã nhúng duy nhất của riêng mình từ Bảng điều khiển vì nó chứa ID tiện ích cá nhân của bạn.
Bước 2: Chỉnh sửa Mẫu chính (Khuyến nghị)
Cách dễ nhất để thêm chatbot vào tất cả các trang là chỉnh sửa mẫu Master của bạn:
- Đăng nhập vào Umbraco Backoffice của bạn
- Đi đến Settings trong thanh bên trái
- Mở rộng Templates
- Nhấp vào mẫu Master của bạn (hoặc mẫu bố cục chính mà trang web của bạn sử dụng)
- Tìm thẻ đóng
</body> - Dán mã nhúng Asyntai ngay trước thẻ
</body> - Nhấp "Save"
Mẹo: Thêm tập lệnh trước thẻ đóng </body> đảm bảo nó tải sau nội dung trang, được khuyến nghị cho tiện ích trò chuyện và sẽ không làm chậm tải trang.
Thay thế: Sử dụng Loại tài liệu Cài đặt trang
Để linh hoạt hơn, bạn có thể thêm một trường tùy chỉnh để quản lý các kịch bản chân trang:
- Vào Settings → Document Types
- Chỉnh sửa loại tài liệu Site Settings của bạn (hoặc tạo một loại nếu chưa tồn tại)
- Thêm một thuộc tính mới có tên "Footer Scripts" với kiểu dữ liệu Textarea
- Lưu Loại tài liệu
- Go to Content and edit your Site Settings node
- Dán mã nhúng Asyntai của bạn vào trường Footer Scripts
- Trong mẫu Master của bạn, thêm mã này trước
</body>:@Html.Raw(Model.Value("footerScripts")) - Lưu cả nội dung và mẫu
Lưu ý: Sử dụng @Html.Raw() là quan trọng để hiển thị các thẻ kịch bản đúng mà không bị mã hóa HTML.
Thay thế: Sử dụng thư mục Scripts
Bạn cũng có thể tạo một tệp JavaScript trong Umbraco Backoffice:
- Vào Settings → Scripts
- Nhấp chuột phải vào Scripts và chọn "Create"
- Tạo một tệp mới có tên asyntai-chatbot.js
- Thêm mã sau:
(function() {
var script = document.createElement('script');
script.async = true;
script.src = 'https://asyntai.com/static/js/chat-widget.js';
script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
document.body.appendChild(script);
})(); - Thay thế
YOUR_WIDGET_IDbằng ID tiện ích thực tế của bạn - Lưu tệp
- Bao gồm kịch bản này trong mẫu Master của bạn trước
</body>:<script src="/scripts/asyntai-chatbot.js"></script>
Thay thế: Theo trang với RenderSection
Nếu bạn chỉ muốn chatbot trên các trang cụ thể:
- Trong mẫu Master của bạn, thêm trước
</body>:@RenderSection("footerScripts", required: false) - Trong mẫu trang cụ thể nơi bạn muốn chatbot, thêm:
@section footerScripts {
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
}
Bước 3: Xác minh Cài đặt
Sau khi lưu thay đổi, truy cập trang web trong tab trình duyệt mới hoặc cửa sổ ẩn danh. Bạn sẽ thấy nút tiện ích trò chuyện ở góc dưới bên phải. Nhấp vào nó để đảm bảo nó mở và hoạt động chính xác.
Không thấy tiện ích? Hãy đảm bảo bạn đã lưu mẫu sau khi thực hiện thay đổi. Thử xóa bộ nhớ đệm trình duyệt hoặc xem trong cửa sổ ẩn danh. Nếu bạn đang sử dụng Umbraco Cloud, các thay đổi sẽ được triển khai tự động. Đối với Umbraco tự lưu trữ, bạn có thể cần khởi động lại ứng dụng hoặc xóa bộ nhớ đệm.
Weebly