Webhooky — integrácia údržby

Webhooky v module údržby umožňujú automaticky informovať externé systémy (CMMS, ERP, monitorovacie dashboardy) o udalostiach súvisiacich so zariadeniami a údržbou.

Konfigurácia

V admin paneli prejdite na Integrácie → Webhooky a vytvorte nový webhook. Pri výbere udalostí budú dostupné aj udalosti špecifické pre údržbu.

Udalosti údržby

Payload pre IoT alarm

Pri udalosti device.alarm obsahuje správa navyše:

{
  "event": "device.alarm",
  "alarm_action": "created",
  "alarm": {
    "source_id": "DEVICE_001",
    "alarm_code": "TEMP_HIGH",
    "severity": "critical",
    "value": 95.5,
    "threshold": 85
  },
  "ticket": {
    "id": "uuid",
    "number": "WS-2026-0108",
    "subject": "[TEMP_HIGH] Vstrekovací lis #4",
    "status": "open",
    "priority": "critical",
    "device_id": "uuid"
  }
}

Pole alarm_action môže byť created (nový alarm) alebo reopened (opakovaný alarm).

Payload pre plánovanú údržbu

Pri udalosti maintenance.due správa obsahuje:

{
  "event": "maintenance.due",
  "maintenance_plan_id": "uuid",
  "maintenance_plan_title": "Výmena oleja",
  "device_code": "INJ-04",
  "ticket": { ... }
}

Príklady použitia

• CMMS systém — automatický import údržbových úloh z WLP
• Monitorovací dashboard — zobrazenie IoT alarmov v reálnom čase
• ERP — synchronizácia nákladov na údržbu
• Slack/Teams — notifikácie technikov o nových alarmoch
• Plánovací systém — aktualizácia rozvrhu technikov pri novej plánovanej údržbe

Bezpečnosť a doručovanie

Rovnako ako pri helpdesk webhookoch:

• Každá správa je podpísaná HMAC-SHA256 (hlavička X-Webhook-Signature)
• Neúspešné doručenie sa opakuje až 3× (10s, 60s, 5min)
• Logy doručenia na edit stránke webhooku

Tip: Pri IoT alarmoch odporúčame sledovať pole alarm_action — pri reopened sa tiket otvára opakovane, čo môže signalizovať pretrvávajúci problém.