# Integrasi Klaviyo Integrasi Klaviyo memungkinkan Anda untuk menghubungkan chatbot Botpress Anda dengan Klaviyo, platform otomasi pemasaran dan data pelanggan terkemuka. Dengan integrasi ini, chatbot Anda dapat membuat prospek, memperbarui informasi pelanggan, dan berlangganan profil ke pemasaran SMS dan Email. ## Tindakan yang Tersedia ### Buat Profil Membuat profil pelanggan baru di Klaviyo. Tindakan ini memungkinkan Anda untuk menambahkan kontak baru ke database Klaviyo Anda dengan informasi profil yang komprehensif. **Bidang yang diperlukan:** - Baik **alamat email** ATAU **nomor telepon** (dalam format E.164 seperti +15005550006) **Bidang Opsional:** - Nama depan dan nama belakang - **Organisasi** dan **jabatan pekerjaan** - **Lokasi** (dalam format IETF BCP 47 seperti en-US, fr-FR) - **Lokasi** (detail alamat termasuk garis alamat, kota, negara, wilayah, kode pos) - **Properti khusus** (pasangan kunci-nilai untuk menyimpan data profil tambahan) **Keluaran:** Mengembalikan profil yang dibuat dengan ID Klaviyo yang unik. ### Perbarui Profil Memperbarui profil pelanggan yang sudah ada di Klaviyo menggunakan ID unik profil. Tindakan ini memungkinkan Anda untuk memodifikasi informasi profil apa pun setelah pembuatan. **Bidang yang diperlukan:** - ID Profil** (pengenal unik Klaviyo dari profil yang akan diperbarui) **Bidang Opsional:** **Bidang Pilihan:** - Alamat email** (memperbarui email profil) - **Nomor telepon** (dalam format E.164) - Nama depan** dan **nama belakang** - **Organisasi** dan **jabatan pekerjaan** - **Lokasi** (dalam format IETF BCP 47) - **Lokasi** (informasi alamat lengkap) - **Properti khusus** (pasangan kunci-nilai) **Keluaran:** Mengembalikan profil yang telah diperbarui dengan semua informasi terkini. ### Dapatkan Profil Mengambil profil pelanggan tertentu dari Klaviyo menggunakan ID uniknya. Tindakan ini berguna untuk mencari informasi pelanggan individu. Bidang yang diperlukan:** Bidang yang diperlukan:** - ID Profil** (pengenal unik Klaviyo dari profil yang akan diambil) **Keluaran:** Mengembalikan informasi profil lengkap termasuk ID, email, telepon, nama, dan semua data tersimpan lainnya. ### Dapatkan Profil Cari dan ambil beberapa profil pelanggan dari Klaviyo menggunakan filter dan opsi penyortiran. Tindakan ini sangat cocok untuk menemukan kelompok pelanggan berdasarkan kriteria tertentu. **Opsi Filter:** - **Filter Field:** Pilih dari `id`, `email`, `nomor_telepon`, `external_id`, `dibuat`, atau `diperbaharui` - Operator Filter:** Gunakan operator perbandingan seperti `sama dengan`, `berisi`, `lebih besar dari`, `lebih kecil dari`, `dimulai dengan`, `berakhir dengan` - Nilai Filter:** Nilai yang akan dicari (mendukung string dan tanggal) **Penomoran Halaman & Penyortiran:** - Ukuran Halaman:** Jumlah profil yang akan dikembalikan (1-100, default: 20) - ** Urutkan:** Urutkan berdasarkan bidang apa pun dengan urutan menurun opsional (awalan dengan `-`) **Contoh Kasus Penggunaan:** - Menemukan semua profil yang dibuat setelah tanggal tertentu - Mencari profil dengan alamat email yang mengandung domain - Dapatkan profil yang diurutkan berdasarkan tanggal pembuatan (yang terbaru terlebih dahulu) **Keluaran:** Mengembalikan larik profil yang sesuai dengan kriteria Anda. ### Berlangganan Profil Berlangganan beberapa profil pelanggan ke email dan/atau daftar pemasaran SMS di Klaviyo. Tindakan ini memproses langganan secara asinkron dan dapat menangani hingga 1.000 profil sekaligus. **Bidang yang diperlukan:** - Langganan Profil:** Larik profil dengan informasi persetujuan - ID Profil** (atau email/telepon untuk identifikasi) - Persetujuan Email:** Boolean yang menunjukkan persetujuan untuk pemasaran email - Persetujuan SMS:** Boolean yang menunjukkan persetujuan untuk pemasaran SMS **Bidang Opsional:** - **List ID:** Daftar Klaviyo khusus untuk menambahkan profil berlangganan - **Impor Historis:** Boolean untuk mengimpor profil historis Catatan Penting:** Catatan Penting:** - Maksimum 1.000 profil per permintaan - Setidaknya diperlukan satu profil - Bendera persetujuan menentukan saluran pemasaran mana yang akan dilanggan oleh profil tersebut - Operasi diproses secara asinkron oleh Klaviyo **Keluaran:** Mengembalikan boolean sukses yang menunjukkan apakah pekerjaan berlangganan berhasil dijadwalkan.
