Проверка «канал существует» мало что говорит о webhook: его могли удалить, перенести, заменить token, ограничить политикой или вызвать с некорректным телом. Начните с одного минимального HTTP-запроса и сохраните ответ. Не публикуйте серию тестов в рабочий канал — это затруднит диагностику и может упереться в rate limit.
У Execute Webhook параметр `wait` по умолчанию равен false. Официальная документация предупреждает: в этом режиме несохранённое сообщение может не вернуть ошибку. Для диагностики добавьте `?wait=true`, чтобы дождаться подтверждения сервера и получить созданный Message, но не превращайте это в бесконечный повтор.
Минимальный запрос убирает лишние поля
POST https://discord.com/api/webhooks/{id}/{token}?wait=true
Content-Type: application/json
{
"content": "Проверка интеграции 2026-10-06T18:30Z",
"allowed_mentions": {"parse": []}
}URL показан как шаблон. Реальный token — секрет с правом публикации; не вставляйте его в тикет, скриншот, Git или общий лог. `allowed_mentions` с пустым parse не даёт тестовой строке случайно вызвать массовое упоминание. Discord требует хотя бы одно из content, embeds, components, file или poll.
Статус ответа выбирает ветку
| Ответ | Вероятная причина | Следующий шаг |
|---|---|---|
| 200 + Message | запрос опубликован | сверить channel/thread и message id |
| 204 при wait=false | запрос принят без объекта | повторить один раз с wait=true |
| 400 | payload/поле/размер | прочитать code и message |
| 401/403/404 | token, доступ или удалённый webhook | получить новый URL у владельца |
| 429 | rate limit | ждать retry_after, не спамить |
| 5xx/timeout | временный сбой/неизвестный итог | retry с idempotency на своей стороне |
Не маскируйте все не-2xx общим «Discord недоступен». Сохраняйте HTTP status, Discord error code/message, длительность и correlation ID задания. Заголовок Authorization здесь не нужен, если выполняется обычный incoming webhook по его URL.
Rate limit нельзя зашивать константой
Discord возвращает rate-limit headers и при 429 поле `retry_after`. Документация советует не жёстко кодировать лимиты: они могут различаться по маршрутам и меняться. Поставьте отправку в очередь, остановите конкретный bucket до указанного времени и добавьте небольшой jitter, чтобы несколько workers не проснулись одновременно.
- Не повторять 400 и 404 как временную ошибку.
- Для 429 уважать retry_after и global-признак ответа.
- Для timeout хранить неизвестный результат отдельно от явного отказа.
- Ограничить число retry и отправить событие в dead-letter queue.
- Считать успехи, 4xx, 429, 5xx и возраст очереди раздельно.
Forum и thread требуют правильной цели
Для forum/media channel нужен `thread_id` в query или `thread_name` в теле; без цели запрос не соответствует требованиям Execute Webhook. Если интеграция публиковала в thread, проверьте его ID, архивирование и права. В обычном канале лишний устаревший thread_id тоже способен увести диагностику в другую ветку.
Payload сокращают бинарным поиском
- Оставить короткий content и пустой allowed_mentions.
- Если он прошёл, добавить один embed без пользовательского Markdown.
- Затем вернуть components, attachments и thread параметры по одному.
- Для multipart проверить `payload_json` и соответствие индексов files[n].
- Сравнить итоговый JSON с ограничениями текущей документации.
Discord может удалить некорректные Unicode-символы или неожиданное форматирование; пользовательские строки стоит очищать и ограничивать. Не пытайтесь исправить 400 HTML-экранированием всего JSON: сериализация, Markdown и вывод в embed — разные уровни.
Retry не должен создавать поток дублей
Webhook execute не даёт вашему событию универсальный idempotency key. До отправки создайте собственный event ID, храните состояния queued/sending/sent/unknown и Message ID ответа при `wait=true`. После timeout итог неизвестен: автоматический повтор допустим по продуктовой политике, но текст можно снабдить стабильным маркером или сначала проверить известный Message ID, если он был получен.
Компрометированный URL сразу ротируется
Webhook URL содержит token. Если он попал в публичный репозиторий, чат или лог, одной маскировки старой записи недостаточно: удалите/пересоздайте webhook, обновите секрет в хранилище, перезапустите workers и проверьте неожиданные публикации. Не передавайте token как обычную переменную в клиентский JavaScript.
Для разбора подготовьте время запроса, обезличенный endpoint только с webhook ID, HTTP status, Discord error code, retry_after, тип channel/thread и сокращённый payload без token и персональных данных. Этого хватает для выбора ветки.