Klaviyo — jak używać: integracje i ceny

Klaviyo API pozwala wymieniać dane między Klaviyo a innymi systemami za pomocą żądań HTTP. Platforma udostępnia 2 główne zestawy HTTP API, z których każdy ma inne zastosowanie.¹
W tym poradniku omawiamy kampanie, newslettery, automatyzacje, szablony oraz połączenia ze sklepem i WordPressem. Wyjaśniamy też, kiedy korzystać z API. Katalog Klaviyo zawiera ponad 350 gotowych integracji².

Czym jest Klaviyo API i do czego służy?

Klaviyo API to interfejs HTTP, przez który Klaviyo wymienia dane z innym systemem. Integracja może pracować na profilach, czyli rekordach osób, oraz zdarzeniach opisujących ich działania. Endpoint jest adresem API przeznaczonym do obsługi określonego rodzaju żądania. Profil można rozpoznać po jednym z 3 typów identyfikatorów: adresie e-mail, numerze telefonu lub identyfikatorze zewnętrznym³.

Prywatny klucz API określa uprawnienia integracji.

Jakie zasoby i endpointy udostępnia Klaviyo API?

Klaviyo rozdziela endpointy /client i /api według sposobu dostępu do danych. Klucz publiczny trafia do endpointu /client jako parametr zapytania, czyli wartość dołączona do adresu żądania.⁴
Endpointy /client pozwalają tworzyć określone typy obiektów, lecz nie zwracają potencjalnie wrażliwych danych. Dostęp do takich danych wymaga prywatnych endpointów /api.⁴ Endpointy Client API z kluczem publicznym obsługują 2 metody HTTP: POST i GET; wybór metody zależy od endpointu⁵.

Jak tworzyć profile, aktualizować je i przesyłać zdarzenia przez API?

Operacje na profilach i przesyłane zdarzenia muszą dotyczyć właściwej osoby. Klaviyo generuje klucz główny profilu, który jednoznacznie identyfikuje rekord.⁶ Do powiązania zdarzenia z profilem potrzeba co najmniej 1 identyfikatora osoby⁷.

• Utworzenie profilu zapisuje dane osoby w Klaviyo. Przygotuj dane i przekaż je do operacji tworzenia profilu.
• Wyszukanie profilu umożliwia endpoint Get Profiles. Wyniki można filtrować m.in. po identyfikatorze, adresie e-mail, numerze telefonu oraz dacie utworzenia lub aktualizacji.⁶
• Aktualizacja profilu zmienia dane wskazanego rekordu. Zanim prześlesz zmiany, ustal, który profil należy zaktualizować.
• Przesłanie zdarzenia zapisuje informację o działaniu osoby. Zdarzenie trzeba powiązać z odpowiednim profilem.

Zdarzenie opisuje działanie osoby wskazanej w profilu. Do jego utworzenia potrzebne są dane 2 obiektów: metryki z nazwą i profilu z co najmniej jednym identyfikatorem⁸.

Jakie wersje Klaviyo API są dostępne i czym się różnią?

Starsze API v1 i v2 wycofano po 30 czerwca 2024 r. Od 1 lipca 2024 r. wywołania tych endpointów zwracają 410 Gone.¹
W nowszym interfejsie wersja API określa używany interfejs, a zakres uprawnień klucza decyduje o operacjach dostępnych dla integracji⁹.

Endpoint i uprawnienia dobierz do czynności, którą ma wykonać integracja. Odczyt profilu wymaga zakresu profiles:read. Do utworzenia profilu potrzebny jest osobny zakres profiles:write³.

Jak korzystać z Klaviyo API w praktyce?

Praca z Klaviyo API polega na wysłaniu żądania, odczytaniu odpowiedzi i zapisaniu wyniku w systemie integracji. Prywatnego klucza API nie publikuj ani nie używaj do wywoływania REST API bezpośrednio z zasobów po stronie klienta.¹
Żądania wymagające prywatnego klucza wysyłaj z serwera, poza kodem dostępnym w przeglądarce. Brak klucza lub jego nieprawidłowa wartość mogą skutkować odpowiedzią HTTP 401¹⁰.

Jak wysłać żądanie i odczytać odpowiedź API?

Odpowiedź endpointu pokazuje, co stało się z przesłanym żądaniem. W przypadku endpointu Create Profile pomyślne utworzenie profilu potwierdza odpowiedź HTTP 201¹¹.

• Żądanie API kieruje operację do wybranego endpointu. Przygotuj je na serwerze i dobierz metodę do zamierzonej czynności.
• Uwierzytelnienie daje dostęp do endpointu. Dołącz je w sposób wymagany przez wybrany endpoint.
• Odpowiedź API pokazuje rezultat operacji. Odczytaj status HTTP i treść odpowiedzi; samo wysłanie żądania nie oznacza sukcesu.
• Dane odpowiedzi można przekazać do dalszej obsługi. Najpierw upewnij się, że operacja się powiodła.

Od wyniku żądania zależy, czy integracja zapisze dane, ponowi operację, czy zgłosi błąd. HTTP 429 oznacza przekroczenie limitu i możliwość późniejszego ponowienia żądania. HTTP 400 wskazuje natomiast dane, które wymagają poprawy¹².

Jak zarządzać listami i subskrypcjami przez API?

Przy operacjach na liście mailingowej odróżniaj obecność kontaktu na liście od jego zgody na komunikację. W trybie double opt-in subskrypcja wymaga 2 działań użytkownika: zgłoszenia zapisu i potwierdzenia go w otrzymanej wiadomości¹³.

• Lista mailingowa określa zbiór kontaktów objętych operacją. Przed zmianą składu kontaktów wskaż właściwą listę.
• Profil kontaktu wskazuje osobę, której dotyczą dane. Zidentyfikuj ją przed dodaniem do listy lub zmianą danych.
• Subskrypcja określa status zgody na dany rodzaj komunikacji. Zmień go właściwą operacją; samo dodanie kontaktu do listy nie oznacza zgody.
• Odpowiedź API informuje o wyniku operacji. Na jej podstawie ustal, czy system przyjął zmianę.

Członkostwo w liście i status subskrypcji kontroluj osobno w logice integracji. Zgoda na marketing e-mailowy ma 3 możliwe statusy: SUBSCRIBED, NEVER_SUBSCRIBED i UNSUBSCRIBED¹⁴.

Jak rozpoznać i zdiagnozować błędy API?

Gdy żądanie się nie powiedzie, zacznij od statusu HTTP i treści błędu. HTTP 400 wskazuje brak wymaganego parametru lub jego nieprawidłową wartość. Szczegóły znajdziesz w treści błędu¹².

• Status HTTP wskazuje rezultat żądania. Zapisz go razem z nazwą operacji, by ustalić, które żądanie się nie powiodło.
• Treść odpowiedzi zawiera szczegóły błędu. Porównaj komunikat z danymi przesłanymi w żądaniu.
• Parametry żądania określają dane przekazane do endpointu. Sprawdź identyfikator profilu, uprawnienia i strukturę danych względem wymagań endpointu.
• Dziennik integracji pomaga prześledzić błąd. Zapisuj w nim czas, operację i wynik, ale nie prywatny klucz.

Diagnoza powinna wskazywać konkretne żądanie. Powinna też określać element, który wymaga poprawy¹².

Jak sprawdzić, czy żądania przekraczają limity API?

Przy serii żądań obserwuj odpowiedzi, by odróżnić limit wywołań od błędu danych. Endpoint Create Event ma opublikowane limity 350 żądań na sekundę i 3500 żądań na minutę⁸.

• Odpowiedzi API pokazują wyniki kolejnych żądań. Rejestruj je w integracji.
• Odrzucone żądania mogą wskazywać powtarzający się problem. Grupuj je według endpointu i czasu wystąpienia.
• Komunikaty o ograniczeniu wywołań pomagają zaplanować dalsze kroki. Odczytaj je przed ponowieniem żądania.
• Harmonogram ponowień steruje ponownym wysyłaniem żądań. Dostosuj go do odpowiedzi, zamiast od razu ponawiać odrzucone żądanie.

Monitoruj odpowiedzi bez ujawniania klucza API. Po odpowiedzi HTTP 429 odczekaj liczbę sekund wskazaną w nagłówku Retry-After; nie jest ona stała¹².

Materiały wideo o Klaviyo API: od czego zacząć?

Naukę obsługi Klaviyo API możesz zacząć od nagrania pokazującego konfigurację API credentials, czyli danych uwierzytelniających integrację, i wysłanie żądania. Na YouTube wyszukaj hasła „Get started with Klaviyo” oraz „API credentials”. Wybieraj materiały, które pokazują wybór endpointu, przygotowanie żądania i odczyt odpowiedzi.
Zwróć też uwagę na nagłówek revision: data wersji API ma format YYYY-MM-DD, opcjonalnie z przyrostkiem, np. .pre⁸.

Wideo pozwala prześledzić kolejność czynności. Pokazana w nim odpowiedź API pomaga rozpoznać wynik operacji. Szczegóły żądania porównaj z dokumentacją używanego endpointu.

Klaviyo jako platforma marketingowa: integracje, kanały i obsługa firm

Klaviyo łączy dane klientów z planowaniem komunikacji marketingowej. Wybór sposobu wdrożenia zależy od źródła danych, kanału komunikacji i skali potrzeb. Katalog ponad 350 gotowych integracji daje alternatywę dla połączenia przez API¹⁵.

Jakie integracje oferuje Klaviyo, w tym ze sklepami i WordPressem?

Według Klaviyo z platformą zintegrowało się ponad 300 podmiotów¹⁶. To inna miara niż liczba gotowych integracji. Nie należy utożsamiać tych wartości¹⁷.

Integracje Klaviyo mogą przesyłać dane z systemów sprzedaży, zarządzania zapasami i aplikacji do planowania.¹⁶
Jeśli łączysz sklep, w tym Shopify, lub stronę na WordPressie, ustal zakres przesyłanych danych. Określ, które z nich mają zasilać profile i działania marketingowe.

Tabela pokazuje 350 gotowych integracji i 300 podmiotów zintegrowanych z Klaviyo jako odrębne miary. Pierwsza dotyczy połączeń, a druga podmiotów, które je utworzyły.

Dane w tabeli: 15,16,17,18

Jakie kanały marketingowe obsługuje Klaviyo?

Klaviyo można wykorzystać do kampanii e-mailowych i komunikacji SMS. Wybierając kanał, oddziel sposób dostarczania danych do platformy od sposobu kontaktu z odbiorcą. Segmentacja dzieli kontakty według ustalonych kryteriów; przed kampanią określ odbiorców, treść i status zgody dla wybranego kanału.
Zgoda na marketing e-mailowy ma 3 statusy: SUBSCRIBED, NEVER_SUBSCRIBED i UNSUBSCRIBED¹⁴. Szablon e-mail porządkuje wygląd wiadomości, a automatyzacja określa warunek uruchomienia komunikacji.

Jak Klaviyo wspiera większe firmy?

W większej firmie Klaviyo może wejść w obieg danych między zespołami, które korzystają z informacji o kontaktach i wynikach działań. Dane pobrane z platformy można wykorzystać w pulpitach, synchronizować z innymi systemami i analizować pod kątem wyników marketingowych.¹⁶
Planując integrację, uwzględnij limit endpointu Create Event: 350 żądań na sekundę i 3500 na minutę⁸.

• Pulpit wyników zestawia dane, których zespół potrzebuje do obserwowania działań marketingowych.
• Synchronizacja systemów przekazuje dane do narzędzi używanych w innych procesach firmy.
• Analiza marketingowa pozwala odnieść pobrane dane do pytań o wyniki kampanii i automatyzacji.

Obieg danych planuj według potrzeb zespołów. Punktem wyjścia jest to, kto korzysta z informacji o klientach i kampaniach.

W jakich językach można korzystać z Klaviyo?

Przy pracy w Klaviyo rozdziel język treści dla odbiorców od języka interfejsu używanego przez zespół. Gdy przygotowujesz newsletter lub szablon, dobierz język treści do grupy odbiorców. Osobno uwzględnij język panelu i materiałów instruktażowych.
Wybór języka nie zmienia zasad identyfikacji profilu. Służy do tego jeden z 3 typów identyfikatorów: e-mail, telefon lub identyfikator zewnętrzny³.

Integrację dobierz do potrzeb wymiany danych. Kanał i język komunikacji dopasuj z kolei do odbiorców.

Cennik i plan bezpłatny Klaviyo: szczegóły w opinii

Cennik Klaviyo i warunki planu bezpłatnego omawia osobna opinia. Ten poradnik dotyczy kampanii, automatyzacji, integracji i API. Oceniając koszty, oddziel cenę planu od zakresu funkcji i potrzeb integracyjnych.
Skalę połączenia pomagają określić znane parametry: katalog ponad 350 gotowych integracji² oraz limity Create Event wynoszące 350 żądań na sekundę i 3500 na minutę⁸. Plan bezpłatny oceniaj według potrzebnej skali kontaktów i komunikacji, nie według samej nazwy.

Ceny i warunki sprawdzone u źródeł: październik 2026.