Для розробників

Вебхуки й картки повідомлень

Створення вебхуків, авторизація, надсилання та обмеження.

Звірено з проєктом: 2026-11-18 · Підтримка: support@sibrel.net

Коли потрібен вебхук

Вебхук надсилає сповіщення з зовнішнього сервісу до вибраного текстового каналу. Для читання повідомлень, команд і подій використовуйте бота.

Створення

Відкрийте налаштування текстового каналу → Вебхуки. Для керування потрібне MANAGE_CHANNELS. Збережіть path і token, які показуються після створення.

Метод і шляхДія
GET /api/channels/:channelId/webhooksСписок.
POST /api/channels/:channelId/webhooksСтворення за name, author_name і avatar_url.
DELETE /api/channels/:channelId/webhooks/:idВидалення.

Надсилання

POST /api/webhooks/:id/execute
Authorization: Bearer <WEBHOOK_TOKEN>
Content-Type: application/json

{ "embeds": [{
  "title": "Build ready",
  "description": "The version is ready for review.",
  "color": 5793266,
  "fields": [{ "name": "Status", "value": "Ready", "inline": true }]
}] }

До 2000 символів у content, до 10 карток і 6000 символів загалом. Разом з embeds текст займає одну картку. Успіх повертає 201 з ідентифікаторами повідомлення та каналу.

Ліміти й безпека

Приймається один запит за дві секунди на вебхук. Якщо відповідь 429, дотримуйтеся Retry-After: 2. Передавайте секрет у Authorization. У разі витоку замініть вебхук. Якщо результат невідомий, перевірте канал перед повтором.