设置推送通知
大多数酒店只需要浏览器提醒和一个渠道。此操作大约需要 5 分钟。
本指南帮助你管理当前酒店的推送通知。 页面分为三个层级:酒店层级、用户层级和浏览器层级。 酒店层级决定是否可以发送入住和退房提醒。 用户层级分类决定哪些已获准的提醒会发送到此账户和已配对的 AVA 设备。 浏览器层级控制此浏览器及其订阅。 已配对的 Vouch AVA Alarm 设备使用相同的用户层级分类。 已验证的原生设备可以在你有权访问的每个商户之间保持关联。 页面使用可折叠的分类、手风琴卡片和一个固定显示的保存按钮。 在移动端,设置说明会显示在每个表单下方,保存栏也会避开最后一个字段。 你可以将提醒路由到 Slack、Google Chat、Telegram 或 Zapier。 视频通话提醒可以在每个外部渠道中发送到专用目标位置。 AVA 还会发送入住里程碑提醒和房态就绪提醒。 当住客在 AI 视频通话中请求员工时,提醒会显示 Staff assistance requested。 提醒内容为 A guest is waiting for hotel staff。 AI 监控提醒可能会在人工接管前以静默方式出现。 当住客需要人工协助时,Staff assistance requested 提醒会响铃。 普通的转接员工通话到达时仍会响铃。 共享渠道提醒会在消息详情中包含你的酒店名称。 AVA 现在会在所有匹配的通知标题前添加相同的 emoji 前缀。 展开 Check-in 和 Check-out 可微调提醒子类型。 酒店、用户和浏览器的更改都要等到点击 Save notification settings 后才会生效。 如果你关闭父级开关,其子级控件会保持关闭,直到保存设置。 AVA 会记住每个子级选项,并在父级重新开启时恢复这些选项。 用户层级或浏览器层级保存成功后,AVA 会在批量保存完成后显示一次标准的 Settings saved successfully! 提示。 如果权限被拒绝,或任何请求的保存操作失败,则不会显示该提示。
如果你使用 AVA Portal,移动端会跳过浏览器推送提示。 原生壳层会在登录后注册设备。 它可以接收来电视频通话,以及符合酒店策略的入住或退房提醒。 浏览器提醒在桌面浏览器中仍然有效。
Streamliner 的入住和退房提醒会以不打扰用户的横幅形式推送到 AVA 手机应用。 它们也会更新 Android 和 iPhone 上的应用内铃铛。 这些提醒遵循上文的酒店策略和下文的用户分类设置。 它们仍会发送到已关联、已注册的设备。
此页面用于管理浏览器提醒、酒店层级的入住和退房发送,以及用户分类。 对于已配对的报警设备,请使用 设置 Vouch AVA Alarm。 你也可以在那里添加或重命名设备名称。
如果你管理多家酒店,一个已验证的 AVA 安装可以在这些酒店之间保持关联。 这样无需逐家切换酒店,原生通知偏好也能继续生效。
Google Chat 中的编码器提醒会使用酒店员工易懂的语言。 提醒会说明房卡当前是否可用,并列出下一步操作。 简要故障提醒会说明编码器已恢复,仍然可以制作房卡。 发生中断时,提醒会要求你检查电源和线缆,然后重启 Encoder Agent。 提醒还会说明何时应在前台发卡,或联系 Vouch 支持。 提醒时间使用酒店的本地时区。 斜体的 For Vouch support 页脚会保留用于故障排查的技术细节。
当你编码房卡时,横幅现在会显示房间已就绪。 它不再复用 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 | 当你点击 Save notification settings 时刷新推送订阅 | 此设备上的员工 |
| Save confirmation | 用户层级或浏览器层级保存成功后显示标准成功提示 | 编辑通知设置的员工 |
| AVA Portal mobile shell | 使用原生壳层接收来电视频通话和 Streamliner 铃铛提醒 | 使用 AVA Portal 的员工 |
| User-level AVA device delivery | 在所有可访问的商户中,对已配对的 AVA 设备使用相同的分类选项 | 使用此账户的员工 |
| Live Chat alerts | 将支持请求和分配聊天提醒发送到你的浏览器和已配对的 AVA 应用 | 处理 Live Chat 的员工 |
| External channel notifications | Slack、Google Chat、Telegram 或 Zapier 的商户级路由 | 这些渠道中的团队 |
| External Video Call | 启用或静音外部渠道中的来电提醒 | 处理住客通话的团队 |
| Video-call destination | 将视频通话提醒发送到特定渠道的目标位置 | 处理住客通话的员工 |
| Notification titles | 浏览器、设置和 Telegram 提醒中的共享 emoji 前缀 | 读取提醒的员工 |
| Operational alert tags | 将快速入住、退房和客房清洁横幅区分开来 | 接收快速更新的员工 |
| Vouch AVA Alarm Integration | 将来电视频通话报警发送到已配对的 Android 和 iOS 设备,并存储可选设备名称 | 处理视频通话的员工 |
| Channel integrations | 每个外发渠道的手风琴卡片 | 酒店管理员 |
| Save notification settings | 一起保存酒店、用户、浏览器和渠道更改 | 任何正在编辑设置的人 |
[更新] - 2026-05-16
- 为 Vouch AVA Alarm 设备增加了可选的商户专属名称。
- 已连接设备表会在现有报警设备链接旁显示该名称。
- 你之后可以从报警设备编辑弹窗中重命名该标签。
开始前
确认以下基本条件:
- 你已登录到正确的 酒店
- 你的浏览器允许此网站发送通知
- 你有正确的 webhook URL(Slack/Google Chat/Zapier)
- 如果你使用 Telegram,你有 Telegram bot token 和 chat ID
- 如果你要更改外部渠道,你有权限更新设置
开启浏览器推送通知
-
在 Browser level: browser notifications 下打开开关
-
如果浏览器提示,点击 Allow
✓ 你应该会看到状态变为 Enabled
-
在 My browser push notifications 下选择你想接收的提醒
-
点击 Save notification settings
此开关按浏览器范围生效。它只适用于当前浏览器和酒店。 即使父级开关关闭,用户选择也会单独保存。
选择要接收的浏览器提醒
当你只想更改自己浏览器的提醒时,请使用 My browser push notifications。
- 前往 Settings → Customizations → Push Notifications
- 找到 My browser push notifications
- 打开或关闭分类
- 对于 Check-in 和 Check-out,展开分类并选择具体提醒类型
- 点击 Save notification settings
这些设置不会影响 Slack、Google Chat、Telegram 或 Zapier。 这些渠道请使用 External channel notifications。 关闭父级分类也会同时关闭其所有子类型。 用户分类在酒店允许提醒时也适用于已配对的 AVA 设备。 如果父级分类关闭,子级选择仍会保存,但在重新启用父级前会显示为关闭。 使用 Save notification settings 一起应用完整层级。
允许 Live Chat 提醒
Live Chat 提醒使用你的用户层级偏好,发送到浏览器和已配对的 AVA 应用。 即使没有浏览器订阅,你也可以启用这些提醒。
-
打开 Live Chat。
-
打开 Personal Settings。
-
为新的支持工单打开 Incoming Support Requests。
-
为分配给你的聊天消息打开 Assigned Chat Activity。
-
点击 Apply settings。
✓ 保存的选项会应用到你的浏览器和已配对的 AVA 应用。 ✓ 即使浏览器推送不可用,你仍然可以保存这些设置。
酒店的入住和退房开关不会控制 Live Chat 提醒。 来电设置也不会控制这些提醒。 关闭任一 Live Chat 设置,即可仅静音对应的提醒类型。
发送测试浏览器通知
-
在 Push Notifications 中滚动到 Test Notification
-
点击 Send Test Notification
✓ 几秒内你应该会在设备上看到测试提醒
每条测试通知都会作为一条全新的提醒发送。 如果你再次点击 Send Test Notification,应该会看到新的通知。
你的浏览器推送通知会遵循此设备上的 Streamliner 语言。 如果你之后更改语言,请先关闭再重新打开推送通知以更新它。
选择要发送的外部渠道提醒
当你想控制发送到 Slack、Google Chat、Telegram 或 Zapier 的提醒时,请使用 External channel notifications。
- 前往 Settings → Customizations → Push Notifications
- 找到 External channel notifications
- 打开或关闭分类
- 对于 Check-in 和 Check-out,展开分类并打开或关闭具体提醒类型
- 展开 Video Call,控制该分类和 Incoming call 提醒
- 点击 Save notification settings
外部渠道设置适用于整个酒店。 如果你关闭 Checkout started,所有已连接的外部渠道都会停止接收该提醒。
酒店、用户、浏览器和外部渠道的更改都要等到点击 Save notification settings 后才会生效。 在点击保存按钮前,任何更改都不会应用。
你需要设置权限才能更改 External channel notifications。 没有这项权限时,你仍然可以更改自己的浏览器提醒。
控制外部视频通话提醒
使用 External channel notifications 决定住客来电提醒是否发送到已连接的渠道。
- 打开 Settings → Customizations → Push Notifications
- 找到 External channel notifications
- 打开或关闭 Video Call
- 展开 Video Call events
- 打开或关闭 Incoming call
- 点击 Save notification settings
✓ 保存的选择适用于 Slack、Google Chat、Zapier 和 Telegram。
外部 Video Call 设置适用于整个酒店。 它们不会更改你的个人浏览器或 AVA 设备偏好。 个人 Video Call 控件仍会隐藏在个人通知列表中。
打开渠道集成
Telegram 的设置在 AVA 门户 中完成。 当你添加 bot token 和 chat ID 时,请使用以下步骤。
Telegram 使用从 Streamliner 接收到的标题。 这样可以让浏览器提醒和外部渠道保持相同的 emoji 前缀。
每个集成都会作为独立的手风琴卡片展开。 当你需要一次配置一个渠道时,请使用它。
单个 Webhook(简单)
将所有已启用分类发送到同一个渠道。
-
选择你的平台(例如 Slack)
-
粘贴 Webhook URL
-
打开 Enable Integration
✓ 你应该会看到集成状态显示为 Enabled
按分类的 Webhook(高级)
将提醒路由到不同渠道(例如:Alerts → #it-support)。
- 选择 Different webhooks per category
- 点击 Add category override
- 选择 Video Call 或其他通知分类
- 输入目标 URL
- 不为某个分类添加覆盖,即可使用 Default Webhook
选择 Video Call,即可将来电和后续通话事件提醒发送到专用目标位置。 外部 Video Call 偏好决定是否发送来电提醒。 个人通知类型开关不会控制这些外部提醒。 现有通话控件仍位于视频通话设置下。
Telegram
使用酒店自有的 bot 和一个或多个目标聊天来设置 Telegram。
- 选择 Telegram
- 粘贴 Bot token
- 输入 Chat ID
- 选择 Same chat for all notifications 或 Different chats per category
- 如有需要,在 Category-Specific Chats 下添加分类覆盖
- 打开 Enable Telegram
- 点击 Save notification settings
已保存的 bot token 会显示为 *****。
只有当你想替换现有 token 时,才点击 Edit token。
公开聊天请使用 @channelusername。
私密群组或频道请使用数字 chat ID。
如果聊天是私密的,Telegram 会在 getUpdates 中显示该数字。
在 Same chat for all notifications 中,所有提醒都会使用默认 Chat ID。 在 Different chats per category 中,没有覆盖设置的分类仍会使用默认 Chat ID。
将视频通话提醒路由到专用目标位置
当住客通话应发送到单独的 Slack 频道、Google Chat 空间、Zap 或 Telegram 聊天时,请使用此设置。
- 打开 Settings → Customizations → Push Notifications
- 打开要配置的集成。
- 选择 Different webhooks per category 或 Different chats per category。
- 点击 Add category override。
- 选择 Video Call。
- 输入目标 URL 或 Telegram Chat ID。
- 点击 Save notification settings。
✓ 配置后,视频通话提醒会使用专用目标位置。
没有 Video Call 覆盖时,提醒会使用集成的默认目标位置。 通用覆盖不会重定向视频通话提醒。 路由不会取代外部 Video Call 或 Incoming call 控件。
Telegram 会将公开的 https:// 链接设为可点击。
本地、Docker 或内部 URL 会保持为纯文本,以确保传递正常。
支持的通知分类
| 分类 | 触发条件 |
|---|---|
| Check-in | 住客开始、完成、失败或通过关键步骤的入住流程 |
| Checkout | 住客开始退房、查看账单、付款、完成或失败 |
| Housekeeping | 房态更新(Clean/Dirty/Inspected),如有记录则按房间标识 |
| Keycard Heartbeat | 编码器连接失败和恢复通知 |
| Alert | 系统错误、支付失败或身份证核验审核 |
| Video Call | 来电和后续通话事件 |
| Live Chat | 新支持工单以及分配给你的聊天中的消息 |
| Missing information | 聊天机器人或语音代理主题需要审核酒店文件 |
| Generic | 常规系统通知 |
Smart-lock PIN 和 locker code 会在 Check-in 下使用 Room access ready。 你不需要新增通知分类。 选择入住或房间门禁就绪提醒后,会打开 Command Center → Status。 旅程状态提醒仍会向员工发送有关酒店和预订活动的通知。 指向 Live 的旧提醒链接也会打开 Status。
入住和退房提醒类型
| 分类 | 提醒类型 | 示例 |
|---|---|---|
| Check-in | Check-in started | 住客开始在线入住 |
| Check-in | Document uploaded | 住客上传身份文件 |
| Check-in | Identity verified | 住客通过身份验证 |
| Check-in | Room assigned | 入住时分配了房间 |
| Check-in | Payment completed | 完成付款或押金步骤 |
| Check-in | Keycard encoded | 物理房卡已就绪,房间也已就绪 |
| Check-in | Key retrieved | 数字钥匙已就绪 |
| Check-in | Room access ready | Smart-lock PIN 或 locker code 已就绪 |
| Check-in | Check-in completed / Check-in issue | 入住完成,或被阻止的查询显示问题及原因 |
| Checkout | Checkout started | 住客开始退房 |
| Checkout | Bill viewed / Bill settled | 住客查看或结清账单 |
| Checkout | Checkout payment completed | 退房付款已完成 |
| Checkout | Checkout completed / Checkout issue | 退房已完成或失败 |
当 AVA 收到房间号时,退房提醒会在消息中包含该房间号。 例如,员工可能会看到 Jane started checkout from room 1205。 账单结清和退房完成提醒也会包含房间号。 如果没有房间号,AVA 会保留原有的不含房间号的消息。 退房失败消息保持不变。
如果门锁问题在后续重试中得到修复,AVA 会发送后续进度提醒。 你可能会在之前的 Check-in issue 提醒之后看到 Key retrieved 或 Check-in completed。
当 AVA 在查询期间将住客转交前台审核时,会发送 Check-in issue 提醒。
这包括自助终端、余额、账单、零晚数和长期住宿阻止。
提醒标题会标识失败步骤,例如 Check-in issue at Entry。
消息会以便于员工理解的语言说明预订为何被阻止。
Google Chat 卡片会显示 Status: FAILED,而不是该步骤的 in_progress 状态。
住客在 Entry 成功抵达时仍使用正常的抵达提醒。
打开 Command Center → View Details 查看失败的查询事件。
入住模式标签
实时入住提醒会在标题中标明入住模式。
| 入住模式 | 标题标签 | 入场消息 |
|---|---|---|
| Pre-arrival | [Pre-arrival] | 住客已开始抵达前入住 |
| Self Check-In | [Self check-in] | 住客已到店办理入住 |
| Assisted Check-In | [Assisted check-in] | 住客已到店办理入住 |
该标签会保留在后续里程碑、已完成的行程和入住问题中。 Telegram、Slack 和 Google Chat 也会显示 Check-in mode 详情行。 本地化的浏览器提醒会使用相应的翻译后模式标签。
旧事件或模式未知的事件不会添加标签。 明确设置的自定义通知标题和消息覆盖保持不变。 退房提醒不使用入住模式标签。
当员工从仪表板手动完成退房时,AVA 会发送相同的 Check-out 提醒。 如果两者都有,完成提醒会包含住客姓名和房间号。 例如,员工可能会看到 Jane Doe has checked out from room DV3(2)。 如果预订没有住客姓名,AVA 会显示不带姓名的房间号。 如果没有房间号,AVA 会保留原有的不含房间号的消息。 如果投递到某个渠道失败,退房仍会完成。
如果房卡编码器先离线,随后很快恢复,AVA 会将每个事件分开发送。 这样你就能在通知中心同时看到故障和恢复。 Google Chat 提醒会用员工易懂的语言说明问题。 技术细节会保留在斜体的 For Vouch support 页脚中。 请使用房卡编码器故障排除查找对应修复方法。
故障排查
关闭后推送通知一直保持关闭
现象: 你关闭了浏览器通知开关,它不会自己重新打开。
解决方法:
- 前往 Settings → Customizations → Push Notifications
- 重新打开浏览器通知开关
- 点击 Save notification settings
此开关按酒店和设备保存。只有你再次打开后才会生效。
刷新后推送通知又重新开启
现象: 你禁用了推送通知,刷新后却又显示为开启。
解决方法:
- 确认你在正确的 酒店
- 再次关闭浏览器通知开关
- 保持此浏览器打开几秒,让更改保存
如果站点数据被清除,或者你切换了酒店,可能需要再次禁用它。
没有出现浏览器通知
现象: 开关已开启,但没有任何提醒显示。
解决方法:
- 检查此网站在浏览器中的通知权限
- 点击 Send Test Notification
- 确保你在同一台设备上登录
AVA 可能需要一点时间,在你返回或重新连接后刷新浏览器订阅。 如果浏览器更改了推送订阅,通常下一个可见标签页会恢复它。
不发送入住和退房提醒
现象: 浏览器提醒正常,但入住或退房提醒始终未到达。
解决方法:
- 前往 Settings → Customizations → Push Notifications
- 打开 Property level: allow check-in/check-out alerts
- 确认 My browser push notifications 下所需项目仍处于开启状态
- 如果你使用已配对的 AVA 设备,确认设备已连接到 Set Up Vouch AVA Alarm
酒店层级控件会阻止该酒店所有人的入住和退房提醒发送。 只有酒店允许这些提醒后,用户分类才会生效。 如果父级开关关闭,即使保存的选项仍在,子级控件也可能看起来是关闭的。
Live Chat 提醒没有到达
现象: 工单或分配的消息出现在 Live Chat 中,但没有收到提醒。
解决方法:
- 打开 Live Chat → Personal Settings。
- 打开 Incoming Support Requests 或 Assigned Chat Activity。
- 点击 Apply settings。
- 对于浏览器提醒,启用 Browser level: browser notifications。
- 对于 AVA 应用提醒,确认手机已与你的账户配对。
Live Chat 对两种目标都使用已保存的用户层级开关。 浏览器发送提醒时才需要浏览器权限。 来电以及入住/退房酒店开关不会控制 Live Chat。
关闭父级后子级通知看起来关闭
现象: 你关闭父级开关后,子级分类也显示为关闭。
解决方法:
- 重新打开父级开关
- 检查你需要的子级分类
- 点击 Save notification settings
父级开关阻止发送时,AVA 会将子级控件显示为实际关闭。 重新启用父级后,你保存的子级选项仍然可用。
连续提醒合并成一个横幅
现象: 多个住客事件在短时间内发生,但你只看到一条浏览器提醒。
解决方法:
- 保持浏览器通知开关开启
- 等几秒,让页面重新同步
- 在浏览器通知中心查看是否有遗漏的提醒
- 点击 Send Test Notification
AVA 现在会对接近到达的推送消息进行排队。 入住、退房和客房清洁提醒也会保持独立标签。
通知显示了错误的语言
现象: 提醒显示的语言和你的 Streamliner 页面不同。
解决方法:
- 使用语言下拉菜单更改你的 Streamliner 语言,例如 EN。
- 前往 Settings → Customizations → Push Notifications
- 先关闭再打开浏览器通知开关
- 点击 Save notification settings
- 点击 Send Test Notification
每台设备都可以有自己的通知语言。
Webhook 消息没有出现
现象: 浏览器提醒正常,但 Slack/Chat 没有消息。
解决方法:
- 确认完整 URL 以
https://开头 - 重新启用 Enable Integration
- 在新渠道中尝试发送测试消息
Telegram 仍在发送你已关闭的提醒
现象: 你的浏览器不接收 Checkout started,但 Telegram 仍然接收。
解决方法:
- 前往 Settings → Customizations → Push Notifications
- 找到 External channel notifications
- 在 Check-out 下关闭 Checkout started
- 点击 Save notification settings
浏览器提醒和外部渠道提醒使用的是不同设置。 更改 My browser push notifications 只会影响你的浏览器。
Telegram token 仍显示为星号
现象: 你打开 Telegram 设置后,token 字段里仍显示 *****。
解决方法:
- 点击 Edit token
- 粘贴新的 bot token
- 点击 Save notification settings
AVA 会将已存储的 token 隐藏起来。
保存 ***** 会保留现有 token,而不是替换它。
Telegram 消息发到了错误的聊天
现象: Telegram 提醒已送达,但到了错误的群组或频道。
解决方法:
- 打开 Settings → Customizations → Push Notifications
- 检查 Telegram Routing 设置
- 确认 Chat ID 正确
- 添加或更新匹配的分类覆盖
- 点击 Save notification settings
如果没有分类覆盖,Telegram 会使用默认聊天。
视频通话提醒发到了错误的目标位置
现象: 视频通话提醒到达了默认渠道,而不是专用目标位置。
解决方法:
- 打开 Settings → Customizations → Push Notifications
- 打开受影响的 Slack、Google Chat、Zapier 或 Telegram 集成
- 选择按分类路由的选项
- 确认 Video Call 覆盖中的 URL 或 Chat ID 正确
- 点击 Save notification settings
没有 Video Call 覆盖时,AVA 会使用集成的默认目标位置。 Generic 覆盖不适用于视频通话提醒。
Telegram 链接不可点击
现象: Telegram 提醒显示了 URL,但不是可点击链接。
解决方法:
- 检查该 URL 是否是公开地址并以
https://开头 - 对于内部或 Docker 地址,改用纯 URL
- 确认消息仍然成功发送
Telegram 只会为公开的 HTTPS 地址创建可点击链接。 内部 URL 会保留为纯文本,以避免投递错误。
无法保存外部渠道设置
现象: 浏览器提醒设置可以保存,但外部渠道设置报错。
解决方法:
- 请管理员确认你拥有设置权限
- 刷新页面
- 再次尝试修改 External channel notifications
外部渠道链接打开了错误的酒店
现象: 你从 Slack、Google Chat、Telegram 或 Zapier 中点击 Open in Streamliner 后,AVA 打开了另一家酒店。
解决方法:
- 使用正确的账号登录 AVA
- 返回原始提醒消息
- 如果你在另一个标签页切换了酒店,请刷新 AVA
外部渠道链接包含了提醒中的酒店信息。 旧的浏览器会话仍可能指向另一家酒店。
仍然卡住?
如果出现以下情况,请联系 success@vouch-technologies.com:
- ❌ 按上述步骤操作后,通知仍然缺失
- ❌ 设置中反复出现错误横幅
- ❌ 问题持续超过 30 分钟
建议附上:
- 设置页面截图
- 酒店名称
- 问题开始的时间
- 受影响的渠道,例如 Telegram 或 Slack