API to sposób, w jaki dwa różne systemy komputerowe mogą ze sobą „rozmawiać". Twój system zewnętrzny (na przykład voice bot albo system kadrowy) pyta Element o dane lub przekazuje mu nowe informacje — automatycznie, bez ręcznego klikania w panelu.

W praktyce: Twój dział IT (lub Twój dostawca technologii) podaje Element loginowi i hasłu w specjalnej formie, a potem napisze kawałek kodu, który robi to, co dotychczas robił człowiek — tylko szybciej i bez przerw.

Każdy tenant ma swoje pomysły, ale oto co najczęściej zgłaszają nasi klienci:

Bot dzwoni do kandydata, zbiera podstawowe dane i CV, a potem sam dodaje go do projektu w Element. Konsultant od razu widzi nową aplikację w panelu, z notatką: „API: voice-bot dodał kandydata, kandydat preferuje pracę zdalną od 1 czerwca".

Twój system HR widzi, na jakim etapie rekrutacji jest dana osoba, bez konieczności logowania się do Element przez konsultanta kadrowego.

Kandydat wypełnia formularz na Twojej stronie internetowej, a aplikacja trafia do właściwego projektu w Element automatycznie — z CV w załączniku.

Twój system raportowania (Power BI, Looker, własny dashboard) regularnie pobiera dane o kandydatach i odpowiedziach z formularzy, żeby liczyć metryki rekrutacyjne.

To tylko przykłady. Jeśli masz konkretny system, który chciałbyś podpiąć — odezwij się, sprawdzimy razem czy obecne API to obsłuży.

W trzech krokach:

1. Zaloguj się jako administrator i otwórz sekcję Dostęp do API.

2. Wygeneruj credentials dla systemu, który chcesz podłączyć (np. „voicebot"). System wygeneruje Ci login i hasło. Zapisz hasło od razu w bezpiecznym miejscu — nie da się go potem odzyskać, można je tylko wygenerować na nowo.

3. Przekaż dokumentację swojemu zespołowi IT (lub firmie integrującej). Mamy ją tutaj:

👉Dokumentacja Element External Integration API

Dokumentacja zawiera komplet informacji potrzebnych deweloperowi: opis wszystkich endpointów, format danych, zasady bezpieczeństwa i konkretne przykłady (m.in. voice bot, system ATS, pipeline analityczny).

W aktualnej wersji (`v1-beta`) możesz:

- Czytać dane: projekty rekrutacyjne, ich etapy, kandydatów, profil kandydata, odpowiedzi udzielone w formularzu aplikacyjnym, publiczne notatki.

- Zapisywać dane: dodawać nowych kandydatów do projektów (z CV), dodawać publiczne notatki na profilach.

W kolejnych iteracjach planujemy rozszerzyć API o pełne operacje rekrutacyjne — m.in. zmianę etapu kandydata, odrzucenie kandydata, tworzenie projektów. Powiadomimy Cię, jak tylko będą gotowe.

Tak. Najważniejsze punkty:

- Każdy system zewnętrzny ma własny login i hasło— w razie problemu z jednym systemem reszta nie traci dostępu.

- Hasła trzymamy w formie zhashowanej — nawet nasz zespół nie widzi Twoich haseł.

- Wszystkie wywołania są audytowane — wiemy dokładnie, kto, kiedy i co zrobił przez API.

- Konta API nie liczą się do limitu konsultantów i nie są widoczne na listach konsultantów w panelu — nie zaśmiecają widoków biznesowych.

- Notatki dodane przez API są zawsze publiczne i podpisane Twoim systemem (np. „API: voicebot dodał notatkę") — konsultanci widzą jasno źródło informacji.

- Limit 70 wywołań na minutę chroni Twój tenant przed nadużyciem credentials w razie ich wycieku.

Etykieta `v1-beta` oznacza, że przez najbliższe ~2-3 miesiące zbieramy feedback od pierwszych użytkowników i możemy wprowadzać drobne zmiany w API. Po tym okresie zamrozimy kontrakt jako stabilne `v1` — wszelkie dalsze zmiany będą szły pod nowymi wersjami, nie naruszając istniejących integracji.

Jeśli Twoja firma jest zainteresowana wczesnym wdrożeniem i feedbackiem — daj znać, chętnie pomożemy.

- Pytania techniczne (do dewelopera): kanał wsparcia jak zawsze.

- Pytania o sens biznesowy / „czy moja firma w ogóle tego potrzebuje" / „pomóżcie mi to zrozumieć": napisz, umówimy krótkie spotkanie, na którym pokażemy konkretne use case'y dla Twojego tenanta.

Powodzenia z integracjami!