Webhooky

Podepsané webhooky pro každou událost rezervace a platby

Streamujte každou událost rezervace a platby do vlastních systémů — CRM, datového skladu, Slacku, vlastních integrací. Podepsané HMAC, opakované pokusy s exponenciálním ústupem a plné logování. Vytvořeno pro vývojářské týmy, které odmítají pollovat API.

14denní bezplatná zkušební verze. Bez zadání kreditní karty.

Proč vývojářské týmy volí webhooky Triviyo

Standardní vzory, předvídatelné chování a log doručení, který skutečně pomáhá při ladění.

HMAC podpisy u každého payloadu

Každý webhook je podepsán algoritmem HMAC-SHA256 pomocí tajného klíče vašeho endpointu. Ověřte podpis před zpracováním payloadu — stejný vzor jako u Stripe, GitHubu a každého dalšího webhooku, kterému již důvěřujete.

Opakované pokusy s exponenciálním ústupem

Pokud váš endpoint neodpoví včas nebo vrátí 408, 429 či 5xx, Triviyo doručení automaticky zopakuje, celkem až 6 pokusů. Jakákoli jiná odpověď 4xx se považuje za trvalou a neopakuje se.

Standardní názvy událostí

BOOKING_CREATED, BOOKING_UPDATED, BOOKING_CANCELED, PAYMENT_SUCCEEDED, PAYMENT_FAILED, REFUND_PROCESSED. Přihlaste odběr pouze těch událostí, které vaše integrace potřebuje; ostatní ignorujte.

Podpisové klíče pro každý endpoint

Každý endpoint má vlastní podpisový klíč, který můžete kdykoli znovu vygenerovat v Nastavení → Webhooky.

Úplný protokol doručení

Každý pokus o doručení se zaznamená v přehledu se stavem HTTP, odpovědí a časem.

Webhooky Triviyo vs. pollování REST API

Jak vypadá streamování událostí v reálném čase oproti neustálému dotazování REST endpointu.

Co zahrnuje webhooks APITriviyoWithout Triviyo
DostupnostPlán Professional a vyššíPouze přístup k Enterprise API
BOOKING_CREATED
BOOKING_UPDATED
BOOKING_CANCELED
PAYMENT_SUCCEEDED
Podpisy HMAC-SHA256Doplněk Enterprise
Strategie opakováníAž 6 pokusůJeden pokus nebo žádný
Protokol doručení
PodporaPrioritní podporaE-mailová fronta ticketů

Standardní vzory — nic exotického, nic proprietárního.

Nejčastější dotazy

Na jaké události se mohu přihlásit?

BOOKING_CREATED, BOOKING_UPDATED, BOOKING_CANCELED, PAYMENT_SUCCEEDED, PAYMENT_FAILED, REFUND_PROCESSED. Přihlaste odběr pro každý endpoint zvlášť — jen to, co vaše integrace potřebuje.

Jak ověřím, že webhook skutečně pochází z Triviyo?

Každý payload je podepsán algoritmem HMAC-SHA256 pomocí jedinečného tajného klíče vašeho endpointu. Před zpracováním ověřte hlavičku X-Webhook-Signature oproti nezpracovanému tělu požadavku — stejný vzor jako u webhooků Stripe a GitHubu. Ukázky kódu najdete v naší dokumentaci.

Co se stane, když je můj endpoint nedostupný?

Triviyo provede celkem až 6 pokusů o doručení. Po posledním je doručení v protokolu doručení označeno jako neúspěšné. Odpověď 4xx jiná než 408 a 429 označí doručení jako neúspěšné okamžitě, bez dalších pokusů.

Mohu testovat webhooky ve stagingovém prostředí?

Ano. Odešlete testovací doručení na libovolný endpoint v Nastavení → Webhooky a ověřte integraci před spuštěním.

Jaký plán potřebuji pro webhooky?

Plán Professional a vyšší.

Vytvářejte integrace v reálném čase bez pollování

Podepsaný, s opakovanými pokusy, logovaný — přesně tak, jak to vývojářské týmy od webhooků očekávají.

14denní bezplatná zkušební verze. Bez zadání kreditní karty. Zrušení kdykoli.