Catalogo Eventi Webhook

Questa pagina elenca ogni evento webhook a cui puoi iscriverti su Wink. Per le istruzioni di configurazione, consulta la Guida all’integrazione Webhook o la pagina di gestione Webhooks.

Come iscriversi

1. Vai su Applicazioni > Webhooks nel tuo portale.
2. Crea un webhook e seleziona gli eventi che vuoi ricevere — oppure lascia la lista vuota per ricevere ogni evento.
3. Wink invia una richiesta HTTP POST firmata al tuo endpoint ogni volta che si verifica l’evento. Consulta Integrazione Webhook per informazioni su envelope, header, verifica della firma e ritentativi.

Ogni tipo di evento

Questa tabella è generata dal catalogo eventi della piattaforma in fase di build, quindi corrisponde sempre all’API. I tipi di evento contrassegnati come consegnati linkano alla loro pagina di riferimento nella API Webhooks, che documenta il corpo JSON esatto (WebhookEnvelope con un object specifico per evento), gli header Wink-* e la policy di ritentativo. I tipi di evento non consegnati esistono internamente (pagamenti, ledger, sincronizzazione channel-manager, …) ma non sono attualmente inviati agli iscritti webhook.

Destinatari indica chi riceve un evento: SUPPLIER (l’hotel), AFFILIATE (un rivenditore con un canale di vendita attivo verso l’hotel), AGENT (l’agenzia di viaggi che ha effettuato la prenotazione) o SELF (l’entità gestore a cui l’evento si riferisce). Ogni destinatario riceve la stessa struttura di payload; i dettagli specifici per ruolo sono dietro l’URL links.self del payload.

account.*

Evento	Descrizione	Consegnato	Destinatari
account.details.updated	The account's details changed.	non consegnato	—
account.managers.update	The account's manager list changed.	✓ consegnato	SELF
account.task.complete	An onboarding task was completed.	non consegnato	—
account.task.create	An onboarding task was created for the account.	non consegnato	—
account.task.remove	An onboarding task was removed.	non consegnato	—
account.task.tax_id.complete	The tax-id onboarding task was completed.	non consegnato	—
account.task.update	An onboarding task was updated.	non consegnato	—
account.under_review	The account was placed under review.	non consegnato	—

activity.*

Evento	Descrizione	Consegnato	Destinatari
activity.created	An activity was created.	✓ consegnato	AFFILIATE, SUPPLIER
activity.deleted	An activity was deleted.	✓ consegnato	AFFILIATE, SUPPLIER
activity.updated	An activity was updated.	✓ consegnato	AFFILIATE, SUPPLIER

add_on.*

Evento	Descrizione	Consegnato	Destinatari
add_on.created	An add-on was created.	✓ consegnato	AFFILIATE, SUPPLIER
add_on.deleted	An add-on was deleted.	✓ consegnato	AFFILIATE, SUPPLIER
add_on.updated	An add-on was updated.	✓ consegnato	AFFILIATE, SUPPLIER

booking.*

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

channel-manager.*

Evento	Descrizione	Consegnato	Destinatari
channel-manager.update	A channel manager pushed an update.	non consegnato	—
channel-manager.update.availability	A channel manager pushed an availability update.	non consegnato	—
channel-manager.update.rate	A channel manager pushed a rate update.	non consegnato	—

email.*

Evento	Descrizione	Consegnato	Destinatari
email.correspondence	An email correspondence was recorded.	non consegnato	—

internal.*

Evento	Descrizione	Consegnato	Destinatari
internal.payment.failed	A payment failed (internal).	non consegnato	—
internal.payment.processing	A payment is processing (internal).	non consegnato	—
internal.payment.succeeded	A payment succeeded (internal).	non consegnato	—

ledger.*

Evento	Descrizione	Consegnato	Destinatari
ledger.entry.create	A ledger entry was created.	non consegnato	—

managing_entity.*

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

master_rate.*

Evento	Descrizione	Consegnato	Destinatari
master_rate.created	A master rate was created.	✓ consegnato	AFFILIATE, SUPPLIER
master_rate.deleted	A master rate was deleted.	✓ consegnato	AFFILIATE, SUPPLIER
master_rate.updated	A master rate was updated.	✓ consegnato	AFFILIATE, SUPPLIER

meeting_room.*

Evento	Descrizione	Consegnato	Destinatari
meeting_room.created	A meeting room was created.	✓ consegnato	AFFILIATE, SUPPLIER
meeting_room.deleted	A meeting room was deleted.	✓ consegnato	AFFILIATE, SUPPLIER
meeting_room.updated	A meeting room was updated.	✓ consegnato	AFFILIATE, SUPPLIER

payee.*

Evento	Descrizione	Consegnato	Destinatari
payee.create	A payee was created.	non consegnato	—
payee.create.failure	Creating a payee failed.	non consegnato	—
payee.update	A payee was updated.	non consegnato	—
payee.update.failure	Updating a payee failed.	non consegnato	—

perk.*

Evento	Descrizione	Consegnato	Destinatari
perk.deleted	A perk was deleted.	non consegnato	—
perk.updated	A perk was updated.	non consegnato	—

property.*

Evento	Descrizione	Consegnato	Destinatari
property.address.updated	A property's address changed.	✓ consegnato	AFFILIATE, SUPPLIER
property.created	A property (hotel) was created.	✓ consegnato	AFFILIATE, SUPPLIER
property.deleted	A property was deleted.	✓ consegnato	AFFILIATE, SUPPLIER
property.geolocation.updated	A property's geolocation changed.	✓ consegnato	AFFILIATE, SUPPLIER
property.name.updated	A property's name changed.	✓ consegnato	AFFILIATE, SUPPLIER
property.policy.created	A property policy was created.	✓ consegnato	AFFILIATE, SUPPLIER
property.policy.updated	A property policy changed.	✓ consegnato	AFFILIATE, SUPPLIER
property.profile.updated	A property's profile changed.	✓ consegnato	AFFILIATE, SUPPLIER
property.registered	A property completed registration.	✓ consegnato	AFFILIATE, SUPPLIER
property.services.updated	A property's services/amenities changed.	✓ consegnato	AFFILIATE, SUPPLIER
property.status.updated	A property's platform status changed.	✓ consegnato	AFFILIATE, SUPPLIER
property.updated	A property was updated.	non consegnato	—
property.welcome_text.updated	A property's welcome text changed.	✓ consegnato	AFFILIATE, SUPPLIER

rate_modifier.*

Evento	Descrizione	Consegnato	Destinatari
rate_modifier.updated	A rate modifier was updated.	non consegnato	—

rate_plan.*

Evento	Descrizione	Consegnato	Destinatari
rate_plan.created	A rate plan was created.	✓ consegnato	AFFILIATE, SUPPLIER
rate_plan.deleted	A rate plan was deleted.	✓ consegnato	AFFILIATE, SUPPLIER
rate_plan.updated	A rate plan was updated.	✓ consegnato	AFFILIATE, SUPPLIER

restaurant.*

Evento	Descrizione	Consegnato	Destinatari
restaurant.created	A restaurant was created.	✓ consegnato	AFFILIATE, SUPPLIER
restaurant.deleted	A restaurant was deleted.	✓ consegnato	AFFILIATE, SUPPLIER
restaurant.updated	A restaurant was updated.	✓ consegnato	AFFILIATE, SUPPLIER

room_type.*

Evento	Descrizione	Consegnato	Destinatari
room_type.created	A room type was created.	✓ consegnato	AFFILIATE, SUPPLIER
room_type.deleted	A room type was deleted.	✓ consegnato	AFFILIATE, SUPPLIER
room_type.updated	A room type was updated.	✓ consegnato	AFFILIATE, SUPPLIER

sales_channel.*

Evento	Descrizione	Consegnato	Destinatari
sales_channel.created	A sales-channel relationship (supplier ↔ reseller) was created.	✓ consegnato	AFFILIATE, SUPPLIER
sales_channel.deleted	A sales-channel relationship was deleted.	✓ consegnato	AFFILIATE, SUPPLIER
sales_channel.updated	A sales-channel relationship was updated.	✓ consegnato	AFFILIATE, SUPPLIER

spa.*

Evento	Descrizione	Consegnato	Destinatari
spa.created	A spa was created.	✓ consegnato	AFFILIATE, SUPPLIER
spa.deleted	A spa was deleted.	✓ consegnato	AFFILIATE, SUPPLIER
spa.updated	A spa was updated.	✓ consegnato	AFFILIATE, SUPPLIER

special_rate.*

Evento	Descrizione	Consegnato	Destinatari
special_rate.created	A promotion (special rate) was created.	✓ consegnato	AFFILIATE, SUPPLIER
special_rate.deleted	A promotion was deleted.	✓ consegnato	AFFILIATE, SUPPLIER
special_rate.updated	A promotion was updated.	✓ consegnato	AFFILIATE, SUPPLIER

Consiglio

Inizia iscrivendoti a tutti gli eventi durante lo sviluppo. Una volta capito quali payload il tuo sistema necessita, restringi le iscrizioni per ridurre il rumore. Inviati un evento di test da Applicazioni > Webhooks (o POST …/webhook/{id}/test) per confermare il tuo endpoint e la verifica della firma prima di andare in produzione.

Ulteriori letture

• Guida all’integrazione Webhook — Passaggi di configurazione e best practice.
• Webhooks — Gestisci le tue iscrizioni webhook.
• Applicazioni — Gestisci le credenziali API.
• Sviluppa su Wink — Panoramica della piattaforma per sviluppatori.