Коли потрібен вебхук
Вебхук надсилає сповіщення з зовнішнього сервісу до вибраного текстового каналу. Для читання повідомлень, команд і подій використовуйте бота.
Створення
Відкрийте налаштування текстового каналу → Вебхуки. Для керування потрібне 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. У разі витоку замініть вебхук. Якщо результат невідомий, перевірте канал перед повтором.