1. 목적

애프터노트 사용자가 앱에서 일회성 초대를 생성한 뒤 카카오톡 공유 화면에서 친구 또는 채팅방을 직접 선택해 초대 메시지를 보낸다.

초대받은 사용자는 카카오톡 메시지의 수락하기 버튼을 누른다.

• 앱이 설치되어 있으면 애프터노트 앱을 실행한다.
• 앱이 설치되어 있지 않으면 카카오디벨로퍼스에 등록된 Play 스토어 URL로 이동한다.
• 앱에서 로그인 또는 회원가입을 완료한 뒤 초대를 수락한다.
• 수락이 완료되면 초대한 사용자의 수신자 목록에 가입 회원이 자동 등록된다.
• 최초 등록 시 relation과 message는 null이며, 초대한 사용자가 나중에 수정한다.

카카오 친구 목록을 애프터노트 서버나 앱이 직접 조회하지 않는다. 카카오톡 공유 화면에서 사용자가 발송 대상을 직접 선택한다.

2. 전체 흐름

1. 초대하는 사용자가 애프터노트 앱에서 수신자 초대를 누른다.

2. Android 앱이 POST /api/v1/receiver-invitations를 호출한다.

3. 서버가 invitationToken을 반환한다.

4. Android 앱이 invitationToken을 카카오 사용자 정의 템플릿 인자로 넣어 카카오톡 공유를 실행한다.

5. 사용자가 카카오톡에서 친구 또는 채팅방을 선택해 메시지를 보낸다.

6. 초대받은 사용자가 메시지의 수락하기 버튼을 누른다.

7. 카카오톡이 다음 커스텀 URL 스킴으로 애프터노트 앱을 실행한다.

   kakao{NATIVE_APP_KEY}://kakaolink?inviteToken={invitationToken}
   

8. Android 앱은 URI의 inviteToken을 추출해 로컬에 임시 보관한다.

9. 앱이 GET /api/v1/receiver-invitations/{token}으로 초대 상태를 조회한다.