跳到主要内容

设置推送通知

快速开始

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

本指南帮助你为当前酒店开启推送通知。 页面使用折叠分类、手风琴卡片和一个固定的保存按钮。 在移动端，设置说明会显示在每个表单下方，保存栏也会避开最后一个字段。 你可以将提醒路由到 Slack、Google Chat、Telegram 或 Zapier。 AVA 还会发送入住里程碑提醒和房态就绪提醒。 共享渠道提醒会在消息详情中包含你的酒店名称。 AVA 现在会在所有匹配的通知标题前添加相同的 emoji 前缀。 展开 Check-in 和 Check-out 可微调提醒子类型。

Vouch AVA Alarm

此页面用于浏览器提醒和渠道路由。 对于已配对的报警设备，请使用 设置 Vouch AVA Alarm。 你也可以在那里添加或重命名设备名称。

房卡编码提醒

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

当前酒店

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

通知链接

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

推送可靠性

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

位置​

Settings → Customizations → Push Notifications

快速参考​

设置项控制内容影响对象
Enable Push Notifications当前酒店和此设备的浏览器提醒此设备上的员工
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 notification settings一次保存所有已更改的部分任何正在编辑设置的人

[Update] - 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 会将每个事件分开发送。 这样你就能在通知中心同时看到故障和恢复。

故障排查​

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

现象： 你关闭了 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. 保持 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 链接不可点击​

现象： 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

相关指南​

Keycard heartbeat alerts

如果房卡编码器先离线，随后很快恢复，AVA 会将每个事件分开发送。 这样你就能在通知中心同时看到故障和恢复。

故障排查​

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

现象： 你关闭了 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. 保持 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
Good to know

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

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 链接不可点击​

现象： 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

相关指南​