Skonfiguruj Klaviyo lub Mailchimp

Wavize synchronizuje kontakty z precyzyjną publicznością

Klaviyo i Mailchimp mają oddzielne strony konfiguracji. Każda integracja wymaga klucza API, identyfikatora listy/publiczności, trybu synchronizacji i statusu aktywnego. Przy wprowadzaniu zmian pozostawienie pola klucza pustego zachowuje już zapisany sekret.

Tylko profil tworzy lub aktualizuje profil bez roszczenia o zgodę marketingową. Podwójne potwierdzenie (double opt-in) uruchamia proces potwierdzenia przez dostawcę: kontakt staje się subskrybentem dopiero po oczekiwanej akcji.

Wspólne zasady bezpieczeństwa
Utwórz dedykowany klucz Wavize, skopiuj go tylko raz w zaszyfrowanym formularzu, nie wysyłaj e-mailem ani zrzutem ekranu i odwołaj go natychmiast, gdy zostanie ujawniony.

Konfiguracja Klaviyo z kluczem prywatnym

Wavize korzysta z endpointów serwerowych: publiczny klucz o długości sześciu znaków, zwany Site ID, nie jest odpowiedni.

1. Utwórz klucz

   W Klaviyo: Ustawienia > Klucze API > Prywatne klucze API > Utwórz prywatny klucz API. Wymagane jest uprawnienie Owner, Admin lub Manager. Nazwij go Wavize i skopiuj wartość zaczynającą się od pk_ przy tworzeniu.

2. Wybierz zakresy

   Sprawdzenie odczytuje konta i listę; synchronizacja tworzy/aktualizuje profile i w przypadku podwójnego potwierdzenia subskrypcje. Przyznaj co najmniej uprawnienia do odczytu accounts/lists oraz zapisu profiles/subscriptions zgodnie z endpointami.

3. Znajdź identyfikator listy

   Otwórz Audience > Lists & Segments, następnie docelową listę. Skopiuj ID listy z jej ustawień lub URL, nie z nazwy wyświetlanej. Wavize weryfikuje go z pomocą /lists/{id}.

Konfiguracja Mailchimp z kluczem i ID publiczności

Klucz Mailchimp Marketing API zwykle zawiera centrum danych po myślniku, np. -us21.

1. Utwórz klucz

   W Mailchimp: ikona Profil > Profil > Dodatki > Klucze API > Utwórz klucz. Nazwij go Wavize, wygeneruj i natychmiast skopiuj: Mailchimp potem pokazuje tylko nazwę i pierwsze znaki.

2. Zachowaj przyrostek datacentrum

   Wavize wyciąga przyrostek po ostatnim myślniku, by wywołać właściwy host API. Skrócony klucz bez -usXX nie może być poprawnie trasowany.

3. Znajdź Audience ID

   W Audience > Wszystkie kontakty > Ustawienia > Nazwa i ustawienia publiczności, skopiuj Audience ID. To nie jest nazwa publiczna ani ID kampanii.

Wybierz tylko profil lub podwójne potwierdzenie

Tryb musi odpowiadać Twojej podstawie prawnej i tekstowi w widżecie.

• Tylko profil

  Klaviyo otrzymuje profil; Mailchimp używa statusu transactional. Kontakt nie jest uważany za subskrybenta marketingowego i może służyć do dozwolonych zastosowań niepromocyjnych.

• Podwójne potwierdzenie (double opt-in)

  Klaviyo inicjuje zadanie subskrypcji profilu; Mailchimp ustawia członka w stanie oczekującym. Adres musi zostać potwierdzony przez dostawcę, zanim stanie się aktywny dla marketingu.

• Synchronizowane pola

  Wymagany ważny e-mail, telefon E.164 jeśli istnieje, imię, nazwisko, organizacja, lokalizacja i przydatne właściwości Wavize. Pola Mailchimp FNAME/LNAME muszą istnieć lub być kompatybilne w publiczności.

Sprawdź i przetestuj prawdziwy kontakt testowy

Wavize najpierw testuje konto i publiczność przed włączeniem synchronizacji.

1. Weryfikacja Klaviyo

   Serwer wywołuje /accounts i /lists/{id}. 403 często wskazuje brakujący zakres; 404 - zły ID listy dla konta.

2. Weryfikacja Mailchimp

   Serwer wywołuje /ping i /lists/{id}. Błąd datacentrum często wynika z sufiksu klucza; nieznalezienie publiczności - z błędnego ID.

3. Kontakt testowy

   Wyślij adres należący do zespołu z widżetu, sprawdź jego utworzenie w Wavize i dostarczenie do dostawcy. W double opt-in otwórz i potwierdź wiadomość przed zakończeniem.

Obrót i incydenty

Nowy klucz nie zastępuje automatycznie starego w Wavize.

• Utwórz — Nowy dedykowany klucz z minimalnymi tymi samymi uprawnieniami.
• Aktualizuj i testuj — Wprowadź nową wartość, zachowaj publiczność i tryb, następnie weryfikuj.
• Odwołaj — Usuń stary klucz u dostawcy po pomyślnym teście.