Каталог подій Webhook

На цій сторінці наведено всі події webhook, на які ви можете підписатися на Wink. Для інструкцій з налаштування дивіться Посібник з інтеграції Webhook або сторінку керування Webhooks.

Як підписатися

1. Перейдіть у Applications > Webhooks у вашому порталі.
2. Створіть webhook і виберіть події, які хочете отримувати — або залиште список порожнім, щоб отримувати всі події.
3. Wink надсилає підписаний HTTP POST на вашу кінцеву точку щоразу, коли відбувається подія. Дивіться Інтеграція Webhook для інформації про конверт, заголовки, перевірку підпису та повторні спроби.

Кожен тип події

Ця таблиця генерується з каталогу подій платформи під час збірки, тому вона завжди відповідає API. Типи подій, позначені як доставлені, містять посилання на їхню сторінку довідки в Webhooks API, де задокументовано точне тіло JSON (WebhookEnvelope з подієспецифічним object), заголовки Wink-* та політику повторних спроб. Типи подій, які не доставляються, існують внутрішньо (платежі, бухгалтерія, синхронізація з channel-manager тощо), але наразі не надсилаються підписникам webhook.

Одержувачі вказують, хто отримує подію: SUPPLIER (готель), AFFILIATE (перепродавець з активним каналом продажів до готелю), AGENT (туристична агенція, що зробила бронювання) або SELF (керуюча структура, про яку йде подія). Кожен одержувач отримує однакову структуру вмісту; деталі, специфічні для ролі, доступні за URL links.self у вмісті.

account.*

Подія	Опис	Доставлено	Одержувачі
account.details.updated	The account's details changed.	не доставлено	—
account.managers.update	The account's manager list changed.	✓ доставлено	SELF
account.task.complete	An onboarding task was completed.	не доставлено	—
account.task.create	An onboarding task was created for the account.	не доставлено	—
account.task.remove	An onboarding task was removed.	не доставлено	—
account.task.tax_id.complete	The tax-id onboarding task was completed.	не доставлено	—
account.task.update	An onboarding task was updated.	не доставлено	—
account.under_review	The account was placed under review.	не доставлено	—

activity.*

Подія	Опис	Доставлено	Одержувачі
activity.created	An activity was created.	✓ доставлено	AFFILIATE, SUPPLIER
activity.deleted	An activity was deleted.	✓ доставлено	AFFILIATE, SUPPLIER
activity.updated	An activity was updated.	✓ доставлено	AFFILIATE, SUPPLIER

add_on.*

Подія	Опис	Доставлено	Одержувачі
add_on.created	An add-on was created.	✓ доставлено	AFFILIATE, SUPPLIER
add_on.deleted	An add-on was deleted.	✓ доставлено	AFFILIATE, SUPPLIER
add_on.updated	An add-on was updated.	✓ доставлено	AFFILIATE, SUPPLIER

booking.*

Подія	Опис	Доставлено	Одержувачі
booking.cancelled	A booking was cancelled.	✓ доставлено	AFFILIATE, AGENT, SUPPLIER
booking.create	A booking was created (confirmed).	✓ доставлено	AFFILIATE, AGENT, SUPPLIER
booking.failed	A booking attempt failed.	✓ доставлено	AFFILIATE, AGENT, SUPPLIER
booking.funds.available	Funds for a booking became available for payout.	✓ доставлено	AFFILIATE, AGENT, SUPPLIER
booking.funds.ledgered	Funds for a booking were added to the ledger.	✓ доставлено	AFFILIATE, AGENT, SUPPLIER
booking.initialize.complete	A booking initialisation completed.	не доставлено	—
booking.initialize.request	A booking initialisation (checkout) was requested.	не доставлено	—
booking.payout.complete	A payout for a booking completed.	не доставлено	—
booking.payout.create	A payout for a booking was created.	не доставлено	—
booking.processing	A booking is being processed.	не доставлено	—
booking.refund.error	A booking was refunded because of a processing error.	не доставлено	—
booking.refund.full	A booking was fully refunded.	✓ доставлено	AFFILIATE, AGENT, SUPPLIER
booking.refund.partial	A booking was partially refunded.	✓ доставлено	AFFILIATE, AGENT, SUPPLIER
booking.refund.request	A refund was requested for a booking.	✓ доставлено	AFFILIATE, AGENT, SUPPLIER
booking.review.created	A guest submitted a review for a booking.	✓ доставлено	SUPPLIER
booking.review.responded	The hotel responded to a guest review.	✓ доставлено	AFFILIATE, AGENT, SUPPLIER
booking.sync.failed	A booking-to-channel-manager synchronisation failed.	не доставлено	—
booking.sync.run	A booking-to-channel-manager synchronisation run started.	не доставлено	—

channel-manager.*

Подія	Опис	Доставлено	Одержувачі
channel-manager.update	A channel manager pushed an update.	не доставлено	—
channel-manager.update.availability	A channel manager pushed an availability update.	не доставлено	—
channel-manager.update.rate	A channel manager pushed a rate update.	не доставлено	—

email.*

Подія	Опис	Доставлено	Одержувачі
email.correspondence	An email correspondence was recorded.	не доставлено	—

internal.*

Подія	Опис	Доставлено	Одержувачі
internal.payment.failed	A payment failed (internal).	не доставлено	—
internal.payment.processing	A payment is processing (internal).	не доставлено	—
internal.payment.succeeded	A payment succeeded (internal).	не доставлено	—

ledger.*

Подія	Опис	Доставлено	Одержувачі
ledger.entry.create	A ledger entry was created.	не доставлено	—

managing_entity.*

Подія	Опис	Доставлено	Одержувачі
managing_entity.account_representative.updated	The account representative changed.	не доставлено	—
managing_entity.agent.email.notification	An email notification was sent to the account's agent.	не доставлено	—
managing_entity.agent.updated	The account's travel-agent details changed.	не доставлено	—
managing_entity.city.updated	The account's address or city changed.	✓ доставлено	SELF
managing_entity.created	A managing entity (account) was created.	✓ доставлено	SELF
managing_entity.deleted	The account was deleted.	✓ доставлено	SELF
managing_entity.information.updated	The account's general information changed.	✓ доставлено	SELF
managing_entity.logo.updated	The account's logo changed.	✓ доставлено	SELF
managing_entity.managed_by.updated	The entity managing this account on its behalf changed.	✓ доставлено	SELF
managing_entity.manager.accepted	An invited manager accepted the invitation.	не доставлено	—
managing_entity.manager.added	A manager was added to the account.	✓ доставлено	SELF
managing_entity.manager.email.notification	An email notification was sent to an account manager.	не доставлено	—
managing_entity.manager.invited	A manager was invited to the account.	✓ доставлено	SELF
managing_entity.manager.owner.set	The account owner was set.	✓ доставлено	SELF
managing_entity.manager.rejected	An invited manager rejected the invitation.	не доставлено	—
managing_entity.manager.removed	A manager was removed from the account.	✓ доставлено	SELF
managing_entity.name.updated	The account's display name changed.	не доставлено	—
managing_entity.place_id.updated	The account's Google Place ID changed.	✓ доставлено	SELF
managing_entity.profile_picture.updated	The account's profile picture changed.	✓ доставлено	SELF
managing_entity.status.updated	The account's platform status changed (e.g. approved, suspended).	✓ доставлено	SELF
managing_entity.subscription.changed	The account's platform subscription changed.	не доставлено	—
managing_entity.subscription.invoice.changed	The status of a subscription invoice changed.	✓ доставлено	SELF
managing_entity.subscription.provisioned	A platform subscription was provisioned for the account.	✓ доставлено	SELF
managing_entity.unique_id.updated	The account's short unique id changed.	✓ доставлено	SELF
managing_entity.url_name.updated	The account's URL name (slug) changed.	✓ доставлено	SELF

master_rate.*

Подія	Опис	Доставлено	Одержувачі
master_rate.created	A master rate was created.	✓ доставлено	AFFILIATE, SUPPLIER
master_rate.deleted	A master rate was deleted.	✓ доставлено	AFFILIATE, SUPPLIER
master_rate.updated	A master rate was updated.	✓ доставлено	AFFILIATE, SUPPLIER

meeting_room.*

Подія	Опис	Доставлено	Одержувачі
meeting_room.created	A meeting room was created.	✓ доставлено	AFFILIATE, SUPPLIER
meeting_room.deleted	A meeting room was deleted.	✓ доставлено	AFFILIATE, SUPPLIER
meeting_room.updated	A meeting room was updated.	✓ доставлено	AFFILIATE, SUPPLIER

payee.*

Подія	Опис	Доставлено	Одержувачі
payee.create	A payee was created.	не доставлено	—
payee.create.failure	Creating a payee failed.	не доставлено	—
payee.update	A payee was updated.	не доставлено	—
payee.update.failure	Updating a payee failed.	не доставлено	—

perk.*

Подія	Опис	Доставлено	Одержувачі
perk.deleted	A perk was deleted.	не доставлено	—
perk.updated	A perk was updated.	не доставлено	—

property.*

Подія	Опис	Доставлено	Одержувачі
property.address.updated	A property's address changed.	✓ доставлено	AFFILIATE, SUPPLIER
property.created	A property (hotel) was created.	✓ доставлено	AFFILIATE, SUPPLIER
property.deleted	A property was deleted.	✓ доставлено	AFFILIATE, SUPPLIER
property.geolocation.updated	A property's geolocation changed.	✓ доставлено	AFFILIATE, SUPPLIER
property.name.updated	A property's name changed.	✓ доставлено	AFFILIATE, SUPPLIER
property.policy.created	A property policy was created.	✓ доставлено	AFFILIATE, SUPPLIER
property.policy.updated	A property policy changed.	✓ доставлено	AFFILIATE, SUPPLIER
property.profile.updated	A property's profile changed.	✓ доставлено	AFFILIATE, SUPPLIER
property.registered	A property completed registration.	✓ доставлено	AFFILIATE, SUPPLIER
property.services.updated	A property's services/amenities changed.	✓ доставлено	AFFILIATE, SUPPLIER
property.status.updated	A property's platform status changed.	✓ доставлено	AFFILIATE, SUPPLIER
property.updated	A property was updated.	не доставлено	—
property.welcome_text.updated	A property's welcome text changed.	✓ доставлено	AFFILIATE, SUPPLIER

rate_modifier.*

Подія	Опис	Доставлено	Одержувачі
rate_modifier.updated	A rate modifier was updated.	не доставлено	—

rate_plan.*

Подія	Опис	Доставлено	Одержувачі
rate_plan.created	A rate plan was created.	✓ доставлено	AFFILIATE, SUPPLIER
rate_plan.deleted	A rate plan was deleted.	✓ доставлено	AFFILIATE, SUPPLIER
rate_plan.updated	A rate plan was updated.	✓ доставлено	AFFILIATE, SUPPLIER

restaurant.*

Подія	Опис	Доставлено	Одержувачі
restaurant.created	A restaurant was created.	✓ доставлено	AFFILIATE, SUPPLIER
restaurant.deleted	A restaurant was deleted.	✓ доставлено	AFFILIATE, SUPPLIER
restaurant.updated	A restaurant was updated.	✓ доставлено	AFFILIATE, SUPPLIER

room_type.*

Подія	Опис	Доставлено	Одержувачі
room_type.created	A room type was created.	✓ доставлено	AFFILIATE, SUPPLIER
room_type.deleted	A room type was deleted.	✓ доставлено	AFFILIATE, SUPPLIER
room_type.updated	A room type was updated.	✓ доставлено	AFFILIATE, SUPPLIER

sales_channel.*

Подія	Опис	Доставлено	Одержувачі
sales_channel.created	A sales-channel relationship (supplier ↔ reseller) was created.	✓ доставлено	AFFILIATE, SUPPLIER
sales_channel.deleted	A sales-channel relationship was deleted.	✓ доставлено	AFFILIATE, SUPPLIER
sales_channel.updated	A sales-channel relationship was updated.	✓ доставлено	AFFILIATE, SUPPLIER

spa.*

Подія	Опис	Доставлено	Одержувачі
spa.created	A spa was created.	✓ доставлено	AFFILIATE, SUPPLIER
spa.deleted	A spa was deleted.	✓ доставлено	AFFILIATE, SUPPLIER
spa.updated	A spa was updated.	✓ доставлено	AFFILIATE, SUPPLIER

special_rate.*

Подія	Опис	Доставлено	Одержувачі
special_rate.created	A promotion (special rate) was created.	✓ доставлено	AFFILIATE, SUPPLIER
special_rate.deleted	A promotion was deleted.	✓ доставлено	AFFILIATE, SUPPLIER
special_rate.updated	A promotion was updated.	✓ доставлено	AFFILIATE, SUPPLIER

Порада

Починайте з підписки на всі події під час розробки. Коли зрозумієте, які вмісти потрібні вашій системі, звузьте підписки, щоб зменшити шум. Надішліть собі тестову подію з Applications > Webhooks (або POST …/webhook/{id}/test), щоб підтвердити роботу кінцевої точки та перевірку підпису перед запуском у продакшн.

Додаткова література

• Посібник з інтеграції Webhook — Кроки налаштування та найкращі практики.
• Webhooks — Керування підписками webhook.
• Applications — Керування API-ключами.
• Build on Wink — Огляд платформи для розробників.