Webhookの設定方法
Webhookを使用すると、選択したTicketingHubのイベントを発生時に別のシステムへ送信できます。
始める前に
- TicketingHubアカウントでWebhookが有効になっている必要があります。Webhookセクションが表示されない場合は、TicketingHubにお問い合わせください。
- 管理者またはマネージャーのアクセス権が必要です。
- 受信側のシステムが、公開されたHTTPS URLを提供している必要があります。
Webhookを追加する
- 設定 → 詳細設定に移動します。
- Webhookを見つけて、編集を選択します。
- 新しいWebhookを選択します。
- イベントを受信するHTTPS URLを入力します。
- 送信するイベントの種類を選択します。たとえば、予約の確定やキャンセルなどです。
- 任意：受信側のシステムが各リクエストを検証できるよう、強力なシークレットを入力します。
- Webhookを作成し、選択したイベントのいずれかを実行してテストします。
シークレットを追加すると、TicketingHubは各リクエストに署名し、X-TicketingHub-Signature-256ヘッダーで署名を送信します。データを受け入れる前に、この署名を検証するよう開発者に依頼してください。
Webhookを有効な状態に保つ
受信側のシステムは、成功を示す2xxステータスを速やかに返す必要があります。TicketingHubは、タイムアウトした配信や成功しないレスポンスを返した配信を再試行します。継続的に失敗するエンドポイントは自動的に無効になります。受信側のシステムを修正したら、Webhookページに戻り、もう一度有効にしてください。
TicketingHubはパブリックアドレスにのみイベントを送信します。URLがプライベートネットワークアドレス（自社ネットワーク内のサーバーなど）を指している場合、TicketingHubはイベントを送信せず、Webhookを直ちに無効にします。Webhookページには「URLはプライベートネットワークアドレスを指しています」と表示され、アカウント管理者にはメールが届きます。URLをパブリックなHTTPSアドレスに変更してから、Webhookを再度有効にしてください。
必要なイベントだけを選択し、本番アカウントでテスト用URLを使用しないでください。独自の受信システムを構築せずにZapierへイベントを送信する方法については、TicketingHubをZapierに接続する方法をご覧ください。TicketingHubからデータを取得する機能も備えた連携を構築する方法については、APIトークンを作成して使用する方法をご覧ください。