Исходящие вебхуки

Разработчикам

Исходящие вебхуки

Подпишите HTTP-конечную точку (или URL Slack / Teams) на события задач, спринтов, встреч, кода и упоминаний.

Исходящие вебхуки

Skrum — универсальная панель управления проектами с ИИ: командный чат, задачи и спринты, нативные видеовстречи и входящая активность кода в одном рабочем пространстве, где каждое действие ИИ ждёт подтверждения человека.

Исходящие вебхуки рассылают уведомления о событиях. Это исходящий аналог «Активности кода» — источником выступает Skrum, а получателем сторонняя система.

  1. Создание. «Настройки → Интеграции → Вебхуки → Новый». URL, секрет подписи (Skrum генерирует его сам; показывается один раз) и подписки на события (task.*, sprint.*, meeting.*, code.*, message.mention).
  2. Подписанное тело. Каждая доставка несёт подпись HMAC-SHA256 над необработанным телом запроса, проверяемую вашим секретом подписи.
  3. Повторные попытки. Ответы не 2xx повторяются с экспоненциальной задержкой, максимум пять попыток. Защита от SSRF — приватные IP-адреса и хосты метаданных отклоняются.

Slack / Teams

Вставьте URL входящего вебхука Slack или Teams. Skrum распознаёт схему, формирует ограниченный по размеру текстовый payload и отправляет его — с той же проверкой SSRF, что и для любого исходящего URL.

Частые вопросы

  • Смена секрета? Удалите и создайте заново; секреты показываются один раз.
  • История доставок? Недавние доставки показываются для каждого вебхука вместе с классом ошибки для неповторяемых сбоев (ssrf_refused, signing_failed, http_4xx).

См. также: Документация Skrum