Каталог событий Webhook

На этой странице перечислены все события webhook, на которые вы можете подписаться в Wink. Для инструкций по настройке смотрите Руководство по интеграции Webhook или страницу управления Webhook.

Как подписаться

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

Все типы событий

Эта таблица генерируется из каталога событий платформы во время сборки, поэтому всегда соответствует 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), чтобы подтвердить работу endpoint и проверку подписи перед запуском в продакшен.

Дополнительные материалы

• Руководство по интеграции Webhook — шаги настройки и лучшие практики.
• Webhooks — управление подписками webhook.
• Applications — управление API-учётными данными.
• Build on Wink — обзор платформы для разработчиков.