Catàleg d'Esdeveniments Webhook

Aquesta pàgina llista cada esdeveniment webhook al qual et pots subscriure a Wink. Per a instruccions de configuració, consulta la Guia d’Integració Webhook o la pàgina de gestió de Webhooks.

Com subscriure’s

1. Navega a Aplicacions > Webhooks al teu portal.
2. Crea un webhook i selecciona els esdeveniments que vols rebre — o deixa la llista buida per rebre tots els esdeveniments.
3. Wink envia un HTTP POST signat al teu endpoint cada vegada que l’esdeveniment ocorre. Consulta Integració Webhook per a l’estructura, capçaleres, verificació de signatura i reintents.

Cada tipus d’esdeveniment

Aquesta taula es genera a partir del catàleg d’esdeveniments de la plataforma en temps de compilació, així que sempre coincideix amb l’API. Els tipus d’esdeveniments marcats com a entregats enllacen a la seva pàgina de referència a la API de Webhooks, que documenta el cos JSON exacte (WebhookEnvelope amb un objecte específic de l’esdeveniment), les capçaleres Wink-* i la política de reintents. Els tipus d’esdeveniments que no s’entreguen existeixen internament (pagaments, llibre major, sincronització del gestor de canals, …) però actualment no s’envien als subscriptors webhook.

Destinataris indica qui rep un esdeveniment: SUPPLIER (l’hotel), AFFILIATE (un revenedor amb un canal de vendes actiu amb l’hotel), AGENT (l’agència de viatges que va fer la reserva) o SELF (l’entitat gestora sobre la qual tracta l’esdeveniment). Cada destinatari rep la mateixa forma de càrrega útil; el detall específic per rol està darrere de l’URL links.self de la càrrega útil.

account.*

Esdeveniment	Descripció	Entregat	Destinataris
account.details.updated	The account's details changed.	no entregat	—
account.managers.update	The account's manager list changed.	✓ entregat	SELF
account.task.complete	An onboarding task was completed.	no entregat	—
account.task.create	An onboarding task was created for the account.	no entregat	—
account.task.remove	An onboarding task was removed.	no entregat	—
account.task.tax_id.complete	The tax-id onboarding task was completed.	no entregat	—
account.task.update	An onboarding task was updated.	no entregat	—
account.under_review	The account was placed under review.	no entregat	—

activity.*

Esdeveniment	Descripció	Entregat	Destinataris
activity.created	An activity was created.	✓ entregat	AFFILIATE, SUPPLIER
activity.deleted	An activity was deleted.	✓ entregat	AFFILIATE, SUPPLIER
activity.updated	An activity was updated.	✓ entregat	AFFILIATE, SUPPLIER

add_on.*

Esdeveniment	Descripció	Entregat	Destinataris
add_on.created	An add-on was created.	✓ entregat	AFFILIATE, SUPPLIER
add_on.deleted	An add-on was deleted.	✓ entregat	AFFILIATE, SUPPLIER
add_on.updated	An add-on was updated.	✓ entregat	AFFILIATE, SUPPLIER

booking.*

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

channel-manager.*

Esdeveniment	Descripció	Entregat	Destinataris
channel-manager.update	A channel manager pushed an update.	no entregat	—
channel-manager.update.availability	A channel manager pushed an availability update.	no entregat	—
channel-manager.update.rate	A channel manager pushed a rate update.	no entregat	—

email.*

Esdeveniment	Descripció	Entregat	Destinataris
email.correspondence	An email correspondence was recorded.	no entregat	—

internal.*

Esdeveniment	Descripció	Entregat	Destinataris
internal.payment.failed	A payment failed (internal).	no entregat	—
internal.payment.processing	A payment is processing (internal).	no entregat	—
internal.payment.succeeded	A payment succeeded (internal).	no entregat	—

ledger.*

Esdeveniment	Descripció	Entregat	Destinataris
ledger.entry.create	A ledger entry was created.	no entregat	—

managing_entity.*

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

master_rate.*

Esdeveniment	Descripció	Entregat	Destinataris
master_rate.created	A master rate was created.	✓ entregat	AFFILIATE, SUPPLIER
master_rate.deleted	A master rate was deleted.	✓ entregat	AFFILIATE, SUPPLIER
master_rate.updated	A master rate was updated.	✓ entregat	AFFILIATE, SUPPLIER

meeting_room.*

Esdeveniment	Descripció	Entregat	Destinataris
meeting_room.created	A meeting room was created.	✓ entregat	AFFILIATE, SUPPLIER
meeting_room.deleted	A meeting room was deleted.	✓ entregat	AFFILIATE, SUPPLIER
meeting_room.updated	A meeting room was updated.	✓ entregat	AFFILIATE, SUPPLIER

payee.*

Esdeveniment	Descripció	Entregat	Destinataris
payee.create	A payee was created.	no entregat	—
payee.create.failure	Creating a payee failed.	no entregat	—
payee.update	A payee was updated.	no entregat	—
payee.update.failure	Updating a payee failed.	no entregat	—

perk.*

Esdeveniment	Descripció	Entregat	Destinataris
perk.deleted	A perk was deleted.	no entregat	—
perk.updated	A perk was updated.	no entregat	—

property.*

Esdeveniment	Descripció	Entregat	Destinataris
property.address.updated	A property's address changed.	✓ entregat	AFFILIATE, SUPPLIER
property.created	A property (hotel) was created.	✓ entregat	AFFILIATE, SUPPLIER
property.deleted	A property was deleted.	✓ entregat	AFFILIATE, SUPPLIER
property.geolocation.updated	A property's geolocation changed.	✓ entregat	AFFILIATE, SUPPLIER
property.name.updated	A property's name changed.	✓ entregat	AFFILIATE, SUPPLIER
property.policy.created	A property policy was created.	✓ entregat	AFFILIATE, SUPPLIER
property.policy.updated	A property policy changed.	✓ entregat	AFFILIATE, SUPPLIER
property.profile.updated	A property's profile changed.	✓ entregat	AFFILIATE, SUPPLIER
property.registered	A property completed registration.	✓ entregat	AFFILIATE, SUPPLIER
property.services.updated	A property's services/amenities changed.	✓ entregat	AFFILIATE, SUPPLIER
property.status.updated	A property's platform status changed.	✓ entregat	AFFILIATE, SUPPLIER
property.updated	A property was updated.	no entregat	—
property.welcome_text.updated	A property's welcome text changed.	✓ entregat	AFFILIATE, SUPPLIER

rate_modifier.*

Esdeveniment	Descripció	Entregat	Destinataris
rate_modifier.updated	A rate modifier was updated.	no entregat	—

rate_plan.*

Esdeveniment	Descripció	Entregat	Destinataris
rate_plan.created	A rate plan was created.	✓ entregat	AFFILIATE, SUPPLIER
rate_plan.deleted	A rate plan was deleted.	✓ entregat	AFFILIATE, SUPPLIER
rate_plan.updated	A rate plan was updated.	✓ entregat	AFFILIATE, SUPPLIER

restaurant.*

Esdeveniment	Descripció	Entregat	Destinataris
restaurant.created	A restaurant was created.	✓ entregat	AFFILIATE, SUPPLIER
restaurant.deleted	A restaurant was deleted.	✓ entregat	AFFILIATE, SUPPLIER
restaurant.updated	A restaurant was updated.	✓ entregat	AFFILIATE, SUPPLIER

room_type.*

Esdeveniment	Descripció	Entregat	Destinataris
room_type.created	A room type was created.	✓ entregat	AFFILIATE, SUPPLIER
room_type.deleted	A room type was deleted.	✓ entregat	AFFILIATE, SUPPLIER
room_type.updated	A room type was updated.	✓ entregat	AFFILIATE, SUPPLIER

sales_channel.*

Esdeveniment	Descripció	Entregat	Destinataris
sales_channel.created	A sales-channel relationship (supplier ↔ reseller) was created.	✓ entregat	AFFILIATE, SUPPLIER
sales_channel.deleted	A sales-channel relationship was deleted.	✓ entregat	AFFILIATE, SUPPLIER
sales_channel.updated	A sales-channel relationship was updated.	✓ entregat	AFFILIATE, SUPPLIER

spa.*

Esdeveniment	Descripció	Entregat	Destinataris
spa.created	A spa was created.	✓ entregat	AFFILIATE, SUPPLIER
spa.deleted	A spa was deleted.	✓ entregat	AFFILIATE, SUPPLIER
spa.updated	A spa was updated.	✓ entregat	AFFILIATE, SUPPLIER

special_rate.*

Esdeveniment	Descripció	Entregat	Destinataris
special_rate.created	A promotion (special rate) was created.	✓ entregat	AFFILIATE, SUPPLIER
special_rate.deleted	A promotion was deleted.	✓ entregat	AFFILIATE, SUPPLIER
special_rate.updated	A promotion was updated.	✓ entregat	AFFILIATE, SUPPLIER

Consell

Comença subscrivint-te a tots els esdeveniments durant el desenvolupament. Un cop entenguis quines càrregues útils necessita el teu sistema, restringeix les teves subscripcions per reduir el soroll. Envia’t un esdeveniment de prova des de Aplicacions > Webhooks (o POST …/webhook/{id}/test) per confirmar el teu endpoint i la verificació de signatura abans d’anar a producció.

Lectures addicionals

• Guia d’Integració Webhook — Passos de configuració i millors pràctiques.
• Webhooks — Gestiona les teves subscripcions webhook.
• Aplicacions — Gestiona les credencials API.
• Desenvolupa a Wink — Visió general de la plataforma per a desenvolupadors.