Dokumentacja
Wszystko, co musisz wiedzieć o tworzeniu quizów, pozyskiwaniu leadów i rozwijaniu biznesu z Convertly.
Na tej stronie
Dokumentacja APIPierwsze kroki
Zarejestruj się na bezpłatne konto Convertly na stronie convertly.buzz. Karta kredytowa nie jest wymagana — plan Free daje Ci 3 quizy, 50 leadów miesięcznie i 2 quizy generowane przez AI na dobry start. Po zalogowaniu trafisz na Dashboard z przeglądem Twoich quizów, ostatnich leadów i statystyk użycia.
Aby stworzyć pierwszy quiz, przejdź do Dashboard > Quizzes i kliknij Create Quiz. Masz trzy opcje startowe: zbuduj od zera z pustym quizem, wybierz jeden z 6 gotowych szablonów (Lead Qualification, Product Match, Marketing Audit, Knowledge Quiz, Personality Quiz, ROI Calculator) lub pozwól AI wygenerować quiz dopasowany do Twojej branży.
Kreator quizów ma cztery zakładki: Questions (dodawaj i zmieniaj kolejność pytań z 4 opcjami odpowiedzi każde), Scoring (definiuj zakresy punktacji i opcjonalne kategorie), Design (prześlij logo, ustaw kolory marki) oraz Settings (konfiguruj pozycję formularza lead capture, webhooki, integracje i opcje osadzania).
Każda opcja odpowiedzi ma wartość punktową (0–10). Po ukończeniu quizu przez odwiedzającego suma punktów decyduje, który wynik zostanie wyświetlony. Zdefiniuj zakresy punktacji, takie jak "Hot Lead (36–50)" lub "Needs Nurturing (0–19)" — każdy z własnym tytułem i wiadomością.
Gdy quiz jest gotowy, kliknij Publish w prawym górnym rogu. Quiz otrzymuje link do udostępnienia pod adresem convertly.buzz/q/twoj-slug. Możesz go też osadzić na swojej stronie lub udostępnić w mediach społecznościowych. Leady zaczną pojawiać się w Twoim panelu, gdy tylko odwiedzający ukończą quiz.
Kreator quizów
Kreator quizów to edytor przeciągnij i upuść, w którym tworzysz i zarządzasz wszystkimi aspektami quizu. Każdy quiz składa się z pytań (po 4 opcje odpowiedzi), zakresów punktacji (kategorie wyników na podstawie łącznego wyniku) i opcjonalnych kategorii do wielowymiarowej punktacji.
Pytania dodajesz w zakładce Questions. Każde pytanie ma pole tekstowe i dokładnie 4 opcje odpowiedzi. Przypisz wartości punktowe (0–10) do każdej opcji — to decyduje o wyniku respondenta. Przeciągaj pytania, aby zmienić ich kolejność. Możesz też dodawać obrazy do pytań, by były bardziej angażujące.
W zakładce Scoring definiujesz, jakie wyniki zobaczą respondenci. Utwórz 3–4 zakresy punktacji obejmujące pełny zakres punktów (od 0 do liczba pytań x 10). Każdy zakres ma tytuł (np. "Ekspert", "Początkujący"), wiadomość (spersonalizowana informacja zwrotna) i opcjonalne przyciski CTA z niestandardowymi URL-ami do kierowania następnych działań.
W przypadku zaawansowanych ocen włącz Category Scoring (plan Pro+). Pozwala to grupować pytania w kategorie, takie jak "Marketing", "Sprzedaż", "Operacje" — każda z własnym kolorem, zakresami punktacji i spersonalizowaną informacją zwrotną. Wyniki pokazują wykres radarowy z podziałem per kategoria obok wyniku globalnego.
Zakładka Design pozwala przesłać logo, wybrać kolor marki (stosowany do przycisków, paska postępu i akcentów) oraz skonfigurować ustawienia raportu PDF. Plany Pro i Business mogą usunąć odznakę "Powered by Convertly" dla w pełni white-label doświadczenia.
Użyj przycisku Preview, aby przetestować quiz dokładnie tak, jak zobaczą go respondenci. Podgląd na żywo aktualizuje się w czasie rzeczywistym wraz ze zmianami. Wszystkie zmiany są automatycznie zapisywane — kreator grupuje Twoje edycje i synchronizuje je z serwerem.
Generowanie AI
Generator quizów AI tworzy kompletny, gotowy do publikacji quiz w mniej niż 2 minuty. Przejdź do Dashboard > Quizzes > Generate with AI. Wybierz spośród 8 presetów branżowych (Mortgage, Insurance, Coaching, Marketing, E-commerce, Fitness, Nutrition, Education) lub opisz własny temat.
Skonfiguruj quiz, podając temat, grupę docelową i cel (np. kwalifikacja leadów, rekomendacja produktu, edukacja). Wybierz liczbę pytań (5, 7 lub 10) i język (angielski lub polski). Przy 7 i więcej pytaniach AI automatycznie tworzy category scoring z odrębnymi wymiarami oceny.
AI generuje pytania z punktacją i zróżnicowanym rozkładem punktów, 3–4 kategorie wyników ze spersonalizowanymi wiadomościami oraz (przy większych quizach) podział na kategorie. Presety branżowe zawierają zoptymalizowane wskazówki — na przykład preset Mortgage skupia się na gotowości finansowej, stabilności zatrudnienia i historii kredytowej.
Po wygenerowaniu quiz otwiera się w kreatorze, gdzie możesz edytować dowolne pytanie, dostosować punktację, zmodyfikować wiadomości lub dodać branding. Wynik AI to punkt wyjścia — dostosuj go do swojego głosu i potrzeb biznesowych.
Limity generowania AI zależą od planu: Free dostaje 2 generowania miesięcznie, Pro — 20, a Business — 50. Licznik resetuje się 1. każdego miesiąca. Każdy wygenerowany quiz wlicza się też do limitu tworzenia quizów.
Pozyskiwanie leadów
Każdy quiz zawiera formularz lead capture, który zbiera imię i adres e-mail respondenta. Domyślnie formularz pojawia się na końcu quizu, przed wyświetleniem wyników. Możesz to zmienić w ustawieniach quizu — formularz może pojawiać się na początku (przed pytaniami), w środku (po połowie pytań) lub na końcu (domyślnie).
Gdy zbierasz leady na początku lub w środku, Convertly natychmiast tworzy częściowego leada — nawet jeśli respondent porzuci quiz, masz już jego dane kontaktowe. Lead jest finalizowany z wynikiem po ukończeniu quizu. Dane branżowe pokazują, że wczesne zbieranie leadów potraja liczbę kontaktów od odwiedzających, którzy w przeciwnym razie by odeszli.
Wszystkie przechwycone leady pojawiają się w Dashboard > Leads. Każdy lead pokazuje imię, adres e-mail, quiz, łączny wynik, kategorię wyniku i datę ukończenia. Używaj narzędzi wyszukiwania i filtrowania, aby znaleźć konkretne leady. Plany Pro i Business umożliwiają eksport leadów do CSV.
Convertly automatycznie wysyła e-mail z wynikami do każdego leada z jego punktacją i spersonalizowaną wiadomością. Właściciele quizów otrzymują e-mail z powiadomieniem o każdym nowym leadzie. W planach Pro+ z włączonymi Raportami PDF leady mogą też otrzymywać wyniki jako załącznik PDF z logo marki.
Przechwytywanie leadów podlega miesięcznym limitom: plan Free pozwala na 50 leadów/miesiąc, Pro — 1 000, a Business — bez limitu. Po osiągnięciu limitu w planie Free nowe leady są nadal przechwytywane, ale oznaczane jako zablokowane do czasu uaktualnienia. Przy 80% wykorzystania otrzymasz e-mail ostrzegawczy.
Personalizacja
Convertly pozwala w pełni opatrzyć swoje quizy brandingiem. W zakładce Design prześlij logo firmy (wyświetlane w nagłówku quizu i raportach PDF) i ustaw kolor marki — jest on stosowany do przycisków, pasków postępu, odznak wyników i elementów akcentujących w całym quizie.
Plany Pro i Business zawierają pełny custom branding. Stopka "Powered by Convertly" jest usuwana ze strony wyników quizu, nadając mu w pełni white-label wygląd. Quizy w planie Free zawsze wyświetlają atrybucję Convertly.
Dostosuj stronę wyników dla każdego zakresu punktacji indywidualnie. Napisz unikalną wiadomość, dodaj przycisk call-to-action z niestandardowym URL (np. link do strony rezerwacji lub produktu) i dopasuj doświadczenie do uzyskanego wyniku. To zamienia wyniki quizu w spersonalizowany lejek sprzedażowy lub onboardingowy.
Dzięki Raportom PDF (plan Pro+) wyniki quizu można eksportować jako markowe dokumenty PDF. PDF zawiera wynik respondenta, podział na kategorie (przy użyciu category scoring), wszystkie jego odpowiedzi oraz Twoje logo i kolory marki. Możesz włączyć automatyczne dostarczanie PDF e-mailem i pozwolić respondentom pobrać raport bezpośrednio ze strony wyników.
W przypadku zaawansowanych quizów z Category Scoring każda kategoria ma własny kolor (widoczny na wykresie radarowym i odznakach), niezależne zakresy punktacji ze spersonalizowanymi wiadomościami i dedykowaną sekcję w raporcie PDF. Daje to respondentom bogate, wielowymiarowe spojrzenie na swoje wyniki.
Integracje
Convertly natywnie integruje się z popularnymi platformami e-mail marketingowymi i systemami CRM. Obsługiwani dostawcy: GetResponse, Mailchimp, ActiveCampaign, Klaviyo, HubSpot i Pipedrive. Gdy lead ukończy quiz, jego dane kontaktowe i wyniki są automatycznie synchronizowane z podłączonymi platformami.
Aby skonfigurować integrację, przejdź do Dashboard > Integrations. Każdy dostawca ma własną kartę, gdzie wprowadzasz klucz API (lub token dostępu), testujesz połączenie i wybierasz domyślną listę lub kampanię. W platformach e-mail wybierasz, do której listy trafiają nowi leady. Integracje CRM (HubSpot, Pipedrive) synchronizują kontakty bezpośrednio bez konieczności wyboru listy.
Po podłączeniu integracje są domyślnie włączone dla wszystkich quizów. Aby kontrolować, które quizy synchronizują się z którymi integracjami, otwórz quiz w kreatorze, przejdź do zakładki Settings i użyj przełączników integracji w sekcji Email Marketing Integrations. Możesz wstrzymać lub wyłączyć integrację dla konkretnego quizu bez wpływu na pozostałe.
Dla każdego zsynchronizowanego leada Convertly wysyła imię, adres e-mail i metadane quizu. Platformy e-mail otrzymują automatycznie generowane tagi (slug quizu + kategoria wyniku). HubSpot otrzymuje quiz_title, quiz_score i quiz_result jako właściwości kontaktu. Pipedrive tworzy nową osobę z adresem e-mail leada.
Dla szerszej automatyzacji Convertly integruje się też z Zapier, dając dostęp do ponad 6 000 aplikacji bez pisania kodu. Integracja Zapier używa REST Hooks — gdy lead ukończy quiz, Convertly wysyła żądanie POST w czasie rzeczywistym do Twojego Zapa. Skonfiguruj połączenie Zapier używając klucza API Convertly.
Możesz też skonfigurować URL webhooka bezpośrednio w ustawieniach quizu. Gdy lead wypełni quiz, Convertly wysyła żądanie POST na Twój URL z payloadem JSON zawierającym typ zdarzenia, dane quizu i dane leada. Webhooki mają 10-sekundowy limit czasu i działają w trybie fire-and-forget.
{
"event": "lead.created",
"timestamp": "2026-04-20T12:00:00Z",
"quiz": { "id": "abc-123", "title": "Your Quiz" },
"lead": {
"name": "Jane Smith",
"email": "jane@example.com",
"score": 85,
"result": "Expert"
}
}Wszystkie natywne integracje i Zapier wymagają planu Pro lub Business. Webhooki są dostępne w planie Pro (1 quiz) i Business (do 5 quizów). REST API oferuje dostęp tylko do odczytu w Pro i pełny dostęp odczyt-zapis w Business.
Aby uzyskać programowy dostęp do quizów i leadów, zapoznaj się z REST API. Dokumentacja API
Zarządzanie zespołem
Subskrybenci planu Business mogą zapraszać do 3 członków zespołu do współpracy przy quizach i leadach. Przejdź do Dashboard > Team i zaproś współpracowników podając adres e-mail. Zaproszeni członkowie otrzymują e-mail z zaproszeniem i mogą dołączyć używając istniejącego konta Convertly lub tworząc nowe.
Członkowie zespołu mają pełny dostęp do tych samych quizów, leadów, analityki i integracji co właściciel konta. Cała aktywność — tworzenie quizów, przechwytywanie leadów, użycie API i generowania AI — wlicza się do limitów planu właściciela zespołu, a nie limitów poszczególnych członków.
Aby usunąć członka zespołu, przejdź do Dashboard > Team i kliknij Remove obok jego imienia. Usunięci członkowie natychmiast tracą dostęp do quizów i leadów zespołu. Możesz ponownie zaprosić ich w dowolnym momencie — ich poprzednia praca jest zachowana.
Zarządzanie zespołem jest dostępne wyłącznie w planie Business ($79/miesiąc). Plany Free i Pro są przeznaczone dla jednego użytkownika. Jeśli potrzebujesz więcej niż 3 członków zespołu, skontaktuj się z pomocą techniczną w sprawie indywidualnych rozwiązań enterprise.
Analityka
Analityka jest dostępna w planach Pro i Business. Panel analityczny pokazuje, jak działają Twoje quizy — łączna liczba wyświetleń, wskaźnik ukończenia, średni wynik i łączna liczba przechwyconych leadów w czasie. Filtruj według zakresu dat (7 dni, 30 dni, 90 dni), aby śledzić trendy.
Wykres śledzenia ukończeń pokazuje, w którym miejscu respondenci rezygnują. Jeśli wielu odwiedzających opuszcza quiz przy konkretnym pytaniu, to sygnał, by je uprościć lub przepisać. Wykorzystaj te dane do optymalizacji quizu pod kątem wyższego wskaźnika ukończenia — nawet niewielka poprawa porzuceń może znacząco zwiększyć liczbę leadów.
Wykresy rozkładu wyników pokazują, jak respondenci punktują we wszystkich kategoriach wyników. Pomaga to sprawdzić, czy model punktacji jest zrównoważony — jeśli 90% respondentów trafia do jednej kategorii, wartości punktowe mogą wymagać korekty. Dobrze skalibrowany quiz rozkłada respondentów mniej więcej równomiernie.
Każdy quiz ma własny widok analityki dostępny z Dashboard > Analytics lub przez kliknięcie ikony analityki przy dowolnym quizie. Porównuj wydajność quizów, aby zidentyfikować najlepiej działające treści i powielać to, co działa.
Dane analityczne są ograniczone do wybranego zakresu dat i aktualizują się w czasie rzeczywistym wraz z napływem nowych leadów. Użytkownicy planu Free widzą jedynie podstawowy panel z łączną liczbą quizów i leadów — przejdź na Pro, aby uzyskać dostęp do pełnego pakietu analityki.
Rozliczenia i plany
Convertly oferuje trzy plany: Free ($0/miesiąc, stały), Pro ($29/miesiąc) i Business ($79/miesiąc). Oba płatne plany są dostępne w rozliczeniu miesięcznym lub rocznym — plany roczne są tańsze o około 20%. Wszystkie płatności są bezpiecznie przetwarzane przez Paddle jako nasz merchant of record.
Plan Free pozwala wypróbować Convertly bez żadnych zobowiązań. Otrzymujesz 3 quizy, 50 leadów miesięcznie, 2 generowania AI i dostęp do wszystkich 6 szablonów quizów. Gdy będziesz gotowy na więcej, możesz uaktualnić plan bezpośrednio z panelu.
Plan Pro odblokowuje 20 quizów, 1 000 leadów/miesiąc, niestandardowy branding, analitykę, eksport CSV, widżety osadzania, webhooki, natywne integracje (GetResponse, Mailchimp, ActiveCampaign, Klaviyo, HubSpot, Pipedrive), Zapier, category scoring i raporty PDF. Idealny dla marketerów i małych firm aktywnie generujących leady.
Plan Business usuwa wszystkie limity — nieograniczone quizy i leady, 50 generowań AI, do 5 webhooków, pełny dostęp do REST API (odczyt + zapis), 3 członków zespołu, własne domeny do white-label hostingu i priorytetowe wsparcie. Stworzony z myślą o agencjach i rozwijających się zespołach.
Możesz uaktualnić, obniżyć lub anulować plan w dowolnym momencie z Dashboard > Account. Obniżenia wchodzą w życie na końcu okresu rozliczeniowego. Jeśli po obniżeniu przekroczysz limity nowego planu, istniejące quizy i leady są zachowane, ale tworzenie nowych jest wstrzymane do czasu zmieszczenia się w limitach.
Ready to dive deeper?
Explore the full REST API reference for programmatic access to your data.