Pular para o conteúdo
Wink

Integração de Webhook

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

Público

Seção intitulada “Público”

Este guia é para desenvolvedores que integram o Wink com sistemas externos, como sistemas de gestão de propriedades (PMS), gerenciadores de canais, CRMs ou painéis personalizados.

Como os webhooks funcionam

Seção intitulada “Como os webhooks funcionam”
  1. Você registra uma URL de webhook no Wink.
  2. Quando um evento ocorre (por exemplo, uma nova reserva), o Wink envia um HTTP POST para sua URL.
  3. Seu servidor processa o payload e responde com um 200 OK.

Configurando um webhook

Seção intitulada “Configurando um webhook”
  1. Faça login 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. Insira um nome (por exemplo, “Sincronização de Reservas PMS”).
  5. Insira sua URL de webhook — o endpoint HTTPS no seu servidor.
  6. Selecione eventos — Escolha eventos específicos para assinar, ou deixe vazio para receber todos os eventos.
  7. Ative o botão Enabled.
  8. Clique em Save.

Tipos de eventos

Seção intitulada “Tipos de eventos”

O Wink suporta vários tipos de eventos. Eventos comuns incluem:

  • Reserva criada — Uma nova reserva foi confirmada.
  • Reserva cancelada — Uma reserva foi cancelada.
  • Pagamento concluído — O pagamento foi processado.
  • Reserva atualizada — Detalhes de uma reserva foram alterados.

Melhores práticas

Seção intitulada “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 — Seu handler deve ser idempotente. O Wink pode tentar reenviar se não receber uma resposta 200.
  • Valide a origem — Verifique se as requisições recebidas são do Wink antes de processar.
  • Registro de logs — Registre todos os payloads de webhook que receber. Isso facilita muito a depuração de problemas de integração.

Pausar e excluir

Seção intitulada “Pausar e excluir”

Você pode desativar um webhook sem excluí-lo. Isso pausa a entrega para que você possa solucionar problemas sem perder sua configuração. Quando estiver pronto, ative-o novamente.

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

Leitura adicional

Seção intitulada “Leitura adicional”