Webhook-tapahtumaluettelo

Tällä sivulla on luettelo kaikista webhook-tapahtumista, joihin voit tilata Winkissä. Asennusohjeita varten katso Webhook Integration Guide tai Webhooks management page.

Kuinka tilata

1. Siirry portaalissasi kohtaan Applications > Webhooks.
2. Luo webhook ja valitse vastaanotettavat tapahtumat — tai jätä lista tyhjäksi vastaanottaaksesi kaikki tapahtumat.
3. Wink lähettää allekirjoitetun HTTP POST -pyynnön päätepisteeseesi aina, kun tapahtuma tapahtuu. Katso Webhook Integration kuoresta, otsikoista, allekirjoituksen tarkistuksesta ja uudelleenyrityksistä.

Kaikki tapahtumatyypit

Tämä taulukko on luotu alustan tapahtumaluettelosta rakennusvaiheessa, joten se vastaa aina API:a. Toimitetut tapahtumatyypit linkittävät niiden viitesivulle Webhooks API:ssa, jossa on dokumentoitu tarkka JSON-rakenne (WebhookEnvelope tapahtumakohtaisella object-kentällä), Wink-*-otsikot ja uudelleenyrityskäytäntö. Toimittamattomat tapahtumatyypit ovat sisäisiä (maksut, kirjanpito, kanavahallinnan synkronointi, …), mutta niitä ei tällä hetkellä lähetetä webhook-tilaajille.

Vastaanottajat kertoo, kuka tapahtuman saa: SUPPLIER (hotelli), AFFILIATE (jälleenmyyjä, jolla on aktiivinen myyntikanava hotellille), AGENT (matkatoimisto, joka teki varauksen) tai SELF (hallinnoiva taho, johon tapahtuma liittyy). Jokainen vastaanottaja saa saman hyötykuorman muodon; roolikohtaiset tiedot löytyvät hyötykuorman links.self-URL-osoitteesta.

account.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
account.details.updated	The account's details changed.	ei toimitettu	—
account.managers.update	The account's manager list changed.	✓ toimitettu	SELF
account.task.complete	An onboarding task was completed.	ei toimitettu	—
account.task.create	An onboarding task was created for the account.	ei toimitettu	—
account.task.remove	An onboarding task was removed.	ei toimitettu	—
account.task.tax_id.complete	The tax-id onboarding task was completed.	ei toimitettu	—
account.task.update	An onboarding task was updated.	ei toimitettu	—
account.under_review	The account was placed under review.	ei toimitettu	—

activity.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
activity.created	An activity was created.	✓ toimitettu	AFFILIATE, SUPPLIER
activity.deleted	An activity was deleted.	✓ toimitettu	AFFILIATE, SUPPLIER
activity.updated	An activity was updated.	✓ toimitettu	AFFILIATE, SUPPLIER

add_on.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
add_on.created	An add-on was created.	✓ toimitettu	AFFILIATE, SUPPLIER
add_on.deleted	An add-on was deleted.	✓ toimitettu	AFFILIATE, SUPPLIER
add_on.updated	An add-on was updated.	✓ toimitettu	AFFILIATE, SUPPLIER

booking.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
booking.cancelled	A booking was cancelled.	✓ toimitettu	AFFILIATE, AGENT, SUPPLIER
booking.create	A booking was created (confirmed).	✓ toimitettu	AFFILIATE, AGENT, SUPPLIER
booking.failed	A booking attempt failed.	✓ toimitettu	AFFILIATE, AGENT, SUPPLIER
booking.funds.available	Funds for a booking became available for payout.	✓ toimitettu	AFFILIATE, AGENT, SUPPLIER
booking.funds.ledgered	Funds for a booking were added to the ledger.	✓ toimitettu	AFFILIATE, AGENT, SUPPLIER
booking.initialize.complete	A booking initialisation completed.	ei toimitettu	—
booking.initialize.request	A booking initialisation (checkout) was requested.	ei toimitettu	—
booking.payout.complete	A payout for a booking completed.	ei toimitettu	—
booking.payout.create	A payout for a booking was created.	ei toimitettu	—
booking.processing	A booking is being processed.	ei toimitettu	—
booking.refund.error	A booking was refunded because of a processing error.	ei toimitettu	—
booking.refund.full	A booking was fully refunded.	✓ toimitettu	AFFILIATE, AGENT, SUPPLIER
booking.refund.partial	A booking was partially refunded.	✓ toimitettu	AFFILIATE, AGENT, SUPPLIER
booking.refund.request	A refund was requested for a booking.	✓ toimitettu	AFFILIATE, AGENT, SUPPLIER
booking.review.created	A guest submitted a review for a booking.	✓ toimitettu	SUPPLIER
booking.review.responded	The hotel responded to a guest review.	✓ toimitettu	AFFILIATE, AGENT, SUPPLIER
booking.sync.failed	A booking-to-channel-manager synchronisation failed.	ei toimitettu	—
booking.sync.run	A booking-to-channel-manager synchronisation run started.	ei toimitettu	—

channel-manager.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
channel-manager.update	A channel manager pushed an update.	ei toimitettu	—
channel-manager.update.availability	A channel manager pushed an availability update.	ei toimitettu	—
channel-manager.update.rate	A channel manager pushed a rate update.	ei toimitettu	—

email.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
email.correspondence	An email correspondence was recorded.	ei toimitettu	—

internal.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
internal.payment.failed	A payment failed (internal).	ei toimitettu	—
internal.payment.processing	A payment is processing (internal).	ei toimitettu	—
internal.payment.succeeded	A payment succeeded (internal).	ei toimitettu	—

ledger.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
ledger.entry.create	A ledger entry was created.	ei toimitettu	—

managing_entity.*

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

master_rate.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
master_rate.created	A master rate was created.	✓ toimitettu	AFFILIATE, SUPPLIER
master_rate.deleted	A master rate was deleted.	✓ toimitettu	AFFILIATE, SUPPLIER
master_rate.updated	A master rate was updated.	✓ toimitettu	AFFILIATE, SUPPLIER

meeting_room.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
meeting_room.created	A meeting room was created.	✓ toimitettu	AFFILIATE, SUPPLIER
meeting_room.deleted	A meeting room was deleted.	✓ toimitettu	AFFILIATE, SUPPLIER
meeting_room.updated	A meeting room was updated.	✓ toimitettu	AFFILIATE, SUPPLIER

payee.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
payee.create	A payee was created.	ei toimitettu	—
payee.create.failure	Creating a payee failed.	ei toimitettu	—
payee.update	A payee was updated.	ei toimitettu	—
payee.update.failure	Updating a payee failed.	ei toimitettu	—

perk.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
perk.deleted	A perk was deleted.	ei toimitettu	—
perk.updated	A perk was updated.	ei toimitettu	—

property.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
property.address.updated	A property's address changed.	✓ toimitettu	AFFILIATE, SUPPLIER
property.created	A property (hotel) was created.	✓ toimitettu	AFFILIATE, SUPPLIER
property.deleted	A property was deleted.	✓ toimitettu	AFFILIATE, SUPPLIER
property.geolocation.updated	A property's geolocation changed.	✓ toimitettu	AFFILIATE, SUPPLIER
property.name.updated	A property's name changed.	✓ toimitettu	AFFILIATE, SUPPLIER
property.policy.created	A property policy was created.	✓ toimitettu	AFFILIATE, SUPPLIER
property.policy.updated	A property policy changed.	✓ toimitettu	AFFILIATE, SUPPLIER
property.profile.updated	A property's profile changed.	✓ toimitettu	AFFILIATE, SUPPLIER
property.registered	A property completed registration.	✓ toimitettu	AFFILIATE, SUPPLIER
property.services.updated	A property's services/amenities changed.	✓ toimitettu	AFFILIATE, SUPPLIER
property.status.updated	A property's platform status changed.	✓ toimitettu	AFFILIATE, SUPPLIER
property.updated	A property was updated.	ei toimitettu	—
property.welcome_text.updated	A property's welcome text changed.	✓ toimitettu	AFFILIATE, SUPPLIER

rate_modifier.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
rate_modifier.updated	A rate modifier was updated.	ei toimitettu	—

rate_plan.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
rate_plan.created	A rate plan was created.	✓ toimitettu	AFFILIATE, SUPPLIER
rate_plan.deleted	A rate plan was deleted.	✓ toimitettu	AFFILIATE, SUPPLIER
rate_plan.updated	A rate plan was updated.	✓ toimitettu	AFFILIATE, SUPPLIER

restaurant.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
restaurant.created	A restaurant was created.	✓ toimitettu	AFFILIATE, SUPPLIER
restaurant.deleted	A restaurant was deleted.	✓ toimitettu	AFFILIATE, SUPPLIER
restaurant.updated	A restaurant was updated.	✓ toimitettu	AFFILIATE, SUPPLIER

room_type.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
room_type.created	A room type was created.	✓ toimitettu	AFFILIATE, SUPPLIER
room_type.deleted	A room type was deleted.	✓ toimitettu	AFFILIATE, SUPPLIER
room_type.updated	A room type was updated.	✓ toimitettu	AFFILIATE, SUPPLIER

sales_channel.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
sales_channel.created	A sales-channel relationship (supplier ↔ reseller) was created.	✓ toimitettu	AFFILIATE, SUPPLIER
sales_channel.deleted	A sales-channel relationship was deleted.	✓ toimitettu	AFFILIATE, SUPPLIER
sales_channel.updated	A sales-channel relationship was updated.	✓ toimitettu	AFFILIATE, SUPPLIER

spa.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
spa.created	A spa was created.	✓ toimitettu	AFFILIATE, SUPPLIER
spa.deleted	A spa was deleted.	✓ toimitettu	AFFILIATE, SUPPLIER
spa.updated	A spa was updated.	✓ toimitettu	AFFILIATE, SUPPLIER

special_rate.*

Tapahtuma	Kuvaus	Toimitettu	Vastaanottajat
special_rate.created	A promotion (special rate) was created.	✓ toimitettu	AFFILIATE, SUPPLIER
special_rate.deleted	A promotion was deleted.	✓ toimitettu	AFFILIATE, SUPPLIER
special_rate.updated	A promotion was updated.	✓ toimitettu	AFFILIATE, SUPPLIER

Vinkki

Aloita tilaamalla kaikki tapahtumat kehitysvaiheessa. Kun ymmärrät, mitä hyötykuormia järjestelmäsi tarvitsee, rajaa tilauksiasi vähentääksesi häiriöitä. Lähetä itsellesi testitapahtuma kohdasta Applications > Webhooks (tai POST …/webhook/{id}/test) varmistaaksesi päätepisteesi ja allekirjoituksen tarkistuksen ennen tuotantoon siirtymistä.

Lisälukemista

• Webhook Integration Guide — Asennusvaiheet ja parhaat käytännöt.
• Webhooks — Hallinnoi webhook-tilauksiasi.
• Applications — Hallinnoi API-tunnuksia.
• Build on Wink — Alustan yleiskatsaus kehittäjille.