> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Panele aplikacji

> Rekrutuj personel i przetwarzaj prośby o role za pomocą formularzy pytań, bramek uprawnień, głosowania recenzentów i zautomatyzowanych akcji.

Członek klika przycisk, odpowiada na Twoje pytania, a personel akceptuje lub odrzuca. Po akceptacji Vetox może nadać role, wysłać DM, zmienić nick, otworzyć kanał wywiadu i więcej.

## Limity

|                                  | Starter | Basic | Max | Black |
| -------------------------------- | ------- | ----- | --- | ----- |
| Panele                           | 1       | 3     | 10  | 10    |
| Pytania per formularz            | 5       | 15    | 50  | 50    |
| Akcje per etap                   | 1       | 3     | 10  | 10    |
| Formularze (przyciski) per panel | 1       | 3     | 5   | 10    |

<Warning>
  **Downgrade trwale usuwa pytania ponad nowy limit.** To jedyne miejsce w Vetox, gdzie downgrade niszczy dane zamiast je wyłączać.

  Przejście z Max (50 pytań) na Basic (15) usuwa pytania od 16 wzwyż na zawsze. Ponowny upgrade ich nie przywraca.

  **Wyeksportuj lub skopiuj pytania przed downgrade.**
</Warning>

Wszystko inne przy downgrade jest wyłączane, a nie usuwane, i wraca przy upgrade.

## Dwa przepływy zgłoszeń

<CardGroup cols={2}>
  <Card title="Przycisk dialogu" icon="window-maximize">
    Pop-up Discord z formularzem. Darmowe na każdym poziomie. **Maksymalnie 5 pytań.**
  </Card>

  <Card title="Prywatna wiadomość" icon="envelope">
    Vetox pisze DM do aplikującego i zadaje pytania jedno po drugim. Obsługuje pełny limit pytań.
  </Card>
</CardGroup>

<Warning>
  **Formularz dialogowy z 6 lub więcej pytaniami, gdzie któreś pytanie po piątym jest wymagane, nigdy nie może być wysłany.**

  Pop-upy Discord mieszczą 5 pól. Pytania poza tym nie są pokazywane, ale wymagane wciąż jest sprawdzane — więc aplikujący jest informowany, że brakuje wymaganej odpowiedzi, bez sposobu, aby ją dostarczyć. Nic Cię nie ostrzega przy zapisie.

  Jeśli potrzebujesz więcej niż 5 pytań, użyj przepływu **Prywatna wiadomość**.
</Warning>

### Czego nie może zrobić przepływ DM

Przepływ DM zadaje pytania jako wiadomości czatu, więc bogatsze typy pytań się degradują:

| Typ pytania          | Przycisk dialogu | Prywatna wiadomość                  |
| -------------------- | ---------------- | ----------------------------------- |
| Krótki tekst, Akapit | Natywne          | Natywne                             |
| Dropdown             | Natywne          | Natywny picker                      |
| **User picker**      | Natywne          | **Wpisany tekst, niezweryfikowany** |
| **Role picker**      | Natywne          | **Wpisany tekst, niezweryfikowany** |
| **Channel picker**   | Natywne          | **Wpisany tekst, niezweryfikowany** |
| **User/Role picker** | Natywne          | **Wpisany tekst, niezweryfikowany** |
| **Upload pliku**     | Natywne          | **Tylko nazwy plików**              |

<Warning>
  W przepływie DM cztery typy pickerów akceptują **dowolny tekst** bez walidacji. Aplikujący może wpisać cokolwiek i jest to zapisane jako jego odpowiedź. Nie polegaj na tym, że odpowiedź pickera to prawdziwy użytkownik, rola lub kanał w formularzu DM.
</Warning>

## Pytania

Osiem typów. Pytania tekstowe mają zakres 0–4 000 znaków; dropdowny mają do 25 wyborów; uploady plików mają do 10 plików.

## Uprawnienia

Kto może aplikować:

| Bramka                               | Co sprawdza                                                |
| ------------------------------------ | ---------------------------------------------------------- |
| **Minimalny wiek konta**             | Ile lat ma konto Discord                                   |
| **Minimalne członkostwo w serwerze** | Jak długo są w Twoim serwerze                              |
| **Wymagane role**                    | Muszą mieć **którąkolwiek** lub **wszystkie** z nich       |
| **Zablokowane role**                 | Nie mogą mieć **którejkolwiek** ani **wszystkich**         |
| **Weryfikacja wieloserwerowa**       | Muszą być członkami innych wymienionych serwerów (**Max**) |
| **Cooldown**                         | 0–1 440 minut między aplikacjami                           |
| **Max oczekujących**                 | 1–5 otwartych aplikacji per osoba                          |
| **DM osiągalne**                     | Ich DM-y muszą być otwarte (domyślnie włączone)            |

<Info>
  Wymagane i zablokowane role oraz auto-deny wymagają **Basic**. Weryfikacja wieloserwerowa wymaga **Max**.
</Info>

<Warning>
  **Nie ma bramki „już zaakceptowany".** Gdy ktoś zostanie zaakceptowany, może aplikować ponownie, gdy tylko cooldown wygaśnie. Jeśli nie chcesz powtarzanych aplikacji, ustaw długi cooldown lub dodaj zaakceptowaną rolę do **Zablokowanych ról**.
</Warning>

## Akcje workflow

Co się dzieje przy submit, accept lub deny.

| Akcja                                | Poziom  |
| ------------------------------------ | ------- |
| Dodaj role, Usuń role                | Darmowe |
| Wyślij embed, Wyślij DM, Pinguj role | Darmowe |
| Edytuj nick, Ustaw tagi forum        | Darmowe |
| Kick, Ban, Timeout członek           | Basic   |
| Edytuj nazwę wątku                   | Basic   |
| Utwórz kanał wywiadu                 | Basic   |
| Auto-nadawanie roli probacyjnej      | Max     |
| Opóźnij akcję / łańcuch akcji        | Max     |
| **Execute command**                  | Max     |

<Warning>
  **Execute command nic nie robi.** Zapisuje się, jest bramkowane za Max, a bot loguje to i przechodzi dalej bez uruchamiania komendy. Edytor odpowiednio go etykietuje, ale nadal jest prezentowane jako płatna możliwość.

  Nie buduj workflow, który od tego zależy.
</Warning>

### Zmienne w wiadomościach akcji

<Warning>
  Zmienne członka i serwera — `{username}`, `{user.displayName}`, `{nickname}`, `{guildname}`, `{server.name}`, `{server.memberCount}` — **rozwiązują się do niczego wewnątrz szablonów akcji workflow.**

  Szablon jak `[{answer1}] {username}` renderuje się jako `[ich odpowiedź]` ze spacją na końcu. Używaj zmiennych odpowiedzi i statycznego tekstu w akcjach workflow; szczegóły członka umieść w wiadomościach DM, gdzie działają.
</Warning>

## Recenzja przez personel

Aplikacje publikowane są w kanale recenzji, gdzie recenzenci akceptują lub odrzucają.

| Opcja                         | Uwagi                                                       |
| ----------------------------- | ----------------------------------------------------------- |
| **Kanał recenzji**            | Tekstowy, ogłoszeniowy lub forum                            |
| **Role recenzentów**          | Do 10                                                       |
| **Dodaj wątek do zgłoszenia** | Wątek per aplikacja (**Basic**)                             |
| **Głosowanie**                | Wymagaj N akceptacji lub odrzuceń przed decyzją (**Basic**) |
| **Auto-deny**                 | Odrzuć po 1–720 godzinach oczekiwania (**Basic**)           |

<Note>
  Opcja **private thread** dla wątków recenzji nie działa — wątki recenzji są zawsze publiczne dla wszystkich, którzy widzą kanał recenzji. Zamiast tego ogranicz sam kanał.
</Note>

<Note>
  Recenzent nie może recenzować własnej aplikacji.
</Note>

## Uprawnienia, których Vetox potrzebuje

| Akcja                    | Uprawnienie                                                   |
| ------------------------ | ------------------------------------------------------------- |
| Dodaj lub usuń role      | **Manage Roles**, a rola musi znajdować się **poniżej** Vetox |
| Edytuj nick              | **Manage Nicknames**, a członek musi być poniżej Vetox        |
| Kick / Ban / Timeout     | Pasujące uprawnienie, a członek poniżej Vetox                 |
| Opublikuj embed recenzji | **View Channel**, **Send Messages**, **Embed Links**          |
| Wątki recenzji           | **Manage Threads**                                            |
| Kanały wywiadów          | **Manage Channels**                                           |

<Warning>
  **Jeśli Vetox nie może opublikować w kanale recenzji, aplikującemu wciąż jest mówione, że aplikacja została wysłana** — podczas gdy personel nigdy jej nie widzi. Zweryfikuj, że bot może publikować w kanale recenzji przed uruchomieniem.
</Warning>

Większość innych awarii jest zgłaszana w kanale recenzji, aby personel widział, co poszło źle.

## Konfigurowanie

<Steps>
  <Step title="Włącz Aplikacje w Server Setup" />

  <Step title="Zacznij od szablonu">
    Dostarczonych jest sześć — Aplikacja o staff, Członek gry, Prośba o rolę, Zapisy na wydarzenie, Zapytanie partnerskie, Weryfikacja — albo zacznij od pustego.
  </Step>

  <Step title="Wybierz przepływ">
    Pięć pytań lub mniej, Przycisk dialogu jest OK. Więcej niż pięć, użyj Prywatnej wiadomości.
  </Step>

  <Step title="Ustaw kanał recenzji i role recenzentów">
    Potwierdź, że Vetox może tam publikować.
  </Step>

  <Step title="Dodaj akcje accept">
    Zazwyczaj: dodaj rolę, wyślij powitalny DM. Sprawdź, że rola jest poniżej Vetox.
  </Step>

  <Step title="Ustaw uprawnienia">
    Minimalny wiek konta blokuje jednorazowe konta przy prawie zerowym koszcie dla prawdziwych aplikujących.
  </Step>

  <Step title="Wyślij panel i przetestuj go samodzielnie">
    Wyślij prawdziwą aplikację i przeprowadź ją aż do akceptacji, zanim to ogłosisz.
  </Step>
</Steps>

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="Aplikujący dostają błąd brakującej wymaganej odpowiedzi, którego nie mogą naprawić">
    Formularz dialogowy z więcej niż 5 pytaniami, gdzie późniejsze jest wymagane. Przełącz na przepływ Prywatna wiadomość albo uczyń pytania 6+ opcjonalnymi.
  </Accordion>

  <Accordion title="Aplikacje wysyłają się, ale personel ich nigdy nie widzi">
    Vetox nie może publikować w kanale recenzji. Aplikujący jest niezależnie informowany, że zadziałało.
  </Accordion>

  <Accordion title="Rola nie jest nadawana przy akceptacji">
    Manage Roles, a rola musi być poniżej Vetox na liście ról.
  </Accordion>

  <Accordion title="Ktoś już zaakceptowany aplikował ponownie">
    To normalne — nie ma dla tego bramki. Dodaj zaakceptowaną rolę do Zablokowanych ról.
  </Accordion>

  <Accordion title="Moje zmienne renderują się puste w akcji accept">
    Zmienne członka i serwera nie rozwiązują się w akcjach workflow. Przenieś ten tekst do DM akceptacji.
  </Accordion>

  <Accordion title="Pytania zniknęły po zmianie planu">
    Downgrade przycina pytania ponad nowy limit i nie można ich odzyskać.
  </Accordion>

  <Accordion title="Przycisk nic nie robi po kliknięciu">
    Zwykle panel, który był edytowany lub odtworzony po wysłaniu wiadomości. Wyślij panel ponownie.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Zgłoszenia" icon="inbox" href="/pl/utility/applications/submissions">
    Recenzuj, filtruj i eksportuj aplikacje.
  </Card>

  <Card title="Analityka" icon="chart-line" href="/pl/utility/applications/analytics">
    Wskaźniki akceptacji i gdzie aplikujący odpadają.
  </Card>
</CardGroup>