コンテンツにスキップ
Wink

Webhook連携

Webhookを使うと、Winkアカウントで発生した新しい予約、キャンセル、支払いの更新などのイベントをリアルタイムでシステムに通知できます。このガイドでは設定方法とベストプラクティスを解説します。

対象読者

Section titled “対象読者”

このガイドは、Winkを物件管理システム（PMS）、チャネルマネージャー、CRM、カスタムダッシュボードなどの外部システムと連携する開発者向けです。

Webhookの仕組み

Section titled “Webhookの仕組み”
  1. WinkにWebhookのURLを登録します。
  2. イベントが発生すると（例：新しい予約）、WinkがあなたのURLにHTTP POSTを送信します。
  3. あなたのサーバーがペイロードを処理し、200 OKで応答します。

Webhookの設定

Section titled “Webhookの設定”
  1. アカウントにログインします（Extranet、Studio、TripPayのいずれもWebhookをサポートしています）。
  2. ApplicationsからWebhooksに移動します。Webhooksを参照してください。
  3. Create webhookをクリックします。
  4. 名前を入力します（例：「PMS予約同期」）。
  5. Webhook URLを入力します — あなたのサーバーのHTTPSエンドポイントです。
  6. イベントを選択 — 購読する特定のイベントを選ぶか、すべてのイベントを受け取る場合は空欄のままにします。
  7. Enabledをオンに切り替えます。
  8. Saveをクリックします。

イベントタイプ

Section titled “イベントタイプ”

Winkはアカウント管理、予約契約、支払い、チャネルマネージャーの更新、管理エンティティの管理などのカテゴリで64以上のWebhookイベントタイプをサポートしています。主なイベントは以下の通りです：

カテゴリ例
予約booking.create, booking.cancelled
予約契約booking.contract.created, booking.contract.processing, booking.contract.cancelled
支払いinternal.payment.succeeded, internal.payment.failed
返金booking.contract.refund.partial, booking.contract.refund.full
チャネルマネージャーchannel-manager.update.rate, channel-manager.update.availability
アカウントaccount.create, account.status.updated

すべてのイベントタイプと説明の完全なリストは、Webhookイベントカタログをご覧ください。

64以上のすべてのイベントタイプを見る

ベストプラクティス

Section titled “ベストプラクティス”
  • HTTPSを使用する — WinkはHTTPSエンドポイントにのみペイロードを送信します。
  • 迅速に応答する — ペイロードを受け取ったらすぐに200 OKを返してください。重い処理は非同期で行いましょう。
  • 冪等性 — ハンドラーは冪等であるべきです。Winkは200応答がない場合、再送を試みることがあります。
  • 送信元の検証 — 処理前にリクエストがWinkからのものであることを確認してください。
  • ログ記録 — 受信したWebhookペイロードはすべてログに記録しましょう。統合の問題解決が容易になります。

一時停止と削除

Section titled “一時停止と削除”

Webhookを無効化すると削除せずに配信を一時停止できます。設定を保持したままトラブルシューティングが可能です。準備ができたら再度有効に切り替えます。

Webhookを削除すると完全に削除されます。そのWebhookに依存する統合は通知を受け取れなくなります。

参考資料

Section titled “参考資料”