Webhooky — externí integrace
Webhooky umožňují automaticky odesílat HTTP POST notifikace do externích systémů (ERP, CRM, Slack, Microsoft Teams) při událostech v helpdesku. Když se něco stane — nový tiket, změna stavu, komentář — systém odešle JSON zprávu na vámi nakonfigurovanou URL.
Přístup k webhookům
V admin panelu přejděte na Integrace → Webhooky. Tato sekce je dostupná pouze pro značky s aktivním modulem API Access.
Vytvoření webhooku
Klikněte na *+ Nový webhook
- a vyplňte:
- *URL adresa
- — HTTPS endpoint vašeho systému, který bude přijímat notifikace
- *Popis
- — volitelná poznámka (např. "ERP integrace", "Slack notifikace")
- *Události
- — vyberte, při kterých událostech se má webhook spustit
Dostupné události (HelpDesk)
| Událost | Kdy se spustí |
|---|---|
| *Tiket vytvořen | |
| * | Nový tiket v systému (manuálně, emailem) |
| *Změna stavu | |
| * | Změna stavu tiketu (otevřený → v řešení → vyřešený) |
| *Tiket přiřazen | |
| * | Přiřazení tiketu agentovi |
| *Tiket vyřešen | |
| * | Tiket označen jako vyřešený |
| *Nový komentář | |
| * | Přidání veřejného komentáře (ne interní poznámka) |
| *SLA eskalace | |
| * | Překročení SLA limitu (varování, porušení, kritické) |
Podpisový klíč (Secret)
Každý webhook má automaticky vygenerovaný podpisový klíč. Váš systém ho může použít k ověření, že požadavek skutečně přišel z WLP portálu.
Podpis se odesílá v hlavičce X-Webhook-Signature ve formátu sha256=.
Doručování a opakování
- Webhook se odesílá asynchronně
- Při neúspěšném doručení se pokus opakuje *až 3×
- (10s, 60s, 5min)
- Logy doručení najdete na stránce úpravy webhooku
*Tip:
- Na testování webhooků použijte službu webhook.site.