跳到主要内容

设置 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 数据处理预订和客人详情
  • ✅ Access Token 字段会显示掩码字符
  • ✅ 如果您以后需要更新令牌，请使用 Edit Token
  • ℹ️ 当您保存其他 Mews 字段时，AVA 会保留当前的 Demo Mode 值。
  • ℹ️ 生产环境不会强制将 Demo Mode 设为 OFF。

对客人与员工的影响​

  • 客人表单会根据 Mews 规则自动调整。 必填字段和隐藏字段会随 Mews 配置变化，因此客人只会看到需要填写的内容。
  • 预订查询使用 Mews。 如果未配置 Mews，客人查询步骤会失败。

故障排除​

"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 配置不一致，请联系支持

验证清单​

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

仍然卡住？​

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

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

建议附上：

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

相关指南​