对话解决方案

通过 API 或 pre-built 用户界面，促进旅行者与酒店之间的无缝沟通。

对话 API

借助对话 API，您可以促进旅行者（或代理商）与住宿供应商之间的无缝沟通。集成后，您可以通过 API 获取酒店、度假租赁和 Vrbo 房源的对话记录，以及创建和查看消息。

此功能可通过 post-booking API 体验启用 post-booking 消息。您可以通过将对话嵌入到您自己的 traveler-facing 和 agent-facing 工具中来控制 front-end 体验，从而建立与旅行者的信任，减少取消和服务成本，并简化支持工作流程。

对话 API 还支持通过通知进行主题标记功能。主题标签是对消息内容的描述，可以是单个或 two-word，可以帮助您自动提供支持并确保消息路由到正确的渠道。

请在“其他资源”中阅读更多关于主题标签和 AI-powered re-marketing 抑制的信息。

对话 API 是唯一支持 Vrbo 库存的对话解决方案。

对话 API 的工作原理

根据您的需要，对话 API 可以配置为直接在酒店和旅客之间或酒店和您的支持人员之间进行消息传递。无论哪种情况，您都将通过“管理预订”检索该预订的响应来访问“对话 API”链接，然后将对话入口点呈现给旅行者或代理商。当供应商发送新消息时，您将立即通过通知收到通知。

注意： 对话 API 不提供 pre-built 消息传递 UI 体验。您要么需要开发该体验，要么需要将对话 API 连接到您现有的消息传递 UI 体验。

如果您需要 pre-built 用户界面，请参阅“属性消息中心”。

通过“管理预订”检索预订信息

当您从“管理预订 API”的“检索预订”端点请求预订详情时，响应将包含指向“对话 API”的链接，该链接位于 conversations对象中。

>> 了解更多关于管理预订 API 的信息。

注意：对话的链接是 time-bound，将在发出后一小时过期。add-message 每次响应时都应重新调用 Retrieve 函数以获取最新链接，而不是长期存储会话链接。

回复中的对话链接示例：

{
  "itinerary_id": "8999989898988",
  "rooms": [
    {
      "id": "926784314"
    }
  ],
  "links": [
    "conversation": {
      "method": "GET",
      "href": "/v3/conversations/1234567890?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
    }
  ]
}

与旅行者/代理商进行表面对话的切入点

您有两种选择：

• 将此链接嵌入到您的 traveler-facing 界面中，以便旅客可以直接与酒店收发消息。常见入口点包括预订确认页面、行程详情页面或确认电子邮件。
  请参阅其他资源，了解最佳实践。
• 将链接嵌入到您的代理工具中，以便您的支持团队可以与旅客和酒店进行沟通。

订阅通知，接收新消息

订阅 Rapid Notifications API 中的以下 conversation-related 事件，即可接收 supplier-initiated 消息推送通知：

• itinerary.message.received —当房源向需求合作伙伴/旅行者发送新消息时触发
• itinerary.message.rejected —当房产信息被识别为欺诈或网络钓鱼性质并被屏蔽时触发。邮件已被拦截，无法送达。
• itinerary.conversation.attachment.success —当旅客或需求合作伙伴（作为代理消息的一部分）发送的附件成功上传并处理后触发。
• itinerary.conversation.attachment.failure —当附件上传失败时触发

>> 有关入职通知的更多信息，请参阅通知页面。

向物业发送消息

对话 API 会在单个响应中返回预订的完整消息历史记录，包括旅行者/代理商发送的消息和酒店的回复。房产信息可能包含附件和访问附件的链接。支持的附件类型包括 PNG、PDF、JPEG 和 DOCX。

相同的回复中还包含用于发送消息的链接：一个用于发送纯文本，一个用于发起附件上传。

发送纯文本消息

要发起新消息或回复房源，请使用 add_message链接向对话中添加消息。成功响应后会返回一个更新后的对话链接，你应该保存该链接并在下次读取时使用它，以保持令牌状态最新。

当代理代表旅行者发送消息时，无论是在 API 中还是在酒店方面，该消息都看起来像是旅行者发送的。如果代理人想表明该消息是由代理人发送的，他们可以添加如下注释：“由[合作伙伴]代理人代表旅客发送。”

发送附件

附件直接上传到亚马逊 S3。流程从附件 API 请求开始，其中包含文件元数据，以及（可选的）随附消息文本。响应返回一个安全的 S3 URL、其过期时间以及 AWS 要求的表单字段。支持的文件类型包括 PNG、PDF 和 JPEG。

**笔记：**本次通话中提供的文本将随文件一起上传，并在文件送达时作为消息发布。单独的add_message因此，无需进行调用——发出调用会在线程中产生重复消息。

在安全的 S3 URL 过期之前，使用之前附件 API 响应中提供的表单字段，将文件 POST 到该 URL。

>> 更多详情请参阅 AWS 文档。

S3 上传成功后，Rapid 会触发恶意软件扫描：

• 如果文件干净：文件将被存储，包含附件及其正文的消息将被发送到该物业，并且itinerary.conversation.attachment.success通知已推送。
• 如果检测到威胁，则删除该文件并进行处理。itinerary.conversation.attachment.failure通知已推送。

以下是对话 API 返回的对话对象示例：

{
  "itinerary_id": "987654321098",
  "expedia_confirmation_id": "1234567890",
  "property_id": "12345",
  "messages": [
    {
      "text": "Can I have an early check-in?",
      "participant": {
        "role": "traveler",
        "given_name": "John",
        "family_name": "Smith"
      },
      "creation_date_time": "2025-04-15T00:45:14.000Z",
      "message_type": "free_text",
      "delivery_status": "accepted"
    },
    {
      "text": "Please note that check-in time is 5pm and that you will need to meet with our receptionist to receive information about your room assignment.",
      "participant": {
        "role": "supplier"
      },
      "creation_date_time": "2025-04-15T00:10:12.000Z",
      "message_type": "free_text",
      "delivery_status": "accepted"
    }
  ],
  "links": {
    "add_message": {
      "method": "POST",
      "href": "/v3/conversations/1234567890/messages?token=MY5S3j36cOcL",
      "expires": "2025-04-15T00:45:14.000Z"
    },
    "add_attachment": {
      "method": "POST",
      "href": "/v3/conversations/1234567890/messages/attachments?token=MY5S3j36cOcL",
      "expires": "2025-04-15T00:45:14.000Z"
    }
  }
}

链接有效期和令牌过期时间

链接add_message和add_attachment是临时的，会在指定的时间戳到期。expires字段或 check-out 日期后 30 天，以先到者为准。对话链接本身有效期最长为 90 天 post-stay。

评估expires每次调用前都要检查字段值。如果请求已通过，或者您收到 401/403，re-run 检索预订或对话调用以生成新的链接。

请联系您的 Expedia Group 代表，以启动您的 Conversation API 集成。

AI-powered re-marketing 抑制和消息主题标记

被识别为“Property-initiated”的消息（推广直接预订或以其他方式预订的消息 off-platform）会被 Conversation API 和 Property Message Center 自动抑制。

为了更轻松、更大规模地使用 property-initiated 消息，我们的对话解决方案采用了 AI-driven 模型，该模型可以识别消息的主要主题，并将这些主题作为标签传递。itinerary.message.received通知事件。您可以利用这些标签在您自己的系统中实现搜索、路由、自动化和抑制逻辑。

潜在的房产信息主题标签

带有主题标签的通知有效负载示例：itinerary.message.received

{
  "event_id": "493ae7d4-fb3c-49fb-b180-0d7f4030aaeb",
  "event_type": "itinerary.message.received",
  "event_time": "2024-09-16T15:22:42.783857461Z",
  "itinerary_id": "9025294229844",
  "email": "test@travelnow.com",
  "message": "Please checkin before 12:00 PM!",
  "topic_tags": "Check-in",
  "affiliate_reference_id": "b086d299-2f1f-4134-a23c-f4a1c9286fac"
}

度假短租屋

启用与度假租赁房产的直接消息功能至关重要，Rapid API 上 84% 的度假租赁房产没有前台。这些住宿接待方通常依靠直接传递消息来为住客提供：

• 进入住宿的个性化门禁密码
• 关于住宿独特或可用服务设施的指导信息
• 停车说明或车位分配

注意： 房源留言中心与 Vrbo 房源不兼容。如果您目前正在分销或计划分销 Vrbo 库存，我们建议您集成 Conversation API。

住宿消息中心

two-way 消息工具，通过 pre-built 消息用户界面，促进酒店与旅行者或代理商之间的直接互动，从而提供更简化的 post-booking 体验。

住宿消息中心如何运作

可以通过在预订请求中提供旅客电子邮件地址，将房源消息中心配置为直接在房源和旅客之间发送消息；或者通过在预订请求中提供客服人员电子邮件地址，将房源消息中心配置为在房源和客服人员之间发送消息。

房源信息中心对话示例

Property-initiated 消息 该酒店想告知旅客，他们提供免费的 round-trip 往返机场的班车服务。

Traveler-initiated 消息 旅行者预订时要求提供婴儿床住宿，并希望在抵达前与酒店再次确认此要求。

访问物业消息中心旅客和 Agent-Model 启动要求，以及 Expedia 合作伙伴解决方案：

>> 更多详情请参阅 AWS 文档。
>> 了解 traveler-model 的启动要求
>> 阅读有关 agent-model 启动要求的信息

请联系您的 Expedia Group 代表，以启动您的物业消息中心集成。

其他资源

如何有效地向旅行者展示对话切入点

以下是一些关于如何在旅客完成预订后向他们公开 Conversation API 链接的指导。

1. 在预订确认页面添加“给酒店留言”或“给房东留言”按钮
   这样，需要向酒店提出请求或询问信息的旅客可以在预订后立即联系酒店。
   

   

2. 在行程页面添加“给酒店留言”或“给房东留言”按钮
   这样旅行者就可以直接从预订页面联系酒店。
   

   

3. 在预订邮件中添加“给酒店留言”或“给房东留言”按钮
   这有助于提示旅客在收到有关即将到来的入住的更新或提醒时与酒店联系。
   

   

对话 API 错误处理

在不同情况下可能会返回几个错误，所有错误都用 400表示。以下列出了常见错误原因以及每个错误返回的相应消息：

API 详情

在本页上探索对话 API 定义，然后使用 API Explorer 或其他测试软件来了解示例和模式定义与实际输出的比较情况。