이해하기

이 문서는 푸시 알림 기능을 소개합니다.

기능 설명

Apple Push Notification service(APNs)과 Firebase Cloud Messaging(FCM)을 활용하여 카카오 플랫폼을 통해 사용자에게 푸시 알림을 보낼 수 있습니다. 푸시 알림 기능은 REST API 방식으로 제공되므로 서비스 자체 서버가 필요합니다.

이 기능을 사용하면 다음과 같은 장점이 있습니다.

• 서비스에서 토큰을 직접 관리하지 않아도, 카카오 플랫폼에 등록하면 대신 저장 및 관리해 줍니다.
• 서비스 고유 ID(uuid) 기반으로 푸시 토큰이 등록된 기기 여러 대에 한 번에 푸시를 발송할 수 있습니다.
• 발송 대상의 APNs, FCM 구분 없이 서비스 고유 ID(uuid) 기반으로 푸시 알림을 보낼 수 있습니다.
• 메시지 큐 서버(Queue Server) 및 전송 서버를 별도로 구축할 필요가 없습니다.

요구 사양

푸시 알림 기능을 이용하려면 REST API를 호출할 수 있는 서버가 필요합니다. 카카오디벨로퍼스(Kakao Developers)에 등록된 애플리케이션(이하 앱) 어드민 키(Admin Key)를 사용하므로, 반드시 클라이언트(Client)가 아닌 서버에서 사용해야 합니다.

또한 서비스 회원 정보는 사용자 고유 ID(uuid)를 가지고 있어야 합니다. 푸시 알림 기능은 사용자 고유 ID 기준으로 동작하므로, 푸시 토큰과 별도로 이를 관리하기 위한 사용자 고유 ID가 필요합니다. 카카오 로그인을 사용한다면 카카오계정 사용자 정보의 회원번호(id)를 사용할 수 있으며, 자체적으로 발급한 정수(Long) 형태의 숫자 ID를 사용해도 무방합니다.

푸시 토큰 관리

푸시 토큰 등록

카카오 플랫폼은 고유 ID(uuid)별로 푸시 토큰을 등록하고 관리합니다. APNs와 FCM으로부터 발급 받은 푸시 토큰을 서비스 서버에 전달한 뒤, 서비스 서버에서 앱 어드민 키(Admin Key)를 사용해 사용자의 고유 ID(uuid)별로 카카오 플랫폼에 등록해야 합니다.

푸시 토큰 삭제

만약 사용자가 Android 또는 iOS 앱에서 로그아웃하거나 푸시 알림을 끈다면, 앱은 이 사실을 서비스 서버에 알려줘야 하고, 서비스 서버는 푸시 토큰 삭제 REST API를 호출해야 합니다. 카카오 플랫폼은 푸시 토큰 삭제 요청을 받고, 고유 ID(uuid)를 기준으로 해당 사용자의 푸시 토큰을 삭제합니다.

푸시 알림 보내기

사용자가 앱에서 특정 이벤트를 발생시켰을 때, 푸시 알림을 보내도록 할 수 있습니다. 사용자의 게시물에 새로운 댓글이 달렸을 때 푸시 알림으로 알려주거나, 사용자가 대기 예약한 식당에 빈 자리가 났을 때 알려주는 등 이벤트 기반의 활용이 가능합니다.

지원하는 기능

API 및 기능	설명	문서
푸시 토큰 등록하기	푸시 알림을 받을 사용자의 푸시 토큰을 카카오 푸시 서비스에 등록합니다.	REST API
푸시 토큰 보기	카카오 푸시 서비스에 등록된 사용자의 푸시 토큰 정보를 조회합니다.	REST API
푸시 토큰 삭제하기	특정 사용자의 푸시 토큰을 삭제합니다.	REST API
푸시 알림 보내기	지정한 사용자에게 푸시 알림을 보냅니다.	REST API