Начало

Быстрый старт

На этой странице вы создадите вебхук и отправите в канал первое сообщение, сначала простой текст, потом карточку. Понадобится приложение Glitch и терминал с curl. Примеры на Python и JavaScript есть на странице Библиотеки.

1. Создайте вебхук

Вебхук создаётся в приложении Glitch, в настройках текстового канала. Для этого нужно право «Управлять вебхуками» в этом канале. У владельца сообщества и у ролей с правом «Администратор» оно есть всегда, остальным его выдают в настройках ролей или прав канала.

Откройте сообщество и наведите курсор на нужный текстовый канал (на телефоне откройте канал). Нажмите на шестерёнку, откроются настройки канала.
Перейдите в раздел «Интеграции» и откройте «Вебхуки».
Нажмите «Новый вебхук». Задайте имя, под которым будут видны сообщения, и при желании аватарку.
Нажмите «Копировать URL вебхука».

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

2. Посмотрите на адрес

Скопированный адрес выглядит так.

https://api.glitchapp.online/v10/webhooks/1053143547551872/kO3rYtV0m6…xQ2Zq

Число после /webhooks/ — это номер вебхука, а длинная строка после него — ключ. Библиотекам они нужны по отдельности, а для curl и обычных HTTP-запросов достаточно адреса целиком.

Адрес вебхука работает как пароль. Любой, у кого он есть, может писать в канал от имени вебхука. Не публикуйте его в открытых репозиториях, скриншотах и чатах. В программе храните его в переменной окружения или в файле настроек, который не попадает в репозиторий. Если адрес всё-таки утёк, удалите вебхук в настройках канала и создайте новый. Старый адрес сразу перестанет работать.

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

В примерах ниже замените ID/KEY на конец своего адреса.

curl

curl -X POST "https://api.glitchapp.online/v10/webhooks/ID/KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Привет из терминала!"}'

Сервер ответит 204 No Content. Тела у ответа нет, а сообщение уже появилось в канале.

Если вместо этого пришла ошибка, посмотрите на её код.

Ответ	Что не так
`401`, код `50027`	Ключ в адресе неверный. Скопируйте адрес заново
`404`, код `10015`	Вебхука с таким номером нет. Скорее всего, его удалили
`400`, код `50006`	Сообщение пустое. Проверьте поле `content`
`400`, код `50035`	В запросе неверное поле или параметр, которого нет в Glitch. Подробности в поле `errors`
`429`	Слишком много сообщений подряд. Подождите столько секунд, сколько указано в `retry_after`

4. Получите сообщение в ответ

Если программа собирается потом изменить или удалить сообщение, ей нужен его номер. Добавьте к адресу ?wait=true, и сервер вернёт созданное сообщение целиком. Заодно можно задать имя автора только для этого сообщения.

curl

curl -X POST "https://api.glitchapp.online/v10/webhooks/ID/KEY?wait=true" \
  -H "Content-Type: application/json" \
  -d '{"content": "Сборка 1.4.2 запущена", "username": "CI"}'

JSON

{
  "id": "1053147923963904",
  "type": 0,
  "channel_id": "1053143874918656",
  "webhook_id": "1053143547551872",
  "author": {
    "id": "1053143547551872",
    "username": "CI",
    "discriminator": "0000",
    "avatar": null,
    "bot": true
  },
  "content": "Сборка 1.4.2 запущена",
  "timestamp": "2026-10-28T08:30:00+00:00",
  "edited_timestamp": null,
  "attachments": [],
  "embeds": []
}

Здесь показаны главные поля. Полный состав объекта описан на странице Сообщение.

5. Измените сообщение

Номер из ответа подставьте в адрес сообщения. Изменится только текст, остальное останется как было.

curl

curl -X PATCH "https://api.glitchapp.online/v10/webhooks/ID/KEY/messages/1053147923963904" \
  -H "Content-Type: application/json" \
  -d '{"content": "Сборка 1.4.2 прошла успешно"}'

У изменённого сообщения в приложении появится пометка «изменено», а в объекте сообщения заполнится поле edited_timestamp.

6. Добавьте карточку

Карточка — это блок под текстом сообщения с цветной полосой слева. В ней бывают заголовок со ссылкой, описание, поля в столбик или в ряд, картинка и подпись. Сообщение может состоять только из карточек, без текста.

curl

curl -X POST "https://api.glitchapp.online/v10/webhooks/ID/KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "CI",
    "embeds": [{
      "title": "Сборка 1.4.2 прошла",
      "url": "https://example.com/builds/142",
      "description": "Все проверки зелёные, версия выложена.",
      "color": 3124890,
      "fields": [
        {"name": "Ветка", "value": "master", "inline": true},
        {"name": "Длительность", "value": "2 мин 14 с", "inline": true}
      ],
      "footer": {"text": "Сборка №142"},
      "timestamp": "2026-10-28T08:30:00+00:00"
    }]
  }'

Цвет в поле color задаётся числом. Шестнадцатеричный цвет #2FAE9A записывается как 0x2FAE9A, в десятичном виде это 3124890.

Что дальше

Библиотеки. Всё то же самое на Python и JavaScript, в том числе через discord.py и discord.js.
Вебхук. Файлы и картинки, аватарка по ссылке, упоминания, удаление сообщений.
Карточки. Все части карточки, их пределы и картинки из файлов.
Пределы частоты. Сколько сообщений можно отправлять и что делать с ответом 429.