Webhooks

Webhooks отправляют уведомления в реальном времени во внешние системы при возникновении событий с активами. Используйте их с Zapier, Make, пользовательскими API или системами учёта.

1. Доступ к Webhooks

Навигация: Assets → Settings → вкладка Webhooks.

2. Создать Webhook

Нажмите New Webhook
Введите Webhook Name (например, «Sync to ERP»)
Введите Webhook URL - ваш endpoint (должен принимать POST-запросы)
Выберите Events для подписки (или выберите все)
Опционально установите Secret Key для проверки HMAC-подписи
Опционально добавьте Custom Headers (например, API key)
Установите Active в Yes
Нажмите Save

3. Доступные события

Asset Lifecycle

Event	When Triggered
`asset.created`	New asset created
`asset.updated`	Asset updated
`asset.deleted`	Asset deleted

Allocation & Assignment

Event	When Triggered
`asset.allocated`	Asset allocated to staff
`asset.revoked`	Allocation revoked

Check-in/Check-out

Event	When Triggered
`asset.checked_out`	Asset checked out
`asset.checked_in`	Asset checked in

Reservations

Event	When Triggered
`asset.reserved`	Reservation created
`asset.reservation_approved`	Reservation approved
`asset.reservation_rejected`	Reservation rejected

Maintenance & Transfers

Event	When Triggered
`asset.maintenance_scheduled`	Maintenance scheduled
`asset.maintenance_completed`	Maintenance completed
`asset.transferred`	Transfer completed

Loss, Damage, Disposal

Event	When Triggered
`asset.lost`	Asset reported lost
`asset.broken`	Asset reported broken
`asset.warranty`	Asset sent for warranty
`asset.liquidated`	Asset liquidated

Alerts (via Cron)

Event	When Triggered
`alert.warranty_expiring`	Warranty expiring in 30 days
`alert.maintenance_due`	Maintenance due in 7 days
`alert.checkout_overdue`	Checkout overdue
`alert.low_stock`	Stock below threshold

4. Формат payload

Каждый webhook отправляет JSON payload:

{
  "event": "asset.created",
  "timestamp": "2025-02-04T12:00:00+00:00",
  "source": "perfex_assets_module",
  "asset_id": 123,
  "asset": { ... },
  "data": { ... }
}

event - Event name
timestamp - ISO 8601 format
asset_id - ID of the asset (null for deleted)
asset - Asset data (or extra data for deleted)
data - Event-specific data (e.g., allocation details)

5. Проверка подписи

Модуль отправляет подпись HMAC-SHA256 в заголовке:

X-Asset-Webhook-Signature: <signature>
X-Asset-Webhook-Timestamp: <timestamp>
X-Asset-Webhook-Event: <event>

Проверьте в вашем endpoint:

signature = HMAC-SHA256(secret_key, request_body)

6. Логи Webhooks

Просмотрите Webhook Logs для статуса доставки
Response Code - 2xx = успех, 4xx/5xx = сбой
Retry - Некоторые интерфейсы позволяют повторять неудачные доставки
Логи обычно очищаются через 30 дней

7. Тест Webhook

Используйте Test Webhook для отправки тестового payload. Полезно для проверки доступности и корректной настройки endpoint.

1. Доступ к Webhooks​

2. Создать Webhook​

3. Доступные события​

Asset Lifecycle​

Allocation & Assignment​

Check-in/Check-out​

Reservations​

Maintenance & Transfers​

Loss, Damage, Disposal​

Alerts (via Cron)​

4. Формат payload​

5. Проверка подписи​

6. Логи Webhooks​

7. Тест Webhook​

Рекомендации​