푸시 알림
클라우드 전용
푸시 알림은 클라우드 버전에서만 사용할 수 있습니다.
푸시 알림을 사용하면 대시보드 탭이 닫혀 있거나 기기가 백그라운드 상태일 때도 ADHDev Cloud가 알림을 보낼 수 있습니다.
어떤 경우에 유용한가
푸시 알림은 빠른 주의가 필요한 이벤트에 가장 유용합니다:
- 승인 요청
- 다중 선택 프롬프트 (에이전트가 옵션 선택을 기다리는 중)
- 완료된 태스크
- 에이전트 오류
- 머신 연결 해제 알림
이 알림들은 브라우저 알림 및 프로바이더별 알림 설정과 함께 Notifications 페이지에서 구성합니다.
승인 요청과 다중 선택 프롬프트는 동일한 승인 설정 토글을 공유합니다 — 이를 끄면 둘 다 조용해집니다.
푸시 알림에 포함되는 내용
완료 푸시는 채팅 내용을 절대 담지 않습니다 — 어떤 에이전트가 어떤 프로젝트에서 완료했는지, 얼마나 걸렸는지 같은 라우팅 정보만 담습니다.
승인 및 다중 선택 푸시는 유일하게 의도적인 예외입니다: 무엇을 승인하거나 선택해야 하는지에 대한 모달 자체의 텍스트를 80자로 잘라 포함합니다. "에이전트에게 승인이 필요합니다"만으로는 행동으로 옮길 수 없기 때문입니다 — git push --force를 요청하는 것인지 무해한 것인지 알아야 합니다. 전체 채팅 트랜스크립트는 절대 푸시 페이로드에 도달하지 않습니다.
지원 환경
ADHDev는 브라우저와 운영체제에 내장된 Web Push 스택을 사용합니다. 실제로 지원되는 경로는 다음과 같습니다:
- ✅ 데스크탑 (Chrome, Edge, Firefox, Safari macOS)
- ✅ Android (Chrome)
- ✅ iOS (Safari PWA — iOS 16.4 이상)
푸시 알림 활성화 방법
데스크탑 및 Android
- 대시보드에서 Notifications를 엽니다.
- 전체 알림이 꺼져 있으면 켭니다.
- Push Notifications를 활성화합니다.
- 브라우저가 알림 권한을 요청하면 허용합니다.
푸시가 활성화되면 ADHDev에서 등록된 기기 목록을 확인하고 테스트 알림을 보낼 수도 있습니다.
iOS (PWA 설치 필요)
iPhone 및 iPad에서는 설치된 PWA에서만 푸시가 작동합니다:
- Safari에서 adhf.dev를 엽니다.
- 공유(⬆️) → 홈 화면에 추가 → 추가를 탭합니다.
- 홈 화면에서 설치된 ADHDev 앱을 엽니다.
- ADHDev에서 Notifications를 엽니다.
- iOS가 알림 권한을 요청하면 **"허용"**을 탭합니다.
WARNING
- iOS 16.4 이상이 필요합니다.
- 일반 Safari 탭에서는 푸시가 작동하지 않습니다.
- 알림이 표시되지 않으면 iOS 설정 → 알림 → ADHDev도 확인하세요.
관리 가능한 항목
Notifications 페이지는 단순한 켜기/끄기 스위치 그 이상입니다. 다음을 포함할 수 있습니다:
- 전체 알림 활성화
- 브라우저 알림
- 푸시 알림
- 등록된 푸시 구독의 기기 목록
- 테스트 푸시 버튼
- 완료, 승인, 연결 해제, 오류 알림 등 이벤트별 설정
이 알림들은 클라우드 계정 경로를 통해 전달됩니다. 스탠드얼론/셀프호스트에서는 호스팅 푸시 전송을 제공하지 않습니다.
동작 방식
- 브라우저가 푸시 구독을 생성합니다.
- ADHDev Cloud가 해당 구독을 계정에 저장합니다.
- 관련 이벤트가 발생하면 클라우드 서비스가 해당 기기로 푸시 메시지를 전송합니다.
- OS 또는 브라우저가 알림을 표시합니다.
- 알림을 열면 대시보드 흐름으로 돌아갑니다.
동일 계정에 여러 기기를 등록할 수 있습니다.
플랜 제한
| 플랜 | 일일 알림 |
|---|---|
| Free | 30 |
| Pro | 무제한 |
| Ultra | 무제한 |
| Enterprise | 무제한 |
비활성화
Notifications 페이지에서 Push Notifications를 끄거나, 브라우저나 OS 설정에서 권한을 취소하세요.
iOS에서는 설정 → 알림 → ADHDev에서도 비활성화할 수 있습니다.
문제 해결
- 푸시가 미지원으로 표시되면 지원되는 브라우저로 전환하거나 iOS PWA를 설치하세요.
- 권한이 거부된 경우, 먼저 브라우저나 사이트 설정에서 알림을 다시 활성화하세요.
- 기기가 알림을 받지 못하면 Notifications의 등록된 기기 목록을 확인하세요.
- 셀프호스트를 사용하는 경우, 푸시 전송은 해당 경로에서 지원되지 않습니다.