Integracja Webhooków

Webhooki pozwalają Twoim systemom otrzymywać powiadomienia w czasie rzeczywistym, gdy na Twoim koncie Wink zachodzą zdarzenia — nowe rezerwacje, anulacje, aktualizacje płatności i inne. Ten przewodnik przeprowadzi Cię przez konfigurację i najlepsze praktyki.

Odbiorcy

Ten przewodnik jest przeznaczony dla programistów integrujących Wink z zewnętrznymi systemami, takimi jak systemy zarządzania nieruchomościami (PMS), channel managerowie, CRM-y lub niestandardowe pulpity nawigacyjne.

Jak działają webhooki

1. Rejestrujesz URL webhooka w Wink.
2. Gdy wystąpi zdarzenie (np. nowa rezerwacja), Wink wysyła żądanie HTTP POST na Twój URL.
3. Twój serwer przetwarza dane i odpowiada 200 OK.

Konfiguracja webhooka

1. Zaloguj się na swoje konto (Extranet, Studio lub TripPay — wszystkie obsługują webhooki).
2. Przejdź do Applications, a następnie Webhooks. Zobacz Webhooks.
3. Kliknij Create webhook.
4. Wprowadź nazwę (np. “Synchronizacja rezerwacji PMS”).
5. Wprowadź swój URL webhooka — punkt końcowy HTTPS na Twoim serwerze.
6. Wybierz zdarzenia — Wybierz konkretne zdarzenia, na które chcesz się zapisać, lub pozostaw puste, aby otrzymywać wszystkie zdarzenia.
7. Przełącz Enabled na włączone.
8. Kliknij Save.

Typy zdarzeń

Wink obsługuje ponad 64 typy zdarzeń webhooków w kategoriach takich jak zarządzanie kontem, umowy rezerwacyjne, płatności, aktualizacje channel managera oraz zarządzanie administracją podmiotów. Do najczęstszych zdarzeń należą:

Kategoria	Przykłady
Rezerwacja	booking.create, booking.cancelled
Umowa rezerwacyjna	booking.contract.created, booking.contract.processing, booking.contract.cancelled
Płatność	internal.payment.succeeded, internal.payment.failed
Zwroty	booking.contract.refund.partial, booking.contract.refund.full
Channel manager	channel-manager.update.rate, channel-manager.update.availability
Konto	account.create, account.status.updated

Pełną listę wszystkich typów zdarzeń wraz z opisami znajdziesz w Katalogu Zdarzeń Webhook.

Zobacz wszystkie 64+ typy zdarzeń

Wskazówka

Na początku subskrybuj wszystkie zdarzenia podczas fazy rozwoju. Gdy poznasz strukturę danych, zawęź listę do tych zdarzeń, które są potrzebne Twojemu systemowi.

Najlepsze praktyki

• Używaj HTTPS — Wink wysyła dane tylko na punkty końcowe HTTPS.
• Odpowiadaj szybko — Zwróć 200 OK zaraz po otrzymaniu danych. Ciężkie przetwarzanie wykonuj asynchronicznie.
• Idempotencja — Twój handler powinien być idempotentny. Wink może ponawiać dostarczenie, jeśli nie otrzyma odpowiedzi 200.
• Weryfikuj źródło — Sprawdzaj, czy przychodzące żądania pochodzą od Wink przed ich przetworzeniem.
• Logowanie — Zapisuj każdy otrzymany payload webhooka. Ułatwia to debugowanie problemów z integracją.

Wstrzymywanie i usuwanie

Możesz wyłączyć webhook bez usuwania go. To wstrzymuje dostarczanie, dzięki czemu możesz rozwiązywać problemy bez utraty konfiguracji. Gdy będziesz gotowy, włącz go ponownie.

Usunięcie webhooka powoduje jego trwałe usunięcie. Każda integracja korzystająca z tego webhooka przestanie otrzymywać powiadomienia.

Dalsza lektura

• Katalog Zdarzeń Webhook — Pełna lista wszystkich 64+ typów zdarzeń.
• Webhooks — Pełna dokumentacja zarządzania webhookami.
• Applications — Zarządzaj swoimi danymi API.
• Developers > APIs — Pełna dokumentacja API.