Konfiguracja szablonów procesu rekrutacyjnego

Przegląd

Szablon procesu definiuje etapy, przez które przechodzi kandydat w Twoim pipelinie rekrutacyjnym. Szablony pisze się w YAML i składają się z uporządkowanej listy etapów, z których każdy ma typ, nazwę i opcjonalną konfigurację.

Gdy tworzysz ogłoszenie o pracę i wybierasz szablon, etapy są tworzone w kolejności. Kandydaci przechodzą przez kolejne etapy po kolei — od aplikacji do oferty.

Podstawowa struktura

name: My Hiring Process
description: |
  A short description of this template.
  Supports **Markdown** formatting.

tags:
  - engineering
  - remote

stages:
  - type: application_form
    name: "Application"
    config:
      candidate_description: "Tell us about yourself."

  - type: live_interview
    name: "Interview"
    config:
      candidate_description: "A conversation about your background."

  - type: offer
    name: "Offer"

Szablony są walidowane przy zapisie, a klucze konfiguracji podlegają ścisłej kontroli — błędnie wpisany lub nieobsługiwany klucz kończy się błędem walidacji, zamiast zostać po cichu zignorowany, więc literówki wychodzą na jaw od razu.

Klucze najwyższego poziomu

Klucz	Wymagany	Opis
stages	Tak	Uporządkowana lista definicji etapów (co najmniej jeden)
name	Nie	Nazwa szablonu (można ją też ustawić w polu formularza)
description	Nie	Opis procesu w formacie Markdown
tags	Nie	Lista tagów tekstowych do kategoryzacji
quick_fields	Nie	Szybkie pola do zbierania informacji o kandydacie (patrz sekcja Szybkie pola poniżej)

Klucze etapu

Każdy etap wymaga kluczy name i type. Opcjonalny słownik config oraz lista reviewers różnią się w zależności od typu etapu.

Klucz	Wymagany	Opis
name	Tak	Wyświetlana nazwa etapu
type	Tak	Jeden z 10 typów etapów wymienionych poniżej
config	Nie	Opcje konfiguracji specyficzne dla danego typu
reviewers	Nie	Lista przypisanych recenzentów

Wynagradzanie kandydatów

Każdy etap może wynagradzać kandydatów za poświęcony czas — najczęściej dotyczy to zadania do wykonania w domu, ale płatne ćwiczenie projektowe czy płatna rozmowa działają tak samo. Dodaj zagnieżdżony blok payout do config etapu; gdy kandydat ukończy etap, tworzona jest wypłata na skonfigurowaną kwotę. Jak wypłaty są zatwierdzane i wysyłane, przeczytasz w artykule Candidate Payouts.

Klucz	Typ	Domyślnie	Opis
enabled	boolean	false	Włącza wynagrodzenie na tym etapie
amount	integer	—	Kwota do wypłaty w podanej walucie (np. 250)
currency	string	USD	Trzyliterowy kod waluty

- type: code_assignment
  name: "Take-Home Assignment"
  config:
    candidate_description: "Complete a practical coding exercise."
    payout:
      enabled: true
      amount: 250
      currency: USD

Dokumentacja typów etapów

application_form

Punkt wejścia dla kandydatów. Zbiera ustrukturyzowane informacje za pomocą niestandardowych pól formularza. Opcjonalnie wstrzymuje kandydatów na etapie przeglądu wstępnego przed przekazaniem dalej.

Klucz konfiguracji	Typ	Domyślnie	Opis
candidate_description	string	—	Instrukcje wyświetlane kandydatowi
screening_enabled	boolean	true	Wstrzymuje zgłoszenia do ręcznej weryfikacji przed przekazaniem dalej. Włączone domyślnie — ustaw wprost na false, żeby wyłączyć przegląd wstępny
screening_message	string	—	Wiadomość wyświetlana kandydatom, gdy przegląd wstępny jest aktywny
resume_required	boolean	false	Wymagaj CV — kandydaci nie mogą wysłać aplikacji bez załączenia pliku PDF lub dokumentu Word (maks. 10 MB)
fields	array	—	Lista definicji pól formularza (patrz poniżej)

Opcje pól formularza:

Klucz	Wymagany	Typ	Opis
name	Tak	string	Identyfikator pola
type	Tak	string	text, textarea, file, url, select, checkbox, email, phone
required	Nie	boolean	Czy pole musi być wypełnione — sprawdzane przy wysyłce aplikacji na każdej ścieżce aplikowania, także przez publiczne API
label	Nie	string	Wyświetlana etykieta (domyślnie nazwa pola)
placeholder	Nie	string	Tekst zastępczy
max_length	Nie	integer	Maksymalna liczba znaków (min: 1)
options	Nie	array	Opcje wyboru dla pól typu select

Ważne: Żeby wymagać CV, ustaw resume_required: true w konfiguracji etapu. Pole formularza o nazwie resume jest ignorowane — CV ma w formularzu aplikacyjnym własny upload i jest załączane niezależnie od pól niestandardowych, więc deklaracja - name: resume z type: file i required: true nie daje żadnego efektu.

- type: application_form
  name: "Application"
  config:
    candidate_description: "Tell us about yourself."
    screening_enabled: true
    screening_message: "We'll review your application shortly."
    resume_required: true
    fields:
      - name: experience_level
        type: select
        required: true
        options:
          - "Junior (0-2 years)"
          - "Mid (2-5 years)"
          - "Senior (5+ years)"
      - name: cover_letter
        type: textarea
        required: false
        max_length: 500

code_assignment

Zadanie programistyczne do wykonania w domu. Gdy GitHub jest podłączony, dla każdego kandydata tworzone jest prywatne repozytorium na podstawie szablonu. Obejmuje zarządzanie terminami.

Ważne: Repozytorium podane w github_template musi być oznaczone na GitHubie jako szablon. Wymagania i instrukcje konfiguracji znajdziesz w artykule GitHub Template Repository Setup.

Klucz konfiguracji	Typ	Domyślnie	Opis
candidate_description	string	—	Instrukcje wyświetlane kandydatowi
github_template	string	—	Repozytorium szablonu GitHub (np. org/hiring-assignment)
duration_days	integer	7	Liczba dni na wykonanie (min: 1)
estimated_hours	integer	—	Szacowany nakład pracy w godzinach (np. 5)
instructions	string	—	Instrukcje dodawane commitem do repozytorium kandydata
grace_period_hours	integer	24	Ile godzin po terminie zgłoszenia są jeszcze przyjmowane, zanim termin stanie się ostateczny
allow_extension	boolean	true	Kandydaci mogą poprosić o przedłużenie terminu

Żeby zapłacić kandydatom za zadanie, dodaj blok payout — zobacz sekcję Wynagradzanie kandydatów powyżej. Starsze klucze paid, payment_amount i payment_currency są nadal akceptowane na etapie code_assignment i zamieniane na równoważną wypłatę, ale w nowych szablonach używaj payout.

- type: code_assignment
  name: "Take-Home Assignment"
  config:
    candidate_description: "Complete a practical coding exercise."
    github_template: "mycompany/hiring-challenge"
    duration_days: 7
    estimated_hours: 5
    payout:
      enabled: true
      amount: 250
      currency: USD

portfolio_upload

Kandydaci przesyłają próbki prac (pliki projektowe, przykładowe teksty itp.). Obsługuje ograniczenia typów plików, limity przesyłania i linki zewnętrzne.

Klucz konfiguracji	Typ	Domyślnie	Opis
candidate_description	string	—	Instrukcje wyświetlane kandydatowi
accept	array	pdf, png, jpg, jpeg, gif, webp	Dozwolone rozszerzenia plików, bez początkowej kropki
max_files	integer	10	Maksymalna liczba plików (min: 1)
max_file_size_mb	integer	25	Maksymalny rozmiar pojedynczego pliku w MB
allow_links	boolean	true	Kandydaci mogą też przesyłać linki zewnętrzne (np. Figma, Behance)

- type: portfolio_upload
  name: "Portfolio Review"
  config:
    candidate_description: "Share 3-5 examples of your best work."
    accept:
      - pdf
      - png
      - jpg
    max_files: 5
    max_file_size_mb: 50
    allow_links: true

questionnaire

Pytania pisemne, na które kandydaci odpowiadają asynchronicznie. Przydatne do przeglądu wstępnego opartego na scenariuszach na stanowiskach w dziale wsparcia, sprzedaży lub na stanowiskach wymagających umiejętności pisarskich.

Klucz konfiguracji	Typ	Domyślnie	Opis
candidate_description	string	—	Instrukcje wyświetlane kandydatowi
questions	array	—	Lista definicji pytań
duration_days	integer	—	Sugerowana liczba dni na odpowiedź — widoczna tylko w podglądzie szablonu, nie jest egzekwowana

Opcje pytań:

Klucz	Wymagany	Typ	Opis
type	Tak	string	Kategoria pytania (np. scenario)
prompt	Tak	string	Treść pytania

- type: questionnaire
  name: "Written Scenarios"
  config:
    candidate_description: "Respond to these real-world scenarios."
    questions:
      - type: scenario
        prompt: "A customer reports a billing error. Walk us through your response."
      - type: scenario
        prompt: "You discover a bug affecting 10% of users. What do you do?"

video

Prezentuje kandydatowi materiał wideo. Obsługuje przesłane filmy (przez Mux) lub osadzone filmy z zewnętrznych platform.

Ustawienia wideo są zgrupowane pod zagnieżdżonym kluczem video wewnątrz config.

Klucz konfiguracji	Typ	Domyślnie	Opis
candidate_description	string	—	Instrukcje wyświetlane kandydatowi
video	hash	—	Ustawienia wideo (zobacz poniżej)

Opcje video:

Klucz	Typ	Domyślnie	Opis
source_type	string	mux	mux (przesłany) lub oembed (osadzenie zewnętrzne)
oembed_url	string	—	URL osadzonego filmu (gdy źródłem jest oembed)
description	string	—	Opis lub kontekst filmu
min_watch_percentage	integer	15	Minimalny wymagany procent obejrzenia (1-100)

- type: video
  name: "Company Introduction"
  config:
    candidate_description: "Watch this video about our team and culture."
    video:
      source_type: oembed
      oembed_url: "https://www.youtube.com/watch?v=example"
      description: "A 5-minute overview of our engineering team."
      min_watch_percentage: 80

video_recording

Kandydaci nagrywają lub przesyłają odpowiedź wideo na podany temat. Przydatne do przedstawienia się, wideo-listów motywacyjnych lub asynchronicznych rozmów wideo. Wymaga integracji z Mux.

Ustawienia nagrywania są zgrupowane pod zagnieżdżonym kluczem video_recording wewnątrz config.

Klucz konfiguracji	Typ	Domyślnie	Opis
candidate_description	string	—	Instrukcje wyświetlane kandydatowi
video_recording	hash	—	Ustawienia nagrywania (zobacz poniżej)

Opcje video_recording:

Klucz	Typ	Domyślnie	Opis
max_duration_seconds	integer	120	Maksymalna długość nagrania w sekundach
allow_upload	boolean	true	Pozwala kandydatom przesłać wcześniej nagrany plik wideo
max_retakes	integer	—	Liczba dozwolonych ponownych nagrań (puste = bez limitu)

- type: video_recording
  name: "Video Introduction"
  config:
    candidate_description: "Record a 2-minute video introducing yourself."
    video_recording:
      max_duration_seconds: 120
      allow_upload: true
      max_retakes: 3

team_review

Wewnętrzny etap oceny, na którym Twój zespół ocenia kandydata. Obsługuje progi głosowania i zasady weta.

Klucz konfiguracji	Typ	Domyślnie	Opis
candidate_description	string	—	Wiadomość wyświetlana kandydatowi na tym etapie
voting	hash	—	Konfiguracja głosowania (patrz poniżej)

Opcje głosowania:

Klucz	Typ	Domyślnie	Opis
threshold	integer	2	Minimalna liczba głosów „tak”, żeby przejść dalej (1-10)
require_all_reviewers	boolean	false	Wszyscy przypisani recenzenci muszą zagłosować
veto_auto_rejects	boolean	false	Pojedyncze weto automatycznie odrzuca kandydata

- type: team_review
  name: "Code Review"
  config:
    candidate_description: "Our team is reviewing your submission."
    voting:
      threshold: 2
      require_all_reviewers: true
      veto_auto_rejects: true

live_interview

Synchroniczna rozmowa kwalifikacyjna prowadzona przez wideokonferencję lub osobiście. Integruje się z planowaniem w kalendarzu.

Klucz konfiguracji	Typ	Domyślnie	Opis
candidate_description	string	—	Instrukcje wyświetlane kandydatowi
duration_minutes	integer	60	Długość rozmowy w minutach (min: 15)
interviewers_required	integer	1	Liczba prowadzących, którzy muszą wziąć udział
includes_roleplay	boolean	false	Rozmowa obejmuje ćwiczenie z odgrywaniem ról

- type: live_interview
  name: "Technical Interview"
  config:
    candidate_description: "A conversation about your technical skills."
    duration_minutes: 90
    interviewers_required: 2

reference_check

Zbieranie i weryfikacja referencji kandydata. Nie ma jeszcze osobnego procesu przesyłania referencji — kandydaci widzą opis etapu, a references_required pojawia się w podglądzie szablonu, ale nie jest egzekwowany.

Klucz konfiguracji	Typ	Domyślnie	Opis
candidate_description	string	—	Instrukcje wyświetlane kandydatowi
references_required	integer	—	Wymagana liczba referencji (min: 1)

- type: reference_check
  name: "References"
  config:
    candidate_description: "Provide contact details for your references."
    references_required: 2

offer

Ostatni etap, na którym składasz kandydatowi ofertę. Zazwyczaj wymaga minimalnej konfiguracji.

Klucz konfiguracji	Typ	Domyślnie	Opis
candidate_description	string	—	Wiadomość wyświetlana kandydatowi

- type: offer
  name: "Offer"
  config:
    candidate_description: "We'd love to have you join the team."

Recenzenci

Do każdego etapu możesz przypisać recenzentów. Każdy recenzent wymaga adresu e-mail i roli.

Klucz	Wymagany	Opis
email	Tak	Adres e-mail recenzenta (musi odpowiadać członkowi zespołu)
role	Tak	reviewer (standardowy) lub lead (główny decydent)

- type: team_review
  name: "Code Review"
  config:
    voting:
      threshold: 2
  reviewers:
    - email: [email protected]
      role: lead
    - email: [email protected]
      role: reviewer
    - email: [email protected]
      role: reviewer

Szybkie pola

Szybkie pola definiują ustrukturyzowane metadane, które Twój zespół zbiera dla każdego aplikującego — takie jak oczekiwania płacowe, dostępność, preferencje lokalizacyjne czy dowolny inny sygnał istotny dla danej roli. Pola pojawiają się w panelu bocznym kandydata.

Jak zarządzać definicjami pól bezpośrednio w interfejsie — zobacz Pola danych kandydata.

Schemat

Klucz	Wymagany	Typ	Opis
key	Tak	string	Unikalny identyfikator (małe litery, tylko podkreślenia, np. salary_expectation)
label	Tak	string	Wyświetlana etykieta widoczna dla zespołu
field_type	Nie	string	Jeden z 4 typów pól wymienionych poniżej (domyślnie: text)
placeholder	Nie	string	Tekst zastępczy dla pola
options	Nie	array	Opcje wyboru dla pól typu select

Uwaga: Bogatsze typy pól i opcje — takie jak liczby, oceny, ekstrakcja AI i reguły widoczności — konfiguruje się w metafield_definitions, osobnym kluczu najwyższego poziomu. Zobacz Pola danych kandydata.

Typy pól

Typ	Opis
text	Jednowierszowe pole tekstowe
textarea	Wielowierszowe pole tekstowe
select	Lista rozwijana z ustalonego zbioru opcji
date	Wybór daty

Przykłady

quick_fields:
  - key: salary_expectation
    label: "Salary Expectation"
    field_type: text
    placeholder: "$80,000 - $100,000"
  - key: start_date
    label: "Earliest Start Date"
    field_type: date
  - key: work_authorization
    label: "Work Authorization"
    field_type: select
    options:
      - "US Citizen"
      - "Permanent Resident"
      - "Requires Sponsorship"
  - key: source
    label: "Source / Referral"
    field_type: text
    placeholder: "e.g. LinkedIn, referral from..."

Kompletny przykład

Pełny szablon do rekrutacji inżyniera oprogramowania, obejmujący przegląd wstępny, płatne zadanie programistyczne, ocenę zespołu, dwie rundy rozmów kwalifikacyjnych, referencje i ofertę.

name: Software Engineer - Standard
description: |
  Comprehensive process for mid-to-senior software engineers.
  Includes a take-home assignment with team code review.

tags:
  - engineering
  - technical
  - assignment

quick_fields:
  - key: salary_expectation
    label: "Salary Expectation"
    field_type: text
    placeholder: "e.g. $120k - $150k"
  - key: notice_period
    label: "Notice Period"
    field_type: text
  - key: location_preference
    label: "Location Preference"
    field_type: text

stages:
  - type: application_form
    name: "Application"
    config:
      candidate_description: "Tell us about yourself and your experience."
      screening_enabled: true
      screening_message: "We're reviewing your application."
      resume_required: true
      fields:
        - name: github_url
          type: url
          required: false
        - name: motivation
          type: textarea
          required: true
          max_length: 500

  - type: code_assignment
    name: "Take-Home Assignment"
    config:
      candidate_description: "Complete a practical coding exercise at your own pace."
      github_template: "mycompany/hiring-assignment"
      duration_days: 8
      estimated_hours: 6
      payout:
        enabled: true
        amount: 250
        currency: USD
    reviewers:
      - email: [email protected]
        role: lead

  - type: team_review
    name: "Code Review"
    config:
      candidate_description: "Our team reviews your code submission."
      voting:
        threshold: 2
        require_all_reviewers: true
        veto_auto_rejects: true
    reviewers:
      - email: [email protected]
        role: lead
      - email: [email protected]
        role: reviewer

  - type: live_interview
    name: "Technical Interview"
    config:
      candidate_description: "A conversation about your technical skills."
      duration_minutes: 90
      interviewers_required: 2

  - type: live_interview
    name: "Culture & Values"
    config:
      candidate_description: "Get to know the team and learn about our culture."
      duration_minutes: 45

  - type: reference_check
    name: "References"
    config:
      references_required: 2

  - type: offer
    name: "Offer"
    config:
      candidate_description: "We'll present you with an offer to join the team."

Wskazówki

• Zaczynaj od application_form — to naturalny punkt wejścia, który pozwala zebrać CV i podstawowe informacje.
• Kończ etapem offer — utrzymuje porządek w pipelinie i daje końcowy etap do śledzenia postępów.
• Korzystaj z przeglądu wstępnego w formularzu aplikacyjnym, żeby ręcznie przeglądać kandydatów przed przekazaniem dalej. Zapobiega to otrzymywaniu zadań przez nieodpowiednich kandydatów.
• Płać za zadania do wykonania w domu — dodaj blok payout do config etapu, żeby wynagrodzić kandydatów za poświęcony czas (działa na każdym typie etapu). Zobacz Candidate Payouts.
• Ogranicz proces do maksymalnie 7 etapów — zbyt długie procesy rekrutacji prowadzą do rezygnacji kandydatów.
• Przypisuj recenzentów do etapów team_review i code_assignment, żeby odpowiednie osoby były powiadamiane automatycznie.
• Używaj candidate_description na każdym etapie — kandydaci widzą tę wiadomość, więc jasna komunikacja zmniejsza liczbę nieporozumień i zgłoszeń do działu wsparcia.
• Rejestruj typowe sygnały za pomocą quick_fields — dodaj pola takie jak oczekiwania płacowe, dostępność i lokalizacja, żeby zespół spójnie zapisywał je w panelu bocznym kandydata.
• Potrzebujesz bogatszych typów lub ekstrakcji AI? — liczby, oceny, automatyczne uzupełnianie przez AI i reguły widoczności znajdują się w metafield_definitions. Zobacz Pola danych kandydata.