> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 알림: 시스템 알림과 앱 내 알림

> 시스템 알림 스위치, 권한, 세 가지 알림 유형과 배너가 표시되는 경우, 앱 내 알림 목록의 필터, 읽음 표시, 이동을 설명합니다.

AIHubMix Cloud에는 서로 독립적인 두 종류의 알림이 있습니다. **시스템 알림**은 Cloud를 보고 있지 않을 때 알려 주기 위해 운영 체제(또는 브라우저)가 표시하는 배너입니다. **앱 내 알림**은 **Settings › Notifications** 의 알림 목록으로, 알림 기록을 보관합니다. 시스템 알림을 꺼도 앱 내 기록에는 영향이 없습니다.

## 적용 범위

| 형태 | 지원 | 비고 |
| - | - | - |
| 데스크톱 앱 | 지원 | 네이티브 시스템 알림. 로그인 온보딩을 완료하거나 건너뛴 후 알림 권한을 한 번 요청합니다. 읽지 않은 개수가 Dock 아이콘에 표시됩니다 |
| 웹 앱 | 지원 | 브라우저 알림을 사용합니다. 권한을 자동으로 요청하지 않으므로 설정에서 켭니다. 읽지 않은 개수가 브라우저 탭 제목 앞에 표시됩니다 |
| 모바일 웹 | 일부 지원 | 앱 내 알림을 사용할 수 있습니다. 일부 모바일 브라우저는 웹 알림을 지원하지 않으며, 이 경우 **System permission** 에 **Not supported** 가 표시됩니다 |

## 찾는 위치

* **시스템 알림 설정**: **Settings › General** 의 **System notifications** 그룹. 앱 내 알림 목록 오른쪽 위의 톱니바퀴 **Notification settings** 로도 열 수 있습니다.
* **앱 내 알림 목록**: 계정 메뉴 › **Notifications**(읽지 않은 알림이 있으면 읽지 않은 개수가 표시되고, 아바타에 작은 점이 나타납니다), **Settings › Personal › Notifications**, **System notifications** 제목 오른쪽의 **View notifications**, 단축키 `⌥⌘U`(Windows: `Ctrl+Alt+U`).

## 시스템 알림

### 설정

| 설정 | 설명 |
| - | - |
| System notifications | 메인 스위치이며 기본값은 켜짐입니다 |
| System permission | 운영 체제(또는 브라우저)가 Cloud의 알림 전송을 허용하는지 여부: **Not requested**, **Allowed**, **Not allowed** 또는 **Not supported**. 버튼은 상태가 **Not requested** 이면 **Allow notifications**, 그 외에는 **System Settings** 입니다 |
| Task completed | 세션 또는 예약 작업이 완료됨 |
| Needs your attention | 승인, 추가 정보 또는 직접 처리가 필요함 |
| Task issues | 실행이 실패했거나 중단되었거나, 예약 작업이 자동으로 일시 중지됨 |

* 세 가지 알림 유형은 모두 기본값이 켜짐입니다. 메인 스위치를 끄면 세 가지 알림 유형의 선택 상태는 유지되며, 다시 켜면 복원됩니다.
* **System Settings** 는 데스크톱 앱에서 운영 체제의 알림 설정을 바로 엽니다. 웹 앱에서는 브라우저 설정에서 변경합니다.
* 알림의 소리, 방해 금지 모드 등의 동작은 운영 체제에서 제어합니다.

### 처음 권한 요청

* **데스크톱 앱**: 로그인 온보딩을 처음 완료하거나 건너뛰면 운영 체제가 권한 요청 창을 한 번 표시합니다. 그 이후에는 **Allow notifications** 를 클릭하여 다시 요청하거나, **System Settings** 를 클릭하여 변경할 수 있습니다.
* **웹 앱**: 자동으로 요청하지 않습니다. **System notifications** 를 켜거나 **Allow notifications** 를 클릭할 때만 브라우저가 권한 요청 창을 표시합니다.

알림을 허용하든 허용하지 않든 Cloud는 정상적으로 사용할 수 있습니다.

### 규칙과 상태

| 상황 | 표시 내용 | 할 수 있는 작업 |
| - | - | - |
| 메인 스위치 켜짐 + Allowed | 세 가지 알림 유형 스위치. 조건에 맞는 이벤트는 배너를 표시 | 개별 유형 끄기 |
| 메인 스위치 켜짐 + Not requested | 세 가지 알림 유형이 숨겨짐 | **Allow notifications** 클릭 |
| 메인 스위치 켜짐 + Not allowed | 세 가지 알림 유형이 숨겨짐 | **System Settings** 를 클릭하고 시스템에서 알림 허용 |
| 메인 스위치 꺼짐 | 세 가지 알림 유형이 숨겨지고 배너가 표시되지 않음 | 메인 스위치를 다시 켭니다. 아직 권한을 요청하지 않았다면 켤 때 권한도 요청합니다 |
| Not supported | 메인 스위치를 사용할 수 없음 | 앱 내 알림 목록 사용 |

## 시스템 알림이 표시되는 이벤트

| 유형 | 이벤트 |
| - | - |
| Task completed | 작업 완료, 예약 작업 완료 |
| Needs your attention | 승인 필요, 입력 필요, 조치 필요 |
| Task issues | 작업 실패, 작업 중단, 예약 작업 실패, 일정 일시 중지 |

그 밖의 알림(프로젝트의 환경 변수 누락, 클라우드 서버 데스크톱 트래픽 알림, 구독 관련 알림 등)은 앱 내 알림 목록에만 기록되며 배너를 표시하지 않습니다.

### 배너가 표시되는 경우

새 알림은 다음 조건을 모두 충족할 때만 배너가 표시됩니다. 그렇지 않으면 앱 내 알림에만 기록됩니다.

1. 메인 스위치가 켜져 있고 시스템이 알림을 허용했습니다.
2. 해당 알림 유형의 스위치가 켜져 있습니다.
3. 이 알림에 해당하는 페이지를 현재 포그라운드에서 보고 있지 않습니다.

Cloud를 열 때 이미 있던 알림은 이후에 배너를 표시하지 않습니다. 예약 작업이 실행 결과를 알리는지는 해당 예약 작업 자체의 **Notifications** 설정에도 따라 다릅니다. [예약 작업](https://docs.aihubmix.com/ko/cloud/automation/scheduled-tasks.md)을 참고하세요.

### 배너 동작

* **배너 클릭**: 해당 세션이나 예약 작업을 열고 창을 포그라운드로 가져옵니다.
* 여러 세션이 거의 동시에 완료되면 **N tasks completed** 배너 하나로 합쳐집니다. 클릭하면 앱 내 알림 목록이 열립니다. 앱 내 목록에는 각 알림이 따로 남아 있습니다.
* **Needs your attention** 알림을 읽음으로 표시하는 것은 확인했다는 의미일 뿐입니다. 승인하거나 대신 처리하지 않습니다.

### 창 닫기와 앱 종료

* 데스크톱 앱에서 **Keep in the menu bar** 가 켜져 있으면(기본값 켜짐) 기본 창을 닫은 후에도 알림이 표시됩니다.
* 앱을 완전히 종료하면 시스템 알림이 표시되지 않습니다. 그동안의 알림은 앱 내 목록에서 확인합니다.

## 앱 내 알림

**Settings › Personal › Notifications** 에는 앱 내 알림이 최신순으로 나열되며, 읽지 않은 항목에는 표시가 붙습니다.

### 목록과 필터

* 상단에 **All / Unread** 필터, **Mark all read** 버튼, 톱니바퀴 **Notification settings** 가 있습니다.
* 각 행에는 제목, 설명(또는 프로젝트 이름), 시간이 표시됩니다. 읽지 않은 항목에는 **Mark as read** 버튼이 있습니다.
* 목록 하단의 **Load more** 를 클릭하면 이전 알림을 볼 수 있습니다.

### 클릭하여 열기

| 알림에 연결된 대상 | 클릭한 후 |
| - | - |
| 세션 / 예약 작업 / 프로젝트 | 해당 페이지를 엽니다 |
| 프로젝트의 환경 변수 누락 | 프로젝트의 환경 설정 페이지를 엽니다 |
| 클라우드 서버 데스크톱 트래픽 알림 | 클라우드 서버 페이지를 엽니다 |
| 구독 관련 알림 | **Settings › Account** 의 결제 부분을 엽니다 |
| 삭제된 세션 / 프로젝트 | 아무것도 열지 않고 **This chat was deleted** 또는 **This project was deleted** 를 표시합니다 |

* 클릭하면 먼저 알림을 읽음으로 표시한 다음 대상을 엽니다.
* 데스크톱 앱에서만 처리할 수 있는 알림에는 웹 앱에서 **Resolve in the desktop app** 또는 **View in the desktop app** 이 표시됩니다.

### 규칙과 상태

| 상황 | 표시 내용 | 할 수 있는 작업 |
| - | - | - |
| 알림이 전혀 없음 | **No notifications yet** | 필요한 작업 없음 |
| **Unread** 필터에서 읽지 않은 알림 없음 | **No unread notifications** | **All** 로 다시 전환 |
| 불러온 항목은 모두 읽었지만 이전의 읽지 않은 알림이 남아 있음 | **Everything loaded is read. Load more to check older ones.** | **Load more** 클릭 |
| 불러오기 또는 읽음 표시 실패 | **Couldn’t load notifications** 또는 **Couldn’t mark as read: 이유** | **Retry** 클릭 또는 다시 시도 |

* **Mark all read** 를 클릭하면 계정 메뉴의 읽지 않은 개수, 아바타의 점, Dock / 탭의 읽지 않은 개수가 사라집니다.
* 읽음 상태는 계정과 함께 다른 기기에 동기화됩니다.

## 자주 묻는 질문

### 세션이 완료되었는데 왜 알림이 표시되지 않았나요?

다음을 순서대로 확인하세요. **System notifications** 가 켜져 있는지, **System permission** 이 **Allowed** 인지, **Task completed** 유형이 켜져 있는지 확인합니다. 예약 작업이라면 해당 작업의 **Notifications** 설정이 **All updates** 인지 확인합니다(기본값 **Important updates** 는 실패만 알립니다). 또한 당시 해당 세션을 포그라운드에서 보고 있었는지 확인합니다.

### 시스템 알림을 꺼도 알림 기록을 볼 수 있나요?

네. 앱 내 알림 목록은 시스템 알림 스위치와 독립적입니다.

### 시스템 설정에서 이미 알림을 허용했는데 왜 여전히 "Not allowed"로 표시되나요?

상태는 Cloud 창으로 다시 전환할 때 업데이트됩니다. macOS에서는 다음 알림이 전달된 후에야 **Allowed** 로 돌아갈 수 있습니다.

### "Approval needed" 알림을 읽음으로 표시하면 세션이 계속 진행되나요?

아니요. 읽음은 확인했다는 의미일 뿐입니다. 세션을 열어 승인을 완료해야 합니다.

## 관련 문서

* [일반 및 화면 스타일](https://docs.aihubmix.com/ko/cloud/settings/general.md)
* [예약 작업](https://docs.aihubmix.com/ko/cloud/automation/scheduled-tasks.md)
* [입력 필요](https://docs.aihubmix.com/ko/cloud/sessions/user-intervention.md)
* [보관](https://docs.aihubmix.com/ko/cloud/settings/archived.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.