Ako nastaviť webhook
Čo dosiahnete: Dakoty hlási novinky na vašu adresu
Section titled “Čo dosiahnete: Dakoty hlási novinky na vašu adresu”Webhook je poštový zvonček: keď sa v Dakoty niečo stane, zazvoní na vašej adrese a pošle správu. Nastavíte ho asi za 5 minút a výsledkom je, že Make, Zapier, n8n alebo váš program dostanú nový lead, zaplatenú faktúru či rezerváciu hneď, ako vznikne. Adresu webhooku najprv vytvoríte v nástroji, do ktorého chcete posielať (viď Make, Zapier alebo n8n).
Kto môže nastaviť webhook
Section titled “Kto môže nastaviť webhook”Webhooky vytvára vlastník organizácie alebo používateľ, ktorého rola má oprávnenie Spravovať - Integrácie. Organizácia môže mať predvolene najviac 25 webhookov.
Ako vytvoriť webhook – krok za krokom
Section titled “Ako vytvoriť webhook – krok za krokom”- Vpravo hore kliknite na svoje meno, vyberte Nastavenia organizácie a záložku Integrácie.
- Prepnite na časť Webhooky.
- Kliknite na Nový webhook. Otvorí sa okno Nový webhook.
- Do poľa Adresa (URL) vložte adresu, ktorú vám dal Make, Zapier alebo n8n. Musí začínať
https://. - Do poľa Názov napíšte, na čo webhook slúži, napríklad
Leady do Make. - V časti Udalosti vyhľadajte a zaškrtnite aspoň jednu udalosť.
- V poli Upozorniť pri výpadku môžete vybrať členov tímu, ktorým príde e-mail, keď webhook prestane fungovať.
- Do poľa Popis môžete doplniť poznámku.
- Kliknite na Uložiť a poslať test →. Otvorí sa okno Webhook je vytvorený.
- Skopírujte tajný kľúč ikonou kopírovania.
- Kliknite na Poslať testovaciu udalosť.
- Keď uvidíte zelené potvrdenie, kliknite na Mám ho uložený.
Ktoré udalosti môže webhook posielať
Section titled “Ktoré udalosti môže webhook posielať”Udalosti sú zoskupené: Leady, Firmy a kontakty, Klienti, Aktivity, Úlohy, Faktúry, Cenové ponuky, Rezervácie, Produkty a objednávky (priebeh aj platba). Napríklad Lead vytvorený, Faktúra zaplatená, Nová rezervácia alebo Objednávka odoslaná. V poli Hľadať udalosť… nájdete udalosť podľa názvu. Udalosť označená Čoskoro sa zatiaľ vybrať nedá. Kód udalosti (napríklad lead.created) uvidíte po prejdení myšou.
Tajný kľúč webhooku
Section titled “Tajný kľúč webhooku”Dakoty podpisuje každú správu tajným kľúčom, ktorý začína whsec_. Príjemca podľa podpisu overí, že správa prišla od Dakoty. Kľúč sa po vytvorení ukáže naraz s upozornením Uložte si tajný kľúč na overenie podpisu. Neskôr ho zobrazíte v detaile webhooku v záložke Podpis tlačidlom Zobraziť po zadaní svojho hesla. Viac v návode Zabezpečenie integrácií.
Ako spravovať webhooky v zozname
Section titled “Ako spravovať webhooky v zozname”Zoznam ukazuje stĺpce Stav, Názov, Adresa, Udalosti, Posledné doručenie a Úspešnosť (7 dní). Pri každom riadku sú tri bodky s ponukou:
- Detail a doručenia – otvorí detail s históriou doručení,
- Poslať test – pošle testovaciu udalosť,
- Upraviť (Zobraziť pri webhooku spravovanom aplikáciou),
- Vypnúť alebo Zapnúť,
- Odstrániť – po potvrdení tlačidlom Odstrániť; Dakoty na adresu prestane posielať udalosti.
Tlačidlo Vypnúť všetky zastaví všetky webhooky naraz, hodí sa pri incidente. Po zapnutí sa udalosti, ktoré medzitým vznikli, už nedoručia.
Čo znamenajú stavy webhooku
Section titled “Čo znamenajú stavy webhooku”- Funguje – posledné doručenia prešli.
- Zlyháva (n) – príjemca neodpovedá, Dakoty skúša znova. Ak to potrvá 3 dni, webhook vypne.
- Vypnutý automaticky – príjemca 3 dni neodpovedal; zameškané udalosti uchovávame 30 dní.
- Vypnutý – vypli ste ho vy.
- Spravuje aplikácia – webhook vytvoril Make alebo Zapier cez váš API kľúč; zapína a vypína ho sám podľa scenára.
- Starší formát – webhook vznikol pred novým formátom správ a posiela pôvodné telo.
Čo robiť pri výpadku, nájdete v návode Prečo webhook zlyháva.
Čo sa stane po vytvorení webhooku
Section titled “Čo sa stane po vytvorení webhooku”Hotovo! Webhook je v zozname so stavom Funguje a pri každej zvolenej udalosti Dakoty pošle správu so záhlavím X-Dakoty-Event. Správa má tvar obálky s poľami id, type, timestamp, api_version, organization, test a data. Príjemca musí odpovedať kódom 2xx do 10 sekúnd.
Časté problémy pri nastavení webhooku
Section titled “Časté problémy pri nastavení webhooku”Adresu nevezme. Adresa musí byť verejná a začínať https://. Lokálne a interné adresy z bezpečnostných dôvodov neprijmeme.
Test hlási „Nedoručené“. Dakoty ukáže dôvod, napríklad že adresa už neexistuje. Skontrolujte adresu v Make, Zapieri či n8n.
Nevidím udalosť, ktorú potrebujem. Označené sú Čoskoro; tie zatiaľ vybrať nejde.
Nenašli ste svoj problém? Opýtajte sa Milana: vpravo hore kliknite na svoje meno a vyberte Podpora a pomoc. Milan je náš AI asistent a o Dakoty vie veľa; keď si nebude istý, odovzdá vás kolegom z podpory.