Comment on page
API Javascript của Subiz Widget
Là các phương thức tương tác với Subiz Widget (cửa sổ Subiz) thông qua Javascript. Nó giúp các website làm việc với Subiz sáng tạo hơn.
Để có thể hiển thị thành công những tùy chỉnh, bạn cần đặt các mã API này ngay phía sau của mã nhúng Subiz trên website.
API cho phép cập nhật dữ liệu khách hàng ngay từ Website. Ví dụ khi khách truy cập đăng nhập trên web, bạn có thể cập nhật email, họ tên... lên Subiz để quản lý cũng như tương tác.
<script>
subiz('updateUserAttributes', [{ key: 'fullname', text : 'David' }]);
</script>
//Cập nhật tên. Trong đó fullname là Attributes Key của trường dữ liệu Fullname.
<script>
subiz('updateUserAttributes', [{ key: 'so_thich', list :['Máy ', 'EnglDu lịch']);
</script>
//Cập nhật một trường dữ liệu khách hàng tùy chỉnh, và là dạng nhiều giá trị.
Bạn cũng có thể cập nhật nhiều trường giá trị cùng lúc.
<script>
subiz('updateUserAttributes', [{ key: 'fullname', text : 'David' },{ key: 'phones', text : '+84983123456' }]);
</script>
//Update trường fullname và phones cùng lúc.
API cho phép lấy dữ liệu Khách truy cập từ Subiz để cho website sử dụng. Ví dụ, một khách truy cập quay lại, bạn có thể lấy dữ liệu đã lưu trong Subiz và hiển thị lên website. Ví dụ như dữ liệu Vị trí địa lý để web hiển thị thông tin phù hợp.
<script>
subiz('getUserAttributes', (attributes) => {console.log('user attributes', attributes)});
</script>
//Lấy dữ liệu User Attributes từ Subiz về.
Chức năng cho phép bạn thiết kế cơ chế để Khách truy cập có thể xóa dữ liệu của họ. Dữ liệu bị xóa bao gồm tất cả thông tin trên trình duyệt của khách truy cập và trong Subiz. Do vậy, khi bị xóa thì agents cũng không nhìn thấy User này.
<script>
subiz('forgetMe');
</script>
//API Để xóa dữ liệu User.
API cho phép web chỉ định ngôn ngữ hiển thị của Subiz Widget. Khi đó, bạn có thể quyết định trang nào hiển thị tiếng Việt, trang nào hiển thị tiếng Anh.
<script>
subiz('setLanguage', 'en');
</script>
//Chỉ định ngôn ngữ tiếng Anh. Trong đó 'en' là mã ngôn ngữ.
Mã ngôn ngữ là Mã đại diện của ngôn ngữ theo chuẩn ISO 639-1 ( hai ký tự) và là những ngôn ngữ mà Subiz hiện đang có. Xem danh sách ngôn ngữ Subiz đang hỗ trợ.
API cho phép bạn ra lệnh mở Subiz Widget. Ví dụ, bạn có thể tạo một nút trên website để khi khách truy cập click vào nút đó, cửa sổ Subiz sẽ mở ra.
<script type="text/javascript">
window.subiz('expandWidget')
</script>
// API mở Subiz widget qua function Javascript.
<a href="#nogo" onclick="subiz('expandWidget')">Text của </a>
//Gắn vào một link để ra lệnh mở Subiz widget.
<script type="text/javascript">
window.subiz('shrinkWidget')
</script>
//API đóng cửa sổ Subiz.
<a href="#nogo" onclick="subiz('shrinkWidget')">text của </a>
//Gắn vào link để đóng Subiz widget.
Trước hết bạn cần tải file ngôn ngữ của Subiz để biết mục nào mình muốn thay
- Tại mục NGÔN NGỮ > chọn Tiếng Việt > Chọn Bạn có thể sửa tất cả nội dung Tiếng Việt tại đây
- Chọn Tải về tệp nội dung gốc > Tệp định dạng .po sẽ được lưu về máy tính
Sau đó sử dụng đoạn mã API sau:
<script>
subiz('setLanguageData', {}) . VD subiz('setLanguageData', {message_input_help: "Nhập tin", joined_the_conversation: "joined"})
</script>
// Tùy chỉnh cùng lúc nội dung nhập tin và tham gia hội thoại
Trong đó:
- Message_input_help: Là key language và được lấy từ File Po.
- Nhập tin: là nội dung language bạn muốn thay đổi
Key language trong file Po
Chẳng hạn bạn muốn thay đổi nội dung lời giới thiệu trên thanh tiêu đề, bạn tìm kiếm phần giới thiệu đó trong file ngôn ngữ đã tải và thay đổi trên web bằng cách gắn API như sau:
<script>
subiz('setLanguageData', {team_intro: "Muahanggiare.com - website cung cấp dịch vụ tốt nhất tại Hà Nội"})
</script>
Tùy chỉnh nội dung thanh tiêu đề
Thay đổi nội dung thanh tiêu đề
API cho phép bạn chủ động hỏi user đồng ý nhận thông báo qua trình duyệt khi cửa sổ Subiz của họ có tin nhắn mới. Bạn có thể đặt vào một nút trên trang web hay một link bất kỳ để có thể gia tăng số người đồng ý nhận thông báo.
<script type="text/javascript">
subiz('subscribePushNotification')
</script>
//API để hỏi user đồng ý nhận thôn .
<script type="text/javascript">
subiz('unsubscribePushNotification')
</script>
//API để hủy đăng ký nhận thông .
<script type="text/javascript">
subiz('checkPushNotification', function(status) {
console.log(status)
})
</script>
//API để kiểm tra tình trạng user đã đồng ý nhận thông báo chưa?