# Klaviyo Entegrasyonu Klaviyo entegrasyonu, Botpress chatbotunuzu önde gelen bir müşteri verileri ve pazarlama otomasyon platformu olan Klaviyo'ya bağlamanıza olanak tanır. Bu entegrasyon sayesinde sohbet robotunuz potansiyel müşteriler oluşturabilir, müşteri bilgilerini güncelleyebilir ve profilleri SMS ve E-posta pazarlamasına abone edebilir. ## Mevcut Eylemler ### Profil Oluştur Klaviyo'da yeni bir müşteri profili oluşturun. Bu işlem, Klaviyo veritabanınıza kapsamlı profil bilgileri ile yeni kişiler eklemenizi sağlar. **Gerekli Alanlar:** - Ya **e-posta adresi** YA DA **telefon numarası** (+15005550006 gibi E.164 formatında) **Opsiyonel Alanlar:** - **İlk ad** ve **soyad** - Organizasyon** ve **iş unvanı** - **Locale** (en-US, fr-FR gibi IETF BCP 47 formatında) - Konum** (adres satırları, şehir, ülke, bölge, posta kodu dahil adres ayrıntıları) - **Özel özellikler** (ek profil verilerini saklamak için anahtar-değer çiftleri) **Çıktı:** Oluşturulan profili benzersiz Klaviyo ID'si ile birlikte döndürür. ### Profili Güncelle Klaviyo'daki mevcut bir müşteri profilini, profilin benzersiz kimliğini kullanarak güncelleyin. Bu eylem, oluşturulduktan sonra herhangi bir profil bilgisini değiştirmenize olanak tanır. **Gerekli Alanlar:** - **Profil ID** (güncellenecek profilin benzersiz Klaviyo tanımlayıcısı) **Opsiyonel Alanlar:** - E-posta adresi** (profilin e-postasını günceller) - Telefon numarası** (E.164 formatında) - **İlk ad** ve **soyad** - Organizasyon** ve **iş unvanı** - **Locale** (IETF BCP 47 formatında) - Konum** (tam adres bilgileri) - **Özel özellikler** (anahtar-değer çiftleri) **Çıktı:** Güncellenmiş profili tüm güncel bilgilerle birlikte döndürür. ### Profil Al Benzersiz kimliğini kullanarak Klaviyo'dan belirli bir müşteri profilini alın. Bu eylem, bireysel müşteri bilgilerini aramak için kullanışlıdır. **Gerekli Alanlar:** - **Profil ID** (alınacak profilin benzersiz Klaviyo tanımlayıcısı) **Çıktı:** Kimlik, e-posta, telefon, ad ve depolanan diğer tüm veriler dahil olmak üzere profil bilgilerinin tamamını döndürür. ### Profilleri Al Filtreleri ve sıralama seçeneklerini kullanarak Klaviyo'dan birden fazla müşteri profilini arayın ve alın. Bu eylem, belirli kriterlere göre müşteri gruplarını bulmak için mükemmeldir. **Filtre Seçenekleri:** - Filtre Alanı:** `id`, `email`, `phone_number`, `external_id`, `created` veya `updated` arasından seçim yapın - Filtre Operatörü:** `equals`, `contains`, `greater-than`, `less-than`, `starts-with`, `ends-with` gibi karşılaştırma operatörlerini kullanın - Filtre Değeri:** Aranacak değer (dizeleri ve tarihleri destekler) **Paginasyon ve Sıralama:** - Sayfa Boyutu:** Döndürülecek profil sayısı (1-100, varsayılan: 20) - **Sırala:** İsteğe bağlı azalan sırayla herhangi bir alana göre sırala (önek `-` ile) **Örnek Kullanım Örnekleri:** - Belirli bir tarihten sonra oluşturulan tüm profilleri bulun - Bir etki alanı içeren e-posta adreslerine sahip profilleri arayın - Profilleri oluşturulma tarihine göre sıralayın (önce en yeni) **Çıktı:** Kriterlerinizle eşleşen profillerden oluşan bir dizi döndürür. ### Abone Profilleri Klaviyo'da birden fazla müşteri profilini e-posta ve/veya SMS pazarlama listelerine abone yapın. Bu eylem abonelikleri eşzamansız olarak işler ve aynı anda en fazla 1.000 profil işleyebilir. **Gerekli Alanlar:** - Profil Abonelikleri:** Onay bilgilerine sahip profil dizisi - **Profil Kimliği** (veya kimlik tespiti için e-posta/telefon) - **E-posta Onayı:** E-posta pazarlaması için onayı gösteren boolean - SMS Onayı:** SMS pazarlaması için onayı gösteren boolean **Opsiyonel Alanlar:** - Liste Kimliği:** Abone olunan profillerin ekleneceği belirli Klaviyo listesi - Tarihsel İçe Aktarma:** Geçmiş profilleri içe aktarmak için Boolean **Önemli Notlar:** - Talep başına maksimum 1.000 profil - En az bir profil gereklidir - Onay bayrakları profilin hangi pazarlama kanallarına abone olacağını belirler - İşlem Klaviyo tarafından asenkron olarak işlenir **Çıktı:** Abonelik işinin başarıyla zamanlanıp zamanlanmadığını gösteren bir başarı booleanı döndürür.
