跳到主要内容

设置 Mews PMS 集成

快速设置

大多数酒店只需要 Access Token。这大约只需 10 分钟。

本指南帮助你将 AVA 连接到 Mews，以便预订和住客详情能够正确同步。

在哪里找到​

Settings → Essentials → Property Management System (PMS) Integration

快速参考​

设置控制内容使用时机
Access Token将 AVA 连接到 Mews始终使用
Advanced → Client Token高级连接凭据仅在支持人员要求时使用
Advanced → Client ID你在 Mews 中的物业标识符仅在支持人员要求时使用
Advanced → Demo Mode使用沙盒端点进行测试仅用于测试环境

开始之前​

你需要：

  • 可以访问 Mews 管理后台
  • 用于 AVA 集成的 Access Token / Token ID
  • 可在 AVA 中更新 PMS 设置的管理员权限
信息

如果你没有 Access Token，请联系你的 Mews 管理员或 AVA 支持。

如何获取你的 Mews Access Token​

请在 Mews 中按以下步骤操作：

  1. 登录 Mews PMS

  2. 在侧边栏中点击 Marketplace

    Mews Marketplace Search

  3. 点击 My Subscriptions

    Mews Subscriptions

  4. 找到 Vouch AVA Front Desk Agent

  5. 点击 Edit

  6. 打开 Access Token 区域

  7. 复制 Token ID

    Mews Access Token

提示

请马上把令牌粘贴到 AVA 中，避免之后找不到。

配置步骤​

第 1 步：选择 Mews​

  1. 前往 Settings → Essentials → PMS Integration
  2. 点击 Mews 卡片
  3. 会出现 Mews 配置表单

第 2 步：输入 Access Token​

  1. 将 Mews 提供的 Token ID 粘贴到 Access Token 字段中
  2. 保存后，为了安全，令牌会被隐藏
掩码值是安全的

如果你稍后返回并看到掩码字符，请保持原样，然后点击 Save。 AVA 会保留已保存的 Access Token、Client Token 和 Client ID。

如果你需要 Advanced Mews 设置（仅限支持人员）
  1. 点击 Advanced
  2. 输入支持人员提供的值：
    • Client Token
    • Client ID
  3. 可选：如果你正在用沙盒端点测试，请开启 Demo Mode
注意

除非支持人员明确要求，否则不要更改 Advanced 值。错误的值会导致同步停止。

第 3 步：保存​

  1. 点击页面底部的 Save
  2. 查看成功消息
  3. Access Token 字段会显示占位符，以保护机密信息

连接后会发生什么​

  • ✅ AVA 开始使用 Mews 数据处理预订和住客详情
  • ✅ 如果 AVA 的住客称谓与 Mews 中的记录匹配，称谓会同步到 Mews 客户记录
  • ✅ Access Token 字段会显示掩码字符
  • ✅ 如果你以后需要更新令牌，请使用 Edit Token
  • ℹ️ 当你保存其他 Mews 字段时，AVA 会保留当前的 Demo Mode 值。
  • ℹ️ 生产环境不会强制将 Demo Mode 设为 OFF。
  • ✅ “Do Not Move” 房间锁定状态会与 Mews 保持同步。

对住客与员工的影响​

  • 住客表单会根据 Mews 规则自动调整。 必填字段和隐藏字段会随 Mews 配置变化，因此住客只会看到需要填写的内容。
  • 预订查询使用 Mews。 如果未配置 Mews，住客查询步骤会失败。
  • 被锁定的房间会保持在 AVA 中锁定。 如果 Mews 将某个预订标记为锁定，Streamliner 会在房型变更视图中显示锁定图标。

故障排除​

"Access Token is required" 错误​

你看到的： "Access Token is required"

解决方法：

  1. 从 Mews 粘贴 Token ID
  2. 再次点击 Save
  3. ✓ 保存后错误会消失

令牌已保存但没有同步数据​

你看到的： 你保存了令牌，但预订没有出现

解决方法：

  1. 等待 10-15 分钟完成首次同步
  2. 刷新页面并确认 Mews 仍处于选中状态
  3. 请你的 Mews 管理员确认 AVA 订阅处于活动状态
  4. 如果问题持续，请联系 AVA 支持

刷新后又出现掩码字段​

你看到的： 刷新页面后，Access Token 或高级字段显示掩码字符。

解决方法：

  1. 保持掩码值不变。
  2. 再次点击 Save。
  3. ✓ AVA 会保留已保存的 Mews 凭据。

找不到 Client Token、Client ID 或 Demo Mode​

你看到的： 你看不到 Client Token、Client ID 或 Demo Mode 字段

解决方法：

  1. 点击 Advanced
  2. ✓ 高级字段会显示在 Advanced 区域中

Demo Mode 已开启，但同步看起来不对​

你看到的： 预订缺失或出现了意外的测试数据

解决方法：

  1. 关闭 Demo Mode
  2. 点击 Save
  3. 刷新页面并检查连接状态
  4. 如果问题持续，请联系支持

保存后 Demo Mode 不一致​

你看到的： 刷新后 Demo Mode 复选框发生变化，或者与已保存的 Mews 设置不一致。

解决方法：

  1. 打开 Advanced。
  2. 检查 Demo Mode 的值。
  3. 只保存你想要更改的内容。
  4. 刷新页面。
  5. 如果复选框仍与已保存的 Mews 配置不一致，请联系支持。

某个房间没有出现在房型变更中​

你看到的： 该房间未显示在 Allow move room 中。

解决方法：

  1. 检查 Mews 中的预订。
  2. 如果该房间应该可移动，请移除房间锁定。
  3. 在 AVA 中刷新该预订。
  4. 再次尝试房型变更。

验证清单​

  • 已在 Select PMS Provider 中选择 Mews
  • 已输入并保存 Access Token，且没有错误
  • 刷新后 Access Token 字段显示掩码字符
  • 预订开始从 Mews 同步

仍然卡住？​

如果出现以下情况，请联系 success@vouch-technologies.com：

  • ❌ 同步在 15 分钟后仍未开始
  • ❌ 你遇到无法解决的保存错误
  • ❌ 你需要 Advanced 设置但没有对应值

建议附上：

  • PMS Integration 部分的截图
  • 你的 PMS 提供商（Mews）
  • 具体错误文本（如有）

相关指南​