Klaviyo là nền tảng email marketing và SMS marketing chuyên sâu, cho phép tự động hoá chiến dịch dựa trên hành vi khách hàng theo thời gian thực. Bài viết này hướng dẫn Seller kết nối BettaMax với Klaviyo bằng phương thức OAuth, cách kết nối được khuyến nghị, nhanh và an toàn hơn so với việc nhập API Key thủ công.
Mục 1: Truy cập mục Email marketing #
Tại menu bên trái trong tài khoản BettaMax, chọn Marketing, sau đó chọn Email marketing để mở trang tích hợp Klaviyo.
Mục 2: Chọn phương thức kết nối #
Tại trang Klaviyo detail, hệ thống cung cấp hai phương thức kết nối:
- Connect via OAuth (Recommended)
- Connect with API Key (nhập thủ công API Key, dùng khi không thể dùng OAuth)

Seller nên chọn Connect via OAuth vì mang lại nhiều ưu điểm hơn so với việc nhập API Key thủ công trước đây:
- Automatic token refresh: token xác thực được BettaMax tự động làm mới, Seller không cần lo token hết hạn hay phải cập nhật API Key thủ công định kỳ.
- Secure credential management: credential được quản lý và lưu trữ an toàn theo chuẩn OAuth 2.0, hạn chế rủi ro lộ API Key khi thao tác thủ công.
- All required scopes pre-configured: toàn bộ scope cần thiết để đồng bộ khách hàng, sự kiện và chiến dịch đã được cấu hình sẵn, tránh thiếu quyền dẫn đến đồng bộ không đầy đủ.
Seller bấm nút Connect ở khối Connect via OAuth để bắt đầu quá trình xác thực.
Note: Trước đây BettaMax chỉ hỗ trợ tích hợp Klaviyo qua API Key nhập thủ công, phương thức này chưa được tối ưu, dễ phát sinh lỗi thiếu quyền hoặc token hết hạn mà không tự làm mới. OAuth ra mắt nhằm khắc phục các hạn chế đó.
Mục 3: Đăng nhập và uỷ quyền #
Sau khi bấm Connect, hệ thống sẽ mở cửa sổ đăng nhập chính thức của Klaviyo (klaviyo.com/login). Seller thực hiện:
- Nhập Email và Password của tài khoản Klaviyo cần kết nối.
- Xác nhận reCAPTCHA (“I’m not a robot”), sau đó bấm Log in.
- Ở màn hình uỷ quyền tiếp theo, xác nhận Authorize để BettaMax được phép truy cập và đồng bộ dữ liệu với tài khoản Klaviyo này.
Tips: Klaviyo cũng hỗ trợ đăng nhập nhanh bằng Google, Passkey hoặc SSO nếu tài khoản của Seller đã liên kết sẵn. Chỉ đăng nhập bằng tài khoản Klaviyo của chính Seller, không sử dụng thông tin đăng nhập của bên thứ ba.
Mục 4: Xác nhận và cấu hình #
Ngay sau khi uỷ quyền thành công, hệ thống chuyển Seller quay lại trang Klaviyo detail kèm thông báo Klaviyo connected ở góc trên bên phải, xác nhận kết nối đã hoàn tất. Tại đây, Seller có thể kiểm tra và cấu hình thêm:
- Connect via OAuth, Connected: trạng thái hiển thị nhãn Connected kèm tên Store đã được uỷ quyền. Cần đổi tài khoản Klaviyo khác thì bấm Disconnect.
- Enable Klaviyo tracking: toggle cho phép nhúng script tracking của Klaviyo lên storefront, phục vụ theo dõi hành vi phía client-side (onsite tracking, viewed product) cũng như hiển thị forms/popup thu thập email-SMS do Klaviyo quản lý.
- Server-side Sync: nhóm sự kiện được đồng bộ tự động từ BettaMax sang Klaviyo theo cơ chế server-side, không phụ thuộc việc bật/tắt Klaviyo tracking:
Bấm View tracking details để xem đầy đủ payload gửi sang Klaviyo.

Tips: Server-side Sync hoạt động ngay sau khi kết nối OAuth thành công, không cần bật Enable Klaviyo tracking, toggle này chỉ áp dụng cho tracking/forms/popup phía storefront.
Mục 5: Kiểm soát dữ liệu trên Klaviyo #

Sau khi kết nối OAuth thành công, toàn bộ dữ liệu khách hàng và sự kiện (event) từ BettaMax sẽ được đồng bộ trực tiếp vào Profiles trên Klaviyo. Seller vào Audience, sau đó chọn Profiles để xem chi tiết từng khách hàng, bao gồm:
Channel consent: trạng thái đăng ký nhận email/SMS (Subscribed, Never subscribed…).
Custom properties: các thuộc tính tuỳ chỉnh gắn với khách hàng.
Information: thông tin định danh (Unique ID, Locale, Location, Timezone…) và nguồn khách hàng biết đến Store.
All events: lịch sử hành vi/sự kiện của khách hàng theo thời gian thực, đồng bộ trực tiếp từ Store, ví dụ:
- Active on Site: khách hàng đang truy cập Store.
- Viewed Product: khách hàng xem trang sản phẩm.
- Added to Cart: khách hàng thêm sản phẩm vào giỏ hàng.
- Checkout Started: khách hàng bắt đầu thanh toán.
- Placed Order: khách hàng đã đặt hàng thành công.
- Ordered [tên sản phẩm]: chi tiết sản phẩm đã đặt trong đơn.
- Fulfilled Order: đơn hàng đã được xử lý/giao xong.
- Received email: khách hàng đã nhận email từ chiến dịch/flow đang chạy.
Nhờ dữ liệu sự kiện chi tiết và theo thời gian thực này, Seller có thể xây dựng các Flow tự động (nhắc giỏ hàng bỏ quên, cảm ơn sau khi giao hàng…) và phân Segment khách hàng chính xác dựa trên hành vi thực tế thay vì chỉ dựa trên thông tin tĩnh.
Note: Nếu ngắt kết nối OAuth hoặc thu hồi quyền trên Klaviyo, việc đồng bộ sẽ dừng lại. Seller cần thực hiện lại các bước trên để kết nối lại.