跳到主要内容

设置 Vouch AVA Alarm

快速设置

如果设备已准备好，通常约需 10 分钟。

本指南帮助你将 Vouch AVA Alarm 连接到酒店的视频通话提醒。 请从 Communication Hub → Video Calls → Alarm Devices 打开它。 每台设备都使用 Streamliner 帐户配对。 不再支持报警代码配对和商户拥有的设备链接。 帐户配对仅可在 AVA 移动壳内使用。 入住和退房的投递现在位于推送通知中。 Vouch AVA Alarm 使用与设备配对的 Streamliner 帐户。 其通知偏好遵循该帐户的推送类别。 旧的 Night Shift → Alarm 页面现在会打开此标签页。 设置现在从 Android 和 iOS 商店安装卡开始。 每张卡都会打开一个 QR 弹窗，其中包含商店页面和直接链接按钮。 如果酒店有自定义商店链接，弹窗会优先使用这些链接。 否则会回退到公开的 Play Store 和 App Store 页面。 如果你管理多家酒店，请为该帐户应接收来电的每家酒店启用报警投递。 报警代码创建、链接和 QR 配对已不再提供。 Vouch AVA Alarm 可在 Android 和 iOS 设备上运行。

小屏幕

连接的设备表现在会在窄屏幕上堆叠显示。 这样可以让 QR 卡片、编辑操作和删除按钮在移动设备上保持可见。

设置项控制内容显示位置
Install app打开 Android 或 iOS 商店的 QR 弹窗第 1 步设置卡
Enable Vouch AVA Alarm打开或关闭集成Alarm Devices 标签页
Device name为该商户标记设备已连接设备表
Streamliner account pairing将当前 AVA 应用设备关联到你的员工帐户Pair this AVA device 卡片
Current sound显示此手机上选择的声音已配对设备卡片
Change sound打开此手机的原生声音设置已配对设备卡片
Recover notifications刷新此手机的通知注册已配对设备卡片
Receive incoming-call alarms为当前酒店打开报警已配对帐户控件
Notification preferences控制移动端视频通话提醒和生命周期更新报警集成区域
Send test alarm向已配对设备发送示例报警集成区域中的测试区域
重要

Vouch AVA Alarm 只处理视频通话提醒。 它不会取代浏览器推送通知。 它不控制入住或退房投递。

仅限帐户配对

报警设备属于 Streamliner 帐户。 请先在 AVA 移动壳内配对每台设备，然后再启用其酒店报警偏好。 旧的报警代码链接无法创建、关联、排程或用于投递。

原生声音设置

选择的报警声音属于当前手机。 Streamliner 会显示其名称，但不会上传或管理声音文件。 声音控件仅会在当前手机存在活跃配对时显示。

iOS 后台投递

在更新后的 iPhone 和 iPad 应用中，报警触发使用后台 APNs 投递。 这样即使应用处于后台或已关闭，设备也能发出提醒。 较旧的 iOS 应用版本继续使用标准推送投递。 Android 投递方式保持不变。 请在设备设置中允许 AVA 应用发送通知。

iOS 重新安装恢复

重新安装 AVA 应用后，请登录同一个 Streamliner 帐户。 AVA 会恢复最新匹配的 iOS 报警配对，而不是创建重复配对。 设备标签、酒店报警设置和帐户所有权保持不变。 如果不存在匹配的配对，AVA 不会自动创建配对。 请使用 Pair this AVA device 明确进行配对。

在 iPhone 上测试投递

在兼容的 iPhone 上，Send test alarm 会分别检查标准推送和后台 VoIP 投递。 两次发送使用同一个测试操作，因此其中一次失败不会阻止另一次。 较旧的 iPhone 应用和 Android 设备只会接收标准推送测试。 发送已被接受只能确认服务提供商接受了请求，并不表示手机已响铃。 当兼容的 iPhone 只有 VoIP 测试目标时，测试仍然可用。

通话状态同步

当 AI 接听、访客请求人工服务或通话结束时，已配对报警设备会立即更新。 这样可以保持提醒状态同步，让设备停止响铃或正确关闭通知。 同一个偏好设置同时适用于来电和这些通话状态更新。

原生应用通话详情

每次通话更新都会在可用时包含其活动和房间标识。 这有助于 Vouch AVA Alarm 应用只更新匹配的通话。 应用还会接收当前由 AI 还是人工处理通话的信息。 这样员工就能通过正确的移动端操作加入现有通话。 员工从 AVA 移动壳接听时，Streamliner 会发送已登录帐户的显示名称。 原生应用可以在记录谁接听或拒绝通话时使用该名称。

多酒店配置

将设备与员工的 Streamliner 帐户配对。 然后分别为每家酒店启用 Vouch AVA Alarm。 员工路由使用帐户身份，而不是共享报警代码。

员工排班

如果你使用员工班次路由，请为每位值班员工分配 Streamliner 帐户。 当这些员工应接收原生提醒时，请分配已配对的 Streamliner 帐户。 每周排班表控制浏览器来电的接收人。

开始前​

确认以下基本条件：

  • 你可以编辑这些设置
  • 你的角色拥有 video_call:device_pairing:manage 权限
  • Android 或 iOS 设备已准备好并联网
  • 设备可以扫描 QR 码
  • 该酒店的报警服务已启用

打开集成​

  1. 前往 Communication Hub → Video Calls

  2. 选择 Alarm Devices

  3. 打开 Vouch AVA Alarm Integration

  4. 启用 Enable Vouch AVA Alarm

  5. 点击 Save notification settings

    ✓ 页面刷新后，集成仍会保持启用。

更改报警集成设置需要专用的设备配对权限。 通用的 settings:read 和 settings:write 权限不授予此访问权限。

安装应用​

  1. 在 Vouch AVA Alarm Integration 中找到 Step 1

  2. 选择 Android 或 iOS

  3. 点击 Get it on Google Play 或 Download on the App Store

  4. 扫描弹窗中的 QR 码，或打开直接商店链接

  5. 在需要接收提醒的设备上安装应用

    ✓ 会为所选平台打开应用商店页面。 ✓ 如果扫描不方便，弹窗会提供直接商店链接。

连接设备​

每台设备都使用帐户配对。

将 AVA 应用与 Streamliner 帐户配对​

当原生提醒需要跟随员工当前使用的 AVA 应用设备时，请使用帐户配对。 Pair this AVA device 卡片仅会在 AVA 移动壳内显示。 配对会将设备关联到已登录的 Streamliner 帐户。

  1. 在手机的 AVA 应用中打开 Streamliner。

  2. 前往 Communication Hub → Video Calls → Alarm Devices。

  3. 找到 Pair this AVA device。

  4. 选择 Pair using Streamliner account。

  5. 选择 Confirm pairing。

  6. 开启 Receive incoming-call alarms for this property。

  7. 添加可选的 Device label，然后点击 Save。

    ✓ 卡片会显示“This device is paired with your Streamliner account.”

帐户配对可以包含多个活跃的 AVA 设备。 已暂停的设备在你重新登录前不会响铃。 来电开关仅适用于当前酒店。 需要让该帐户在其他酒店接收报警时，请分别为每家酒店启用此开关。

在 Android 上，如果已知被拒绝的通知令牌中断配对，AVA 会保留可用的批准状态。 应用可以续期令牌，并在批准过期前使用同一批准重试。 批准已过期，或批准使用后遭到拒绝，都需要新的配对批准。

替换其他帐户的配对

如果设备属于其他 Streamliner 帐户，应用会要求确认。 只有在确实要替换该帐户配对时才继续。

更改报警声音​

在 AVA 移动壳内的已配对设备卡片中更改报警声音。 原生 AVA 应用会在此手机上存储并应用该声音。

  1. 在 AVA 应用中打开 Streamliner。

  2. 前往 Communication Hub → Video Calls → Alarm Devices。

  3. 确认卡片显示 This device is paired。

  4. 查看卡片上的 Current sound。

  5. 选择 Change sound。

  6. 在手机的原生设置中选择声音。

  7. 返回 Streamliner；如有需要，重新打开 Alarm Devices。

    ✓ 已配对设备卡片会显示所选声音名称。

Change sound 操作仅适用于当前手机的活跃配对。 已暂停的配对和其他手机不会显示此操作。

在已配对手机上恢复通知​

当已配对手机漏掉设备测试或来电视频通话提醒时，请使用恢复功能。 恢复功能会刷新手机的通知注册，不会创建另一台设备。

  1. 在 AVA 移动壳内打开 Streamliner。

  2. 前往 Communication Hub → Video Calls → Alarm Devices。

  3. 确认卡片显示 This device is paired。

  4. 在 Change sound 下方选择 Recover notifications。

  5. 查看确认消息，然后选择 Recover notifications。

  6. 查看结果，然后选择 Close。

  7. 为此设备选择 Test 并检查手机。

    ✓ 成功恢复后会显示“Notification registration updated.”。 ✓ 测试会检查通知和来电是否到达手机。

恢复功能仅适用于当前手机上的活跃配对。 较旧的 AVA 应用壳会改为显示更新消息。 恢复进行期间不要再次点击该操作。

结果含义操作
Notification registration updated通知注册已成功刷新使用此设备的 Test
Notifications partially recovered标准通知已更新，但 iOS 来电注册不可用更新应用，然后重试恢复
Recovery result unavailable应用未返回结果使用 Test，然后再次尝试恢复
Notifications could not be recovered恢复失败或连接已结束检查连接，然后重试

如果来电或设备测试已经处于活动状态，请先完成它，再开始恢复。

较旧的 AVA 应用版本

较旧的 AVA 移动壳会忽略新的声音消息。 Alarm Devices 页面仍可使用，但声音控件可能不会显示。

重新安装应用后恢复 iOS 配对​

在 iPhone 或 iPad 上重新安装 AVA 后，请使用同一个 Streamliner 帐户。

  1. 在 AVA 移动壳内打开 Streamliner。

  2. 登录拥有之前配对的 Streamliner 帐户。

  3. 前往 Communication Hub → Video Calls → Alarm Devices。

  4. 确认现有设备标签和酒店报警设置。

  5. 发送测试报警。

    ✓ 现有配对会在不添加重复设备的情况下恢复。 ✓ 设备会使用刷新后的注册凭据。

如果无法匹配之前的配对，AVA 会让设备保持未配对状态。 选择 Pair this AVA device，以明确创建新的配对。

将班次路由至已配对帐户​

  1. 打开视频通话排班编辑器。

  2. 为该班次添加或编辑员工。

  3. 选择 Paired Streamliner account。

  4. 选择员工帐户。

  5. 保存排班。

    ✓ 来电会在与该 Streamliner 帐户配对的所有活跃设备上响铃。

仅当员工有活跃的帐户绑定时，才会显示已配对帐户选项。 报警代码排班已不再提供。

每周排班路由

启用的每周排班表控制向值班 Streamliner 帐户发送浏览器来电。 此 Alarm 设置控制可选的原生投递，不会添加非值班的浏览器接收人。

在应用中注册设备​

新设备不再使用 QR 或报警代码注册。 请在 AVA 移动壳内打开 Streamliner，并使用帐户配对。 如果你正在按照旧版设置指南操作并看到此标题，请参考本节。

重命名或清除设备名称​

以后需要更改标签时，请使用编辑弹窗。 将字段留空即可清除已存储的名称。

  1. 在 Vouch AVA Alarm Integration 中找到已连接设备表

  2. 点击要修改的已配对设备对应的 Edit device

  3. 更新 Device name 字段

  4. 点击 Save

    ✓ 表格会更新为新名称。 ✓ 如果留空，表格会显示破折号。

选择报警通知​

  1. 在 Vouch AVA Alarm Integration 中打开 Notification preferences

  2. 开启你希望在移动设备上接收的视频通话提醒

  3. 点击 Save notification settings

    ✓ 来电提醒现在会按照你选择的偏好触发。 ✓ 已配对设备仍会绑定到注册它的 Streamliner 用户。

发送测试报警​

  1. 打开 Vouch AVA Alarm Integration

  2. 找到要检查的已配对设备

  3. 使用该设备的测试操作

  4. 查看每种投递方式的结果

  5. 确认提醒已到达已配对设备

    ✓ 兼容的 iPhone 会分别显示标准推送和 VoIP 的结果。 ✓ 较旧的 iPhone 和 Android 设备会显示标准推送结果。 ✓ 已接受的结果表示服务提供商已接受请求。

测试不会创建视频通话活动或媒体房间。 它使用短时有效的测试通话标签，并在 20 秒后过期。 服务提供商接受请求并不能证明手机已接收或显示提醒。

查看测试结果​

发送测试后，分别查看每种传输方式的结果。

结果含义操作
Accepted服务提供商已接受测试请求。检查设备是否收到提醒并响铃。
Failed服务提供商拒绝了投递。按显示的原因处理，然后再次测试。
Skipped该传输方式不可用或不受支持。按显示的原因处理，或使用标准推送。

常见原因包括：

  • Alarm is disabled：为此设备或酒店启用报警。
  • Standard push token unavailable：打开 AVA 应用并允许通知。
  • Update and open the iPhone app：更新应用，然后打开一次。
  • VoIP dispatch is disabled：iPhone 尚未准备好进行后台 VoIP 测试。
  • VoIP destination unavailable：iPhone 没有可用的 VoIP 测试目标。

iPhone 可能显示标准测试失败、VoIP 测试已接受。 这表示 VoIP 请求已被接受，但标准推送仍需处理。

较旧的 Core 响应可能只显示一个合并的已接受结果。 仍请检查设备，因为请求被接受不等于设备已收到提醒。

取消设备配对​

当手机更换员工所有权或不再需要报警时，请取消设备配对。 取消配对会将该设备从帐户的活跃报警目标中移除。

  1. 在 Vouch AVA Alarm Integration 中找到已配对设备

  2. 点击 Unpair 或 Remove device

  3. 确认操作

    ✓ 该设备不再显示为活跃的已配对设备。 ✓ 它不再接收酒店报警测试或来电视频通话报警。

取消配对前

取消配对不会移除与该帐户配对的其他设备。 请先将手机与正确的帐户配对，再将其用于其他员工。

故障排查​

报警设置不可用​

你会看到： 你可以打开 Video Calls，但报警设置或配对操作不可用。

解决方法：

  1. 请管理员打开 Superadmin → Permissions → Roles。

  2. 为你的角色授予 video_call:device_pairing:manage。

  3. 角色变更后刷新 AVA。

  4. 重新打开 Communication Hub → Video Calls → Alarm Devices。

    ✓ 报警配置和设备配对操作会与自己的角色权限相匹配。

通用的设置权限不能替代专用的设备配对权限。

你会看到： QR 弹窗会打开，但商店页面没有加载。

解决方法：

  1. 关闭弹窗并重新打开正确的平台卡片
  2. 点击弹窗中的直接商店链接
  3. 确认你为设备选择了正确的平台
  4. 在网络正常的设备上重试

新设备无法配对​

你会看到： 你无法为新设备创建代码，也找不到 QR 配对功能。

解决方法：

  1. 在 AVA 移动壳内打开 Streamliner

  2. 前往 Communication Hub → Video Calls → Alarm Devices

  3. 使用 Pair this AVA device

  4. 确认配对，并启用 Receive incoming-call alarms for this property

    ✓ 新设备使用帐户配对，而不是报警代码或 QR 配对。

登录未创建报警设备​

你会看到： 你登录 AVA，但 Streamliner 中没有显示新的报警设备。

解决方法：

仅登录不会配对报警设备。 新设备必须在 AVA 移动壳内使用帐户配对。

  1. 打开 Communication Hub → Video Calls → Alarm Devices

  2. 启用 Enable Vouch AVA Alarm

  3. 在 AVA 移动壳内打开 Streamliner

  4. 使用 Pair this AVA device 并确认配对

  5. 确认设备显示在已配对帐户控件中

    ✓ 完成帐户配对后，设备会显示出来。

如果找不到设备，请先将它与已登录的 Streamliner 帐户配对，再检查通知设置。

缺少帐户配对​

你会看到： Pair this AVA device 卡片没有显示。

解决方法：

  1. 从 AVA 应用内打开 Streamliner。
  2. 确认你已登录正确的 Streamliner 帐户。
  3. 返回 Alarm Devices。
  4. 刷新页面并重试。

声音操作缺失​

你会看到： 你看不到 Current sound 或 Change sound。

解决方法：

  1. 确认你在 AVA 移动壳内打开了 Streamliner。

  2. 确认此手机显示 This device is paired。

  3. 如果配对状态显示为 Paused，请重新登录。

  4. 刷新 Alarm Devices。

  5. 如果控件仍未显示，请更新 AVA 应用。

    ✓ 当前手机完成活跃配对后，声音控件会显示。

通知未到达​

你会看到： 已配对手机漏掉设备测试或来电视频通话提醒。

解决方法：

  1. 确认手机显示 This device is paired。

  2. 检查 Receive incoming-call alarms for this property 已开启。

  3. 在 Change sound 下方选择 Recover notifications。

  4. 等待结果后再开始下一次恢复。

  5. 为此设备选择 Test。

  6. 检查手机的通知权限和音量。

    ✓ 测试结果会显示服务提供商是否接受了每种可用的投递方式。

如果缺少恢复操作，请更新 AVA 应用。 如果 iOS 恢复报告部分结果，请更新应用并重试。 如果测试已接受但没有出现提醒，请携带结果联系支持人员。

重新安装后 iOS 配对未恢复​

你会看到： 重新安装 AVA 后，之前的 iOS 设备没有显示。

解决方法：

  1. 使用拥有之前配对的同一个 Streamliner 帐户登录。

  2. 在 AVA 应用内打开 Communication Hub → Video Calls → Alarm Devices。

  3. 确认 iPhone 或 iPad 使用预期的 AVA 应用包和环境。

  4. 刷新页面并检查已配对设备卡片。

  5. 如果没有显示配对，请选择 Pair this AVA device。

  6. 开启 Receive incoming-call alarms for this property。

  7. 发送测试报警。

    ✓ 匹配的配对会被恢复，或你可以明确创建一个配对。 ✓ 设备表只包含你打算使用的配对。

恢复处理期间不要反复重新安装或配对。 如果仍有重复设备，请先联系支持人员，再移除任何配对。

所选声音未更新​

你会看到： 手机使用了新声音，但 Streamliner 显示之前的名称。

解决方法：

  1. 更改原生声音设置后返回 AVA 应用。

  2. 重新打开 Communication Hub → Video Calls → Alarm Devices。

  3. 刷新页面。

  4. 确认手机仍显示 This device is paired。

    ✓ Current sound 会显示手机报告的最新声音。

手机已与其他帐户配对​

你会看到： “This AVA device is paired with a different Streamliner account.”

解决方法：

  1. 确认已登录帐户应拥有此设备。
  2. 选择 Pair this device to this account。
  3. 选择 Confirm pairing。
  4. 检查报警偏好和设备标签。

设备名称没有更改​

你会看到： 你保存了新标签，但表格仍显示旧名称。

解决方法：

  1. 重新打开 Edit device
  2. 检查 Device name 字段是否包含新文本
  3. 再次点击 Save
  4. 如果表格仍显示旧内容，请刷新页面

测试报警没有到达​

你会看到： Streamliner 显示测试已发送，但设备上没有任何内容。

解决方法：

  1. 确认 Enable Vouch AVA Alarm 已启用
  2. 确认设备显示已配对状态
  3. 检查设备音量和通知设置
  4. 再次发送测试报警

来电视频通话不会触发报警​

你会看到： 浏览器提醒正常，但新来电不会触发报警。

解决方法：

  1. 打开 Vouch AVA Alarm Integration
  2. 确认来电通知偏好已启用
  3. 确认酒店仍启用了集成，尤其是在停用 Night Shift 后
  4. 检查已配对设备是否已断开连接

iOS 投递不可用​

你会看到： 更新后的 iPhone 或 iPad 报告来电投递不可用。

解决方法：

  1. 确认 iPhone 或 iPad 上的 AVA 应用已更新。

  2. 打开设备设置并允许 AVA 发送通知。

  3. 在 AVA 移动壳内打开 Streamliner。

  4. 确认设备仍显示 This device is paired。

  5. 开启 Receive incoming-call alarms for this property。

  6. 从 Alarm Devices 发送测试报警。

    ✓ 设备应通过可用的推送方式接收测试报警。

较旧的 iOS 应用版本

较旧的 iOS 应用继续通过标准推送投递接收来电。 在应用支持之前，它们不会使用后台 VoIP 投递。

如果完成这些检查后投递仍不可用，请联系 Vouch 支持人员检查设备注册情况。

已配对帐户收不到来电​

你会看到： 排班指向已配对帐户，但没有 AVA 设备响铃。

解决方法：

  1. 在 AVA 移动壳内打开 Alarm Devices。

  2. 确认卡片显示正确的已登录帐户。

  3. 开启 Receive incoming-call alarms for this property。

  4. 如果卡片显示设备已暂停，请重新登录。

  5. 确认员工仍有活跃的已配对 AVA 设备。

  6. 配对恢复活跃后，再次保存排班。

    ✓ 员工选择器会显示活跃的已配对设备。 ✓ 该员工班次期间的来电会使用已配对帐户目标。

仍然无法解决？​

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

  • ❌ 新设备仍无法通过 AVA 移动壳配对
  • ❌ 测试报警没有到达设备
  • ❌ 30 分钟后，来电视频通话仍不会触发报警

建议提供：

  • 集成区域的屏幕截图
  • 设备配对状态的屏幕截图
  • 问题开始的时间