APRESLY API V1
Połącz Apresly z Zapier
Po zapisie lub zakupie zarejestruj leada, przekaż link do oferty i odczytaj termin przed przypomnieniem.
Sprawdzono z produkcyjnym API: 9 października 2026
Na tej stronie
Zanim zaczniesz
Przygotuj opublikowaną kampanię, klucz z ustawień API i ID kampanii z szybkiego startu. Wybierz zdarzenie, po którym klient ma wejść do kampanii, np. zapis formularza albo opłacony zakup.
To połączenie przez HTTP. Nie wymaga natywnego konektora Apresly. Dostęp do modułów i ich nazwy mogą zależeć od wersji oraz planu narzędzia. Test wykonuje prawdziwą rejestrację, więc użyj własnego adresu e-mail.
1. Dodaj wywołanie HTTP
Dodaj trigger ze sklepu, formularza albo CRM. W kolejnym kroku wybierz Webhooks by Zapier → POST. Ustaw Payload Type: JSON. Dodaj email i language jako osobne pola Data. W Headers ustaw Authorization: Bearer <YOUR_API_KEY> oraz Content-Type: application/json. Nie dodawaj Basic Auth. Dokumentacja Webhooks by Zapier.
2. Ustaw adres i dane
URL: https://app.apresly.com/api/public/v1/campaigns/42/leads. Zastąp 42 ID swojej kampanii. Docelowa treść żądania wygląda tak:
{
"email": "[email protected]",
"language": "pl"
}
Zmapuj email z triggera, nie zostawiaj na stałe testowego adresu. Nie przekazuj całego obiektu kontaktu: dodatkowe pola zostaną odrzucone. Użyj struktury JSON, żeby narzędzie poprawnie zakodowało dane.
3. Przetestuj i zapisz wynik
Oczekuj 201 dla nowego leada albo 200 dla istniejącego. Sprawdź warnings, a następnie zapisz w kontakcie CRM lub platformie mailowej:
offerLinks[].url: spersonalizowany adres przycisku. Wybierz właściwą stronę przezpageId, nie zakładaj, że pierwszy link jest zawsze właściwy.deadline: termin UTC. Może być null, zachowaj tę możliwość w mapowaniu.mailTimerUrl: źródło obrazu licznika. Pomijaj obraz, jeśli wartość jest null.
Dopiero kolejny krok Twojej automatyzacji wysyła e-mail. API Apresly nie wysyła wiadomości. Jeśli nie ma linków, zatrzymaj krok wysyłki oferty i sprawdź ostrzeżenia.
4. Przypomnienie bez ponownej rejestracji
Przed przypomnieniem użyj drugiego POST z takim samym JSON i nagłówkami, pod adresem https://app.apresly.com/api/public/v1/campaigns/42/leads/lookup. Ten odczyt nie uruchamia nowego cyklu.
Sprawdź, czy deadline nie wygasł i czy wybrany link istnieje. Przy LEAD_NOT_FOUND pomiń przypomnienie albo skieruj zdarzenie do diagnostyki. Null zamiast terminu wymaga świadomej reguły w Twoim przepływie, nie traktuj go jak przyszłej daty.
5. Obsłuż ponowienia
Trigger może dostarczyć to samo zdarzenie kilka razy. Zapisuj jego ID w swoim systemie i deduplikuj wysyłkę, także jeśli odpowiedź API została utracona. created nie jest gwarancją jednokrotnego e-maila.
Po 429 odczekaj Retry-After sekund. Timeout i 503 ponawiaj z rosnącym opóźnieniem. Błędów konfiguracji 400, 401, 409, 415 i 422 nie naprawi samo ponawianie. Nie kopiuj kluczy, e-maili ani spersonalizowanych linków do logów; ogranicz dostęp do historii automatyzacji.
Pełna dokumentacja API opisuje dostępne pola i zasady kampanii.