Prečo webhook zlyháva a čo s tým

Vyžaduje oprávnenieSpravovať - Integrácie

Čo dosiahnete: zistíte, prečo webhook zlyháva

Webhook sa občas zasekne a stáva sa to každému, najčastejšie keď sa v Make zmaže scenár. V detaile webhooku zistíte, čo príjemca odpovedal, opravíte adresu a zameškané správy doručíte. Trvá to zvyčajne pár minút.

Kde vidíte, že webhook zlyháva

V časti Webhooky má webhook v stĺpci Stav štítok Zlyháva (n), Vypnutý automaticky alebo Vypnutý – adresa neexistuje. Pri štítku uvidíte vysvetlenie po prejdení myšou. Pri webhooku kliknite na tri bodky a vyberte Detail a doručenia. Na vrchu detailu je žltý alebo červený pruh s popisom (Webhook zlyháva alebo Webhook je vypnutý automaticky) a tlačidlami, napríklad Pozrieť log.

Ako zistiť, prečo doručenie zlyhalo

V zozname webhookov kliknite pri webhooku na tri bodky a vyberte Detail a doručenia.
Otvorí sa záložka Doručenia. Filtrami Stav doručenia, Udalosť a Obdobie zúžte výber (24 hodín, 7 alebo 30 dní).
Pri neúspešnom riadku si prečítajte vysvetlenie pod výsledkom, napríklad „Táto adresa už neexistuje“.
Kliknutím na riadok otvoríte bočný panel. V sekcii Odpoveď vidíte kód HTTP a začiatok odpovede príjemcu, v sekcii Pokusy všetky pokusy.
V paneli sú aj Hlavičky a Telo (JSON) s tlačidlom Kopírovať. Identifikátor udalosti nájdete v zbalenej sekcii Technické detaily.

Ako webhook opraviť a znova zapnúť

Opravte príčinu (napríklad adresu cez tlačidlo Upraviť URL v pruhu alebo v záložke Nastavenia). Potom:

V pruhu Webhook je vypnutý automaticky kliknite na Zapnúť a doručiť zameškané (N), aby sa nahromadené správy odoslali, alebo na Zapnúť bez nich, ak ich nepotrebujete (zrušia sa).
Pri jednej správe kliknite v bočnom paneli na Odoslať znova. Tlačidlo je neaktívne, kým je webhook vypnutý.
Viac zlyhaných naraz odošlete tlačidlom Znova odoslať zlyhané a potvrdením Odoslať znova. Zaradí najviac 1 000 zlyhaných udalostí z posledných 30 dní.

Ako Dakoty opakuje doručenie

Dakoty skúša doručiť správu až 9-krát: hneď, po 5 sekundách, 5 minútach, 30 minútach, 2, 5, 10 a 14 hodinách a po 24 hodinách. Ak príjemca pošle hlavičku Retry-After (kódy 429 alebo 503), ďalší pokus príde najskôr o ten čas, najviac o 24 hodín. Príjemca musí odpovedať kódom 2xx do 10 sekúnd.

Kedy sa webhook vypne sám

Ak webhook 24 hodín nič nedoručí, pošleme e-mail členom z poľa Upozorniť pri výpadku. Po 72 hodinách bez úspešného doručenia webhook vypneme (zobrazí sa ako Vypnutý automaticky) a nové udalosti uchováme 30 dní (najviac 1 000), aby sa nestratili. Ak príjemca odpovie kódom 410 (adresa už neexistuje), vypneme webhook hneď. Webhooky spravované aplikáciou (Make, Zapier) sa však nevypínajú, ale mažú: po 72 hodinách výpadku aj po odpovedi 410 webhook zmizne zo zoznamu a aplikácia ho vytvorí znova, keď scenár znova zapnete. Nehľadajte preto pri nich štítok o automatickom vypnutí.

Čo znamenajú chyby doručenia

Na adresu sa nedá dovolať – skontrolujte URL a či server beží.
Server nás presmeroval inam – zadajte priamo cieľovú adresu.
Server odmietol prístup (401, 403) – príjemca vyžaduje heslo alebo token.
Táto adresa už neexistuje (404) – v Make, Zapieri či n8n ste možno zmazali scenár; skopírujte novú URL.
Príjemca je zahltený (429) – spomalíme a skúsime neskôr.
Príjemca prijal správu, ale spadol (5xx) – pozrite jeho históriu; skúsime znova.
Príjemca neodpovedal do 10 sekúnd – nech najprv odpovie 200 a pracuje potom.
Problém s HTTPS certifikátom – príjemca má neplatný certifikát.
Na túto adresu nemôžeme posielať – použite verejnú adresu https://.

Časté problémy pri opravách webhooku

Tlačidlo Odoslať znova je sivé. Webhook je vypnutý. Najprv ho zapnite.

Zameškané správy sa nedoručili. Zapli ste ho cez Zapnúť bez nich; tie sa zrušili. Do budúcna zvoľte Zapnúť a doručiť zameškané.

Webhook zmizol zo zoznamu. Ak ho spravovala aplikácia, zmazala ho po vypnutí scenára alebo zrušení API kľúča. Zapnite scenár znova.

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.