通知
Rapid 的通知服务可针对各种预订事件发送警报,使您能够简化操作并有效扩大规模。
该通知服务可让您比以往更紧密地与 Rapid 集成。如发生影响您业务或操作的预订变更,通知 API 将通过标准 POST 消息直接向您的系统推送变更详情。借助这些推送通知,您可以了解情况、简化操作并扩大业务规模。
当前我们支持发生在 API 范围外的所有预订事件的通知。因此,如果呼叫中心客服做出变更或酒店取消预订,您将立即获得通知。
当我们为 Rapid API 添加特点和功能时,我们通常也会添加新的通知事件类型,以改善您的体验。
通过实现与您业务的无缝集成,这些通知可为 Rapid API、Affiliate Voyager 和其他合作伙伴与客户支持服务锦上添花。
支持的事件类型
Rapid 的通知服务会在发生下列事件时,通过消息向您的系统发送通知:
event_type 值 | 来源 | 活动 | 详细信息 |
---|---|---|---|
itinerary.agent.create | 客户支持客服或联盟伙伴 Voyager | 预订创建 | Rapid 客户支持客服或联盟伙伴 Voyager 创建了一个新预订。 |
itinerary.agent.change | 客户支持客服或联盟伙伴 Voyager | 预订更新 | Rapid 客户支持客服或联盟伙伴 Voyager 更新了一个现有预订。 |
itinerary.agent.cancel | 客户支持客服或联盟伙伴 Voyager | 预订取消 | Rapid 客户支持客服或联盟伙伴 Voyager 取消了一个现有预订。 |
itinerary.supplier.cancel | 酒店 | 预订取消 | 酒店取消了一个现有预订。客户应与您企业的客户支持联系。 |
itinerary.supplier.confirm | 酒店 | 预订更新 | 酒店已更新预订的住宿确认 ID。 |
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 | 受影响预订的行程 ID。 |
email | 与受影响行程关联的客户邮箱地址。 |
message | 有关通知事件的信息。对于 itinerary.message.received 类型的事件,此处将包含提供商消息的实际文本。在所有其他事件类型中,此处将是对事件的静态人性化描述(英文。 |
affiliate_reference_id | 受影响预订的联盟伙伴参考 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 或其他测试软件来了解示例和模式定义与实际输出的比较。