Webhooks
Články nápovědy nemusí být zcela přesné – kvůli častým aktualizacím a automatickému překladu mohou zaostávat za aplikací. V případě pochybností kontaktujte podporu.
Na této stránce
Webhooks vám umožňují, aby se vaše vlastní systémy dozvěděly v okamžiku, kdy se v EventMann stane něco — rezervace potvrzena, vstupenka zaškrtnuta, výplata zaplacena — místo toho, abyste se dotazovali na změny. Nacházejí se pod stejným řádkem Integrace v bočním panelu, na kartě Webhooks.
Jak přidat koncový bod
- Jděte na Integrace → Webhooks → Přidat
- Dejte mu název a veřejnou adresu http(s) URL, která by měla přijímat hovory — soukromá nebo vnitřní adresa je odmítnuta hned, zde a pokaždé, když se webhook skutečně spustí
- Zaškrtněte, které typy událostí chcete přijímat
- Uložit. 64znakové podpisové tajemství se automaticky vygeneruje a zobrazí se maskované; použijte Zobrazit/Skrýt, abyste ho jednou odhalili
Události, na které se můžete přihlásit
| Událost | Spustí se, když |
|---|---|
booking.created | rezervace začíná, před platbou |
booking.confirmed | rezervace je potvrzena |
booking.cancelled | rezervace je zrušena |
booking.refunded | rezervace je vrácena |
event.created | vytvoříte novou akci |
event.published | akce jde živě |
event.cancelled | akce je zrušena |
event.updated | detaily akce se změní |
ticket.checked_in | vstupenka je naskenována u dveří |
payment.received | platba se vypořádá |
payment.refunded | platba je vrácena |
payout.created | výplata se vytvoří |
payout.paid | výplata se vyplatí |
staff.assigned | člen personálu se přiřadí vaší akci |
staff.checked_in | člen personálu se check-in ke směně |
vendor.assigned | dodavatel se přiřadí vaší akci |
vendor.invoice_submitted | dodavatel odešle fakturu |
Samotné doručení
Každý hovor je POST JSON ve tvaru:
{"event":"booking.confirmed","data":{"id":1,"reference":"BK-ABC123","status":"confirmed","total":49.99,"currency":"USD","attendee_name":"Jane Doe","attendee_email":"jane@example.com","event_id":10,"confirmed_at":"2026-03-01T12:05:00Z"},"timestamp":"2026-03-01T12:05:00Z","delivery_id":"..."}
Spolu s ním dostanete hlavičku X-Webhook-Event pojmenující událost, X-Webhook-Delivery-Id a hlavičku X-Webhook-Signature — HMAC-SHA256 nezpracovaného těla požadavku, klíčovaného se tajemstvím zobrazeným na stránce koncového bodu. Přepočítejte stejným způsobem na konci a porovnejte předtím, než důvěřujete datové zátěži.
Pokusy a co se stane, když je přijímač vypnut
- Doručení se pokusí až 5krát, čekání 10, pak 30, pak 60 sekund mezi pokusy; pouze odpověď 2xx se počítá jako doručená
- Jakmile všechny 5 pokusů o doručení pro jednu událost selhají, počet selhání koncového bodu vzroste přesně o jeden — ne jednou za pokus
- 10 neúspěšných doručení v rámci hodinové doby pozastaví tento koncový bod na 5 minut; pokud počet selhání někdy přejde 10 nebo se toto pozastavení spustí, koncový bod se automaticky vypne a přestane přijímat cokoli, dokud jej neopravíte
- V okamžiku, kdy se to stane, dostanete oznámení v aplikaci pojmenující koncový bod
- Zakázaný koncový bod zobrazuje oznámení “Tento koncový bod je zakázán” s důvodem, jak v seznamu koncových bodů, tak na jeho vlastní stránce — úprava jeho jména, URL nebo událostí ho nevrátí. Opravte, co bylo špatně s vaším přijímačem, poté použijte tlačítko Znovu povolit; vymaže počet selhání a obnoví doručení, zachovávajíc stejnou adresu URL a podpisové tajemství
- Historie doručení — typ události, stav HTTP, trvání a čas — se uchovává 30 dní a poté se automaticky vymaže
Dobré vědět
- Test na stránce koncového bodu odešle syntetickou
pingudálost, abyste mohli zkontrolovat svůj přijímač a ověření podpisu, než se přihlásíte k čemukoliv skutečnému - Opakovat na neúspěšném doručení znovu odešle tuto událost čerstvou do vašich aktuálně aktivních koncových bodů — je to nové doručení, ne pokračování původní řady pokusů
- Odesílání webhooků běží v jejich vlastní frontě, odděleně od placení a e-mailu, takže pomalý nebo rozbitý přijímač na vašem konci nemůže zpomalit rezervace nebo e-maily se vstupenkami
- Zrušení zaškrtnutí typu události tiše jej zastaví odesílání — není zde oznámení, že jste přestali něco přijímat
Řešení problémů
- Doručení se zastavilo bez viditelné chyby na mé straně — otevřete koncový bod a zkontrolujte jeho počet selhání a stav; pokud se zobrazuje zakázáno, opravte svůj přijímač a klikněte na Znovu povolit
- Podpis se nikdy neshoduje — zahashujte přesné nezpracované tělo požadavku, ne jeho znovu serializovanou kopii, se tajemstvím zobrazeným na stránce koncového bodu
- Test uspěje, ale skutečné události se nikdy neobjeví — potvrďte, že je na tomto koncovém bodu zaškrtnuta konkrétní typ události; nepublikované typy se jednoduše nikdy neposílají