Kde nájdem webhooky v aplikácii?

V module MonivioIntegration. Vľavo hore kliknite na prepínač platformy, zvoľte MonivioIntegration a v ľavom menu sa objaví sekcia Integrácia s položkou Webhooky.

Aký je rozdiel medzi API kľúčom a webhookom?

API kľúčom sa váš systém pýta Monivia. Webhook je opačný smer — Monivio zavolá váš server, keď nastane udalosť, takže sa nemusíte cyklicky pýtať.

Na čo je webhook secret?

Ním overíte podpis prichádzajúceho requestu, aby ste mali istotu, že prišiel z Monivio a nie od niekoho iného. Zobrazí sa len raz, dá sa však regenerovať.

Prečo sa mi webhook sám deaktivoval?

Po opakovaných zlyhaniach doručenia ho Monivio automaticky vypne a v zozname pri ňom uvidíte dôvod. Po oprave na vašej strane ho znova zapnite.

Ako zistím, prečo webhook nedorazil?

V menu webhooku zvoľte Zobraziť logy — otvorí sa Integrácia → Analytics, záložka Webhooky. Pri každom pokuse vidíte event, stav, poradie pokusu aj čas odozvy a doručenie viete zopakovať.

Môžem k requestom pridať vlastné hlavičky?

Áno. Vo formulári webhooku je sekcia Custom HTTP Headers — hodí sa, keď váš server vyžaduje vlastnú autorizačnú hlavičku.

Ktoré udalosti viem odoberať?

Eventy sú zoskupené podľa oblastí — doklady, kontakty, náklady a transakcie. Vybrať sa dajú jednotlivo, po skupinách alebo všetky naraz.

Dá sa webhook dočasne vypnúť?

Áno, prepínačom Aktívny vo formulári webhooku. Kým je vypnutý, Monivio naň eventy neposiela a po zapnutí pokračuje ďalej.

Webhooky

Na čo je webhook

Webhook je opačný smer ako API: nie vy sa pýtate Monivia, ale Monivio zavolá váš server, keď sa niečo stane — vznikne faktúra, klient zaplatí, pribudne kontakt. Váš systém tak nemusí nič cyklicky kontrolovať.

Krok 1: Prepnite sa do modulu MonivioIntegration

Webhooky nie sú v bežnom menu s faktúrami. Kliknite vľavo hore na prepínač platformy (nad ľavým menu, predvolene ukazuje MonivioDocuments) a vyberte MonivioIntegration.

Ľavé menu modulu MonivioIntegration s položkou Webhooky — Po prepnutí platformy sa v ľavom menu objaví sekcia Integrácia s Webhookmi.

Krok 2: Vytvorte webhook

V sekcii Integrácia → Webhooky kliknite na Nový webhook a vyplňte:

Názov — na rozlíšenie v zozname
URL — adresa, kam má Monivio posielať POST requesty
Eventy — ktoré udalosti chcete dostávať (doklady, kontakty, náklady, transakcie); dajú sa vybrať po skupinách alebo všetky naraz
Custom HTTP headers — voliteľné, napr. autorizačná hlavička vášho systému
Aktívny — či má webhook prijímať eventy hneď po vytvorení

Formulár webhooku s URL a výberom eventov — Vyberajte len tie eventy, ktoré váš systém naozaj spracuje.

Krok 3: Uložte si secret

Po vytvorení sa zobrazí secret — rovnako ako API kľúč len jediný raz. Slúži na overenie podpisu prichádzajúcich requestov, aby ste si boli istí, že prišli naozaj z Monivio a nie od niekoho iného.

Ak secret stratíte, v menu webhooku ho viete regenerovať. Starý okamžite prestane platiť, takže nový treba nasadiť do vášho systému hneď.

Krok 4: Skontrolujte, či doručenia prechádzajú

V menu webhooku (ikonka ⋯) je položka Zobraziť logy — presmeruje vás do Integrácia → Analytics, na záložku Webhooky. Nájdete tu graf doručovania a tabuľku pokusov: stav (Úspech, Neúspech), event, poradie pokusu, čas odozvy a dátum.

Záložka Webhooky v Analytics so zoznamom doručení a ich stavmi — Keď integrácia „nič nedostáva“, odpoveď je zvyčajne tu.

V detaile záznamu vidíte odoslané aj prijaté telo requestu a doručenie sa dá zopakovať.

Ak váš server opakovane odpovedá chybou, Monivio webhook automaticky deaktivuje a v zozname pri ňom uvidíte dôvod. Po oprave na svojej strane ho znova zapnite.

Monivio nenasleduje presmerovania. Ak adresa webhooku odpovie presmerovaním (stav 3xx), doručenie sa zaráta ako neúspešné a v detaile uvidíte dôvod. Zadajte preto rovno konečnú adresu — teda tú, na ktorú by vás presmerovanie poslalo.

Krok 5: Prehľad na jednom mieste

Sekcia Integrácia → Dashboard ukazuje počet aktívnych webhookov aj kľúčov a aktivitu za posledné dni. Je to najrýchlejší spôsob, ako zistiť, či integrácia žije.

Zoznam webhookov s eventmi a časom posledného doručenia — Karta webhooku ukazuje stav, vybrané eventy aj posledné doručenie.

Čo ďalej?

API kľúče — autentifikácia pre volania REST API
Párovanie platieb z banky — časté využitie eventu „faktúra zaplatená“
Prechod zo SuperFaktúry — jednorazový prenos dát webhook nepotrebuje