# Integracja z Klaviyo Integracja z Klaviyo umożliwia połączenie chatbota Botpress z Klaviyo, wiodącą platformą automatyzacji danych klientów i marketingu. Dzięki tej integracji chatbot może tworzyć leady, aktualizować informacje o klientach i subskrybować profile do marketingu SMS i e-mail. ## Dostępne akcje ### Utwórz profil Utwórz nowy profil klienta w Klaviyo. Ta czynność umożliwia dodawanie nowych kontaktów do bazy danych Klaviyo wraz z kompleksowymi informacjami profilowymi. **Wymagane pola:**. - **adres e-mail** LUB **numer telefonu** (w formacie E.164, takim jak +15005550006) **Pola opcjonalne:** - **imię** i **nazwisko** - **Organizacja** i **tytuł stanowiska** - **Locale** (w formacie IETF BCP 47, np. en-US, fr-FR) - **Lokalizacja** (szczegóły adresu, w tym linie adresowe, miasto, kraj, region, kod pocztowy) - **Właściwości niestandardowe** (pary klucz-wartość do przechowywania dodatkowych danych profilu) **Wyjście:** Zwraca utworzony profil z jego unikalnym identyfikatorem Klaviyo ID. ### Zaktualizuj profil Aktualizuje istniejący profil klienta w Klaviyo przy użyciu unikalnego ID profilu. Ta czynność umożliwia modyfikację wszelkich informacji o profilu po jego utworzeniu. **Wymagane pola:**. - **Profile ID** (unikalny identyfikator Klaviyo profilu do aktualizacji) **Pola opcjonalne:** - **Adres e-mail** (aktualizuje adres e-mail profilu) - **Numer telefonu** (w formacie E.164) - **imię** i **nazwisko** - **Organizacja** i **tytuł stanowiska** - **Locale** (w formacie IETF BCP 47) - Lokalizacja** (pełne informacje adresowe) - **Właściwości niestandardowe** (pary klucz-wartość) **Wyjście:** Zwraca zaktualizowany profil ze wszystkimi aktualnymi informacjami. ### Get Profile Pobiera określony profil klienta z Klaviyo przy użyciu jego unikalnego identyfikatora. Ta akcja jest przydatna do wyszukiwania informacji o poszczególnych klientach. **Wymagane pola:**. - **Profile ID** (unikalny identyfikator Klaviyo profilu do pobrania) **Dane wyjściowe:** Zwraca pełne informacje o profilu, w tym identyfikator, adres e-mail, telefon, imię i nazwisko oraz wszystkie inne przechowywane dane. ### Get Profiles Wyszukiwanie i pobieranie wielu profili klientów z Klaviyo przy użyciu filtrów i opcji sortowania. Ta akcja jest idealna do znajdowania grup klientów na podstawie określonych kryteriów. **Opcje filtrów:** - Pole filtra:** Wybierz spośród `id`, `email`, `phone_number`, `external_id`, `created` lub `updated`. - Operator filtra:** Użyj operatorów porównania takich jak `equals`, `contains`, `greater-than`, `less-than`, `starts-with`, `ends-with`. - **Filter Value:** Wartość do wyszukania (obsługuje ciągi znaków i daty) **Paginacja i sortowanie:** - Rozmiar strony:** Liczba profili do zwrócenia (1-100, domyślnie: 20) - Sortowanie:** Sortuj według dowolnego pola z opcjonalnym porządkiem malejącym (prefiks z `-`) **Przykładowe przypadki użycia:** - Znajdź wszystkie profile utworzone po określonej dacie - Wyszukiwanie profili z adresami e-mail zawierającymi domenę - Pobieranie profili posortowanych według daty utworzenia (najpierw najnowsze) **Wyjście:** Zwraca tablicę profili pasujących do kryteriów. ### Subskrybuj profile Subskrybuj wiele profili klientów do list marketingowych e-mail i/lub SMS w Klaviyo. Ta akcja przetwarza subskrypcje asynchronicznie i może obsługiwać do 1000 profili jednocześnie. **Wymagane pola:**. - **Subskrypcje profili:** Tablica profili z informacjami o zgodzie - **Profile ID** (lub e-mail/telefon do identyfikacji) - Zgoda e-mail:** Wartość logiczna wskazująca zgodę na marketing e-mailowy - Zgoda SMS:** Wartość logiczna wskazująca zgodę na marketing SMS **Pola opcjonalne:** - Identyfikator listy:** Określona lista Klaviyo, do której mają zostać dodane subskrybowane profile. - Import historyczny:** Boolean do importowania profili historycznych **Ważne uwagi:** - Maksymalnie 1000 profili na żądanie - Wymagany jest co najmniej jeden profil - Flagi zgody określają, które kanały marketingowe będą subskrybowane przez profil. - Operacja jest przetwarzana asynchronicznie przez Klaviyo. **Wyjście:** Zwraca wartość logiczną sukcesu wskazującą, czy zadanie subskrypcji zostało zaplanowane pomyślnie.
