通知
Rapid 的通知服務可傳送各種預訂事件的提醒，幫助您簡化營運並有效擴展業務。
通知服務可讓您更緊密地與 Rapid 整合。若發生可能影響您業務或營運的預訂變更，通知 API 會透過標準 POST 訊息，直接將變更詳情推播至您的系統。這些推播通知可讓您隨時接收最新資訊、簡化作業以及調整業務範圍。
我們目前支援在 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 | 飯店 | 更新預訂 | 飯店已更新該筆預訂的住宿確認編號。 |
itinerary.fraud.cancel | Expedia | 取消預訂 | 現有預訂未遵循交易適用的條款和/或條件，因此遭到 Expedia 取消。旅客必須將自己的聯絡電話，以及方便討論取消事宜的時間傳送至 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 | 事件通知的時間戳記 (以世界協調時間 UTC 顯示)。 |
itinerary_id | 受影響預訂的行程編號。 |
email | 與受影響行程有關的客戶電子郵件地址。 |
message | 該通知事件的相關資訊。如為 itinerary.message.received 事件類型，將包含供應商訊息的實際文字。如為其他所有事件類型，則將會是以英文撰寫、淺顯易懂地說明該事件的靜態內容。 |
affiliate_reference_id | 受影響預訂的聯盟夥伴參考編號。 |
topic_tags | 事件的主題標籤。只有 itinerary.message.received 這個類型的事件才會提供此標籤。這會是系統分析訊息文字後，判斷可能符合的標籤清單。 |
每個通知皆為訊息內文為 JSON 格式的 HTTPS 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 或其他測試軟體，了解範例和結構描述定義與實際輸出的比較。