Developer Hub
This is an auto-generated translation

通知

Rapid の通知サービスは、さまざまな予約イベントに対してアラートを送信することで、業務の簡素化と効率的な拡張を可能にします。

通知サービスでは、これまで以上に Rapid を活用していただけます。パートナー様の事業や業務に影響を及ぼす可能性のある予約の変更が発生した場合、Notifications API は標準的な POST メッセージを使用して、お使いのシステムに変更の詳細を直接お知らせします。こうしたプッシュ通知により、常に最新情報を入手でき、運営を簡素化し、ビジネスを拡大できます。

現在、Rapid の API 外部で発生する予約イベントすべてに対して通知をサポートしています。そのため、コールセンターの担当者が予約を変更したり、宿泊施設が予約をキャンセルした場合、すぐにお客様に通知されます。

当社で Rapid API に機能を追加する際には、利便性向上のために新しい通知イベントタイプを追加することもよくあります。

パートナー様のビジネスとのシームレスな統合を可能にすることで、こうした通知は Rapid API、Affiliate Voyager、その他のパートナー様およびお客様サポートサービスを補完する役割を果たします。

サポートされているイベントタイプ

Rapid の通知サービスでは次のようなイベントで、メッセージによってシステムに通知します。

event_type の値発生元発生イベント詳細
itinerary.agent.createカスタマーサポートエージェントまたは Affiliate Voyager予約の作成Rapid カスタマーサポートエージェントまたは Affiliate Voyager で新しい予約が作成されました。
itinerary.agent.changeカスタマーサポートエージェントまたは Affiliate Voyager予約の更新Rapid カスタマーサポートエージェントまたは Affiliate Voyager で既存の予約が更新されました。
itinerary.agent.cancelカスタマーサポートエージェントまたは Affiliate Voyager予約のキャンセルRapid カスタマーサポートエージェントまたは Affiliate Voyager で既存の予約が取り消されました。
itinerary.supplier.cancel施設予約のキャンセル既存の予約は、プロパティによってキャンセルされました。お客様は担当のカスタマーサポートに連絡する必要があります。
itinerary.supplier.confirm施設予約の更新プロパティは、予約のプロパティ確認IDを更新しました。
itinerary.fraud.cancelExpedia予約のキャンセル予約が取引に適用される利用規約に従っていないため、既存の予約がエクスペディアによって取り消されました。お客様は、電話番号および取り消しに関する相談に都合のよい日時を添えて、transactionprocessing@travelscape.com まで連絡する必要があります。
itinerary.supplier.change施設予約の更新旅行者の到着遅延またはアーリーチェックアウトにより、宿泊施設によって既存の予約が変更された場合。
itinerary.traveler.noshow施設旅行者によるノーショー旅行者が現れなかったため、宿泊施設は予約をNo showとしました。
itinerary.supplier.refund施設予約の更新エクスペディア コレクトのご予約については、ご旅行者様のご希望により払い戻しを承ります。旅行者が返金を受けられるようにするのはパートナーの義務です。
itinerary.message.received施設新しい施設メッセージセンターのメッセージ宿泊施設は施設メッセージ センター (PMC) 経由で新しいメッセージを送信しました。このイベントには、施設メッセージの全文に加え、メッセージの一般的なトピックが含まれます。通知に加えて、メッセージにはメールと PMC ツールからもアクセスできます。

注 : このような種類の通知を受け取るには、施設メッセージセンターと統合している必要があります。施設メッセージセンターについて詳しくはこちらをご覧ください

イベントスキーマと詳細

すべての POST 通知イベントが下記のスキーマに従います。さまざまなイベントに新しいイベントタイプが加えられるため、この構成は変更されることがあります。

オブジェクト説明
event_id各イベントの一意の識別子。
event_typeどのイベントが通知のきっかけとなったかを示します。この値はメッセージのハンドリングとルーティングに使用できます。詳細についてはイベントタイプのリストを参照してください。
event_timeイベント通知のタイプスタンプ (協定世界時)。
itinerary_id影響を受ける予約の旅程 ID。
email影響を受ける旅程に関連付いているお客様のメールアドレス。
message通知イベントに関する情報。itinerary.message.received タイプのイベントの場合、プロパティ・メッセージの実際のテキストが格納されます。他のすべてのイベントタイプでは、静的な、人間にとってわかりやすいイベントの説明 (英語) になります。
affiliate_reference_id影響を受ける予約のアフィリエイト参照 ID。
topic_tagsイベントのトピックタグ。これらは itinerary.message.received タイプのイベントでのみ提供されます。これは、メッセージのテキストに存在する可能性があると当社の分析で判断されたタグのリストになります。

各通知は JSON のメッセージ本文を持つ HTTP POST リクエストです。

注 : こうした種類の通知を受信できるようにするには、パートナーをイベントタイプごとに個別に有効にする必要があります。新しい通知イベントタイプを有効にする場合は、サポートにお問い合わせください。

itinerary.agent.create の例

{
     "event_id": "dbacce6c-afcb-4b23-ae66-48050757551c",
     "event_type": "itinerary.agent.create",
     "event_time": "2017-08-09T16:47:32.039Z",
     "itinerary_id": "8091234567890",
     "email": "customer@example.com",
     "message": "An agent created a new itinerary.",
     "affiliate_reference_id": "b086d299-2f1f-4134-a23c-f4a1c9286fac"
 }

itinerary.supplier.confirm の例

{
    "event_id": "e02d6f41-4708-476f-915d-8a7032942e94",
    "event_type": "itinerary.supplier.confirm",
    "event_time": "2018-04-28T20:31:03.423Z",
    "itinerary_id": "8999989898988",
    "email": "alice@example.com",
    "message": "The supplier confirmed one or more rooms on this itinerary.",
    "affiliate_reference_id": "R194193582",
    "rooms": [
        {
            "confirmation_id": {
                "expedia": "926784314",
                "property": "BEF23123AA"
            }
        },
        {
            "confirmation_id": {
                "expedia": "926784315"
            }
        }
    ]
}

itinerary.message.received の例

{
  "event_id": "1aed5641-7285-4c42-b079-f5f2f139d148",
  "event_type": "itinerary.message.received",
  "event_time": "2023-11-14T02:33:18.860105363Z",
  "itinerary_id": "9025254271673",
  "email": "john@email.com",
  "message": " We accept your request for a river view room. You will be able to check in at 11:00 AM. Please also note that the pool will be closed for scheduled maintenance on the day of your arrival, it will be open normal hours (9 AM to 10 PM) for the remainder of your stay. Looking forward to your visit.",
  "topic_tags": "Check-in, Property/Amenity Closure",
  "affiliate_reference_id": "b086d299-2f1f-4134-a23c-f4a1c9286fac"
}

API の詳細

このページで通知関連のエンドポイント定義を調べてから、API Explorer または別のテストソフトウェアを使用して、例とスキーマ定義が実際の出力とどのように比較されるかを理解します。


次のステップ

今すぐ Expedia Group の担当者に連絡して、通知の統合を開始しましょう。

このページで通知関連のエンドポイント定義を調べてから、API Explorer または別のテストソフトウェアを使用して、例とスキーマ定義が実際の出力とどのように比較されるかを理解します。

また、Notification Tester を用意しており、Notification API との統合をテストすることができます。

このページは役に立ちましたか ?
このコンテンツに改善が必要な点があれば、
サービス向上にご協力いただきありがとうございます。