Katalog Acara Webhook

Halaman ini menyenaraikan setiap acara webhook yang anda boleh langgani di Wink. Untuk arahan penyediaan, lihat Panduan Integrasi Webhook atau halaman pengurusan Webhooks.

Cara melanggan

1. Navigasi ke Applications > Webhooks dalam portal anda.
2. Cipta webhook dan pilih acara yang anda ingin terima — atau biarkan senarai kosong untuk menerima setiap acara.
3. Wink menghantar HTTP POST yang ditandatangani ke titik akhir anda setiap kali acara berlaku. Lihat Integrasi Webhook untuk sampul surat, pengepala, pengesahan tandatangan dan cubaan semula.

Setiap jenis acara

Jadual ini dijana dari katalog acara platform semasa binaan, jadi ia sentiasa sepadan dengan API. Jenis acara yang ditandakan sebagai dihantar pautan ke halaman rujukan mereka dalam Webhooks API, yang mendokumentasikan badan JSON tepat (WebhookEnvelope dengan object khusus acara), pengepala Wink-* dan dasar cubaan semula. Jenis acara yang tidak dihantar wujud secara dalaman (pembayaran, lejar, penyegerakan pengurus saluran, …) tetapi tidak dihantar kepada pelanggan webhook buat masa ini.

Penerima menunjukkan siapa yang menerima acara: SUPPLIER (hotel), AFFILIATE (penjual semula dengan saluran jualan aktif ke hotel), AGENT (agensi pelancongan yang membuat tempahan) atau SELF (entiti pengurusan yang berkaitan dengan acara). Setiap penerima menerima bentuk payload yang sama; butiran khusus peranan berada di belakang URL links.self dalam payload.

account.*

Acara	Penerangan	Dihantar	Penerima
account.details.updated	The account's details changed.	tidak dihantar	—
account.managers.update	The account's manager list changed.	✓ dihantar	SELF
account.task.complete	An onboarding task was completed.	tidak dihantar	—
account.task.create	An onboarding task was created for the account.	tidak dihantar	—
account.task.remove	An onboarding task was removed.	tidak dihantar	—
account.task.tax_id.complete	The tax-id onboarding task was completed.	tidak dihantar	—
account.task.update	An onboarding task was updated.	tidak dihantar	—
account.under_review	The account was placed under review.	tidak dihantar	—

activity.*

Acara	Penerangan	Dihantar	Penerima
activity.created	An activity was created.	✓ dihantar	AFFILIATE, SUPPLIER
activity.deleted	An activity was deleted.	✓ dihantar	AFFILIATE, SUPPLIER
activity.updated	An activity was updated.	✓ dihantar	AFFILIATE, SUPPLIER

add_on.*

Acara	Penerangan	Dihantar	Penerima
add_on.created	An add-on was created.	✓ dihantar	AFFILIATE, SUPPLIER
add_on.deleted	An add-on was deleted.	✓ dihantar	AFFILIATE, SUPPLIER
add_on.updated	An add-on was updated.	✓ dihantar	AFFILIATE, SUPPLIER

booking.*

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

channel-manager.*

Acara	Penerangan	Dihantar	Penerima
channel-manager.update	A channel manager pushed an update.	tidak dihantar	—
channel-manager.update.availability	A channel manager pushed an availability update.	tidak dihantar	—
channel-manager.update.rate	A channel manager pushed a rate update.	tidak dihantar	—

email.*

Acara	Penerangan	Dihantar	Penerima
email.correspondence	An email correspondence was recorded.	tidak dihantar	—

internal.*

Acara	Penerangan	Dihantar	Penerima
internal.payment.failed	A payment failed (internal).	tidak dihantar	—
internal.payment.processing	A payment is processing (internal).	tidak dihantar	—
internal.payment.succeeded	A payment succeeded (internal).	tidak dihantar	—

ledger.*

Acara	Penerangan	Dihantar	Penerima
ledger.entry.create	A ledger entry was created.	tidak dihantar	—

managing_entity.*

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

master_rate.*

Acara	Penerangan	Dihantar	Penerima
master_rate.created	A master rate was created.	✓ dihantar	AFFILIATE, SUPPLIER
master_rate.deleted	A master rate was deleted.	✓ dihantar	AFFILIATE, SUPPLIER
master_rate.updated	A master rate was updated.	✓ dihantar	AFFILIATE, SUPPLIER

meeting_room.*

Acara	Penerangan	Dihantar	Penerima
meeting_room.created	A meeting room was created.	✓ dihantar	AFFILIATE, SUPPLIER
meeting_room.deleted	A meeting room was deleted.	✓ dihantar	AFFILIATE, SUPPLIER
meeting_room.updated	A meeting room was updated.	✓ dihantar	AFFILIATE, SUPPLIER

payee.*

Acara	Penerangan	Dihantar	Penerima
payee.create	A payee was created.	tidak dihantar	—
payee.create.failure	Creating a payee failed.	tidak dihantar	—
payee.update	A payee was updated.	tidak dihantar	—
payee.update.failure	Updating a payee failed.	tidak dihantar	—

perk.*

Acara	Penerangan	Dihantar	Penerima
perk.deleted	A perk was deleted.	tidak dihantar	—
perk.updated	A perk was updated.	tidak dihantar	—

property.*

Acara	Penerangan	Dihantar	Penerima
property.address.updated	A property's address changed.	✓ dihantar	AFFILIATE, SUPPLIER
property.created	A property (hotel) was created.	✓ dihantar	AFFILIATE, SUPPLIER
property.deleted	A property was deleted.	✓ dihantar	AFFILIATE, SUPPLIER
property.geolocation.updated	A property's geolocation changed.	✓ dihantar	AFFILIATE, SUPPLIER
property.name.updated	A property's name changed.	✓ dihantar	AFFILIATE, SUPPLIER
property.policy.created	A property policy was created.	✓ dihantar	AFFILIATE, SUPPLIER
property.policy.updated	A property policy changed.	✓ dihantar	AFFILIATE, SUPPLIER
property.profile.updated	A property's profile changed.	✓ dihantar	AFFILIATE, SUPPLIER
property.registered	A property completed registration.	✓ dihantar	AFFILIATE, SUPPLIER
property.services.updated	A property's services/amenities changed.	✓ dihantar	AFFILIATE, SUPPLIER
property.status.updated	A property's platform status changed.	✓ dihantar	AFFILIATE, SUPPLIER
property.updated	A property was updated.	tidak dihantar	—
property.welcome_text.updated	A property's welcome text changed.	✓ dihantar	AFFILIATE, SUPPLIER

rate_modifier.*

Acara	Penerangan	Dihantar	Penerima
rate_modifier.updated	A rate modifier was updated.	tidak dihantar	—

rate_plan.*

Acara	Penerangan	Dihantar	Penerima
rate_plan.created	A rate plan was created.	✓ dihantar	AFFILIATE, SUPPLIER
rate_plan.deleted	A rate plan was deleted.	✓ dihantar	AFFILIATE, SUPPLIER
rate_plan.updated	A rate plan was updated.	✓ dihantar	AFFILIATE, SUPPLIER

restaurant.*

Acara	Penerangan	Dihantar	Penerima
restaurant.created	A restaurant was created.	✓ dihantar	AFFILIATE, SUPPLIER
restaurant.deleted	A restaurant was deleted.	✓ dihantar	AFFILIATE, SUPPLIER
restaurant.updated	A restaurant was updated.	✓ dihantar	AFFILIATE, SUPPLIER

room_type.*

Acara	Penerangan	Dihantar	Penerima
room_type.created	A room type was created.	✓ dihantar	AFFILIATE, SUPPLIER
room_type.deleted	A room type was deleted.	✓ dihantar	AFFILIATE, SUPPLIER
room_type.updated	A room type was updated.	✓ dihantar	AFFILIATE, SUPPLIER

sales_channel.*

Acara	Penerangan	Dihantar	Penerima
sales_channel.created	A sales-channel relationship (supplier ↔ reseller) was created.	✓ dihantar	AFFILIATE, SUPPLIER
sales_channel.deleted	A sales-channel relationship was deleted.	✓ dihantar	AFFILIATE, SUPPLIER
sales_channel.updated	A sales-channel relationship was updated.	✓ dihantar	AFFILIATE, SUPPLIER

spa.*

Acara	Penerangan	Dihantar	Penerima
spa.created	A spa was created.	✓ dihantar	AFFILIATE, SUPPLIER
spa.deleted	A spa was deleted.	✓ dihantar	AFFILIATE, SUPPLIER
spa.updated	A spa was updated.	✓ dihantar	AFFILIATE, SUPPLIER

special_rate.*

Acara	Penerangan	Dihantar	Penerima
special_rate.created	A promotion (special rate) was created.	✓ dihantar	AFFILIATE, SUPPLIER
special_rate.deleted	A promotion was deleted.	✓ dihantar	AFFILIATE, SUPPLIER
special_rate.updated	A promotion was updated.	✓ dihantar	AFFILIATE, SUPPLIER

Tip

Mulakan dengan melanggan semua acara semasa pembangunan. Setelah anda faham payload yang sistem anda perlukan, sempitkan langganan anda untuk mengurangkan gangguan. Hantar acara ujian kepada diri sendiri dari Applications > Webhooks (atau POST …/webhook/{id}/test) untuk mengesahkan titik akhir dan pemeriksaan tandatangan sebelum siaran langsung.

Bacaan lanjut

• Panduan Integrasi Webhook — Langkah penyediaan dan amalan terbaik.
• Webhooks — Urus langganan webhook anda.
• Applications — Urus kelayakan API.
• Build on Wink — Gambaran platform untuk pembangun.