Настройка Webhooks для интеграций

Автоматизируйте реагирование на инциденты. Подключите PulseKit к Jira, Bitrix24, Slack или внутренним системам за 5 минут.

Формат данных (JSON Payload)

PulseKit отправляет POST-запросы с заголовком Content-Type: application/json. Тело запроса содержит статус, метаданные чекпоинта и временные метки.

Ниже приведен пример пейлоада при сбое мониторинга API (статус 500):

{
  "id": "evt_89234012",
  "event": "alert.triggered",
  "severity": "critical",
  "monitor": {
    "id": "mon_7782",
    "name": "API Gateway Production",
    "url": "https://api.mystore.ru/v1/health"
  },
  "status": {
    "previous": "up",
    "current": "down",
    "response_code": 500,
    "response_time_ms": 0
  },
  "timestamp": "2023-10-27T14:30:00Z"
}

Безопасность и аутентификация

Мы рекомендуем защищать ваши конечные точки. PulseKit поддерживает базовую аутентификацию и подписи HMAC.

HMAC-SHA256 Signature

Каждый запрос подписывается вашим секретным ключом. Подпись передается в заголовке X-PulseKit-Signature. Проверяйте этот заголовок на стороне сервера, чтобы убедиться в подлинности источника.

IP Whitelisting

Для корпоративных тарифов мы предоставляем возможность настроить белый список IP-адресов. Входящие запросы от PulseKit будут идти только с диапазонов 185.12.XX.XX/24 и 91.234.XX.XX/28.

Тестирование подключения

Перед внедрением в продакшн убедитесь, что ваш сервер корректно принимает данные.

В разделе "Настройки интеграции" нажмите кнопку "Отправить тестовый хук". PulseKit отправит событие с event: "test.ping". Ваш сервер должен ответить кодом 200 OK в течение 5 секунд.

Логи доставки

Если интеграция не работает, проверьте раздел "Журнал событий". Там отображаются HTTP-коды ответов от вашего сервера и заголовки запросов, отправленных PulseKit.

Инструкции для популярных систем

Пошаговые руководства по подключению к корпоративным инструментам.

Jira Service Management

Создайте автоматический тикет при падении сервера. Используйте Webhook-коннектор в настройках Jira Automation, указав URL эндпоинта PulseKit в поле "Trigger".

Инструкция для Jira

Bitrix24

Создавайте задачи для отдела разработки при сбоях. Используйте встроенный модуль "Входящие веб-хуки" в Битрикс24 и скопируйте полученный URL в настройки PulseKit.

Инструкция для Bitrix24

Собственные системы (Python/Node)

Примеры кода для валидации подписи и парсинга JSON на Python (Flask) и Node.js (Express). Подходит для создания кастомных алертеров.

Смотреть примеры кода