Объявления

Объявление — это сообщение, под которым находится до пяти кнопок перевода. Участник, нажавший одну из них, видит объявление в переводе на этот язык в ответе, который видит только он.

• Кнопки настраиваются один раз для всего сервера: язык, подпись, эмодзи или и то и другое, а также цвет (сине-фиолетовый, серый, зелёный или красный).

• До {max} кнопок, которые показываются в этом порядке под каждым объявлением. Каждая переводит объявление на свой язык. У двух кнопок не может быть одного языка.

• Нажатие переводит текст и эмбеды объявления. Вложения никогда не переводятся.

• В режиме ответа нажатие всегда переводит текущий текст исходного сообщения, даже если его отредактировали.

• Объявления бесплатны на любом сервере, до 3 в день.

1. Вкладка «Редактор» в панели управления: напишите сообщение, проверьте предпросмотр, отправьте.

2. Внешний вебхук: URL, который может использовать любой инструмент, умеющий отправлять сообщения в вебхук Discord.

3. Контекстная команда на существующем сообщении.

4. Канал объявлений: каждое опубликованное в нём сообщение становится объявлением.

Вкладка «Редактор» в панели управления: напишите сообщение, проверьте предпросмотр, отправьте.

Переключите формат на «Контейнер», чтобы опубликовать карточку Components V2: тексты, разделители, разделы (тексты с кнопкой-ссылкой или изображением справа), медиагалереи и кнопки-ссылки с необязательным акцентным цветом. Изображение может быть ссылкой или одним из вложений; вложения, которые карточка не использует, показываются под ней.

В обоих форматах у объявления может быть до 5 собственных кнопок-ссылок. Они показываются в отдельном ряду над кнопками перевода.

URL вебхука позволяет другому инструменту или сервису публиковать объявления в одном канале вместе с кнопками.

URL принимает те же запросы, что и вебхук Discord, поэтому любой инструмент, умеющий отправлять сообщения в вебхук Discord, может публиковать объявления: вставьте URL туда, где инструмент просит URL вебхука Discord.

Отправить сообщение:

curl -X POST "$WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d '{"content": "Hello everyone!"}'

Отправить сообщение с файлом:

curl -X POST "$WEBHOOK_URL" \
  -F 'payload_json={"content": "New screenshots"}' \
  -F 'files[0][email protected]'

Отправить сообщение Components V2:

curl -X POST "$WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d '{"flags": 32768, "components": [{"type": 17, "components": [{"type": 10, "content": "## Patch notes"}, {"type": 14}, {"type": 9, "components": [{"type": 10, "content": "..."}], "accessory": {"type": 2, "style": 5, "label": "Changelog", "url": "https://example.com"}}]}]}'

Сообщения Components V2 поддерживаются: укажите flags = 32768 и отправьте контейнеры из текстов, разделителей, разделов, медиагалерей и рядов кнопок-ссылок. Изображение может ссылаться на загруженный файл через attachment:// и имя файла. Не более 5 кнопок-ссылок на сообщение; другие кнопки и меню выбора отклоняются, так как бот добавляет собственные кнопки перевода в последний ряд.

Переданные в запросе username или avatar_url заменяют сохранённые имя и аватар вебхука — только для этого сообщения.

Нажмите на сообщение правой кнопкой мыши (на телефоне — долгое нажатие), откройте «Приложения» и выберите Сделать объявлением. Команду видят только участники, которые могут управлять сообщениями. Сообщение, которое уже является объявлением, будет отклонено.

Каждое сообщение участника в этих каналах автоматически становится объявлением. После исчерпания дневного лимита сообщения остаются как есть.

Контекстная команда и каналы объявлений превращают существующее сообщение в объявление в одном из трёх режимов. Режим сервера по умолчанию действует везде, а каждый канал объявлений может его переопределить.

Нажатия на кнопки переводятся премиум-движком этого сервера вместо бесплатного. Каждый язык оплачивается только один раз на объявление и хранится 90 дней, поэтому последующие нажатия ничего не стоят. Когда символы заканчиваются, работу берёт на себя бесплатный движок.

Если объявление отредактировали, его перевод выполняется заново один раз. Если премиум-перевод не удался, вместо него отвечает бесплатный движок.

Каждый сервер может публиковать 3 объявления в день, откуда бы они ни пришли. Счётчик сбрасывается в полночь по UTC.

• Редактор и внешние вебхуки: объявление отклоняется с ошибкой.

• Контекстная команда: сообщение об ошибке подскажет, когда лимит сбросится.

• Канал объявлений: сообщение молча остаётся нетронутым.

Всё это можно настроить и из Discord. Эти команды доступны только модераторам.

Слэш-команды

/объявления кнопка задать
/объявления кнопка удалить
/объявления канал добавить
/объявления канал удалить
/объявления режим
/объявления premium_перевод
/объявления текст_ответа
/объявления показать