Skip to main content
Tích hợp Klaviyo giúp bạn tạo hoặc cập nhật Profile từ dữ liệu Contact ngay trong Flow. Action dùng email để nhận diện Profile, có thể thêm Profile vào List và đồng bộ Title, Organization cùng các Custom Properties. Ví dụ: sau khi khách để lại email để nhận tư vấn sản phẩm, ChatbotX gửi thông tin liên hệ và nhu cầu của khách sang Klaviyo để bạn phân nhóm Profile và cá nhân hóa nội dung.

​
Chuẩn bị Private API Key

Bạn cần tạo Private API Key trong Klaviyo trước khi kết nối. Không dùng Public API Key / site ID, vì loại khóa này không cấp quyền tạo hoặc cập nhật Profile.
1

Đăng nhập Klaviyo

Đăng nhập tài khoản Klaviyo mà bạn muốn kết nối với ChatbotX.
2

Mở API keys

Mở Settings, chọn tab General, sau đó chọn API keys trong menu bên trái.
3

Tạo Private API Key

Trong phần Private API Keys, nhấn Create Private API Key và nhập tên giúp bạn nhận biết khóa.
4

Cấp quyền cần thiết

Cấp quyền đọc và ghi cho Profiles cùng Lists. Bạn cũng có thể dùng Full Access, nhưng chỉ nên cấp các quyền ChatbotX cần sử dụng.
5

Sao chép Private API Key

Hoàn tất tạo khóa, sao chép giá trị và lưu ở nơi an toàn. Klaviyo không cho xem lại toàn bộ Private API Key sau khi đóng cửa sổ tạo khóa.Xem hướng dẫn chính thức tại Obtain API credentials.
Create Klaviyo Private Api Key
Private API Key có thể đọc hoặc thay đổi dữ liệu theo các quyền đã cấp. Không chia sẻ khóa trong email, tin nhắn, ảnh chụp công khai hoặc tài liệu dành cho khách hàng.

​
Kết nối Klaviyo với ChatbotX

1

Mở Settings

Trong workspace ChatbotX, chọn Settings từ menu bên trái.
2

Chọn Integrations

Chọn tab Integrations, sau đó mở mục Klaviyo.
3

Mở cửa sổ kết nối

Nhấn Connect để mở cửa sổ Connect Klaviyo.
4

Nhập API Key

Dán Private API Key vào trường API Key, sau đó nhấn Confirm.
Connect Klaviyo In Chatbotx Integrations
Khi khóa hợp lệ và có đủ quyền, ChatbotX lưu kết nối rồi tải các Lists từ Klaviyo để sử dụng trong Flow.

​
Thêm Klaviyo vào Flow

Hãy đặt action Klaviyo sau bước thu thập email và các dữ liệu bạn muốn đồng bộ. Email phải đúng định dạng để Klaviyo tạo hoặc xác định Profile.
1

Mở Flow cần chỉnh sửa

Chọn Flows, sau đó mở Flow mà bạn muốn dùng để thu thập Contact.
2

Thêm Actions

Trong Send Message node, nhấn + Create rồi chọn Actions.
3

Chọn Email Actions

Mở Email Actions và chọn Add Contact to Klaviyo.
Select Add Contact To Klaviyo Action
4

Mở phần cấu hình

Nhấn Edit trên action vừa thêm để chọn List và đồng bộ dữ liệu Profile.

​
Cấu hình Add Contact to Klaviyo

Thiết lập các trường trong cửa sổ Add Contact to Klaviyo, sau đó nhấn Save.
Configure Add Contact To Klaviyo
Action hiển thị hai kết quả để bạn tiếp tục Flow:
  • Success: Klaviyo đã xử lý yêu cầu tạo hoặc cập nhật Profile và thêm vào List nếu bạn đã chọn List.
  • Error: Yêu cầu thất bại do email, API Key, quyền truy cập, List hoặc dữ liệu đồng bộ không hợp lệ.
Bạn có thể nối mỗi kết quả với một node khác để gửi xác nhận hoặc xử lý lỗi.
Add Contact to Klaviyo không đăng ký Profile nhận Email Marketing và không thay đổi trạng thái consent. Chỉ thêm Profile vào List khi khách đã đồng ý nhận nội dung phù hợp.

​
Đồng bộ Custom Properties

Custom Properties giúp bạn lưu dữ liệu riêng của từng Profile để phân nhóm, cá nhân hóa Template hoặc đặt điều kiện cho Flow trong Klaviyo. Mỗi hàng đồng bộ gồm hai phần:
  • Bên trái: trường Contact trong ChatbotX chứa dữ liệu cần gửi.
  • Bên phải: property key mà Klaviyo dùng để lưu dữ liệu trên Profile.
Hãy dùng property key ngắn, dễ nhận biết và nhất quán. Nếu bạn đổi cách viết property key, Klaviyo có thể lưu dữ liệu vào một thuộc tính mới thay vì cập nhật thuộc tính cũ.

​
Ví dụ thu thập khách cần tư vấn sản phẩm

Một cửa hàng thời trang muốn lưu khách quan tâm đến sản phẩm và phân nhóm theo nhu cầu.
1

Thu thập thông tin khách

Dùng Get User Data để hỏi email, chức danh, công ty và loại sản phẩm khách quan tâm.
2

Thêm Profile vào Klaviyo

Chạy Add Contact to Klaviyo, chọn trường Email và List phù hợp nếu khách đã đồng ý nhận thông tin.
3

Đồng bộ dữ liệu bổ sung

Chọn Title Field, Organization Field và đồng bộ nhu cầu sản phẩm vào Custom Property.
4

Xử lý kết quả

Nối Success với tin nhắn xác nhận. Nối Error với nhánh yêu cầu khách kiểm tra thông tin hoặc chuyển cho nhân viên.

​
Kiểm tra hoạt động của tích hợp

Trước khi Publish Flow, hãy chạy thử bằng một địa chỉ email mà bạn có thể kiểm tra.
  • Mở Audience > Profiles trong Klaviyo và xác nhận Profile xuất hiện.
  • Kiểm tra email, Title, Organization và Custom Properties đã nhận đúng dữ liệu.
  • Nếu đã chọn List, kiểm tra Profile xuất hiện trong đúng List.
  • Kiểm tra Flow đi qua nhánh Success khi email hợp lệ.
  • Thử một email sai định dạng để kiểm tra nhánh Error.
  • Nếu Lists không hiển thị, kiểm tra quyền Profiles và Lists của Private API Key rồi kết nối lại.
Xóa hoặc thu hồi Private API Key sẽ làm kết nối hiện tại ngừng hoạt động. Hãy tạo khóa mới và cập nhật kết nối trong ChatbotX trước khi chạy Flow lại.