Klaviyo

  # Tích hợp Klaviyo Tích hợp Klaviyo cho phép bạn kết nối Botpress chatbot với Klaviyo, một nền tảng tự động hóa tiếp thị và dữ liệu khách hàng hàng đầu. Với tích hợp này, chatbot của bạn có thể tạo khách hàng tiềm năng, cập nhật thông tin khách hàng và đăng ký hồ sơ để tiếp thị qua SMS và Email. ## Hành động khả dụng ### Tạo hồ sơ Tạo hồ sơ khách hàng mới trong Klaviyo. Hành động này cho phép bạn thêm liên hệ mới vào cơ sở dữ liệu Klaviyo của mình với thông tin hồ sơ toàn diện. **Trường bắt buộc:** - **Địa chỉ email** HOẶC **Số điện thoại** (theo định dạng E.164 như +15005550006) **Trường tùy chọn:** - **Tên** và **Họ** - **Tổ chức** và **Chức danh** - **Ngôn ngữ** (theo định dạng IETF BCP 47 như en-US, fr-FR) - **Vị trí** (chi tiết địa chỉ bao gồm dòng địa chỉ, thành phố, quốc gia, khu vực, mã ZIP) - **Thuộc tính tùy chỉnh** (cặp khóa-giá trị để lưu trữ dữ liệu hồ sơ bổ sung) **Đầu ra:** Trả về hồ sơ đã tạo với ID Klaviyo duy nhất. ### Cập nhật hồ sơ Cập nhật hồ sơ khách hàng hiện có trong Klaviyo bằng ID duy nhất của hồ sơ. Hành động này cho phép bạn sửa đổi bất kỳ thông tin hồ sơ nào sau khi tạo. **Các trường bắt buộc:** - **ID hồ sơ** (mã định danh Klaviyo duy nhất của hồ sơ cần cập nhật) **Các trường tùy chọn:** - **Địa chỉ email** (cập nhật email của hồ sơ) - **Số điện thoại** (theo định dạng E.164) - **Tên** và **họ** - **Tổ chức** và **chức danh** - **Vị trí** (theo định dạng IETF BCP 47) - **Vị trí** (thông tin địa chỉ đầy đủ) - **Thuộc tính tùy chỉnh** (cặp khóa-giá trị) **Đầu ra:** Trả về hồ sơ đã cập nhật với tất cả thông tin hiện tại. ### Lấy hồ sơ Truy xuất hồ sơ khách hàng cụ thể từ Klaviyo bằng ID duy nhất của hồ sơ đó. Hành động này hữu ích để tra cứu thông tin từng khách hàng. **Các trường bắt buộc:** - **ID hồ sơ** (mã định danh Klaviyo duy nhất của hồ sơ cần truy xuất) **Đầu ra:** Trả về thông tin hồ sơ đầy đủ bao gồm ID, email, số điện thoại, tên và tất cả dữ liệu được lưu trữ khác. ### Lấy hồ sơ Tìm kiếm và truy xuất nhiều hồ sơ khách hàng từ Klaviyo bằng bộ lọc và tùy chọn sắp xếp. Thao tác này hoàn hảo để tìm nhóm khách hàng dựa trên các tiêu chí cụ thể. **Tùy chọn bộ lọc:** - **Trường bộ lọc:** Chọn từ `id`, `email`, `phone_number`, `external_id`, `created` hoặc `updated` - **Toán tử bộ lọc:** Sử dụng các toán tử so sánh như `equals`, `contains`, `greater-than`, `less-than`, `starts-with`, `ends-with` - **Giá trị bộ lọc:** Giá trị cần tìm kiếm (hỗ trợ chuỗi và ngày) **Phân trang & Sắp xếp:** - **Kích thước trang:** Số lượng hồ sơ cần trả về (1-100, mặc định: 20) - **Sắp xếp:** Sắp xếp theo bất kỳ trường nào với thứ tự giảm dần tùy chọn (thêm tiền tố `-`) **Các trường hợp sử dụng ví dụ:** - Tìm tất cả hồ sơ được tạo sau một ngày cụ thể - Tìm kiếm hồ sơ có địa chỉ email chứa tên miền - Lấy hồ sơ được sắp xếp theo ngày tạo (mới nhất trước) **Đầu ra:** Trả về một mảng hồ sơ phù hợp với tiêu chí của bạn. ### Đăng ký hồ sơ Đăng ký nhiều hồ sơ khách hàng vào danh sách tiếp thị qua email và/hoặc SMS trong Klaviyo. Hành động này xử lý đăng ký không đồng bộ và có thể xử lý tối đa 1.000 hồ sơ cùng lúc. **Trường bắt buộc:** - **Đăng ký hồ sơ:** Mảng hồ sơ có thông tin đồng ý - **ID hồ sơ** (hoặc email/số điện thoại để nhận dạng) - **Đồng ý qua email:** Boolean biểu thị sự đồng ý cho tiếp thị qua email - **Đồng ý qua SMS:** Boolean biểu thị sự đồng ý cho tiếp thị qua SMS **Trường tùy chọn:** - **ID danh sách:** Danh sách Klaviyo cụ thể để thêm hồ sơ đã đăng ký vào - **Nhập lịch sử:** Boolean để nhập hồ sơ lịch sử **Lưu ý quan trọng:** - Tối đa 1.000 hồ sơ cho mỗi yêu cầu - Cần ít nhất một hồ sơ - Cờ đồng ý xác định hồ sơ sẽ được đăng ký vào kênh tiếp thị nào - Hoạt động này được Klaviyo xử lý không đồng bộ **Đầu ra:** Trả về giá trị boolean thành công cho biết tác vụ đăng ký đã được lên lịch thành công hay chưa.