Как создать и настроить вебхуки в TARGPatrol
Вебхук — это автоматическое уведомление, которое отправляет сервер TARGPatrol на ваш сервер, как только в системе происходят определенные действия, например, создание задачи, обновление ее статуса или завершение. Вебхуки полезны для автоматизации процессов, интеграции с другими системами и реагирования на изменения в режиме реального времени.Когда в TARGPatrol происходит событие (event), например, задача меняет статус, система отправляет POST-запрос на заранее настроенный URL. Этот запрос содержит полезную нагрузку (payload) с деталями события, такими как ID задачи, статус и другая связанная информация.

Настройка вебхуков в TARGPatrol

Чтобы создать вебхук:
  1. Авторизуйтесь в TARGPatrol;

  2. Откройте вкладку "Управление" -> "Вебхуки".

Creating an Issue
Добавьте новый вебхук:
  1. Нажмите на кнопку Добавить вебхук.

  2. Введите URL, на который будут отправляться уведомления. Убедитесь, что ваш сервер готов принимать POST-запросы и обрабатывать данные в формате JSON.

  3. Выберите типы событий для вебхука. В TARGPatrol доступны различные триггеры: создание задачи, редактирование задачи, создание происшествия и т.д.

  4. В случае необходимости добавьте Заголовки запроса (например, content-type).

  5. Нажмите "Сохранить".

Creating an Issue
Тестирование вебхука:
  1. После настройки, TARGPatrol предоставляет возможность отправить запрос.

  2. Например, если вы создали вебхук с типом события task.created, то при создании задачи сформируется уведомления.

Просмотр вебхуков в TARGPatrol

Access the webhook logs:
  1. Откройте страницу “Webhooks” в TARGPatrol.

  2. В таблице с запросами нажмите на название (URL) нужного вебхука либо значок.

  3. Откроется окно с историей выполнения событий, статусом, запросов и ответом сервера (правая часть страницы).

  4. Если выполнение было неуспешное, то данный запрос будет отображен в истории с соответствующей иконкой. В случае, если было выполнено 25 некорректных запросов подряд, то вебхук будет автоматически отключен.

Creating an Issue

Советы по работе с вебхуками в TARGPatrol

  • Обработка ошибок. Вебхуки работают в режиме реального времени, но если ваш сервер не отвечает, TARGPatrol поддерживает автоматические повторные попытки отправки.

  • Анализ частых ошибок. Если вы видите систематические ошибки (например, регулярные тайм-ауты), это может указывать на проблемы с производительностью вашего сервера или с конфигурацией маршрутизации.

  • Уведомления. При формировании нового вебхука, систематических ошибках либо автоматическом отключении вебхука вам на почту будут отправляться соответствующие письма, что поможет вам всегда быть в курсе работоспособности вашей интеграции.

  • Безопасность данных. Вебхуки TARGPatrol используют только URL с HTTPS.

Настройка вебхуков в TARGPatrol открывает возможности для автоматизации задач, интеграции с другими системами и работы с данными в реальном времени. Следуйте советам по управлению вебхуками, чтобы избежать распространенных ошибок и обеспечить стабильную работу интеграции. Используйте HTTPS для безопасности, анализируйте ошибки для устранения проблем, и будьте в курсе состояния ваших вебхуков благодаря уведомлениям TARGPatrol. С правильной настройкой вы сможете эффективно управлять процессами и улучшить производительность своей команды.