Skip to main content

Set Up Push Notifications

Quick Setup

Most hotels only need browser alerts and one channel. This takes about 5 minutes.

This guide helps you manage push notifications for your current property. The page has three layers: property level, user level, and browser level. Property level decides whether check-in and checkout alerts can send at all. User level categories decide which allowed alerts reach this account and paired AVA devices. Browser level controls this browser and its subscription. Paired Vouch AVA Alarm devices use the same user-level categories. Verified native devices can stay linked across every merchant you can access. The page uses collapsed categories, accordion cards, and one sticky save button. On mobile, setup instructions stay below each form, and the save bar stays clear of the last field. You can route alerts to Slack, Google Chat, Telegram, or Zapier. AVA also sends check-in milestone alerts and room-access ready alerts. Shared channel alerts include your hotel name in the message details. AVA now adds the same emoji prefix to matching notification titles everywhere. Expand Check-in and Check-out to fine-tune alert subtypes. Property, user, and browser changes all wait for Save notification settings. If you disable a parent gate, its child controls stay off until you save. AVA remembers each child choice and restores it when the parent turns back on. When a user-level or browser-level save succeeds, AVA shows the standard Settings saved successfully! toast once after the batch finishes. You do not see that toast if permission is denied or any requested save fails.

AVA Portal mobile shell

If you use AVA Portal, browser push prompts are skipped on mobile. The native shell registers the device after sign-in. It can receive incoming video calls and check-in or checkout alerts allowed by the property policy. Browser alerts still work in desktop browsers.

Streamliner bell alerts

Streamliner check-in and checkout alerts reach the AVA mobile app as gentle banners. They also update the in-app bell on Android and iPhone. These alerts follow the property policy above and the user categories below. They still reach linked, registered devices.

Vouch AVA Alarm

Use this page for browser alerts, property-level check-in and checkout delivery, and user categories. For paired alarm devices, use Set Up Vouch AVA Alarm. You can also add or rename a device name there.

Multi-merchant native devices

If you manage several hotels, one verified AVA installation can stay linked across them. That lets your native notification preferences apply without switching hotels one by one.

Keycard encoding alerts

When you encode a keycard, the banner now says the room is ready. It no longer reuses the Key retrieved wording.

Active Property

This page follows the hotel you selected in the switcher. Browser alerts and test notifications stay tied to that property. External channel alerts use merchant-wide settings for that property.

Notification links

When you open Open in Streamliner from Slack, Google Chat, Telegram, or Zapier, AVA keeps the correct hotel in the link. That should take you to the same property that received the alert.

Push reliability

AVA refreshes your browser subscription when you return, reconnect, or reload after a browser update. Repeated check-in, checkout, and housekeeping alerts keep separate banners.

Where to Find It

Settings → Customizations → Push Notifications

Quick Reference

SettingWhat It ControlsWho It Affects
Property level: allow check-in/check-out alertsTurns check-in and checkout delivery on or off for this propertyEveryone at this property
User level: My browser push notificationsChooses which allowed alerts reach this account and paired AVA devicesStaff on this device
Browser level: browser notificationsLets this browser show Streamliner alertsStaff on this device
Browser subscription syncRefreshes your push subscription when you click Save notification settingsStaff on this device
Save confirmationShows the standard success toast after a successful user-level or browser-level saveStaff editing notification settings
AVA Portal mobile shellUses the native shell for incoming video calls and Streamliner bell alertsStaff using AVA Portal
User-level AVA device deliveryUses the same category choices on paired AVA devices across all accessible merchantsStaff using this account
External channel notificationsMerchant-wide routing for Slack, Google Chat, Telegram, or ZapierTeams in those channels
Notification titlesShared emoji prefixes across browser, settings, and Telegram alertsStaff who read alerts
Operational alert tagsKeeps rapid check-in, checkout, and housekeeping banners separateStaff who receive fast updates
Vouch AVA Alarm IntegrationSends incoming video-call alarms to paired Android and iOS devices and stores optional device namesStaff handling video calls
Channel integrationsAccordion cards for each outbound channelHotel admins
Save notification settingsSaves property, user, browser, and channel changes togetherAnyone editing settings

[Update] - 2026-05-16

  • Added optional merchant-specific names for Vouch AVA Alarm devices.
  • The connected devices table shows the name beside the alarm code when you add one.
  • You can rename the label later from the alarm edit modal.

Before You Start

Confirm these basics:

  • You are signed in to the correct property
  • Your browser allows notifications for this site
  • You have the correct webhook URL (Slack/Google Chat/Zapier)
  • You have the Telegram bot token and chat ID, if you use Telegram
  • You have permission to update settings if you are changing external channels

Turn On Browser Push Notifications

  1. Go to Settings → Customizations → Push Notifications

  2. Under Browser level: browser notifications, turn on the toggle

  3. If your browser asks, click Allow

    ✓ You should see the status change to Enabled

  4. Choose the alerts you want under My browser push notifications

  5. Click Save notification settings

Good to Know

This toggle is browser-scoped. It applies only to the current browser and property. User choices stay saved separately, even when a parent gate is off.

Choose Which Browser Alerts You Receive

Use My browser push notifications when you only want to change alerts for your own browser.

  1. Go to Settings → Customizations → Push Notifications
  2. Find My browser push notifications
  3. Turn categories on or off
  4. For Check-in and Check-out, expand the category and choose specific alert types
  5. Click Save notification settings
Good to know

These settings do not change Slack, Google Chat, Telegram, or Zapier. Use External channel notifications for those channels. Turning off a parent category turns off all of its subtypes too. User categories also apply to paired AVA devices when the property allows the alert. If a parent category is off, child choices stay saved but appear off until you re-enable the parent. Use Save notification settings to apply the full hierarchy together.

Send a Test Browser Notification

  1. In Push Notifications, scroll to Test Notification

  2. Click Send Test Notification

    ✓ A test alert should appear on your device within a few seconds

Good to know

Each test notification is sent as a fresh alert. If you click Send Test Notification again, you should see a new notification.

Notification language

Your browser push notifications follow your Streamliner language on this device. If you change your language later, turn push notifications off and on to update it.

Choose Which External Channel Alerts Are Sent

Use External channel notifications when you want to control alerts sent to Slack, Google Chat, Telegram, or Zapier.

  1. Go to Settings → Customizations → Push Notifications
  2. Find External channel notifications
  3. Turn categories on or off
  4. For Check-in and Check-out, expand the category and turn specific alert types on or off
  5. Click Save notification settings
Merchant-wide setting

External channel settings apply to the whole property. If you turn off Checkout started, it stops for all connected external channels.

Save behavior

Property, user, browser, and external channel changes all wait for Save notification settings. Nothing applies until you click the save button.

Permission required

You need settings permission to change External channel notifications. You can still change your own browser alerts without this permission.

Open Channel Integrations

AVA Portal

Telegram setup happens in the AVA portal. Use these steps when you add the bot token and chat ID.

Shared alert titles

Telegram uses the title it receives from Streamliner. That keeps the same emoji prefix in browser alerts and external channels.

Each integration opens as its own accordion card. Use it when you need to configure one channel at a time.

Single Webhook (Simple)

Send all enabled categories to one channel.

  1. Select your platform (e.g., Slack)

  2. Paste the Webhook URL

  3. Turn on Enable Integration

    ✓ You should see the integration status show Enabled

Category-Specific Webhooks (Advanced)

Route alerts to different channels (e.g., Alerts → #it-support).

  1. Turn on Use specific webhooks for different categories
  2. Enter a URL for each category
  3. Leave a category blank to use the default URL

Telegram

Set up Telegram with a hotel-owned bot and one or more destination chats.

  1. Select Telegram
  2. Paste the Bot token
  3. Enter the Chat ID
  4. Choose Same chat for all notifications or Different chats per category
  5. If needed, add category overrides under Category-Specific Chats
  6. Turn on Enable Telegram
  7. Click Save notification settings
Good to know

Saved bot tokens show as *****. Click Edit token only when you want to replace the existing token.

Chat ID format

Use @channelusername for public chats. Use the numeric chat ID for private groups or channels. If the chat is private, Telegram shows the number in getUpdates.

Routing behavior

In Same chat for all notifications, all alerts use the default Chat ID. In Different chats per category, categories without overrides still use the default Chat ID.

Telegram link behavior

Telegram makes public https:// links clickable. Local, Docker, or internal URLs stay as plain text so delivery keeps working.

Supported Notification Categories

CategoryTrigger
Check-inGuest check-in started, completed, failed, or moved through key steps
CheckoutGuest checkout started, bill viewed, paid, completed, or failed
HousekeepingRoom status updates (Clean/Dirty/Inspected), identified by room when available
Keycard HeartbeatEncoder connection failures and recovery notices
AlertSystem errors, payment failures, or ID verification reviews
GenericGeneral system notifications
Room access alerts

Smart-lock PINs and locker codes use Room access ready under Check-in. You do not need a new notification category.

Check-in and Checkout Alert Types

CategoryAlert TypeExample
Check-inCheck-in startedA guest starts online check-in
Check-inDocument uploadedA guest uploads an identity document
Check-inIdentity verifiedA guest passes identity verification
Check-inRoom assignedA room is assigned during check-in
Check-inPayment completedA payment or deposit step is completed
Check-inKeycard encodedA physical keycard is ready and the room is ready
Check-inKey retrievedA digital key is ready
Check-inRoom access readyA smart-lock PIN or locker code is ready
Check-inCheck-in completed / Check-in issueCheck-in completes, or a blocked lookup shows the issue and reason
CheckoutCheckout startedA guest starts checkout
CheckoutBill viewed / Bill settledA guest views or settles their bill
CheckoutCheckout payment completedCheckout payment is completed
CheckoutCheckout completed / Checkout issueCheckout is completed or fails
Recovery alerts

If a door-lock issue is fixed on a later retry, AVA sends the follow-up progress alert. You may see Key retrieved or Check-in completed after the earlier Check-in issue alert.

Reservation lookup blocks

When AVA sends a guest to front-desk review during lookup, it sends a Check-in issue alert. This includes kiosk, balance, billing, zero-night, and long-stay blocks. The alert title identifies the failed step, such as Check-in issue at Entry. Its message explains the reservation block in staff-friendly language. Google Chat cards show Status: FAILED, rather than the step's in_progress status. Successful arrivals at Entry still use the normal arrival alert. Open Command Center → View Details to review the failed lookup event.

Manual checkout alerts

When staff complete a manual check-out, AVA sends the same Check-out alerts. If delivery to one channel fails, the check-out still finishes.

Keycard heartbeat alerts

If a keycard encoder goes offline and then recovers soon after, AVA sends each event separately. That lets you see both the failure and the recovery in your notification center. Google Chat and other staff alerts include the specific encoder failure reason, so you can troubleshoot faster. For example, AVA distinguishes No card detected, Unsupported card type, and Card could not be read. Use Keycard Encoder Troubleshooting for the matching fix.

Troubleshooting

Push notifications stay off after you turned them off

What you see: You turned off the browser notifications toggle and it does not turn back on by itself.

Fix:

  1. Go to Settings → Customizations → Push Notifications
  2. Turn the browser notifications toggle back on
  3. Click Save notification settings
Why this happens

The toggle is saved per property and device. It stays off until you turn it back on.

Push notifications turn back on after refresh

What you see: You disable push notifications, refresh, and they appear enabled again.

Fix:

  1. Confirm you are in the correct property
  2. Turn the browser notifications toggle off again
  3. Keep this browser open for a few seconds so the change saves
Why this happens

If site data is cleared or you switch properties, you may need to disable it again.

No browser notifications appear

What you see: The toggle is enabled, but nothing appears.

Fix:

  1. Check your browser notification permission for this site
  2. Click Send Test Notification
  3. Make sure you are logged in on the same device
Why this happens

AVA may need a moment to refresh your browser subscription after you return or reconnect. If the browser changed its push subscription, the next visible tab usually restores it.

Check-in and checkout alerts do not send

What you see: Browser alerts work, but check-in or checkout alerts never arrive.

Fix:

  1. Go to Settings → Customizations → Push Notifications
  2. Turn on Property level: allow check-in/check-out alerts
  3. Confirm the needed items stay on under My browser push notifications
  4. If you use paired AVA devices, confirm the device is connected in Set Up Vouch AVA Alarm
Why this happens

The property-level control blocks check-in and checkout delivery for everyone at that property. User categories only work after the property allows those alerts. If a parent gate is off, child controls can look off even when their saved choice is still there.

Child notifications look off after you disable a parent

What you see: You turn off a parent gate, and the child categories also appear off.

Fix:

  1. Turn the parent gate back on
  2. Check the child categories you want
  3. Click Save notification settings
Why this happens

AVA shows child controls as effectively off when a parent gate blocks delivery. Your saved child choices remain available after you re-enable the parent.

Back-to-back alerts collapse into one banner

What you see: Several guest events happen quickly, but you only see one browser alert.

Fix:

  1. Keep the browser notifications toggle turned on
  2. Wait a few seconds for the page to resync
  3. Check the browser notification center for the missing alert
  4. Click Send Test Notification
Why this happens

AVA now queues push messages that arrive close together. Check-in, checkout, and housekeeping alerts also keep unique tags.

Notifications show the wrong language

What you see: Alerts appear in a different language than your Streamliner screen.

Fix:

  1. Change your Streamliner language using the language dropdown, for example, EN.
  2. Go to Settings → Customizations → Push Notifications
  3. Turn the browser notifications toggle off, then on again
  4. Click Save notification settings
  5. Click Send Test Notification
Good to know

Each device can have its own language for notifications.

Webhook messages do not show up

What you see: Browser alerts work, but Slack/Chat has no messages.

Fix:

  • Confirm the full URL starts with https://
  • Re-enable Enable Integration
  • Try a test message in a new channel

Telegram still sends an alert you turned off

What you see: Your browser does not receive Checkout started, but Telegram still does.

Fix:

  1. Go to Settings → Customizations → Push Notifications
  2. Find External channel notifications
  3. Under Check-out, turn off Checkout started
  4. Click Save notification settings
Why this happens

Browser alerts and external channel alerts have separate settings. Changing My browser push notifications only affects your browser.

Telegram token still shows as stars

What you see: You open Telegram settings and see ***** in the token field.

Fix:

  1. Click Edit token
  2. Paste the new bot token
  3. Click Save notification settings
Why this happens

AVA keeps the stored token hidden. Saving ***** keeps the existing token instead of replacing it.

Telegram messages go to the wrong chat

What you see: Telegram alerts arrive, but they reach the wrong group or channel.

Fix:

  1. Open Settings → Customizations → Push Notifications
  2. Check the Telegram Routing setting
  3. Confirm the Chat ID is correct
  4. Add or update the matching category override
  5. Click Save notification settings
Why this happens

Telegram uses the default chat unless a category override exists.

What you see: A Telegram alert shows a URL, but it is not a clickable link.

Fix:

  1. Check whether the URL is public and starts with https://
  2. Use the plain URL for internal or Docker addresses
  3. Confirm the message still sends successfully
Why this happens

Telegram only creates clickable links for public HTTPS addresses. Internal URLs are kept as plain text to avoid delivery errors.

You cannot save external channel settings

What you see: Browser alert settings save, but external channel settings show an error.

Fix:

  1. Ask an admin to confirm you have settings permission
  2. Refresh the page
  3. Try changing External channel notifications again

What you see: You tap Open in Streamliner from Slack, Google Chat, Telegram, or Zapier, and AVA opens a different hotel.

Fix:

  1. Sign in to AVA with the right account
  2. Return to the original notification message
  3. Refresh AVA if you switched hotels in another tab
Why this happens

External channel links include the hotel from the alert. An old browser session can still point to a different hotel.

Still Stuck?

Contact success@vouch-technologies.com if:

  • ❌ Notifications are still missing after the steps above
  • ❌ You see repeated error banners in settings
  • ❌ Issues persist for more than 30 minutes

Helpful to include:

  • Screenshot of the settings page
  • The property name
  • Time the issue started
  • Which channel is affected, such as Telegram or Slack