가독 읽은 알림 지우기

어느 날 카카오톡을 쓰다가 문득 이런 생각이 들었다.
"왜 데스크톱에서 카톡을 읽으면 폰에 와 있던 알림도 같이 지워질까?"
그동안은 PC에서 읽고 나면 폰에서도 알아서 지워지겠거니 했다. 예전에 회사에서 푸시까지 만들어 봤는데, 막상 저 알림이 어떻게 사라지는지는 모르겠더라.
사실 예전에 회사에서 푸시 알림을 개발한 적은 있다. 백오피스에서 FCM으로 알림을 보내고, 웹뷰 앱에 브릿지를 붙여서 받는 것까지 구현했었다. 그런데 당시에는 어떻게 보내고 보여 줄지만 생각했지, 다른 기기에서 읽은 알림을 어떻게 처리할지는 생각하지 못했다. 이 구조를 그때 알았더라면 조금 더 잘 만들 수 있지 않았을까 하는 아쉬움도 있다.
매일 쓰는 슬랙에서도 비슷한 불편함을 느꼈다. PC에서 이미 읽은 내용인데 폰에는 알림이 그대로 남아 있는 경우가 종종 있었다. 쓰는 입장에서는 그냥 알림을 지우고 넘어갔지만, 직접 메신저를 만들기 시작하니 나도 이걸 처리해 보고 싶어졌다.
지금 정준경, 김가원과 함께 만들고 있는 가독이 그 메신저다. 원래는 노션 대신 쓰려고 시작했는데, 지금은 슬랙까지 이겨 보겠다는 생각으로 메신저 겸 협업 툴을 만들고 있다. 어떻게 시작됐는지는 가독 개발기 (feat. 정준경, 김가원)에 따로 적어 두었다.
그래서 이번에는 푸시를 보내는 데서 끝내지 않고, 다른 기기에서 읽었을 때 폰에 남은 알림을 지우는 것까지 직접 만들어 보기로 했다.
폰에 남은 알림만 지우면 될 줄 알았는데, 웹에서 읽은 상태를 앱까지 전달하는 것부터 해야 했다. 그 과정을 따라가며 적었다. 알림 권한 안내와 미리보기를 만든 이야기는 가독 모바일 알림 일지에 따로 적었다.
11월 4일 오후 2시 8분에 찍어 둔 내 아이폰 잠금화면이다. 미리보기도 잘 나오고 알림도 정상적으로 도착한다. 알림은 잘 오는데 PC에서 다 읽고 나서도 이대로 남아 있으면 매번 손으로 지워야 한다. 이번에는 그 부분까지 고쳐 보고 싶었다.
먼저 가독의 구조부터
가독은 웹, 데스크톱, 모바일 화면을 각각 따로 만들지 않았다. Next.js로 만든 웹을 공통으로 사용하고, 실행하는 환경을 다르게 구성했다.
브라우저에서는 gadoc.kr에 접속하고, 데스크톱 앱에서는 일렉트론으로 같은 웹을 띄운다. 모바일도 React Native(Expo)로 만든 앱 안에 웹뷰를 넣어서 이 웹을 보여 주는 방식이다.
이렇게 하면 공통 화면이나 기능을 수정할 때 웹을 고치는 것으로 세 환경에 반영할 수 있다. 다만 화면을 같이 쓴다고 해서 모든 기능을 웹에서 처리할 수 있는 건 아니다.
이번에 구현하려는 휴대폰 알림 삭제가 그렇다. 웹뷰 안의 자바스크립트에서 휴대폰에 떠 있는 앱 알림을 직접 가져와 지우거나 앱 아이콘의 배지를 바꿀 수는 없다. 그래서 웹에서 모바일 앱에 삭제를 요청하도록 연결했다. 브라우저 알림과 데스크톱 알림은 각각 브라우저 API와 일렉트론에서 처리한다.
설명을 위해 환경에 따른 분기만 남기면 이런 모습이다.
여기서 웹이 앱의 기능을 사용할 수 있도록 연결해 주는 것이 브릿지다. 예전에 회사에서 웹뷰 앱에 푸시를 붙일 때 사용했던 것도 이 부분이다.
웹에서 앱으로 요청 보내기
웹뷰는 앱 안에서 웹을 보여 주지만, 웹의 자바스크립트와 앱의 네이티브 코드는 서로 다른 환경에서 실행된다. 웹에서 모바일 앱의 알림 기능을 바로 호출할 수 없는 이유도 여기에 있다.
그래서 가독은 웹과 앱 사이에 브릿지를 두고 필요한 내용을 메시지로 주고받는다.
웹에서 앱으로 요청을 보낼 때는 객체를 JSON 문자열로 바꿔 postMessage를 호출한다.
앱은 웹뷰의 onMessage로 이 메시지를 받는다. 다만 받았다고 바로 실행하지는 않는다. 먼저 출처와 메시지 형식이 맞는지 확인한다.
반대로 앱에서 웹으로 결과를 알려 줄 때는 웹뷰에 자바스크립트를 실행해 window 이벤트를 보낸다. 웹은 이 이벤트를 받아 필요한 후속 작업을 한다.
일렉트론에서도 비슷하게 웹과 메인 프로세스를 연결한다. preload 스크립트가 contextBridge로 웹에서 쓸 함수를 노출하고, 웹이 호출하면 ipcRenderer.invoke를 거쳐 메인 프로세스의 ipcMain.handle로 전달된다. OS 알림을 띄우는 작업은 메인 프로세스가 맡는다.
모바일에서 주고받는 메시지는 여러 가지다. 이번 글과 관련된 것만 적으면 이렇다.
- 웹 → 앱:
gadoc:notify로 로컬 알림을 띄우고,gadoc:badge로 배지를 바꾸고,gadoc:clear-notifications로 알림을 지운다. - 웹 → 앱:
gadoc:session으로 로그인 상태를 알려 주고, 알림 권한 확인이나 설정 화면 열기도 요청한다. - 앱 → 웹:
gadoc:native-push-token으로 푸시 토큰을 전달하고, 권한 상태와 등록 결과도 알려 준다.
브릿지는 웹에서 네이티브 기능을 실행할 수 있는 통로인 만큼 검사도 필요하다. 가독에서는 메시지를 보낸 웹뷰가 허용한 주소인지, 정해 둔 type인지, 각 필드의 형식과 길이가 맞는지 확인한다. 예를 들어 알림 제목은 120자, 본문은 500자, 지우기 표식은 최대 64개까지만 받는다.
앱 버전도 생각해야 했다. 웹은 먼저 배포하더라도 휴대폰에는 예전 앱이 남아 있을 수 있다. 예전 앱이 모르는 메시지 종류는 무시하게 해 두면 새 요청 때문에 앱이 잘못 동작하는 일은 막을 수 있다. 물론 그 앱에서 새 기능을 사용하려면 업데이트가 필요하다.
같은 알림이 여러 번 뜨지 않게
이제 실제 알림이 뜨는 과정을 보자. PC의 일렉트론과 브라우저 탭, 휴대폰 앱을 동시에 열어 둔 상태에서 누군가 나를 멘션했다고 해 보자. 열린 화면마다 알림을 띄우면 같은 내용으로 여러 번 알림이 올 수 있다. (한 번 불렀는데 여러 군데서 같이 울리면 좀 정신없을 것 같다...)
그래서 소켓으로 알림을 받은 화면이 바로 알림을 띄우지 않고, 먼저 delivery-claim API를 호출하도록 했다. 서버가 가장 먼저 승인한 요청에서만 알림을 띄운다.
서버는 워크스페이스, 사용자, 알림을 조합한 고유 키로 MongoDB에 기록을 만든다. 같은 키는 한 번만 저장할 수 있으니 동시에 요청이 와도 먼저 성공한 쪽만 알림을 띄운다. 만료 시각은 2분 뒤로 두었고, 지난 기록은 MongoDB TTL 작업이 정리한다. 정확히 2분이 되는 순간 삭제되는 방식은 아니다.
일렉트론이 켜져 있다면 PC 알림을 우선으로 보여 주고 싶었다. 그래서 브라우저와 모바일 웹뷰는 0.3초 뒤에 요청하고, 일렉트론은 바로 요청하도록 했다. 다만 일렉트론이 켜져 있다는 사실만으로 항상 먼저 성공한다고 보장하는 건 아니고, 먼저 도착한 요청이 선택되는 구조다.
이건 실행 중인 화면에서 소켓을 받은 경우다. 휴대폰 앱이 백그라운드에 있으면 서버가 별도로 원격 푸시를 보낸다. 앱이 열려 있는 순간에는 소켓 알림과 원격 푸시가 겹칠 수도 있어서, 같은 알림에 붙인 중복 방지 ID(dedupeId)로 중복 표시를 막도록 했다.
원격 푸시는 어디를 거쳐 올까?
원격 푸시는 가독 서버가 휴대폰으로 직접 보내는 방식이 아니다. iOS에서는 Apple의 APNs, Android에서는 Google의 FCM을 거쳐 기기에 전달된다.
가독은 그 앞에 Expo Push 서비스를 사용한다. 서버가 Expo로 푸시를 보내면, Expo가 기기에 맞춰 APNs나 FCM으로 전달하는 구조다.
Expo를 쓰더라도 각 플랫폼의 설정은 필요하다. Android에서는 Firebase에 앱을 등록하고 FCM HTTP v1을 사용할 서비스 계정 자격 증명을 Expo에 올렸다. iOS에서는 Apple Developer에서 만든 APNs 인증 키를 등록했다. 가독 서버에는 Expo 접근 토큰과 기기 토큰 암호화에 필요한 키를 별도로 설정했다.
Firebase에서는 FCM V1이 사용 설정되어 있고 기존 API는 중지된 상태다. 예전에 회사에서 푸시를 붙일 때는 서버 키를 사용했었는데, 이번에는 서비스 계정 키를 준비해야 했다. (그때와 설정 화면도 많이 달라졌다.)
Expo 쪽에 등록한 Android와 iOS 자격 증명이다. 사진에 표시될 수 있는 값들은 가려 두었다.
푸시 토큰은 앱이 만들고 웹이 등록한다
푸시를 보내려면 서버가 어느 기기로 보낼지 알아야 한다. 가독에서는 앱이 만든 Expo 푸시 토큰을 서버에 등록해 사용한다.
여기서 고민한 건 로그인 상태였다. 앱이 푸시 토큰을 가져오지만, 가독의 로그인 세션은 웹이 관리한다. 앱에서도 로그인 정보를 따로 관리하기보다는 브릿지를 통해 역할을 나눴다. 앱이 권한을 확인하고 토큰을 가져오면, 웹이 현재 로그인한 사용자로 서버에 등록한다.
중간에 웹이 /auth/me로 사용자를 다시 확인하는 이유가 있다. 앱에서 토큰을 가져오는 사이에 웹에서 다른 계정으로 로그인했을 수도 있기 때문이다. 앱이 전달한 사용자와 현재 웹의 사용자가 다르면 등록하지 않는다.
등록할 때 만든 별도의 난수 값은 로그아웃 후 기기 등록을 해제하는 데 쓴다. 세션이 먼저 끝나더라도 이 값으로 해당 등록을 지울 수 있게 했다.
푸시 토큰을 지우면 알림도 사라질까?
처음에는 다른 기기에서 읽으면 푸시 토큰을 회수하면 되는 건가 싶었다. 그런데 푸시 토큰은 앞으로 어느 기기에 보낼지를 나타내는 값이다. 등록을 지우면 이후 푸시를 보내지 못할 뿐, 이미 알림 센터에 표시된 알림까지 사라지지는 않는다.
이미 도착한 알림은 휴대폰에서 지워야 한다. 그러려면 서버가 읽음 상태를 휴대폰에 알리고, 앱이 어떤 알림을 지워야 하는지 알아볼 수 있어야 했다.
어떤 알림을 지울지 구분하기
먼저 각 알림이 어느 대화나 이슈에 속하는지 구분할 값이 필요했다. 채널 ID를 그대로 넣는 방법도 있겠지만, 푸시는 외부 서비스를 거쳐 가기 때문에 내부 ID를 그대로 넣고 싶지는 않았다.
그래서 서버 키를 이용한 HMAC으로 표식을 만들었다. 같은 채널이어도 받는 사용자가 다르면 다른 값이 나온다. 아래는 설명에 필요한 부분만 남긴 코드다.
scope는 알림을 묶는 기준이다. 메시지는 채널, 이슈와 문서는 각각의 리소스, 알림센터 전체는 워크스페이스 단위로 구분한다. 휴대폰에 도착하는 알림 데이터는 대략 이렇게 생겼다.
ct는 지울 대상을 구분하는 표식이고, at은 원본 알림의 기준이 되는 시각이다. dedupeId는 앞에서 설명한 중복 방지 ID다. 서버는 보낸 알림의 표식도 기록해 두고 일정 기간이 지나면 정리한다.
시각을 함께 넣은 이유도 있다. PC에서 채널을 읽는 순간 새 메시지가 하나 더 올 수 있기 때문이다. 표식만 같다고 지우면 방금 도착한, 아직 읽지 않은 알림까지 사라질 수 있다.
그래서 읽음 신호에 기준 시각을 함께 보낸다. 앱은 표식이 같고, 원본 메시지나 알림의 생성 시각(at)이 읽음 기준 시각보다 이전이거나 같은 항목만 지운다. 휴대폰에 늦게 도착했더라도 이미 읽은 메시지라면 정리할 수 있다.
안 읽은 알림까지 지워 버리면 정리해 준다고 만든 기능 때문에 오히려 알림을 놓치게 된다. 그래서 이 기준이 꽤 중요했다.
PC에서 읽은 상태를 휴대폰에 전달하기
일렉트론에서 채널을 열어 메시지를 읽으면 웹이 서버에 읽음 상태를 보낸다. 데스크톱이라고 해서 휴대폰을 직접 조작하는 건 아니다. 서버가 읽음을 저장한 뒤 휴대폰 쪽에 전달한다.
휴대폰 앱이 켜져 있을 때와 백그라운드에 있을 때를 위해 두 경로를 두었다.
앱이 열려 있다면 웹뷰의 소켓으로 notification:mobile_clear 이벤트를 받는다. 웹은 이 내용을 브릿지의 gadoc:clear-notifications 메시지로 앱에 넘긴다.
앱은 현재 표시된 알림 목록을 가져와 표식과 기준 시각이 맞는 항목만 지운다. 알림을 지운 뒤에는 배지도 조정한다.
문제는 폰이 잠겨 있거나 앱이 백그라운드에 있는 경우다. iOS에서는 앱과 웹뷰의 실행이 중단될 수 있어서 소켓만으로는 읽음 상태를 제때 전달하기 어렵다.
그래서 서버에서 데이터만 담긴 무음 푸시도 보낸다. 앱이 백그라운드에서 실행될 기회를 얻으면 이 데이터를 읽고 같은 삭제 함수를 호출하는 방식이다.
iOS에는 content-available을 사용하는 백그라운드 푸시로, Android에는 데이터 전용 푸시로 보낸다. 백그라운드 작업은 App 컴포넌트가 뜬 다음이 아니라 앱 진입점에서 등록했다.
소켓과 무음 푸시 중 어느 경로로 받든, 마지막에는 같은 dismissMatching 함수에서 알림을 골라 지운다. 다만 무음 푸시가 항상 도착하거나 앱을 깨우는 것은 아니었다. 이 부분은 아래에서 다시 이야기하겠다.
읽음 요청을 모아서 보내기
채팅방을 오갈 때마다 읽음 이벤트가 생길 수 있다. 그때마다 폰에 무음 푸시를 보내면 같은 작업이 자주 반복되고, iOS의 백그라운드 푸시 제한에도 더 쉽게 걸릴 수 있다.
그래서 서버에 대기열을 두고 같은 사용자의 읽음 요청을 잠깐 모은 다음 한 번에 보내도록 했다.
첫 요청이 들어온 뒤 2초 동안 더 들어온 요청을 모은다. 같은 사용자에게 보내는 간격은 최소 5초로 두었고, 한 번에 담는 표식은 최대 24개다. 이전에 해당 표식으로 보낸 알림이 없다면 지우기 요청도 생략한다.
서버 프로세스가 여러 개여도 같은 작업을 동시에 처리하지 않도록, 가져간 작업에 60초 동안 다른 프로세스가 가져가지 못하는 표시를 둔다. 접수에 실패하면 기다리는 시간을 늘려 가며 다시 시도한다. 여기서 성공은 Expo가 요청을 받았다는 뜻이다. 기기에서 알림을 지웠는지는 이 응답만으로 알 수 없다. (Expo의 티켓·영수증 설명)
이전 버전 앱과의 호환성도 확인했다. 오래된 Android 빌드에서는 데이터 푸시를 제대로 처리하지 못해 빈 알림이 나타날 수 있었다. 그래서 새 앱이 등록할 때 clear-v1 지원 여부를 함께 보내고, 서버는 이를 지원하는 기기에만 지우기 푸시를 보낸다.
알림을 눌러서 들어왔을 때
휴대폰에서 알림 하나를 눌러 채널로 들어간 경우에도 읽음 처리가 필요했다. 같은 대화의 다른 알림이 여러 개 남아 있을 수 있기 때문이다.
알림을 누르면 앱은 알림에 들어 있는 /mobile/push/open?token=... 주소를 웹뷰에서 연다. 서버는 토큰을 확인하고, 그 사용자가 여전히 해당 대화를 볼 권한이 있는지도 확인한 뒤 이동시킨다. 그사이 채널에서 나갔다면 내용을 열어 주지 않는다.
그런데 아이폰에서 잘 지워지지 않았다
여기까지 만들고 운영에 올렸는데, 정작 내 아이폰에서는 알림이 거의 지워지지 않았다. 처음에는 서버 쪽 대기 시간이 길어서 그런가 싶었다. 요청을 2초 동안 모으고 대기열이 주기적으로 동작하니, 우선 그 부분부터 확인했다.
구간을 나눠 보려고 내 아이폰에 실제 알림은 지우지 않는 시험 신호를 보냈다. Expo 접수와 APNs로 넘기는 단계에서는 ok를 확인할 수 있었다. 다만 여기까지의 성공이 아이폰이 푸시를 받았고 앱이 처리했다는 뜻은 아니었다. 그 뒤 기기 수신과 백그라운드 실행도 따로 확인해야 했다.
찾아보니 무음 푸시는 시스템이 전달을 보장하지 않는다. iOS가 상황에 따라 전달을 미루거나 제한할 수 있고, 사용자가 앱을 강제 종료한 경우에도 백그라운드 실행을 기대하기 어렵다. 실제로 앱이 깨어난 뒤 삭제 코드까지 실행했는지도 기기에서 나눠서 확인해야 했다.
Apple의 백그라운드 알림 문서에도 전달이 보장되지 않고, 너무 자주 보내면 제한될 수 있다고 나와 있다. 테스트를 열심히 할수록 확인이 더 어려워질 수도 있다니... 처음에는 좀 당황스러웠다.
알림을 화면에 표시하기 전에 걸러낼 수 있는 별도의 권한이 있는지도 찾아봤다.
Notification Service Extension Filtering 권한 신청 페이지다. 신청 대상에 종단간 암호화 메신저나 긴급 알림 등 정해진 경우가 있었는데, 가독은 해당하지 않는다고 판단해서 신청하지 않았다.
그때 준비하던 다음 방법
그때 살펴본 다른 방법이 Notification Service Extension이었다. 조건에 맞는 표시용 원격 알림이 도착할 때, iOS가 알림을 보여 주기 전에 실행하는 작은 처리기를 앱에 넣을 수 있다.
가독에서는 새 알림을 보낼 때 이미 읽은 대화의 표식도 함께 담고, 처리기가 그 표식을 확인해 알림 센터에 남은 항목을 정리하는 방법을 준비했다. 같은 대화의 알림을 묶어 보여 주는 처리도 여기에 넣었다.
다만 이것도 새 알림이 도착해야 실행되는 방식이다. 새 알림이 오지 않을 때 바로 정리해 주는 해결책은 아니고, iOS 설정과 전달 상황에 따라 동작하므로 실제 기기에서 확인이 필요하다. 필요한 앱 빌드가 배포되기 전에는 기존 앱에 적용되지도 않는다.
이 글을 처음 쓸 당시에는 14번 빌드가 심사 중이었고, 이 처리기는 다음 업데이트를 위해 준비하고 있었다. 그동안에는 앱을 열었을 때 읽음 상태를 다시 맞추는 경로와, 알림을 눌러 대화에 들어갔을 때 정리하는 경로를 함께 두었다.
만들고 나서
회사에서 푸시를 붙일 때는 잘 도착하면 된 줄 알았다. 이번에는 폰에 알림이 도착한 다음부터 일이 더 생겼다. 어느 기기에서 읽었는지 맞추고, 아직 안 읽은 메시지는 남겨 두고, 앱이 잠들어 있을 때도 처리해야 했다.
특히 아이폰은 서버에서 ok를 받았는데도 내 폰 화면은 그대로라 답답했다. 보내는 데 성공한 것과 폰에서 처리한 게 다르다는 걸 직접 보고 나니, 로그에 성공 한 줄 찍혔다고 끝낼 수가 없더라.
이 글은 11월 4일 구현과 시험을 기준으로 적었다. 이후에도 기기 상태별로 확인하며 고치고 있고, 11월 10일 개발 현황은 가독 개발기에 덧붙였다.
이어지는 이야기
- 가독 모바일 알림 일지: 알림 권한 안내와 미리보기를 만든 이야기
- 가독 개발기 (feat. 정준경, 김가원): 가독을 만들기 시작한 이야기
- Microsoft Store 가독 등록일지: 일렉트론 앱을 스토어에 올린 이야기