Уведомления

Какие уведомления поддерживаются?

Хоук умеет уведомлять через:

• Email
• Telegram
• Slack
• Loop
• Webhook — для своих систем (Jira, Mattermost, внутренние сервисы и т.д.)

Есть два уровня:

1. Уведомления проекта — про ошибки: новые события, всплески повторений.Настройки: Проект → Настройки → Уведомления.
2. Персональные уведомления — назначение на issue, недельный дайджест, системные сообщения.Настройки: Аккаунт → Уведомления. Каналы: email, webhook (web/desktop push — по мере доступности).

Как настроить уведомления проекта?

1. Откройте проект → Настройки → Уведомления.
2. Создайте правило и укажите:Что получатьтолько новые события (ONLY_NEW) — первый раз, когда ошибка появилась;«встречалось больше N раз за период» (SEEN_MORE) — порог + период (минута / час / день / неделя).Фильтры (опционально): включать / исключать события по тексту в заголовке.Каналы: email, Telegram, Slack, Loop, Webhook — можно несколько сразу.
3. Что получатьтолько новые события (ONLY_NEW) — первый раз, когда ошибка появилась;«встречалось больше N раз за период» (SEEN_MORE) — порог + период (минута / час / день / неделя).
4. только новые события (ONLY_NEW) — первый раз, когда ошибка появилась;
5. «встречалось больше N раз за период» (SEEN_MORE) — порог + период (минута / час / день / неделя).
6. Фильтры (опционально): включать / исключать события по тексту в заголовке.
7. Каналы: email, Telegram, Slack, Loop, Webhook — можно несколько сразу.
8. Правило можно временно отключить, не удаляя.

Несколько правил на проект — нормальная схема: например, критичные ошибки → Slack, остальное → email.

Как подключить каналы?

• Email — укажите адрес(а) в правиле / в аккаунте.
• Telegram / Slack / Loop — endpoint (webhook URL бота или Incoming Webhook) в настройках канала правила.
• Webhook — HTTPS URL вашего обработчика. Хоук шлёт POST с JSON { "type": "...", "payload": { ... } } и заголовком X-Hawk-Notification (тип уведомления).

Для персональных уведомлений webhook настраивается в Аккаунт → Уведомления.

Что такое Webhook?

Webhook — HTTP(S) POST с JSON на ваш URL, когда сработало правило уведомления проекта или персональное уведомление.

Запрос всегда одного вида:

Content-Type: application/jsonUser-Agent: Hawk-Webhook/1.0X-Hawk-Notification: <type>{"type":"event","payload":{}}

• type — вид уведомления: event, several-events, assignee, а также платёжные и системные (payment-failed, workspace-invite и др.).
• payload — данные; набор полей зависит от type. Токены, пароли и исходный код в webhook не передаются.

Для ошибок (event / several-events) типичная структура:

Используйте HTTPS. Endpoint должен отвечать 2xx; редиректы Hawk не следует.

Не приходят уведомления — что проверить?

1. Правило включено.
2. Канал указан, endpoint валидный (для webhook — доступный HTTPS URL).
3. Тип правила совпадает с ситуацией: при ONLY_NEW повтор ошибки не придёт; при SEEN_MORE нужен порог за выбранный период.
4. Фильтры including / excluding не отсекают заголовок события.
5. Для email — адрес указан в аккаунте / правиле.
6. Webhook отвечает без долгого таймаута и без редиректа; схема на стороне приёмника принимает timestamp как number (unix seconds), а не только как ISO-строку.
7. Проверка пустым телом {} не отражает реальную доставку — Hawk так не отправляет.

Можно ли создавать тикеты автоматически?

Да, двумя способами:

1. Интеграция с GitHub (Проект → Настройки → Task Manager / GitHub): Хоук может сам создавать GitHub Issue при достижении порога повторений.
2. Webhook на ваш endpoint: обработчик создаёт задачу в Jira/YouTrack/Linear, пишет в чат или запускает workflow.