跳到主要内容

设置推送通知

快速开始

大多数酒店只需要浏览器提醒和一个渠道。此操作大约需要 5 分钟。

本指南帮助你管理当前酒店的推送通知。 页面分为三个层级：酒店层级、用户层级和浏览器层级。 酒店层级决定是否可以发送入住和退房提醒。 用户层级分类决定哪些已获准的提醒会发送到此账户和已配对的 AVA 设备。 浏览器层级控制此浏览器及其订阅。 已配对的 Vouch AVA Alarm 设备使用相同的用户层级分类。 已验证的原生设备可以在你有权访问的每个商户之间保持关联。 页面使用折叠分类、手风琴卡片和一个固定的保存按钮。 在移动端，设置说明会显示在每个表单下方，保存栏也会避开最后一个字段。 你可以将提醒路由到 Slack、Google Chat、Telegram 或 Zapier。 AVA 还会发送入住里程碑提醒和房态就绪提醒。 共享渠道提醒会在消息详情中包含你的酒店名称。 AVA 现在会在所有匹配的通知标题前添加相同的 emoji 前缀。 展开 Check-in 和 Check-out 可微调提醒子类型。 酒店、用户和浏览器的更改都要等到点击 Save notification settings 后才会生效。 如果你关闭父级开关，其子级控件会保持关闭，直到保存设置。 AVA 会记住每个子级选项，并在父级重新开启时恢复这些选项。 用户层级或浏览器层级保存成功后，AVA 会在批量保存完成后显示一次标准的 Settings saved successfully! 提示。 如果权限被拒绝，或任何请求的保存操作失败，则不会显示该提示。

Vouch AVA Alarm

此页面用于管理浏览器提醒、酒店层级的入住和退房发送，以及用户分类。 对于已配对的报警设备，请使用 设置 Vouch AVA Alarm。 你也可以在那里添加或重命名设备名称。

AVA Portal 移动壳层

如果你使用 AVA Portal，移动端会跳过浏览器推送提示。 原生壳层会在登录后注册设备。 它可以接收来电视频通话，以及你启用的入住或退房移动提醒。 浏览器提醒在桌面浏览器中仍然有效。

Streamliner 铃铛提醒

Streamliner 的入住和退房提醒会以柔和横幅的形式推送到 AVA 手机应用。 它们也会更新 Android 和 iPhone 上的应用内铃铛。 这些提醒遵循上面的酒店策略和下面的用户分类。 它们仍会发送到已关联、已注册的设备。

房卡编码提醒

当你编码房卡时，横幅现在会显示房间已就绪。 它不再复用 Key retrieved 的措辞。

当前酒店

此页面跟随你在切换器中选择的酒店。 浏览器提醒和测试通知仍然绑定到该酒店。 外部渠道提醒使用该酒店的商户级设置。

通知链接

当你在 Slack、Google Chat、Telegram 或 Zapier 中打开 Open in Streamliner 时，AVA 会在链接中保留正确的酒店。 这样应该会带你回到收到该提醒的同一酒店。

推送可靠性

当你返回、重新连接，或在浏览器更新后重新加载时，AVA 会刷新你的浏览器订阅。 连续的入住、退房和客房清洁提醒会保持为独立横幅。

查找位置​

Settings → Customizations → Push Notifications

快速参考​

设置项控制内容影响对象
Property level: allow check-in/check-out alerts开启或关闭此酒店的入住和退房提醒发送此酒店的所有人
User level: My browser push notifications选择哪些已获准的提醒发送到此账户和已配对的 AVA 设备使用此设备的员工
Browser level: browser notifications允许此浏览器显示 Streamliner 提醒使用此设备的员工
Browser subscription sync当你返回、重新连接或重新加载时刷新推送订阅此设备上的员工
My browser push notifications按此浏览器折叠分组的分类此设备上的员工
External channel notificationsSlack、Google Chat、Telegram 或 Zapier 的商户级路由这些渠道中的团队
Notification titles浏览器、设置和 Telegram 提醒中的共享 emoji 前缀读取提醒的员工
Operational alert tags将快速入住、退房和客房清洁横幅区分开来接收快速更新的员工
Vouch AVA Alarm Integration将来电视频通话报警发送到已配对的 Android 和 iOS 设备，并存储可选设备名称处理视频通话的员工
Channel integrations每个外发渠道的手风琴卡片酒店管理员
Save confirmation用户层级或浏览器层级保存成功后显示标准成功提示编辑通知设置的员工
AVA Portal mobile shell使用原生壳层接收来电视频通话和 Streamliner 铃铛提醒使用 AVA Portal 的员工
User-level AVA device delivery在所有可访问的商户中，对已配对的 AVA 设备使用相同的分类选项使用此账户的员工
Save notification settings一起保存酒店、用户、浏览器和渠道更改任何正在编辑设置的人

[更新] - 2026-05-16​

  • 为 Vouch AVA Alarm 设备增加了可选的商户专属名称。
  • 当你添加名称后，已连接设备表会在报警代码旁显示该名称。
  • 你之后可以从报警编辑弹窗中重命名该标签。

开始前​

确认以下基本条件：

  • 你已登录到正确的 酒店
  • 你的浏览器允许此网站发送通知
  • 你有正确的 webhook URL（Slack/Google Chat/Zapier）
  • 如果你使用 Telegram，你有 Telegram bot token 和 chat ID
  • 如果你要更改外部渠道，你有权限更新设置

开启浏览器推送通知​

  1. 前往 Settings → Customizations → Push Notifications

  2. 打开 Enable Push Notifications

  3. 如果浏览器提示，点击 Allow

    ✓ 你应该会看到状态变为 Enabled

  4. 在 My browser push notifications 下选择你想接收的提醒

  5. 点击 Save notification settings

了解一下

此开关按酒店范围生效。它只适用于当前酒店和此设备。

选择要接收的浏览器提醒​

当你只想更改自己浏览器的提醒时，请使用 My browser push notifications。

  1. 前往 Settings → Customizations → Push Notifications
  2. 找到 My browser push notifications
  3. 打开或关闭分类
  4. 对于 Check-in 和 Check-out，展开分类并选择具体提醒类型
  5. 点击 Save notification settings
了解一下

这些设置不会影响 Slack、Google Chat、Telegram 或 Zapier。 这些渠道请使用 External channel notifications。 关闭父级分类也会同时关闭其所有子类型。

发送测试浏览器通知​

  1. 在 Push Notifications 中滚动到 Test Notification

  2. 点击 Send Test Notification

    ✓ 几秒内你应该会在设备上看到测试提醒

了解一下

每条测试通知都会作为一条全新的提醒发送。 如果你再次点击 Send Test Notification，应该会看到新的通知。

通知语言

你的浏览器推送通知会遵循此设备上的 Streamliner 语言。 如果你之后更改语言，请先关闭再重新打开推送通知以更新它。

选择要发送的外部渠道提醒​

当你想控制发送到 Slack、Google Chat、Telegram 或 Zapier 的提醒时，请使用 External channel notifications。

  1. 前往 Settings → Customizations → Push Notifications
  2. 找到 External channel notifications
  3. 打开或关闭分类
  4. 对于 Check-in 和 Check-out，展开分类并打开或关闭具体提醒类型
  5. 点击 Save notification settings
商户级设置

外部渠道设置适用于整个酒店。 如果你关闭 Checkout started，所有已连接的外部渠道都会停止接收该提醒。

需要权限

你需要设置权限才能更改 External channel notifications。 没有这项权限时，你仍然可以更改自己的浏览器提醒。

打开渠道集成​

AVA 门户

Telegram 的设置在 AVA 门户 中完成。 当你添加 bot token 和 chat ID 时，请使用以下步骤。

共享提醒标题

Telegram 使用从 Streamliner 接收到的标题。 这样可以让浏览器提醒和外部渠道保持相同的 emoji 前缀。

每个集成都会作为独立的手风琴卡片展开。 当你需要一次配置一个渠道时，请使用它。

单个 Webhook（简单）​

将所有已启用分类发送到同一个渠道。

  1. 选择你的平台（例如 Slack）

  2. 粘贴 Webhook URL

  3. 打开 Enable Integration

    ✓ 你应该会看到集成状态显示为 Enabled

按分类的 Webhook（高级）​

将提醒路由到不同渠道（例如：Alerts → #it-support）。

  1. 打开 Use specific webhooks for different categories
  2. 为每个分类输入一个 URL
  3. 将某个分类留空即可使用默认 URL

Telegram​

使用酒店自有的 bot 和一个或多个目标聊天来设置 Telegram。

  1. 选择 Telegram
  2. 粘贴 Bot token
  3. 输入 Chat ID
  4. 选择 Same chat for all notifications 或 Different chats per category
  5. 如有需要，在 Category-Specific Chats 下添加分类覆盖
  6. 打开 Enable Telegram
  7. 点击 Save notification settings
了解一下

已保存的 bot token 会显示为 *****。 只有当你想替换现有 token 时，才点击 Edit token。

Chat ID 格式

公开聊天请使用 @channelusername。 私密群组或频道请使用数字 chat ID。 如果聊天是私密的，Telegram 会在 getUpdates 中显示该数字。

路由行为

在 Same chat for all notifications 中，所有提醒都会使用默认 Chat ID。 在 Different chats per category 中，没有覆盖设置的分类仍会使用默认 Chat ID。

Telegram 链接行为

Telegram 会将公开的 https:// 链接设为可点击。 本地、Docker 或内部 URL 会保持为纯文本，以确保传递正常。

支持的通知分类​

分类触发条件
Check-in住客开始、完成、失败或通过关键步骤的入住流程
Checkout住客开始退房、查看账单、付款、完成或失败
Housekeeping房态更新（Clean/Dirty/Inspected）
Keycard Heartbeat编码器连接失败和恢复通知
Alert系统错误、支付失败或身份证核验审核
Generic常规系统通知
房卡门禁提醒

Smart-lock PIN 和 locker code 会在 Check-in 下使用 Room access ready。 你不需要新增通知分类。

入住和退房提醒类型​

分类提醒类型示例
Check-inCheck-in started住客开始在线入住
Check-inDocument uploaded住客上传身份文件
Check-inIdentity verified住客通过身份验证
Check-inRoom assigned入住时分配了房间
Check-inPayment completed完成付款或押金步骤
Check-inKeycard encoded物理房卡已就绪，房间也已就绪
Check-inKey retrieved数字钥匙已就绪
Check-inRoom access readySmart-lock PIN 或 locker code 已就绪
Check-inCheck-in completed / Check-in issue入住已完成或失败
CheckoutCheckout started住客开始退房
CheckoutBill viewed / Bill settled住客查看或结清账单
CheckoutCheckout payment completed退房付款已完成
CheckoutCheckout completed / Checkout issue退房已完成或失败
恢复提醒

如果门锁问题在后续重试中得到修复，AVA 会发送后续进度提醒。 你可能会在之前的 Check-in issue 提醒之后看到 Key retrieved 或 Check-in completed。

手动退房提醒

当员工手动完成退房时，AVA 会发送相同的 Check-out 提醒。 如果某个渠道投递失败，退房仍会继续完成。

预订查询阻止

当 AVA 在查询期间将住客转交前台审核时，会发送 Check-in issue 提醒。 这包括自助终端、余额、账单、零晚数和长期住宿阻止。 提醒标题会标识失败步骤，例如 Check-in issue at Entry。 消息会以便于员工理解的语言说明预订为何被阻止。 Google Chat 卡片会显示 Status: FAILED，而不是该步骤的 in_progress 状态。 住客在 Entry 成功抵达时仍使用正常的抵达提醒。 打开 Command Center → View Details 查看失败的查询事件。

房卡心跳提醒

如果房卡编码器先离线，随后很快恢复，AVA 会将每个事件分开发送。 这样你就能在通知中心同时看到故障和恢复。 Google Chat 及其他员工提醒会包含具体的编码器失败原因，便于更快排查。 例如，AVA 会区分 No card detected、Unsupported card type 和 Card could not be read。 请使用房卡编码器故障排除查找对应修复方法。

故障排查​

关闭后推送通知一直保持关闭​

现象： 你关闭了 Enable Push Notifications，它不会自己重新打开。

解决方法：

  1. 前往 Settings → Customizations → Push Notifications
  2. 重新打开 Enable Push Notifications
  3. 点击 Save notification settings
原因说明

此开关按酒店和设备保存。只有你再次打开后才会生效。

刷新后推送通知又重新开启​

现象： 你禁用了推送通知，刷新后却又显示为开启。

解决方法：

  1. 确认你在正确的 酒店
  2. 再次关闭 Enable Push Notifications
  3. 保持此浏览器打开几秒，让更改保存
原因说明

如果站点数据被清除，或者你切换了酒店，可能需要再次禁用它。

没有出现浏览器通知​

现象： 开关已开启，但没有任何提醒显示。

解决方法：

  1. 检查此网站在浏览器中的通知权限
  2. 点击 Send Test Notification
  3. 确保你在同一台设备上登录
原因说明

AVA 可能需要一点时间，在你返回或重新连接后刷新浏览器订阅。 如果浏览器更改了推送订阅，通常下一个可见标签页会恢复它。

不发送入住和退房提醒​

现象： 浏览器提醒正常，但入住或退房提醒始终未到达。

解决方法：

  1. 前往 Settings → Customizations → Push Notifications
  2. 打开 Property level: allow check-in/check-out alerts
  3. 确认 My browser push notifications 下所需项目仍处于开启状态
  4. 如果你使用已配对的 AVA 设备，确认设备已连接到 Set Up Vouch AVA Alarm
原因说明

酒店层级控件会阻止该酒店所有人的入住和退房提醒发送。 只有酒店允许这些提醒后，用户分类才会生效。 如果父级开关关闭，即使保存的选项仍在，子级控件也可能看起来是关闭的。

关闭父级后子级通知看起来关闭​

现象： 你关闭父级开关后，子级分类也显示为关闭。

解决方法：

  1. 重新打开父级开关
  2. 检查你需要的子级分类
  3. 点击 Save notification settings
原因说明

父级开关阻止发送时，AVA 会将子级控件显示为实际关闭。 重新启用父级后，你保存的子级选项仍然可用。

连续提醒合并成一个横幅​

现象： 多个住客事件在短时间内发生，但你只看到一条浏览器提醒。

解决方法：

  1. 保持 Enable Push Notifications 开启
  2. 等几秒，让页面重新同步
  3. 在浏览器通知中心查看是否有遗漏的提醒
  4. 点击 Send Test Notification
原因说明

AVA 现在会对接近到达的推送消息进行排队。 入住、退房和客房清洁提醒也会保持独立标签。

通知显示了错误的语言​

现象： 提醒显示的语言和你的 Streamliner 页面不同。

解决方法：

  1. 使用语言下拉菜单更改你的 Streamliner 语言，例如 EN。
  2. 前往 Settings → Customizations → Push Notifications
  3. 先关闭再打开 Enable Push Notifications
  4. 点击 Save notification settings
  5. 点击 Send Test Notification
了解一下

每台设备都可以有自己的通知语言。

Webhook 消息没有出现​

现象： 浏览器提醒正常，但 Slack/Chat 没有消息。

解决方法：

  • 确认完整 URL 以 https:// 开头
  • 重新启用 Enable Integration
  • 在新渠道中尝试发送测试消息

Telegram 仍在发送你已关闭的提醒​

现象： 你的浏览器不接收 Checkout started，但 Telegram 仍然接收。

解决方法：

  1. 前往 Settings → Customizations → Push Notifications
  2. 找到 External channel notifications
  3. 在 Check-out 下关闭 Checkout started
  4. 点击 Save notification settings
原因说明

浏览器提醒和外部渠道提醒使用的是不同设置。 更改 My browser push notifications 只会影响你的浏览器。

Telegram token 仍显示为星号​

现象： 你打开 Telegram 设置后，token 字段里仍显示 *****。

解决方法：

  1. 点击 Edit token
  2. 粘贴新的 bot token
  3. 点击 Save notification settings
原因说明

AVA 会将已存储的 token 隐藏起来。 保存 ***** 会保留现有 token，而不是替换它。

Telegram 消息发到了错误的聊天​

现象： Telegram 提醒已送达，但到了错误的群组或频道。

解决方法：

  1. 打开 Settings → Customizations → Push Notifications
  2. 检查 Telegram Routing 设置
  3. 确认 Chat ID 正确
  4. 添加或更新匹配的分类覆盖
  5. 点击 Save notification settings
原因说明

如果没有分类覆盖，Telegram 会使用默认聊天。

现象： Telegram 提醒显示了 URL，但不是可点击链接。

解决方法：

  1. 检查该 URL 是否是公开地址并以 https:// 开头
  2. 对于内部或 Docker 地址，改用纯 URL
  3. 确认消息仍然成功发送
原因说明

Telegram 只会为公开的 HTTPS 地址创建可点击链接。 内部 URL 会保留为纯文本，以避免投递错误。

无法保存外部渠道设置​

现象： 浏览器提醒设置可以保存，但外部渠道设置报错。

解决方法：

  1. 请管理员确认你拥有设置权限
  2. 刷新页面
  3. 再次尝试修改 External channel notifications

现象： 你从 Slack、Google Chat、Telegram 或 Zapier 中点击 Open in Streamliner 后，AVA 打开了另一家酒店。

解决方法：

  1. 使用正确的账号登录 AVA
  2. 返回原始提醒消息
  3. 如果你在另一个标签页切换了酒店，请刷新 AVA
原因说明

外部渠道链接包含了提醒中的酒店信息。 旧的浏览器会话仍可能指向另一家酒店。

仍然卡住？​

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

  • ❌ 按上述步骤操作后，通知仍然缺失
  • ❌ 设置中反复出现错误横幅
  • ❌ 问题持续超过 30 分钟

建议附上：

  • 设置页面截图
  • 酒店名称
  • 问题开始的时间
  • 受影响的渠道，例如 Telegram 或 Slack