通知
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.cancel | エクスペディア | 予約のキャンセル | 予約が取引に適用される利用規約に従っていないため、既存の予約がエクスペディアによって取り消されました。お客様は、電話番号および取り消しに関する相談に都合のよい日時を添えて、transactionprocessing@travelscape.com まで連絡する必要があります。 |
itinerary.supplier.change | サプライヤー | 予約の更新 | 旅行者の到着遅延またはアーリーチェックアウトが理由で、ホテルが既存の予約を変更しました。 |
itinerary.traveler.noshow | サプライヤー | 旅行者によるノーショー | 旅行者が施設に現れなかったため、サプライヤーが予約をノーショーとしてマークしました。 |
itinerary.supplier.refund | サプライヤー | 予約の更新 | Expedia Collect (事前決済) の予約については、旅行者の要望に応じてホテルが返金を行います。旅行者が返金を受けられるようにするのはパートナーの義務です。 |
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 または別のテストソフトウェアを使用して、例とスキーマ定義が実際の出力とどのように比較されるかを理解します。