Webhooky — externé integrácie

Webhooky umožňujú automaticky posielať HTTP POST notifikácie na externé systémy (ERP, CRM, Slack, Microsoft Teams) pri udalostiach v helpdesku. Keď sa niečo stane — nový tiket, zmena stavu, komentár — systém pošle JSON správu na vami nakonfigurovanú URL.

Prístup k webhookom

V admin paneli prejdite na Integrácie → Webhooky. Táto sekcia je dostupná len pre značky s aktívnym modulom API Access.

Vytvorenie webhooku

Kliknite na *+ Nový webhook

• a vyplňte:

• *URL adresa

• — HTTPS endpoint vášho systému, ktorý bude prijímať notifikácie

• *Popis

• — voliteľná poznámka (napr. "ERP integrácia", "Slack notifikácie")

• *Udalosti

• — vyberte, pri ktorých udalostiach sa má webhook spustiť

Dostupné udalosti (HelpDesk)

Podpisový kľúč (Secret)

Každý webhook má automaticky vygenerovaný podpisový kľúč. Váš systém ho môže použiť na overenie, že požiadavka naozaj prišla z WLP portálu.

Podpis sa posiela v hlavičke X-Webhook-Signature vo formáte:

sha256=

Podpis sa vypočíta z kombinácie timestamp + payload pomocou vášho secret kľúča.

Formát správy

Každá webhook správa obsahuje:

{
  "event": "ticket.created",
  "timestamp": "2026-03-10T14:30:00+00:00",
  "ticket": {
    "id": "uuid",
    "number": "WS-2026-0042",
    "subject": "Problém s prihlásením",
    "status": "open",
    "priority": "high",
    "category": "problem",
    "assigned_to_name": "Ján Novák",
    "device_id": null
  }
}

Pri niektorých udalostiach sú doplnené extra dáta — napr. pri komentári sa pridá text komentára, pri zmene stavu starý a nový stav.

Doručovanie a opakovanie

• Webhook sa posiela asynchrónne (nezpomaľuje prácu v portáli)
• Pri neúspešnom doručení sa pokus opakuje *až 3×

• s narastajúcim intervalom (10s, 60s, 5min)

• Každý pokus sa zaznamenáva do *logov doručenia

• na edit stránke webhooku

• Posledný status kód sa zobrazuje v zozname webhookov

Správa webhookov

• *Aktivácia/deaktivácia

• — kliknite na badge "Aktívny"/"Neaktívny" priamo v zozname

• *Regenerácia kľúča

• — na edit stránke tlačidlom "Pregenerovať" (starý kľúč prestane fungovať)

• *Logy doručenia

• — posledných 20 pokusov s dobou odozvy, statusom a prípadnou chybou

*Tip:

• Na testovanie webhookov použite službu webhook.site — vygeneruje vám testovaciu URL, na ktorej uvidíte prichádzajúce správy.