> ## 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.

# Панели заявок

> Набирайте персонал и обрабатывайте запросы ролей с помощью форм вопросов, фильтров допустимости, голосования рецензентов и автоматических действий.

Участник нажимает кнопку, отвечает на ваши вопросы, а персонал принимает или отклоняет. При принятии Vetox может назначить роли, отправить ЛС, переименовать участника, открыть канал интервью и многое другое.

## Лимиты

|                         | Starter | Basic | Max | Black |
| ----------------------- | ------- | ----- | --- | ----- |
| Панелей                 | 1       | 3     | 10  | 10    |
| Вопросов на форму       | 5       | 15    | 50  | 50    |
| Действий на этап        | 1       | 3     | 10  | 10    |
| Форм (кнопок) на панель | 1       | 3     | 5   | 10    |

<Warning>
  **Понижение безвозвратно удаляет вопросы сверх нового лимита.** Это единственное место в Vetox, где понижение уничтожает данные, а не отключает их.

  Переход с Max (50 вопросов) на Basic (15) удаляет вопросы с 16-го и далее навсегда. Повторное повышение не возвращает их.

  **Экспортируйте или скопируйте свои вопросы перед понижением.**
</Warning>

Всё остальное при понижении отключается, а не удаляется, и возвращается при повышении.

## Два способа подачи

<CardGroup cols={2}>
  <Card title="Dialog Button" icon="window-maximize">
    Всплывающая форма Discord. Бесплатно на любом тарифе. **Максимум 5 вопросов.**
  </Card>

  <Card title="Private Message" icon="envelope">
    Vetox пишет заявителю в ЛС и задаёт вопросы по одному. Поддерживает полный лимит вопросов.
  </Card>
</CardGroup>

<Warning>
  **Форму-диалог с 6 и более вопросами, где любой вопрос после пятого обязателен, никогда невозможно отправить.**

  Всплывающие окна Discord содержат 5 полей. Вопросы сверх этого не отображаются, но обязательный всё равно проверяется — заявителю сообщают, что не хватает обязательного ответа, но нет способа его предоставить. Ничто не предупреждает вас при сохранении.

  Если вам нужно более 5 вопросов, используйте способ **Private Message**.
</Warning>

### Что не может делать способ ЛС

Способ ЛС задаёт вопросы как чат-сообщения, поэтому более богатые типы вопросов деградируют:

| Тип вопроса                 | Dialog Button | Private Message            |
| --------------------------- | ------------- | -------------------------- |
| Короткий текст, Абзац       | Нативно       | Нативно                    |
| Выпадающий список           | Нативно       | Нативный выбор             |
| **Выбор пользователя**      | Нативно       | **Текстом, без валидации** |
| **Выбор роли**              | Нативно       | **Текстом, без валидации** |
| **Выбор канала**            | Нативно       | **Текстом, без валидации** |
| **Выбор пользователя/роли** | Нативно       | **Текстом, без валидации** |
| **Загрузка файла**          | Нативно       | **Только имена файлов**    |

<Warning>
  В способе ЛС четыре типа выбора принимают **любой текст** без валидации. Заявитель может ввести что угодно, и это сохранится как его ответ. Не полагайтесь на то, что ответ выбора будет реальным пользователем, ролью или каналом в форме ЛС.
</Warning>

## Вопросы

Восемь типов. Текстовые вопросы принимают диапазон 0–4000 символов; выпадающие списки — до 25 вариантов; загрузка файлов — до 10 файлов.

## Допустимость

Кому разрешено подавать заявку:

| Фильтр                                   | Что проверяет                                              |
| ---------------------------------------- | ---------------------------------------------------------- |
| **Минимальный возраст аккаунта**         | Сколько лет их аккаунту Discord                            |
| **Минимальный срок членства на сервере** | Как долго они находятся на вашем сервере                   |
| **Обязательные роли**                    | Должны иметь **любую** или **все** из них                  |
| **Заблокированные роли**                 | Не должны иметь **никакой** или **всех** из них            |
| **Мульти-серверная верификация**         | Должны быть участником других названных серверов (**Max**) |
| **Cooldown**                             | 0–1440 минут между заявками                                |
| **Максимум в ожидании**                  | 1–5 открытых заявок на человека                            |
| **Доступность ЛС**                       | Их ЛС должны быть открыты (включено по умолчанию)          |

<Info>
  Обязательные и заблокированные роли, а также авто-отклонение требуют **Basic**. Мульти-серверная верификация требует **Max**.
</Info>

<Warning>
  **Нет фильтра «уже принят».** После принятия человек может подать заявку снова, как только истечёт cooldown. Если вы не хотите повторных заявок, установите длинный cooldown или добавьте принятую роль в **Blocked roles**.
</Warning>

## Действия workflow

Что происходит при подаче, принятии или отклонении.

| Действие                                      | Тариф     |
| --------------------------------------------- | --------- |
| Добавить роли, Удалить роли                   | Бесплатно |
| Отправить embed, Отправить ЛС, Пинговать роли | Бесплатно |
| Изменить никнейм, Задать теги форума          | Бесплатно |
| Kick, Ban, Timeout участника                  | Basic     |
| Изменить имя темы                             | Basic     |
| Создать канал интервью                        | Basic     |
| Авто-назначить роль испытательного срока      | Max       |
| Отложить действие / цепочка действий          | Max       |
| **Выполнить команду**                         | Max       |

<Warning>
  **Выполнить команду ничего не делает.** Оно сохраняется, оно заблокировано за Max, и бот логирует его и идёт дальше без выполнения команды. Редактор помечает это соответственно, но всё равно преподносит как платную возможность.

  Не выстраивайте workflow, зависящий от него.
</Warning>

### Переменные в сообщениях действий

<Warning>
  Переменные участника и сервера — `{username}`, `{user.displayName}`, `{nickname}`, `{guildname}`, `{server.name}`, `{server.memberCount}` — **не преобразуются в шаблонах действий workflow.**

  Шаблон вроде `[{answer1}] {username}` отрисуется как `[их ответ]` с висящим пробелом. Используйте переменные ответов и статический текст в действиях workflow; помещайте данные участника в сообщения ЛС, где они работают.
</Warning>

## Рассмотрение персоналом

Заявки публикуются в канал просмотра, где рецензенты принимают или отклоняют.

| Опция                      | Заметки                                                         |
| -------------------------- | --------------------------------------------------------------- |
| **Канал просмотра**        | Текстовый, анонсовый или форум                                  |
| **Роли рецензентов**       | До 10                                                           |
| **Добавить тему к заявке** | Тема на каждую заявку (**Basic**)                               |
| **Голосование**            | Требовать N одобрений или отклонений перед решением (**Basic**) |
| **Авто-отклонение**        | Отклонить через 1–720 часов в ожидании (**Basic**)              |

<Note>
  Опция **приватной темы** для тем просмотра не имеет эффекта — темы просмотра всегда публичны для всех, кто может видеть канал просмотра. Ограничивайте сам канал вместо этого.
</Note>

<Note>
  Рецензент не может рассматривать свою собственную заявку.
</Note>

## Права, необходимые Vetox

| Действие                     | Право                                                   |
| ---------------------------- | ------------------------------------------------------- |
| Добавить или удалить роли    | **Manage Roles**, и роль должна быть **ниже** Vetox     |
| Изменить никнейм             | **Manage Nicknames**, и участник должен быть ниже Vetox |
| Kick / Ban / Timeout         | Соответствующее право, и участник ниже Vetox            |
| Опубликовать embed просмотра | **View Channel**, **Send Messages**, **Embed Links**    |
| Темы просмотра               | **Manage Threads**                                      |
| Каналы интервью              | **Manage Channels**                                     |

<Warning>
  **Если Vetox не может опубликовать в канал просмотра, заявителю всё равно сообщат, что заявка отправлена** — а персонал её никогда не увидит. Убедитесь, что бот может публиковать в канале просмотра, прежде чем запускать.
</Warning>

Большинство остальных сбоев сообщается в канал просмотра, чтобы персонал видел, что пошло не так.

## Настройка

<Steps>
  <Step title="Включите Applications в Server Setup" />

  <Step title="Начните с шаблона">
    Предоставлены шесть — Staff Application, Game Member, Role Request, Event Signup, Partner Inquiry, Verification — или начните с чистого листа.
  </Step>

  <Step title="Выберите способ">
    Пять вопросов или меньше — Dialog Button подходит. Больше пяти — используйте Private Message.
  </Step>

  <Step title="Задайте канал просмотра и роли рецензентов">
    Убедитесь, что Vetox может публиковать там.
  </Step>

  <Step title="Добавьте действия принятия">
    Обычно: добавить роль, отправить приветственное ЛС. Проверьте, что роль ниже Vetox.
  </Step>

  <Step title="Задайте допустимость">
    Минимальный возраст аккаунта блокирует одноразовые аккаунты почти без ущерба для настоящих заявителей.
  </Step>

  <Step title="Отправьте панель и протестируйте её сами">
    Подайте настоящую заявку и доведите её до принятия перед объявлением.
  </Step>
</Steps>

## Устранение неполадок

<AccordionGroup>
  <Accordion title="Заявители получают ошибку об отсутствии обязательного ответа, которую не могут исправить">
    Форма-диалог с более чем 5 вопросами, где более поздний обязателен. Переключитесь на способ Private Message или сделайте вопросы 6+ необязательными.
  </Accordion>

  <Accordion title="Заявки отправляются, но персонал их не видит">
    Vetox не может публиковать в канал просмотра. Заявителю всё равно сообщают об успехе.
  </Accordion>

  <Accordion title="Роль не назначается при принятии">
    Manage Roles, и роль должна быть ниже Vetox в списке ролей.
  </Accordion>

  <Accordion title="Кто-то, кого уже приняли, снова подал заявку">
    Ожидаемо — для этого нет фильтра. Добавьте принятую роль в Blocked roles.
  </Accordion>

  <Accordion title="Мои переменные пустые в действии принятия">
    Переменные участника и сервера не преобразуются в действиях workflow. Перенесите этот текст в ЛС о принятии.
  </Accordion>

  <Accordion title="Вопросы исчезли после смены тарифа">
    Понижение обрезает вопросы после нового лимита, и их нельзя восстановить.
  </Accordion>

  <Accordion title="Кнопка ничего не делает при клике">
    Обычно панель была отредактирована или пересоздана после отправки сообщения. Отправьте панель снова.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Отправки" icon="inbox" href="/ru/utility/applications/submissions">
    Просматривайте, фильтруйте и экспортируйте заявки.
  </Card>

  <Card title="Аналитика" icon="chart-line" href="/ru/utility/applications/analytics">
    Показатели принятия и где заявители отваливаются.
  </Card>
</CardGroup>