truloop Wiki

다크 모드

룹 초대 ​

정보

룹 초대는 룹 참여자가 새로운 사람을 초대하는 기능입니다. 회원과 비회원 모두 초대할 수 있으며, 초대 링크를 통해 간편하게 참여를 유도할 수 있습니다.

기능 소개 ​

룹 초대를 통해 다음과 같은 일이 가능합니다:

  • 룹 참여자가 회원을 룹에 직접 초대합니다. 직접 초대된 회원은 즉시 참여자로 추가됩니다.
  • 비회원은 이름과 전화번호를 입력하여 초대합니다. AI 비서가 SMS 초대를 발송합니다.
  • 초대 링크(LoopInviteToken)를 생성하여 공유할 수 있습니다. 초대 링크를 받은 회원은 링크를 통해 참여하고, 비회원은 가능 날짜를 입력한 뒤 가입 시 기존 기록과 연결됩니다.
  • 새 참여자가 추가되면 채팅방에 자동으로 반영됩니다.

동작 규칙 ​

  1. 참여자면 누구나 초대 가능: 룹에 참여 중인 사람이라면 누구나 다른 사람을 초대할 수 있습니다 (호스트뿐 아니라 일반 참여자도 가능).
  2. 회원 직접 초대: truloop에 가입한 회원을 검색하여 직접 초대할 수 있습니다. 직접 초대된 회원은 별도의 수락 절차 없이 즉시 참여자로 추가됩니다.
  3. 비회원 초대: 앱에 가입하지 않은 사람도 이름과 전화번호를 입력하면 초대할 수 있습니다. 단, 해당 전화번호가 이미 회원으로 가입되어 있으면 비회원 초대가 거부됩니다 (회원 직접 초대를 사용해야 합니다).
  4. 초대 링크 생성: 참여자는 룹별 초대 링크(LoopInviteToken)를 생성할 수 있습니다. 초대 링크는 생성 후 7일간 유효하며, 만료된 링크로는 참여할 수 없습니다.
  5. 채팅방 자동 반영: 회원이 직접 초대되거나 초대 링크를 통해 참여하면 즉시 채팅방에 추가됩니다. 비회원은 나중에 앱에 가입하면 기존 참여 기록과 자동 연결됩니다.
  6. 참여자 초기 상태:
    • 확정됨(CONFIRMED) 상태의 룹: 초대받은 참여자는 바로 참여 확정(ACCEPTED) 상태가 됩니다.
    • 그 외 상태(WAITING, COLLECTING, COLLECTED)의 룹: 초대받은 참여자는 응답 대기(PENDING) 상태가 됩니다.
  7. 룹 상태 변화: 새 참여자가 추가되면 응답하지 않은 참여자가 생기므로, 조율 완료(COLLECTED) 상태였던 룹이 조율 중(COLLECTING)으로 돌아갈 수 있습니다.
  8. 중복 초대 방지: 이미 룹에 참여 중인 사람은 다시 초대할 수 없습니다. 초대 링크를 통해 이미 참여 중인 사람이 다시 접근하면 기존 참여 상태가 유지됩니다 (오류 없이 정상 처리).
  9. 취소된 룹 제한: 취소(삭제)된 룹에는 새로운 참여자를 추가할 수 없습니다.
  10. 초대 페이지 설명 표시: 초대 링크로 열리는 웹 페이지에서 룹 설명이 마크다운 서식으로 렌더링됩니다. HTML이 포함된 설명은 보안 처리(XSS 방어)를 거쳐 안전하게 표시됩니다. 설명이 길면 자동으로 접히며, 더보기/접기 버튼으로 전체 내용을 확인할 수 있습니다.

사용자 흐름 ​

회원 직접 초대 ​

참여자 검색 ​

참여자가 룹 상세 화면에서 초대 버튼을 누르고, 초대할 회원을 검색합니다.

즉시 참여자 추가 ​

선택한 회원이 즉시 룹 참여자로 추가됩니다. 초대받은 회원에게 알림이 발송되고, 기존 참여자에게도 새 참여자 합류 알림이 발송됩니다.

채팅방 추가 ​

새 참여자가 룹 채팅방에 자동으로 추가됩니다.

비회원 초대 ​

비회원 정보 입력 ​

참여자가 초대할 비회원의 이름과 전화번호를 입력합니다.

AI 비서를 통한 SMS 초대 발송 ​

AI 비서(Secretary)가 비회원에게 초대 SMS를 발송합니다. SMS에는 초대 링크가 포함됩니다.

비회원 참여자 등록 ​

비회원이 초대 링크를 통해 가능 날짜를 입력하면 비회원 참여자(Guest Participant)로 등록됩니다. 나중에 앱에 가입하면 기존 비회원 기록과 자동으로 연결됩니다.

초대 링크 공유 ​

초대 링크 생성 ​

참여자가 룹 상세 화면에서 초대 링크 생성을 요청합니다. 링크는 7일간 유효합니다.

링크 공유 ​

생성된 초대 링크를 메신저, SNS 등 원하는 채널로 공유합니다. 카카오톡 공유 시 룹 상태에 맞는 미리보기가 표시됩니다.

링크를 통한 참여 ​

초대 링크를 받은 사람이 링크를 열면 초대 페이지에서 룹의 정보를 확인할 수 있습니다. 룹 설명은 마크다운 서식(볼드, 제목, 링크, 목록 등)이 적용되어 표시되며, 긴 설명은 접기/펼치기로 조회할 수 있습니다. 회원은 즉시 룹에 참여되고, 비회원은 가능 날짜를 입력한 뒤 비회원 참여자로 등록됩니다. 링크가 만료되었으면 참여할 수 없습니다.

관련 문서 ​

변경 이력 ​

날짜변경 내용
2026-03-16초대 페이지 룹 설명 마크다운 렌더링 및 접기/펼치기 규칙 추가
2026-03-10소스 코드 검증: 초대 권한(호스트→참여자 누구나), 회원 직접 초대 즉시 추가, 초대 링크 7일 만료, 참여자 초기 상태 룹 상태 기반 결정, 비회원 SMS 발송 주체(AI 비서), 취소 룹 제한 등 반영
2026-03-09최초 작성