## Po co to?

OLX.pl to największy polski portal i jedno z miejsc o największym ruchu, gdzie można ogłosić rekrutację. Bez integracji publikowanie tam oznacza ręczne przepisywanie każdej oferty — tytuł, opis, wynagrodzenie, lokalizacja — i powtarzanie tego za każdym razem, gdy stanowisko się zmienia albo rekrutacja się kończy. Wystarczy raz połączyć OLX z Kit i możesz wysłać dowolną ofertę na OLX w kilka minut: Kit wstępnie wypełnia kategorię OLX, miasto i pola na podstawie Twojego ogłoszenia, Ty sprawdzasz i publikujesz. Gdy ogłoszenie się zmienia — zostaje wstrzymane, zamknięte albo otwarte ponownie — Kit utrzymuje ogłoszenie na OLX w zgodzie z tym stanem.

## Jak to działa

- **Połączysz raz, na cały workspace.** Administrator łączy Wasze konto OLX; cały zespół publikuje przez to jedno połączenie.
- **Ze wsparciem AI, potwierdzane przez człowieka.** Kit proponuje kategorię OLX, miasto, typ umowy i treść ogłoszenia na podstawie Twojej oferty. Sprawdzasz i edytujesz, zanim cokolwiek zostanie opublikowane — nic nie publikuje się bez weryfikacji.
- **Pozostaje zsynchronizowane.** Wstrzymanie lub zamknięcie ogłoszenia dezaktywuje jego ogłoszenie na OLX; ponowne otwarcie je przywraca. Status ogłoszenia (aktywne / odrzucone) wraca automatycznie do Kit.

> [!IMPORTANT]
> **OLX wymaga ponownego połączenia co 30 dni.** Ze względów bezpieczeństwa OLX wygasza dostęp aplikacji 30 dni po połączeniu — to zasada OLX, nie ograniczenie Kit. Kit ostrzega administratorów na 5 dni i na 1 dzień przed, a jeśli dostęp wygaśnie, powiadamia właściciela konta — dzięki temu połączysz się ponownie, zanim publikowanie zostanie przerwane.

## Łączenie konta OLX

Potrzebujesz aktywnego konta OLX.pl i uprawnień administratora w Kit.

> [!IMPORTANT]
> **OLX wymaga konta firmowego do publikowania ofert pracy.** Ogłoszenia o pracę na OLX.pl to produkt dla pracodawców — z prywatnego konta OLX nie da się ich opublikować. Jeśli Twoje konto jest prywatne, panel połączenia pokazuje ostrzeżenie z linkiem do zmiany. [Załóż konto firmowe na OLX](https://www.olx.pl/praca/), zanim opublikujesz.

1. Otwórz **Integrations** (Integracje) w ustawieniach workspace.
2. W sekcji **Job distribution** (Dystrybucja ogłoszeń) kliknij kartę **OLX.pl**.
3. Kliknij **Connect OLX** (Połącz OLX), zaloguj się na OLX.pl i zatwierdź dostęp. Wrócisz od razu z powrotem — zajmuje to około minuty.

Na karcie pojawia się wtedy zielony badge **Connected** (Połączono), Twoje konto OLX i data **Reconnect required by** (Połącz ponownie do).

## Publikowanie oferty na OLX

Otwórz **opublikowane** ogłoszenie o pracę. Panel **Distribution** (Dystrybucja) pokazuje OLX z przyciskiem **Post to OLX** (Opublikuj na OLX).

1. Kliknij **Post to OLX**. Kit czyta Twoje ogłoszenie i wstępnie wypełnia ogłoszenie na OLX — kategorię, miasto, typ umowy, wynagrodzenie oraz tytuł i opis ogłoszenia.
2. **Sprawdź dopasowanie.** Pola zasugerowane przez Kit są oznaczone chipem **AI**; możesz edytować każde z nich. Wybierz **Category** (kategorię) i **City** (miasto) na OLX (zacznij pisać, żeby zobaczyć podpowiedzi). Tytuł i opis pokazują na żywo liczbę znaków i ostrzegają o zasadach OLX (długość oraz zakaz numerów telefonu, adresów e-mail i linków w treści).
3. Kliknij **Confirm & publish to OLX** (Potwierdź i opublikuj na OLX).

Wiersz OLX pokazuje wtedy **Pending review** (Oczekuje na moderację), gdy OLX moderuje ogłoszenie (zwykle poniżej minuty), a następnie **Live on OLX** (Aktywne na OLX) z linkiem **View on OLX** (Zobacz na OLX). Jeśli OLX oznaczy ogłoszenie, wiersz pokazuje **Needs attention** (Wymaga uwagi) — kliknij **Fix & retry** (Popraw i ponów), dostosuj i wyślij ponownie.

> [!TIP]
> **OLX nie pozwala na dane kontaktowe w treści ogłoszenia.** Kit automatycznie usuwa numery telefonu, adresy e-mail i linki oraz ostrzega Cię podczas edycji — to najczęstszy powód oznaczenia ogłoszenia.

## Automatyczna dystrybucja nowych ogłoszeń

Żeby wysyłać nowe oferty na OLX bez klikania za każdym razem, włącz **Auto-distribute new postings** (Automatyczna dystrybucja nowych ogłoszeń) na panelu połączenia OLX (Integrations → OLX.pl).

Gdy to włączysz, opublikowanie oferty automatycznie przygotowuje ogłoszenie na OLX, a panel Distribution ogłoszenia pokazuje **Review needed** (Wymaga przeglądu). Nadal sprawdzasz i potwierdzasz dopasowanie, zanim zostanie opublikowane — automatyczna dystrybucja zajmuje się przygotowaniem, nigdy samą publikacją.

## Utrzymywanie ogłoszeń w synchronizacji

| Gdy Ty… | Kit robi to na OLX |
|-----------|----------------------|
| **Wstrzymujesz** lub **zamykasz** ogłoszenie | Dezaktywuje ogłoszenie na OLX |
| **Otwierasz ponownie** ogłoszenie | Reaktywuje ogłoszenie |
| Ogłoszenie staje się **aktywne** lub zostaje **oznaczone** | Aktualizuje wiersz + powiadamia osobę, która je opublikowała |

Dostajesz powiadomienie w Kit (a przy oznaczonych ogłoszeniach też mailem) w momencie, gdy ogłoszenie staje się aktywne lub wymaga uwagi — nie musisz pilnować strony.

> [!WARNING]
> **Jeśli połączenie wygaśnie.** Nowe ogłoszenia nie zostaną opublikowane, a istniejących ogłoszeń na OLX nie da się aktualizować ani usuwać przez Kit, dopóki nie połączysz się ponownie. Ogłoszenia już aktywne na OLX pozostają aktywne. Ponowne połączenie przywraca wszystko.

## Status połączenia

Badge na karcie OLX pokazuje jeden ze stanów: **Connected** (zielony, działa), **Pending** (bursztynowy, połącz ponownie w ciągu kilku dni — pojawia się panel „Reconnect OLX soon") albo **Error** (czerwony, Kit nie mógł połączyć się z OLX). Jeśli dostęp wygasł, zobaczysz panel **„OLX connection expired"** z przyciskiem **Reconnect OLX** (Połącz ponownie OLX). W każdej chwili użyj **Re-check connection** (Sprawdź połączenie ponownie), żeby potwierdzić, że wszystko działa.

## Prośba o kolejny portal

Chcesz, żeby Kit obsługiwał portal inny niż OLX? Na panelu Distribution ogłoszenia kliknij **Request a platform** (Poproś o platformę), podaj nazwę i (opcjonalnie) link, a rozważymy dodanie go.

## Rozwiązywanie problemów

- **Brak przycisku „Post to OLX"** — ogłoszenie musi być **opublikowane**, a administrator musi mieć połączony OLX (Integrations → Job distribution → OLX.pl).
- **Publikacja odrzucona z błędem „tytuł za krótki" lub niejasnym komunikatem** — OLX często zwraca to, gdy **prywatne** konto próbuje opublikować ofertę pracy. OLX wymaga **konta firmowego** do ofert pracy; przełącz konto OLX na firmowe, połącz ponownie i spróbuj jeszcze raz.
- **Ogłoszenie oznaczone / „Needs attention"** — zwykle dane kontaktowe w opisie albo tytuł, który jest za długi lub krzykliwy. Kliknij **Fix & retry**, dostosuj, wyślij ponownie.
- **„OLX isn't connected" / „Invalid OAuth state"** — zacznij łączenie od nowa z karty OLX; link do połączenia jest jednorazowy, więc nie korzystaj ze starej karty.
- **Połączenie ciągle wygasa** — tak ma być, co 30 dni; wypatruj maili z przypomnieniami albo sprawdzaj datę **Reconnect required by**.

## W skrócie

- [ ] Twoje konto OLX to konto **firmowe** (wymagane do ofert pracy)
- [ ] Administrator połączył OLX (Integrations → Job distribution → OLX.pl)
- [ ] Ogłoszenie jest **opublikowane**
- [ ] Kliknięto **Post to OLX** i sprawdzono dopasowanie wstępnie wypełnione przez AI
- [ ] Brak numeru telefonu, e-maila i linków w treści ogłoszenia
- [ ] Potwierdzono — wiersz pokazuje **Pending review**, a potem **Live on OLX**