다크 모드
채팅 채널 관리
정보
truloop의 채팅 채널은 룹 채널과 Secretary 채널 두 가지 유형으로 나뉩니다. 룹 채널은 룹 참여자들이 실시간으로 소통하는 그룹 채널이고, Secretary 채널은 사용자와 AI 비서(Secretary)가 1:1로 대화하는 개인 채널입니다.
기능 소개
- 룹이 생성되면 해당 룹 전용 **그룹 채팅 채널(룹 채널)**이 자동으로 생성됩니다.
- 룹의 모든 회원 참여자가 룹 채널의 초기 멤버로 등록됩니다.
- 참여자가 추가되거나 제거되면 룹 채널에도 자동으로 반영됩니다.
- 회원만 채팅에 참여할 수 있으며, 비회원 참여자는 채팅에 참여할 수 없습니다.
- AI 비서(Secretary)와의 대화는 사용자별 **1:1 전용 채널(Secretary 채널)**에서 이루어집니다. Secretary는 룹 채널에 참여하지 않습니다.
- 신규 회원 가입 시 기본 Secretary가 자동으로 배정되며, Secretary 채널이 함께 생성됩니다.
- 채팅 인프라는 Sendbird를 사용합니다.
채널 유형
| 채널 유형 | 설명 | 생성 시점 |
|---|---|---|
| 룹 채널 | 룹 참여자들의 그룹 채팅 채널. 참여자만 포함되며 Secretary는 참여하지 않음 | 룹 생성 시 자동 생성 |
| Secretary 채널 | 사용자와 Secretary 간 1:1 대화 채널 | 회원 가입 시 기본 Secretary 배정과 함께 자동 생성, 또는 Secretary 변경 시 생성 |
동작 규칙
룹 채널
- 룹 생성 시 자동 생성: 룹이 만들어지면 해당 룹에 대응하는 그룹 채팅 채널이 자동으로 생성됩니다. 별도의 채팅방 생성 과정이 필요하지 않습니다.
- 초기 멤버 등록: 룹 생성 시점의 모든 회원 참여자가 룹 채널의 초기 멤버로 자동 등록됩니다.
- 참여자 추가 동기화: 룹에 새로운 회원 참여자가 추가되면 해당 참여자가 룹 채널에도 자동으로 추가됩니다.
- 참여자 제거 동기화: 룹에서 참여자가 제거되면(본인 탈퇴 또는 호스트에 의한 제거) 룹 채널에서도 자동으로 제거됩니다.
- 회원 전용: 채팅은 회원 참여자(Participant)만 이용할 수 있습니다. 비회원 참여자(Guest Participant)는 채팅에 참여할 수 없습니다.
- 룹과 1:1 관계: 하나의 룹에는 하나의 채팅 채널만 존재합니다. 채팅 채널은 항상 특정 룹에 소속됩니다.
- 채널 복구: 사용자가 채팅 채널을 떠났거나 채널이 누락된 경우, 채팅 세션 연결 시 자동으로 재참여 처리됩니다.
- 채널 이름 자동 설정: 룹 생성 시 채팅 채널의 이름은 룹 제목으로 자동 설정됩니다. 룹 제목이 없으면 "{호스트 이름}'s loop" 형식의 기본 이름이 사용됩니다.
- 채널 이름 동기화: 룹 제목이 변경되면 채팅 채널 이름도 자동으로 변경된 제목과 동기화됩니다.
- 채널 이름 폴백: 룹 제목이 비어 있거나 삭제된 경우 "{호스트 이름}'s loop" 형식의 기본 이름으로 대체됩니다.
Secretary 채널
- 회원 가입 시 자동 생성: 신규 회원이 가입하면 기본 Secretary가 자동으로 배정되고, 사용자와 Secretary 간 1:1 채널이 생성됩니다.
- Secretary 선택/변경: 사용자가 Secretary를 변경하면 새로운 Secretary와의 1:1 채널이 생성됩니다.
- 독립적 채널: Secretary 채널은 룹 채널과 완전히 분리되어 있습니다. 룹과 무관하게 Secretary에게 질문하거나 도움을 요청할 수 있습니다.
- 채널 복구: Secretary 채널 연결이 끊어지거나 누락된 경우, 시스템이 자동으로 채널을 복구하거나 기본 Secretary를 재배정합니다.
사용자 흐름
룹 생성 후 채팅 시작
룹 생성
호스트가 새로운 룹을 생성합니다. 룹 생성과 동시에 룹 채널이 자동으로 만들어집니다.
채팅 채널 진입
룹의 참여자가 룹 채널에 진입합니다. 모든 회원 참여자가 이미 채널에 포함되어 있습니다.
메시지 교환
참여자들이 실시간으로 메시지를 주고받습니다.
참여자 변경 시 동기화
새 참여자 초대
호스트가 룹에 새로운 회원 참여자를 초대하고, 참여자가 초대를 수락합니다.
채팅 채널 자동 추가
새 참여자가 룹 채널에 자동으로 추가됩니다. 별도의 초대 절차 없이 바로 채팅에 참여할 수 있습니다.
참여자 제거 시
룹에서 참여자가 제거되면(본인이 룹을 나가거나, 호스트가 제거) 해당 참여자는 룹 채널에서도 자동으로 제거됩니다.
비회원 참여자의 경우
비회원 초대
비회원 참여자(Guest Participant)가 룹에 초대됩니다.
채팅 참여 불가
비회원 참여자는 룹 채널에 참여할 수 없습니다. 채팅을 이용하려면 앱에 가입해야 합니다.
가입 후 채팅 참여
비회원 참여자가 앱에 가입하여 회원이 되면, 기존 비회원 참여자 기록이 새 회원 계정에 자동으로 연결됩니다. 이후 해당 룹의 참여자로 추가되면 룹 채널에도 자동으로 참여됩니다.
관련 문서
변경 이력
| 날짜 | 변경 내용 |
|---|---|
| 2026-03-11 | 룹 채널 이름 자동 설정/동기화/폴백 규칙 추가 (채팅 채널 이름이 룹 제목과 연동) |
| 2026-03-10 | 채널 유형 구분(룹 채널/Secretary 채널), Secretary는 룹 채널에 불참여 반영, 채널 복구 규칙 추가, 참여자 제거 방식 명시 |
| 2026-03-09 | 최초 작성 |