Тестер вебхуков Discord

Проверь свой вебхук Discord за секунды. Вставь URL, проверь его и отправь тестовое сообщение, чтобы убедиться, что всё работает.

Что такое вебхук Discord?

Вебхук Discord - это уникальный URL, который позволяет отправлять сообщения в конкретный канал Discord без бота. Вебхуки часто используют для уведомлений GitHub, оповещений мониторинга серверов, обновлений CI/CD-конвейеров и собственных интеграций. У каждого вебхука своё имя и аватар, и он привязан к конкретному каналу.

Как создать вебхук Discord

1. Открой свой сервер Discord и перейди в Настройки сервера
2. Перейди в Интеграции > Вебхуки
3. Нажми Новый вебхук
4. Задай имя и выбери целевой канал
5. Нажми Копировать URL вебхука
6. Вставь URL в тестер выше, чтобы проверить его

Как работает этот тестер

Вставь URL вебхука и нажми «Проверить». Инструмент проверяет URL через API Discord и показывает имя, аватар и связанный канал вебхука. Если URL действителен, можно ввести своё сообщение и отправить его через вебхук, чтобы убедиться в работоспособности. URL вебхука проксируется через наш сервер ради безопасности (браузер не может обратиться к API Discord напрямую из-за CORS), но никогда не сохраняется и не логируется.

Частые коды ошибок вебхуков Discord

Когда запрос вебхука не проходит, Discord возвращает HTTP-статус с телом JSON, где есть числовой code и message. Вот те, с которыми реально сталкиваешься:

• 400 Bad Request - Некорректное тело JSON, эмбед превышает 6000 символов суммарно или длина поля больше лимита. Проверяй полезную нагрузку локально перед отправкой.
• 401 Unauthorized - Токен вебхука неверен или был перевыпущен. Перевыпуск вебхука в настройках сервера мгновенно делает старый URL недействительным.
• 404 Not Found - Вебхук удалён, канал удалён или в URL опечатка. Скопируй URL заново в разделе «Настройки сервера > Интеграции».
• 429 Too Many Requests - Сработало ограничение частоты. Discord возвращает поле retry_after (в секундах), которое подсказывает, когда повторить. Соблюдай его.
• Code 50027 (Invalid Webhook Token) - Та же причина, что и у 401; возвращается, когда часть URL с токеном повреждена или обрезана.
• Code 50006 (Cannot send empty message) - В полезной нагрузке нет ни content, ни embeds, ни files. Нужен хотя бы один из них.
• Code 50035 (Invalid Form Body) - Самая частая причина: embed.color отправлен строкой в hex вместо десятичного числа. Переведи #9B59B6 в 10181046 перед отправкой.

Ограничения частоты вебхуков Discord

Discord применяет ограничения частоты на вебхук и на канал, а точные размеры корзин определяются на стороне сервера и передаются в заголовках ответа, а не заданы фиксированным числом. Каждый успешный ответ содержит X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset-After - читай их, чтобы планировать следующий запрос, и не задавай фиксированную частоту в коде. Тело ответа 429 также содержит значение retry_after (в секундах). Для интеграций с большим объёмом (сборочные конвейеры, агрегация логов) объединяй несколько событий в одно сообщение: один вызов вебхука несёт до 10 эмбедов и до 6000 символов суммарно на эмбед, чего обычно хватает, чтобы свести всплеск событий к одному запросу.

Практики безопасности для вебхуков

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

• Никогда не коммить URL вебхуков в публичный Git-репозиторий. Сканирование секретов GitHub находит и отзывает утёкшие вебхуки Discord автоматически, но только после того, как они уже раскрыты.
• Храни URL вебхуков в переменных окружения или в менеджере секретов, а не в исходном коде и не в конфигах под контролем версий.
• Если вебхук раскрыт, сразу удали его в разделе Настройки сервера > Интеграции > Вебхуки. При пересоздании появляется новый токен, а старый URL перестаёт работать.
• Для клиентской части (браузерное приложение, публикующее в Discord) проводи вызов через собственный бэкенд, чтобы URL никогда не попадал в браузер пользователя. Утёкший URL из браузерного приложения притягивает вандализм.
• Вебхуки Discord игнорируют упоминания @everyone и @here, пока allowed_mentions явно их не разрешит. Поставь "parse": [], чтобы отключить все пинги упоминаний, если они не нужны.

Ручная проверка вебхука через curl

Если удобнее тестировать из терминала, минимальная полезная нагрузка - одно поле content. Успешный POST возвращает HTTP 204 с пустым телом или HTTP 200 с JSON созданного сообщения, если добавить ?wait=true к URL. Используй ?wait=true, когда нужен ID сообщения (например, чтобы позже отредактировать или удалить его через эндпоинт /webhooks/<id>/<token>/messages/<message_id>).

Другие бесплатные инструменты для Discord

• Snowflake Checker - Узнай возраст любого аккаунта Discord
• Colored Text Generator - Создавай цветные сообщения с ANSI-кодами
• Message Length Counter - Проверь, влезает ли сообщение в лимиты Discord
• Color Role Previewer - Смотри цвета ролей во всех темах Discord

Работает на Pigona - Бесплатный перевод для Discord