跳到主要内容

设置协助入住

快速设置

大多数酒店约 5 分钟即可完成。 你将确认酒店信息、登记规则和一台平板上的二维码。

本指南帮助你完成面向员工的协助入住设置向导。

双设备 ACI

如果你的 kiosk 使用双设备 ACI，员工会将客人步骤发送到已配对的客人平板。 流程开始前，客人平板会显示 Pair this tablet。 重新加载页面或本地浏览器凭据丢失后，AVA 可以恢复配对。 只要设备身份保持不变，AVA 也可以恢复已过期的存储凭据。 恢复后台标签页后，Safari 可以恢复配对。 已撤销或停用的客人平板必须重新配对。 kiosk 仍必须使用 Two devices。 当浏览器和设备允许时，AVA 会在空闲期间保持客人平板唤醒。 如果浏览器或设备拒绝此操作，客人流程仍会正常继续。 在当前设备上完成客人信息字段，然后在最终入住前保存。

员工设备就绪状态

ACI 现在会在员工入住和退房页面显示员工设备就绪状态。 员工搜索、预订列表以及会改变状态的 ACI 操作都要求员工设备已就绪。 演示模式无需设备验证，仍可使用。 如果 AVA 发现已有已验证浏览器但凭据已过期，可以自动恢复该凭据。 如果无法恢复，请选择 Verify Device，然后扫描最新的一次性 kiosk QR。 仅当页面内扫描器不可用时，才使用 Kiosk Settings 链接。

选择 Verify Device 后，扫描器会在摄像头预览旁显示五个编号步骤。 预览会调整大小以适应屏幕。 状态栏会显示摄像头启动状态、扫描提示或摄像头错误。 摄像头状态变化时，步骤仍会保持可见。 在横向平板和桌面窗口上，预览与步骤会并排显示。

快速参考​

步骤设置内容当前位置
Overview需要准备什么以及可以获得什么Assisted Check-In Setup 第 1 步
Hotel Information酒店名称、国家、时区Hotel Information
PMS Integration连接 PMS，包括 Cloudbeds OAuth 和 Furama iPMSPMS Integration
AVA PMS Setup (optional)创建房型 + 房间（仅 AVA）AVA Setup
Create Reservation创建测试预订Create Reservation
Assign Room (AVA only)为测试预订分配房间Assign Room
Check-In Time允许入住时间和最低年龄Check-In Time
Registration Fields必填客人数据Registration Fields
Registration Card Signing谁签署登记卡Registration Card Signing
Room Access员工协助门禁方式Room Access
Try Check-In Now模式切换、链接和 QRTry Check-In Now

开始前​

请确认以下事项：

  • 你拥有 settings:write 权限
  • 已准备好酒店名称和国家信息
  • 已确认时区，或可以使用自动设置
  • 已准备 PMS 凭据（如需要）
  • 如适用，已准备 Cloudbeds 管理员访问权限和 Property ID
  • 已准备一台用于协助入住的平板
  • 如果使用双设备 ACI，已准备一台客人平板

分步操作​

1. 打开设置向导​

  1. 打开 Onboarding → Assisted Check-In Setup。

  2. 如果出现免费访问优惠，选择 Dismiss。

  3. 查看概览卡片并选择 Begin Setup。

    ✓ 你将进入 Hotel Information。

想先预览流程？

选择 Try demo，在新标签页中打开测试入住。 如果演示预订使用房卡，系统会先显示交接提示。 完成交接后，使用 Create Keycard 或 Already Encoded。

显示位置

仅使用协助入住方案的酒店登录后会进入这里。 如果你看不到该链接，请联系管理员。

2. 添加酒店信息​

  1. 输入 Hotel Name。

  2. 选择 Country。

  3. 确认 Timezone。

  4. 选择 Next。

    ✓ 该步骤会保存，状态显示 "Saved ✓"。

3. 连接 PMS（可选）​

  1. 选择 PMS Provider。

  2. 如果选择 Cloudbeds，选择 Connect to Cloudbeds 并授权访问。 AVA 通过 OAuth 接收 Property ID 和 API key。

  3. 对于其他 PMS，填写该提供商显示的字段。

  4. 返回向导并选择 Next。

    ✓ 连接设置已保存。

提供商字段

向导只显示适用于所选 PMS 的字段。 其必填字段与 Settings → Essentials → PMS Integration 中的字段一致。 之后返回时，已保存的密钥仍会保持掩码状态。

没有 PMS？

选择 AVA PMS 或 Use AVA。 AVA 设置步骤会出现在 Room Access 之前。

还没有 PMS 凭据？

保存前面的步骤后选择 Next。 然后使用 Save & Exit 离开，稍后再回来。

如果你不使用 PMS（选择 AVA PMS）

  1. 在 PMS Integration 中选择 AVA PMS 或 Use AVA。

  2. 选择 Next 保存。

  3. 创建你的第一个 Room Type。

  4. 输入房型名称。

  5. 选择 Room View。

  6. 选择 Save。

    ✓ 你会看到成功提示。

  7. 创建你的第一个 Room。

  8. 创建一个 Test Reservation。

  9. 为测试预订分配房间。

    ✓ 这些步骤会出现在 Room Access 之前。

如果你使用 Cloudbeds
  1. 在 PMS Integration 步骤选择 Cloudbeds。
  2. 选择 Connect to Cloudbeds。
  3. 登录 Cloudbeds，然后选择 Authorize 或 Allow。
  4. 返回向导并选择 Next。
  5. 在 Create Reservation 中选择 Create reservation。

✓ 会创建测试预订，且不会出现 AVA 房间设置步骤。

如果你使用 Furama iPMS

  1. 在 PMS Integration 步骤选择 Furama iPMS。

  2. 输入 iPMS Base URL、Organisation Unit、User Code 和 API Key。

  3. 如果 Furama 提供了单独的值，请添加 Control Unit 和 Business User Code。

  4. 选择 Next。

    ✓ 向导会保存 Furama 连接并继续设置。

Control Unit 默认为 Organisation Unit。 Business User Code 默认为保留原始大小写的 User Code。

4. 设置默认入住时间（可选）​

  1. 输入 Allowed Check-In Time。

  2. 如果政策需要，设置 Minimum Age。

  3. 选择 Next 保存。

    ✓ 默认时间已保存。

跳过此步骤： 选择 Skip / Do Later。

需要高级入住规则？

该向导仅在此步骤显示 Allowed Check-In Time 和 Minimum Age。 高级策略开关请使用 Settings → Check-In Rules。

5. 选择登记字段​

  1. 查看 Check-in 所需字段。

  2. 如果希望使用不同的客人字段，切换到 Pre-arrival。

  3. 打开希望收集的可选字段。

  4. 选择 Next。

    ✓ 登记字段已保存，供后续入住使用。

如果当前 PMS 要求某个字段，AVA 会显示 PMS Required 标记。 该字段会对 all guests 保持可见且必填。

PMS锁定字段
CloudbedsNationality
eZeeEmail Address
Mews、Opera 和 AVA PMS无其他字段

向导使用一套共享的登记字段设置。 如需分别配置模式，请使用配置客人登记字段。 如果更换 PMS 提供商，AVA 会在保存前重新检查必填字段。

PMS 要求不可用

在当前 PMS 能力加载完成前，AVA 会禁用登记字段编辑。 刷新向导，然后重试 Next。

如果你的酒店在泰国
  1. 选择 Yes, enable compliance reporting，自动设置 TM30/RR3 字段。
  2. 选择 No, let me customize，手动编辑字段。

✓ 选择 Yes 后，合规字段会自动填充。

6. 设置登记卡签署​

  1. 选择 Only main guest signs 或 All guests must sign。

  2. 选择 Next。

    ✓ 签名规则已保存。

7. 确认门禁方式​

  1. 查看 Room Access 说明。

  2. 选择 Next。

    ✓ 协助入住的门禁方式已设置为员工协助。

  1. 选择 Assisted Check-In 或 Self Check-In。

  2. 选择 View QR Code。

  3. 使用 Open link 或 Copy link 测试页面。

  4. 用平板扫描二维码。

  5. 在平板浏览器中打开页面。

  6. 使用浏览器的 Share 或菜单选项，然后选择 Add to Home Screen。

    ✓ 平板会为入住页面显示主屏幕快捷方式。

双设备 ACI

如果使用双设备 ACI，客人平板会打开已配对的客人流程。 员工在每个客人步骤中使用 Send to guest tablet。 空闲时，客人平板会显示屏保。 在支持的浏览器上，AVA 会自动尝试保持屏幕唤醒。 扫描 QR 并配对平板后，AVA 会在支持的设备上重试屏幕唤醒请求。 这有助于支持的 iPad 在链接后保持唤醒。 页面回到前台或网络恢复后，AVA 会再次重试。 如果客人平板重新加载，会返回已配对流程，无需重新注册。 如果存储凭据过期，只要浏览器安装仍相同，AVA 就可以恢复配对。 Safari 恢复标签页后，在 AVA 恢复配对期间请保持同一标签页打开。 已撤销或停用的平板仍需要重新配对。

缓存的图标

浏览器会积极缓存快捷方式图标和标签页 favicon。 如果仍看到旧 logo，请删除快捷方式后重新添加。

9. 完成设置​

  1. 选择 Finish setup。

  2. 你将返回 Reservations。

  3. 如果看到免费访问消息，选择 Dismiss。

  4. 完成首次入住后，发送邮件至 success@vouch-technologies.com 领取首月免费。

  5. 你可随时在 Settings → Check-In 查看详情。

    ✓ 你已准备好运行协助入住流程。

故障排查​

保存失败​

你会看到： "Save failed"，或步骤无法进入下一页。

解决方法：

  1. 确认你拥有 settings:write 权限。
  2. 完成该步骤的所有必填字段。
  3. 再次选择 Next。

如果登记步骤显示 PMS 要求警告，请等待警告消失。 在当前 PMS 能力有效前，AVA 无法保存这些更改。

PMS 登记字段已锁定​

你会看到： 字段显示 PMS Required，且无法更改。

解决方法：

  1. 对 All guests 保持该字段可见。
  2. 对 All guests 保持该字段为必填。
  3. 当前 PMS 要求加载完成后选择 Next。

这样可以避免之后预订与客人同步失败。

Cloudbeds 连接未启动​

你会看到： 选择 Connect to Cloudbeds 后没有打开 Cloudbeds。

解决方法：

  1. 确认已选择 Cloudbeds。

  2. 刷新向导页面。

  3. 再次选择 Connect to Cloudbeds。

  4. 尝试其他浏览器或隐私窗口。

    ✓ 授权后，Cloudbeds 会提供 Property ID。

PMS 字段出现或消失​

你会看到： 选择提供商后，向导显示了不同的字段。

原因： 每个 PMS 都有自己的必填凭据和条件凭据。

解决方法：

  1. 填写所选提供商显示的字段。

  2. 对于 Opera，在 OCIM 或 SSD 模式中输入 OHIP Enterprise ID。

  3. 对于 Opera SSD，还要输入显示的 OHIP Username 和 OHIP Password。

  4. 对于 Mews，请向 AVA 支持团队咨询空白的高级值。

  5. 字段验证通过后选择 Next。

    ✓ 向导与 PMS 设置页面使用相同的凭据要求。

必须选择合规选项（泰国）​

你会看到： "Please choose a compliance reporting option."

解决方法：

  1. 选择 Yes, enable compliance reporting 或 No, let me customize。
  2. 选择 Next 保存。

二维码不显示​

你会看到： 二维码区域空白，或显示 "Failed to generate QR code."

解决方法：

  1. 等待 10 秒后重试 View QR Code。
  2. 检查网络连接。
  3. 改用 Open link，然后从该页面扫码。
  4. 如果首次配对失败，请重试。 AVA 会先撤销失败的配对挑战，然后创建新的挑战。

客人平板配对未启动​

你会看到： 客人平板停留在 Pair this tablet，或重新加载后再次要求配对。

解决方法：

  1. 确认员工平板使用双设备 ACI。
  2. 保持客人平板上的同一浏览器安装处于打开状态。
  3. 等待 AVA 恢复配对。
  4. 如果配对没有恢复，只刷新客人平板一次。
  5. 打开 Settings → Kiosk，确认 kiosk 仍使用 Two devices。
  6. 如果平板已撤销或停用，选择 Link guest tablet 并重新配对。
  7. 如果恢复仍失败，选择 Link guest tablet 并重新配对。
  8. 如果客人平板不可用，检查 kiosk 是否允许单设备回退。
恢复保护

当 kiosk 不再使用 Two devices 时，AVA 不会恢复配对。 重新配对客人平板前，请先将 kiosk 切回该模式。

你会看到： 员工搜索、预订或退房控件不可用。 ACI 在员工设备上显示 "Staff verification recommended"。

原因： 浏览器已验证，但其存储的 STAFF 凭据缺失或已过期。

解决方法：

  1. 如有需要，继续入住或退房。

  2. 确认正在使用指定的员工浏览器或 kiosk 设备。

  3. 请管理员从 Settings → Kiosk 显示最新的一次性 ACI QR。

  4. 在 ACI 就绪面板中选择 Verify Device。

  5. 允许摄像头访问，然后扫描 QR。

  6. 等待 ACI 页面重新加载。

    ✓ 完成新的列表加载后，ACI 会重新加载并启用员工操作。

如果就绪状态丢失，AVA 会清除过期的员工状态并要求你重新验证。 扫描器会将验证保持在当前 Web Clip、PWA 或浏览器包装器上下文中。

如果扫描器无法打开，请使用 Settings → Kiosk 并选择 Re-verify staff device。 在同一台实体设备上完成最新的一次性验证链接。

Safari 恢复的标签页停留在 Pair this tablet​

你会看到： Safari 恢复了客人平板标签页，但仍停留在 Pair this tablet。

解决方法：

  1. 在同一台平板上保持恢复的 Safari 标签页打开。

  2. 等待 AVA 恢复已保存的配对。

  3. 如果配对没有恢复，只刷新标签页一次。

  4. 在 Settings → Kiosk 中确认 kiosk 仍使用 Two devices。

  5. 如果恢复仍失败，选择 Link guest tablet 并重新配对。

    ✓ 客人平板会返回已配对流程，无需重新注册。

客人平板屏幕关闭​

你会看到： 显示屏保时，客人平板屏幕关闭。

解决方法：

  1. 唤醒平板并解锁。

  2. 将 AVA 入住页面置于前台。

  3. 确认平板已连接电源和网络。

  4. 检查设备的 Auto-Lock 或 Screen timeout 设置。

  5. 如果设备政策允许，延长面向客人使用时的超时时间。

    ✓ 在支持的情况下，AVA 会再次尝试保持屏幕唤醒。

浏览器或设备限制

部分浏览器和设备策略不允许 AVA 保持屏幕唤醒。 已配对的客人流程仍可使用，但平板可能会再次休眠。

员工平板显示客人平板离线​

你会看到： 客人平板已恢复，但员工平板仍显示 Offline。

该状态取决于客人平板的心跳。 仅重新连接员工浏览器不会将客人平板标记为就绪。

解决方法：

  1. 确认客人平板页面已打开并连接网络。

  2. 唤醒客人平板并将 AVA 页面置于前台。

  3. 等待员工端状态刷新。

  4. 再次选择 Send to guest tablet。

  5. 如果状态仍为 Offline，只刷新客人平板一次。

  6. 如果客人需要立即继续，使用单设备回退。

    ✓ 真正的连接丢失会在客人平板重新连接前保持 Offline。

没有主屏幕快捷方式​

你会看到： 平板浏览器不提供品牌安装提示。

解决方法：

  1. 在平板浏览器中打开入住页面。
  2. 使用 Share 或浏览器菜单。
  3. 选择 Add to Home Screen。
  4. 从平板主屏幕测试该快捷方式。

你会看到： 浏览器标签页或快捷方式仍显示旧的 Vouch 图标。

解决方法：

  1. 刷新页面。

  2. 完全关闭浏览器。

  3. 从平板主屏幕删除快捷方式。

  4. 再次打开入住页面。

  5. 再次将其添加到主屏幕。

    ✓ 快捷方式现在应使用 AVA logo。

剪贴板不可用​

你会看到： "Clipboard not available. Please copy manually."

解决方法：

  1. 选择 Link 字段。
  2. 手动复制 URL。

Overview 页面没有 Next 按钮​

你会看到： 概览页面没有 Next 按钮。

解决方法：

  1. 选择 Begin Setup。
  2. 你将进入 Hotel Information。

房型保存按钮不可用（AVA PMS）​

你会看到： Create Room Type 中的 Save 按钮一直处于禁用状态。

解决方法：

  1. 输入 Room Type Name。
  2. 选择 Room View。
  3. 再次选择 Save。

仍然无法解决？​

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

  • ❌ 多次尝试后向导仍无法保存
  • ❌ QR 码始终无法生成
  • ❌ 执行恢复步骤后客人平板配对仍未恢复
  • ❌ 无法访问 Assisted Check-In Setup 链接

建议附上：

  • 问题截图
  • 酒店名称
  • 问题开始时间
  • 你使用的是单设备还是双设备协助入住