Widget cấp tương tác

Widget cấp tương tác cho phép Doanh nghiệp dễ dàng xin quyền tương tác từ khách hàng truy cập Website để gửi thông báo về giao dịch được thực hiện đến Zalo của khách hàng thông qua Official Account. Sau khi user thực hiện cấp quyền thì Zalo sẽ gửi cho Doanh nghiệp sự kiện Khách hàng đồng ý cấp tương tác. Demo và lưu đồ hướng dẫn sử dụng Widget​

Tạo Widget

Vui lòng để sử dụng tính năng này.

Cài đặt

Chi tiết cấu hình cho Widget yêu cầu cấp tương tác:

AttributeRequiredDescription
data-oaidrequiredZalo Official Account ID
statusrequired
Trạng thái của Widget:
  • hide: Không hiển thị Widget trên website
  • show (Mặc định): Hiển thị Widget trên website. Khi Widget cấp tương tác hiển thị thì sẽ có index cao nhất, hiển thị đè lên các Widget khác của Zalo đang có trên website.
Doanh nghiệp có thể chủ động điều chỉnh status cho phù hợp với ngữ cảnh của khách hàng.
user_external_idoptional
user_id của khách hàng trong hệ thống của Doanh nghiệp, do Doanh nghiệp truyền vào user_id này sử dụng để doanh nghiệp nhận biết khách hàng của mình trên nền tảng Zalo OA. Lưu ý: user_external_id là duy nhất
data-appidrequiredId của ứng dụng
data-callbackoptional
Tên hàm callback được khai báo global. Hàm sẽ được gọi khi user đồng ý cấp tương tác.
Hàm callback có parameter là
  • user_id: là id của khách hàng khi tương tác với Official Account, id sẽ được trả về khi khách hàng chấp nhận tương tác với OA thông qua Webhook hoặc callback function
  • action:
    • Khi widget được load thành công: 'loaded_successfully'
    • Khi user bấm đồng ý cấp quyền: 'click_interaction_accepted'
    • Khi user quan tâm OA: 'click_followed'
    • Khi user bấm bỏ qua ở nút follow: 'dismiss_follow'
    • Khi widget chuyển từ widget cấp interaction sang follow: 'updated_follow_widget'
data-reason-msgoptional
Lý do cần khách hàng cấp quyền tương tác.

*** Chú ý: Dùng hàm ZaloSocialSDK.reload() để init lại widget trong trường hợp bạn cần sử dụng các config động.