Katalog webhook událostí

Tato stránka uvádí všechny webhook události, na které se můžete na Wink přihlásit. Pro instrukce k nastavení si přečtěte Průvodce integrací webhooků nebo stránku správy webhooků.

Jak se přihlásit k odběru

1. Přejděte v portálu do Aplikace > Webhooky.
2. Vytvořte webhook a vyberte události, které chcete přijímat — nebo nechte seznam prázdný, abyste přijímali všechny události.
3. Wink pošle podepsaný HTTP POST na váš endpoint pokaždé, když nastane událost. Viz Integrace webhooků pro informace o obálce, hlavičkách, ověřování podpisu a opakování.

Všechny typy událostí

Tato tabulka je generována z katalogu událostí platformy při sestavení, takže vždy odpovídá API. Typy událostí označené jako doručené odkazují na jejich referenční stránku v Webhooks API, která dokumentuje přesné JSON tělo (WebhookEnvelope s událostí specifickým object), hlavičky Wink-* a politiku opakování. Typy událostí, které nejsou doručovány, existují interně (platby, účetnictví, synchronizace channel-manageru, …), ale momentálně nejsou zasílány odběratelům webhooků.

Příjemci uvádí, kdo událost přijímá: SUPPLIER (hotel), AFFILIATE (reseller s aktivním prodejním kanálem do hotelu), AGENT (cestovní kancelář, která provedla rezervaci) nebo SELF (správce, kterého se událost týká). Každý příjemce dostává stejný tvar payloadu; role-specifické detaily jsou za URL links.self v payloadu.

account.*

Událost	Popis	Doručeno	Příjemci
account.details.updated	The account's details changed.	nedoručeno	—
account.managers.update	The account's manager list changed.	✓ doručeno	SELF
account.task.complete	An onboarding task was completed.	nedoručeno	—
account.task.create	An onboarding task was created for the account.	nedoručeno	—
account.task.remove	An onboarding task was removed.	nedoručeno	—
account.task.tax_id.complete	The tax-id onboarding task was completed.	nedoručeno	—
account.task.update	An onboarding task was updated.	nedoručeno	—
account.under_review	The account was placed under review.	nedoručeno	—

activity.*

Událost	Popis	Doručeno	Příjemci
activity.created	An activity was created.	✓ doručeno	AFFILIATE, SUPPLIER
activity.deleted	An activity was deleted.	✓ doručeno	AFFILIATE, SUPPLIER
activity.updated	An activity was updated.	✓ doručeno	AFFILIATE, SUPPLIER

add_on.*

Událost	Popis	Doručeno	Příjemci
add_on.created	An add-on was created.	✓ doručeno	AFFILIATE, SUPPLIER
add_on.deleted	An add-on was deleted.	✓ doručeno	AFFILIATE, SUPPLIER
add_on.updated	An add-on was updated.	✓ doručeno	AFFILIATE, SUPPLIER

booking.*

Událost	Popis	Doručeno	Příjemci
booking.cancelled	A booking was cancelled.	✓ doručeno	AFFILIATE, AGENT, SUPPLIER
booking.create	A booking was created (confirmed).	✓ doručeno	AFFILIATE, AGENT, SUPPLIER
booking.failed	A booking attempt failed.	✓ doručeno	AFFILIATE, AGENT, SUPPLIER
booking.funds.available	Funds for a booking became available for payout.	✓ doručeno	AFFILIATE, AGENT, SUPPLIER
booking.funds.ledgered	Funds for a booking were added to the ledger.	✓ doručeno	AFFILIATE, AGENT, SUPPLIER
booking.initialize.complete	A booking initialisation completed.	nedoručeno	—
booking.initialize.request	A booking initialisation (checkout) was requested.	nedoručeno	—
booking.payout.complete	A payout for a booking completed.	nedoručeno	—
booking.payout.create	A payout for a booking was created.	nedoručeno	—
booking.processing	A booking is being processed.	nedoručeno	—
booking.refund.error	A booking was refunded because of a processing error.	nedoručeno	—
booking.refund.full	A booking was fully refunded.	✓ doručeno	AFFILIATE, AGENT, SUPPLIER
booking.refund.partial	A booking was partially refunded.	✓ doručeno	AFFILIATE, AGENT, SUPPLIER
booking.refund.request	A refund was requested for a booking.	✓ doručeno	AFFILIATE, AGENT, SUPPLIER
booking.review.created	A guest submitted a review for a booking.	✓ doručeno	SUPPLIER
booking.review.responded	The hotel responded to a guest review.	✓ doručeno	AFFILIATE, AGENT, SUPPLIER
booking.sync.failed	A booking-to-channel-manager synchronisation failed.	nedoručeno	—
booking.sync.run	A booking-to-channel-manager synchronisation run started.	nedoručeno	—

channel-manager.*

Událost	Popis	Doručeno	Příjemci
channel-manager.update	A channel manager pushed an update.	nedoručeno	—
channel-manager.update.availability	A channel manager pushed an availability update.	nedoručeno	—
channel-manager.update.rate	A channel manager pushed a rate update.	nedoručeno	—

email.*

Událost	Popis	Doručeno	Příjemci
email.correspondence	An email correspondence was recorded.	nedoručeno	—

internal.*

Událost	Popis	Doručeno	Příjemci
internal.payment.failed	A payment failed (internal).	nedoručeno	—
internal.payment.processing	A payment is processing (internal).	nedoručeno	—
internal.payment.succeeded	A payment succeeded (internal).	nedoručeno	—

ledger.*

Událost	Popis	Doručeno	Příjemci
ledger.entry.create	A ledger entry was created.	nedoručeno	—

managing_entity.*

Událost	Popis	Doručeno	Příjemci
managing_entity.account_representative.updated	The account representative changed.	nedoručeno	—
managing_entity.agent.email.notification	An email notification was sent to the account's agent.	nedoručeno	—
managing_entity.agent.updated	The account's travel-agent details changed.	nedoručeno	—
managing_entity.city.updated	The account's address or city changed.	✓ doručeno	SELF
managing_entity.created	A managing entity (account) was created.	✓ doručeno	SELF
managing_entity.deleted	The account was deleted.	✓ doručeno	SELF
managing_entity.information.updated	The account's general information changed.	✓ doručeno	SELF
managing_entity.logo.updated	The account's logo changed.	✓ doručeno	SELF
managing_entity.managed_by.updated	The entity managing this account on its behalf changed.	✓ doručeno	SELF
managing_entity.manager.accepted	An invited manager accepted the invitation.	nedoručeno	—
managing_entity.manager.added	A manager was added to the account.	✓ doručeno	SELF
managing_entity.manager.email.notification	An email notification was sent to an account manager.	nedoručeno	—
managing_entity.manager.invited	A manager was invited to the account.	✓ doručeno	SELF
managing_entity.manager.owner.set	The account owner was set.	✓ doručeno	SELF
managing_entity.manager.rejected	An invited manager rejected the invitation.	nedoručeno	—
managing_entity.manager.removed	A manager was removed from the account.	✓ doručeno	SELF
managing_entity.name.updated	The account's display name changed.	nedoručeno	—
managing_entity.place_id.updated	The account's Google Place ID changed.	✓ doručeno	SELF
managing_entity.profile_picture.updated	The account's profile picture changed.	✓ doručeno	SELF
managing_entity.status.updated	The account's platform status changed (e.g. approved, suspended).	✓ doručeno	SELF
managing_entity.subscription.changed	The account's platform subscription changed.	nedoručeno	—
managing_entity.subscription.invoice.changed	The status of a subscription invoice changed.	✓ doručeno	SELF
managing_entity.subscription.provisioned	A platform subscription was provisioned for the account.	✓ doručeno	SELF
managing_entity.unique_id.updated	The account's short unique id changed.	✓ doručeno	SELF
managing_entity.url_name.updated	The account's URL name (slug) changed.	✓ doručeno	SELF

master_rate.*

Událost	Popis	Doručeno	Příjemci
master_rate.created	A master rate was created.	✓ doručeno	AFFILIATE, SUPPLIER
master_rate.deleted	A master rate was deleted.	✓ doručeno	AFFILIATE, SUPPLIER
master_rate.updated	A master rate was updated.	✓ doručeno	AFFILIATE, SUPPLIER

meeting_room.*

Událost	Popis	Doručeno	Příjemci
meeting_room.created	A meeting room was created.	✓ doručeno	AFFILIATE, SUPPLIER
meeting_room.deleted	A meeting room was deleted.	✓ doručeno	AFFILIATE, SUPPLIER
meeting_room.updated	A meeting room was updated.	✓ doručeno	AFFILIATE, SUPPLIER

payee.*

Událost	Popis	Doručeno	Příjemci
payee.create	A payee was created.	nedoručeno	—
payee.create.failure	Creating a payee failed.	nedoručeno	—
payee.update	A payee was updated.	nedoručeno	—
payee.update.failure	Updating a payee failed.	nedoručeno	—

perk.*

Událost	Popis	Doručeno	Příjemci
perk.deleted	A perk was deleted.	nedoručeno	—
perk.updated	A perk was updated.	nedoručeno	—

property.*

Událost	Popis	Doručeno	Příjemci
property.address.updated	A property's address changed.	✓ doručeno	AFFILIATE, SUPPLIER
property.created	A property (hotel) was created.	✓ doručeno	AFFILIATE, SUPPLIER
property.deleted	A property was deleted.	✓ doručeno	AFFILIATE, SUPPLIER
property.geolocation.updated	A property's geolocation changed.	✓ doručeno	AFFILIATE, SUPPLIER
property.name.updated	A property's name changed.	✓ doručeno	AFFILIATE, SUPPLIER
property.policy.created	A property policy was created.	✓ doručeno	AFFILIATE, SUPPLIER
property.policy.updated	A property policy changed.	✓ doručeno	AFFILIATE, SUPPLIER
property.profile.updated	A property's profile changed.	✓ doručeno	AFFILIATE, SUPPLIER
property.registered	A property completed registration.	✓ doručeno	AFFILIATE, SUPPLIER
property.services.updated	A property's services/amenities changed.	✓ doručeno	AFFILIATE, SUPPLIER
property.status.updated	A property's platform status changed.	✓ doručeno	AFFILIATE, SUPPLIER
property.updated	A property was updated.	nedoručeno	—
property.welcome_text.updated	A property's welcome text changed.	✓ doručeno	AFFILIATE, SUPPLIER

rate_modifier.*

Událost	Popis	Doručeno	Příjemci
rate_modifier.updated	A rate modifier was updated.	nedoručeno	—

rate_plan.*

Událost	Popis	Doručeno	Příjemci
rate_plan.created	A rate plan was created.	✓ doručeno	AFFILIATE, SUPPLIER
rate_plan.deleted	A rate plan was deleted.	✓ doručeno	AFFILIATE, SUPPLIER
rate_plan.updated	A rate plan was updated.	✓ doručeno	AFFILIATE, SUPPLIER

restaurant.*

Událost	Popis	Doručeno	Příjemci
restaurant.created	A restaurant was created.	✓ doručeno	AFFILIATE, SUPPLIER
restaurant.deleted	A restaurant was deleted.	✓ doručeno	AFFILIATE, SUPPLIER
restaurant.updated	A restaurant was updated.	✓ doručeno	AFFILIATE, SUPPLIER

room_type.*

Událost	Popis	Doručeno	Příjemci
room_type.created	A room type was created.	✓ doručeno	AFFILIATE, SUPPLIER
room_type.deleted	A room type was deleted.	✓ doručeno	AFFILIATE, SUPPLIER
room_type.updated	A room type was updated.	✓ doručeno	AFFILIATE, SUPPLIER

sales_channel.*

Událost	Popis	Doručeno	Příjemci
sales_channel.created	A sales-channel relationship (supplier ↔ reseller) was created.	✓ doručeno	AFFILIATE, SUPPLIER
sales_channel.deleted	A sales-channel relationship was deleted.	✓ doručeno	AFFILIATE, SUPPLIER
sales_channel.updated	A sales-channel relationship was updated.	✓ doručeno	AFFILIATE, SUPPLIER

spa.*

Událost	Popis	Doručeno	Příjemci
spa.created	A spa was created.	✓ doručeno	AFFILIATE, SUPPLIER
spa.deleted	A spa was deleted.	✓ doručeno	AFFILIATE, SUPPLIER
spa.updated	A spa was updated.	✓ doručeno	AFFILIATE, SUPPLIER

special_rate.*

Událost	Popis	Doručeno	Příjemci
special_rate.created	A promotion (special rate) was created.	✓ doručeno	AFFILIATE, SUPPLIER
special_rate.deleted	A promotion was deleted.	✓ doručeno	AFFILIATE, SUPPLIER
special_rate.updated	A promotion was updated.	✓ doručeno	AFFILIATE, SUPPLIER

Tip

Začněte během vývoje přihlašováním ke všem událostem. Jakmile pochopíte, které payloady váš systém potřebuje, zúžte odběry, abyste snížili šum. Pošlete si testovací událost z Aplikace > Webhooky (nebo POST …/webhook/{id}/test), abyste potvrdili svůj endpoint a kontrolu podpisu před spuštěním do ostrého provozu.

Další čtení

• Průvodce integrací webhooků — Kroky nastavení a osvědčené postupy.
• Webhooky — Správa vašich odběrů webhooků.
• Aplikace — Správa API přístupových údajů.
• Vývoj na Wink — Přehled platformy pro vývojáře.