푸시 알림 설정

빠른 설정

대부분의 호텔은 브라우저 알림과 채널 하나만 설정하면 됩니다. 약 5분이면 완료됩니다.

이 가이드는 현재 호텔의 푸시 알림을 켜는 방법을 안내합니다. 페이지에는 접힌 카테고리, 아코디언 카드, 그리고 하나의 고정 저장 버튼이 사용됩니다. 모바일에서는 설정 안내가 각 폼 아래에 유지되고, 저장 바는 마지막 필드와 겹치지 않도록 표시됩니다. 알림을 Slack, Google Chat, Telegram 또는 Zapier로 보낼 수 있습니다. AVA는 체크인 마일스톤 알림과 객실 접근 준비 알림도 전송합니다. 공유 채널 알림에는 메시지 세부 정보에 호텔 이름이 포함됩니다. AVA는 이제 일치하는 모든 알림 제목에 같은 이모지 접두사를 붙입니다. 알림 세부 유형을 더 세밀하게 조정하려면 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 notifications	Slack, Google Chat, Telegram 또는 Zapier로 보내는 가맹점 전체 라우팅	해당 채널의 팀
Notification titles	브라우저, 설정, Telegram 알림 전반의 공유 이모지 접두사	알림을 읽는 직원
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 봇 토큰과 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 Portal

Telegram 설정은 AVA 포털에서 진행합니다. 봇 토큰과 chat ID를 추가할 때 이 단계를 사용하세요.

공유 알림 제목

Telegram은 Streamliner에서 받은 제목을 사용합니다. 그 덕분에 브라우저 알림과 외부 채널에서 같은 이모지 접두사가 유지됩니다.

각 통합은 별도의 아코디언 카드로 열립니다. 채널을 하나씩 설정해야 할 때 사용하세요.

단일 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

호텔이 보유한 봇과 하나 이상의 대상 채팅을 사용해 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를 클릭합니다

알아두기

저장된 봇 토큰은 *****로 표시됩니다. 기존 토큰을 바꾸고 싶을 때만 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	시스템 오류, 결제 실패 또는 ID 확인 검토
Generic	일반 시스템 알림

객실 접근 알림

스마트락 PIN과 보관함 코드는 Check-in 아래의 Room access ready를 사용합니다. 새 알림 카테고리를 만들 필요가 없습니다.

Check-in 및 Checkout 알림 유형

카테고리	알림 유형	예시
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	스마트락 PIN 또는 보관함 코드가 준비됨
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는 후속 진행 알림을 전송합니다. 이전의 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 토큰이 계속 별표로 보임

보이는 현상: Telegram 설정을 열면 토큰 필드에 *****가 보입니다.

해결:

1. Edit token을 클릭합니다
2. 새 봇 토큰을 붙여넣습니다
3. Save notification settings를 클릭합니다

왜 이런가요

AVA는 저장된 토큰을 숨겨 둡니다. *****를 저장하면 기존 토큰을 바꾸지 않고 유지합니다.

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)

관련 가이드

• 영상 통화 설정
• Vouch AVA Alarm 설정
• Night Shift를 사용해 업무 시간 이후 작업 처리