Catálogo de Eventos Webhook

Esta página lista todos os eventos webhook aos quais você pode se inscrever na Wink. Para instruções de configuração, veja o Guia de Integração Webhook ou a página de gerenciamento de Webhooks.

Como se inscrever

1. Navegue até Aplicações > Webhooks no seu portal.
2. Crie um webhook e selecione os eventos que deseja receber — ou deixe a lista vazia para receber todos os eventos.
3. A Wink envia um HTTP POST assinado para seu endpoint toda vez que o evento ocorre. Veja Integração Webhook para o envelope, cabeçalhos, verificação de assinatura e tentativas.

Todos os tipos de evento

Esta tabela é gerada a partir do catálogo de eventos da plataforma no momento da build, então ela sempre corresponde à API. Tipos de eventos marcados como entregues linkam para sua página de referência na API de Webhooks, que documenta o corpo JSON exato (WebhookEnvelope com um object específico do evento), os cabeçalhos Wink-* e a política de tentativas. Tipos de eventos que não são entregues existem internamente (pagamentos, razão contábil, sincronização de channel-manager, …) mas atualmente não são enviados aos assinantes webhook.

Destinatários indica quem recebe um evento: SUPPLIER (o hotel), AFFILIATE (um revendedor com um canal de vendas ativo para o hotel), AGENT (a agência de viagens que fez a reserva) ou SELF (a entidade gestora sobre a qual o evento trata). Cada destinatário recebe a mesma estrutura de carga útil; detalhes específicos do papel estão por trás da URL links.self da carga útil.

account.*

Evento	Descrição	Entregue	Destinatários
account.details.updated	The account's details changed.	não entregue	—
account.managers.update	The account's manager list changed.	✓ entregue	SELF
account.task.complete	An onboarding task was completed.	não entregue	—
account.task.create	An onboarding task was created for the account.	não entregue	—
account.task.remove	An onboarding task was removed.	não entregue	—
account.task.tax_id.complete	The tax-id onboarding task was completed.	não entregue	—
account.task.update	An onboarding task was updated.	não entregue	—
account.under_review	The account was placed under review.	não entregue	—

activity.*

Evento	Descrição	Entregue	Destinatários
activity.created	An activity was created.	✓ entregue	AFFILIATE, SUPPLIER
activity.deleted	An activity was deleted.	✓ entregue	AFFILIATE, SUPPLIER
activity.updated	An activity was updated.	✓ entregue	AFFILIATE, SUPPLIER

add_on.*

Evento	Descrição	Entregue	Destinatários
add_on.created	An add-on was created.	✓ entregue	AFFILIATE, SUPPLIER
add_on.deleted	An add-on was deleted.	✓ entregue	AFFILIATE, SUPPLIER
add_on.updated	An add-on was updated.	✓ entregue	AFFILIATE, SUPPLIER

booking.*

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

channel-manager.*

Evento	Descrição	Entregue	Destinatários
channel-manager.update	A channel manager pushed an update.	não entregue	—
channel-manager.update.availability	A channel manager pushed an availability update.	não entregue	—
channel-manager.update.rate	A channel manager pushed a rate update.	não entregue	—

email.*

Evento	Descrição	Entregue	Destinatários
email.correspondence	An email correspondence was recorded.	não entregue	—

internal.*

Evento	Descrição	Entregue	Destinatários
internal.payment.failed	A payment failed (internal).	não entregue	—
internal.payment.processing	A payment is processing (internal).	não entregue	—
internal.payment.succeeded	A payment succeeded (internal).	não entregue	—

ledger.*

Evento	Descrição	Entregue	Destinatários
ledger.entry.create	A ledger entry was created.	não entregue	—

managing_entity.*

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

master_rate.*

Evento	Descrição	Entregue	Destinatários
master_rate.created	A master rate was created.	✓ entregue	AFFILIATE, SUPPLIER
master_rate.deleted	A master rate was deleted.	✓ entregue	AFFILIATE, SUPPLIER
master_rate.updated	A master rate was updated.	✓ entregue	AFFILIATE, SUPPLIER

meeting_room.*

Evento	Descrição	Entregue	Destinatários
meeting_room.created	A meeting room was created.	✓ entregue	AFFILIATE, SUPPLIER
meeting_room.deleted	A meeting room was deleted.	✓ entregue	AFFILIATE, SUPPLIER
meeting_room.updated	A meeting room was updated.	✓ entregue	AFFILIATE, SUPPLIER

payee.*

Evento	Descrição	Entregue	Destinatários
payee.create	A payee was created.	não entregue	—
payee.create.failure	Creating a payee failed.	não entregue	—
payee.update	A payee was updated.	não entregue	—
payee.update.failure	Updating a payee failed.	não entregue	—

perk.*

Evento	Descrição	Entregue	Destinatários
perk.deleted	A perk was deleted.	não entregue	—
perk.updated	A perk was updated.	não entregue	—

property.*

Evento	Descrição	Entregue	Destinatários
property.address.updated	A property's address changed.	✓ entregue	AFFILIATE, SUPPLIER
property.created	A property (hotel) was created.	✓ entregue	AFFILIATE, SUPPLIER
property.deleted	A property was deleted.	✓ entregue	AFFILIATE, SUPPLIER
property.geolocation.updated	A property's geolocation changed.	✓ entregue	AFFILIATE, SUPPLIER
property.name.updated	A property's name changed.	✓ entregue	AFFILIATE, SUPPLIER
property.policy.created	A property policy was created.	✓ entregue	AFFILIATE, SUPPLIER
property.policy.updated	A property policy changed.	✓ entregue	AFFILIATE, SUPPLIER
property.profile.updated	A property's profile changed.	✓ entregue	AFFILIATE, SUPPLIER
property.registered	A property completed registration.	✓ entregue	AFFILIATE, SUPPLIER
property.services.updated	A property's services/amenities changed.	✓ entregue	AFFILIATE, SUPPLIER
property.status.updated	A property's platform status changed.	✓ entregue	AFFILIATE, SUPPLIER
property.updated	A property was updated.	não entregue	—
property.welcome_text.updated	A property's welcome text changed.	✓ entregue	AFFILIATE, SUPPLIER

rate_modifier.*

Evento	Descrição	Entregue	Destinatários
rate_modifier.updated	A rate modifier was updated.	não entregue	—

rate_plan.*

Evento	Descrição	Entregue	Destinatários
rate_plan.created	A rate plan was created.	✓ entregue	AFFILIATE, SUPPLIER
rate_plan.deleted	A rate plan was deleted.	✓ entregue	AFFILIATE, SUPPLIER
rate_plan.updated	A rate plan was updated.	✓ entregue	AFFILIATE, SUPPLIER

restaurant.*

Evento	Descrição	Entregue	Destinatários
restaurant.created	A restaurant was created.	✓ entregue	AFFILIATE, SUPPLIER
restaurant.deleted	A restaurant was deleted.	✓ entregue	AFFILIATE, SUPPLIER
restaurant.updated	A restaurant was updated.	✓ entregue	AFFILIATE, SUPPLIER

room_type.*

Evento	Descrição	Entregue	Destinatários
room_type.created	A room type was created.	✓ entregue	AFFILIATE, SUPPLIER
room_type.deleted	A room type was deleted.	✓ entregue	AFFILIATE, SUPPLIER
room_type.updated	A room type was updated.	✓ entregue	AFFILIATE, SUPPLIER

sales_channel.*

Evento	Descrição	Entregue	Destinatários
sales_channel.created	A sales-channel relationship (supplier ↔ reseller) was created.	✓ entregue	AFFILIATE, SUPPLIER
sales_channel.deleted	A sales-channel relationship was deleted.	✓ entregue	AFFILIATE, SUPPLIER
sales_channel.updated	A sales-channel relationship was updated.	✓ entregue	AFFILIATE, SUPPLIER

spa.*

Evento	Descrição	Entregue	Destinatários
spa.created	A spa was created.	✓ entregue	AFFILIATE, SUPPLIER
spa.deleted	A spa was deleted.	✓ entregue	AFFILIATE, SUPPLIER
spa.updated	A spa was updated.	✓ entregue	AFFILIATE, SUPPLIER

special_rate.*

Evento	Descrição	Entregue	Destinatários
special_rate.created	A promotion (special rate) was created.	✓ entregue	AFFILIATE, SUPPLIER
special_rate.deleted	A promotion was deleted.	✓ entregue	AFFILIATE, SUPPLIER
special_rate.updated	A promotion was updated.	✓ entregue	AFFILIATE, SUPPLIER

Dica

Comece se inscrevendo em todos os eventos durante o desenvolvimento. Quando entender quais cargas úteis seu sistema precisa, reduza suas inscrições para diminuir o ruído. Envie para si mesmo um evento de teste em Aplicações > Webhooks (ou POST …/webhook/{id}/test) para confirmar seu endpoint e a verificação de assinatura antes de entrar em produção.

Leitura adicional

• Guia de Integração Webhook — Passos de configuração e melhores práticas.
• Webhooks — Gerencie suas inscrições de webhook.
• Aplicações — Gerencie credenciais de API.
• Desenvolva na Wink — Visão geral da plataforma para desenvolvedores.