Integração de Webhooks

Os webhooks permitem que os seus sistemas recebam notificações em tempo real quando eventos acontecem na sua conta Wink — novas reservas, cancelamentos, atualizações de pagamento e muito mais. Este guia orienta-o na configuração e nas melhores práticas.

Público-alvo

Este guia destina-se a desenvolvedores que integram o Wink com sistemas externos, como sistemas de gestão de propriedades (PMS), gestores de canais, CRMs ou painéis personalizados.

Como funcionam os webhooks

1. Regista uma URL de webhook no Wink.
2. Quando ocorre um evento (por exemplo, uma nova reserva), o Wink envia um HTTP POST para a sua URL.
3. O seu servidor processa o payload e responde com um 200 OK.

Configurar um webhook

1. Inicie sessão na sua conta (Extranet, Studio ou TripPay — todos suportam webhooks).
2. Navegue até Applications e depois Webhooks. Veja Webhooks.
3. Clique em Create webhook.
4. Introduza um nome (por exemplo, “Sincronização de Reservas PMS”).
5. Introduza a sua URL de webhook — o endpoint HTTPS no seu servidor.
6. Selecione eventos — Escolha eventos específicos para subscrever, ou deixe vazio para receber todos os eventos.
7. Ative o botão Enabled.
8. Clique em Save.

Tipos de eventos

O Wink suporta mais de 64 tipos de eventos de webhook em categorias que incluem gestão de conta, contratos de reserva, pagamentos, atualizações do gestor de canais e administração de entidades. Eventos comuns incluem:

Categoria	Exemplos
Reserva	booking.create, booking.cancelled
Contrato de reserva	booking.contract.created, booking.contract.processing, booking.contract.cancelled
Pagamento	internal.payment.succeeded, internal.payment.failed
Reembolsos	booking.contract.refund.partial, booking.contract.refund.full
Gestor de canais	channel-manager.update.rate, channel-manager.update.availability
Conta	account.create, account.status.updated

Para uma lista completa de todos os tipos de eventos com descrições, consulte o Catálogo de Eventos de Webhook.

Ver todos os mais de 64 tipos de eventos

Dica

Comece por subscrever todos os eventos durante o desenvolvimento. Depois de compreender os payloads, restrinja apenas aos eventos que o seu sistema necessita.

Melhores práticas

• Use HTTPS — O Wink envia payloads apenas para endpoints HTTPS.
• Responda rapidamente — Retorne um 200 OK assim que receber o payload. Faça qualquer processamento pesado de forma assíncrona.
• Idempotência — O seu handler deve ser idempotente. O Wink pode tentar reenviar se não receber uma resposta 200.
• Valide a origem — Verifique que os pedidos recebidos são do Wink antes de processar.
• Registo — Registe todos os payloads de webhook que receber. Isto facilita muito a depuração de problemas de integração.

Pausar e eliminar

Pode desativar um webhook sem o eliminar. Isto pausa a entrega para que possa resolver problemas sem perder a configuração. Quando estiver pronto, volte a ativá-lo.

Eliminar um webhook remove-o permanentemente. Qualquer integração que dependa desse webhook deixará de receber notificações.

Leitura adicional

• Catálogo de Eventos de Webhook — Lista completa de todos os mais de 64 tipos de eventos.
• Webhooks — Referência completa para gestão de webhooks.
• Applications — Gerir as suas credenciais API.
• Developers > APIs — Documentação completa da API.