Privileged Gateway Intents

Intent 요청 안내

Debi & Marlene 봇은 Discord의 Privileged Gateway Intents 3가지를 사용합니다. 아래는 Discord 개발자 포털 승인 심사에서 요구하는 항목들에 대한 답변입니다.

애플리케이션 세부 정보

봇의 이름과 목적은 무엇인가요?

Debi & Marlene -- 이터널 리턴(Eternal Return) 게임 커뮤니티를 위한 다기능 Discord 봇입니다.

게임 전적 검색, AI 캐릭터 음성 합성(TTS), 음악 재생, 노래 퀴즈, 환영/퇴장 메시지, YouTube 채널 알림 등의 기능을 제공합니다.

봇은 어떤 서버에서 사용되나요?

이터널 리턴 게임을 플레이하는 한국어 Discord 서버들에서 주로 사용됩니다. 현재 약 100개 서버, 11,000명 이상의 유저가 이용 중입니다.

봇의 기능을 관리하는 웹 대시보드가 있나요?

네. debimarlene.com에서 Discord OAuth2 로그인 후 서버별 봇 설정을 관리할 수 있습니다. TTS 음성 선택, 환영 메시지 설정, 퀴즈 곡 관리 등이 가능합니다.

관리자 전용 웹패널(panel.debimarlene.com)에서는 봇 로그 모니터링, 서버 사용 현황 분석 등을 수행합니다.

Presence Intent (상태 인텐트)

Presence Intent를 왜 필요로 하나요?

유저가 현재 플레이 중인 게임 정보를 감지하여, 이터널 리턴을 플레이 중인 유저에게 자동으로 역할(Role)을 부여하거나 관련 기능을 제공하기 위해 필요합니다.

어떤 사용자 상태/활동 데이터를 수집하나요?
  • 유저의 게임 활동 상태 (현재 플레이 중인 게임 이름)
  • 온라인/자리비움/방해금지 상태

이 데이터는 실시간으로만 사용되며, 서버에 저장하거나 외부로 전송하지 않습니다.

Presence 데이터를 어떻게 활용하나요?
  • 이터널 리턴 플레이 중인 유저에게 "게임 중" 역할 자동 부여/해제
  • 웹패널에서 서버 멤버의 온라인 상태 표시
  • 음성채널 멤버의 현재 활동 상태 확인

Server Members Intent (서버 멤버 인텐트)

Server Members Intent를 왜 필요로 하나요?

새로운 멤버의 입장/퇴장 이벤트를 감지하여 환영 메시지를 보내고, 서버 멤버 목록을 관리하기 위해 필요합니다.

구체적으로 어떤 기능에 사용되나요?
  • 환영/퇴장 메시지: 새 멤버 입장 시 Pillow로 생성한 커스텀 환영 이미지 카드 전송. 퇴장 시 알림 메시지 발송.
  • 자동 역할 부여: 입장 시 서버에서 설정한 기본 역할(Role)을 자동으로 부여.
  • 서버 통계: 멤버 수 변동 추적, 웹패널에서 서버 멤버 목록 조회.
  • 멤버 검색: 전적 검색 시 Discord 닉네임으로 게임 닉네임 매칭.
멤버 데이터를 저장하나요?

서버별 설정(환영 채널, 기본 역할 등)만 Google Cloud Storage에 저장합니다. 개별 멤버의 개인정보(DM, 프로필 등)는 저장하지 않습니다.

Message Content Intent (메시지 콘텐츠 인텐트)

Message Content Intent를 왜 필요로 하나요?

유저가 채팅 채널에 입력하는 텍스트를 봇이 읽어야 TTS(음성 읽기), 금지어 필터링, 자동 응답 등 핵심 기능이 작동합니다.

메시지 콘텐츠를 어떤 기능에 사용하나요?
  • TTS (음성 합성): 유저가 지정된 TTS 채널에 입력한 텍스트를 CosyVoice3 AI 모델로 음성 변환하여 음성 채널에 송출. 이것이 봇의 핵심 기능.
  • 금지어 필터링: 서버 관리자가 설정한 금지어 목록과 메시지 내용을 대조하여 자동 삭제/경고.
  • 자동 응답: 특정 키워드에 반응하는 자동 응답 기능.
  • 노래 퀴즈: 퀴즈 진행 중 유저의 채팅 답변을 읽고 정답 여부 판정.
메시지 내용을 저장하거나 외부로 전송하나요?

아니요. 메시지 내용은 실시간 처리 후 즉시 폐기됩니다. TTS의 경우 텍스트를 음성으로 변환한 뒤 원본 텍스트는 보관하지 않습니다. 봇 로그에는 명령어 사용 기록(명령어 이름, 서버 ID, 시간)만 기록되며 메시지 본문은 포함되지 않습니다.

데이터 처리 및 보안

봇이 수집하는 데이터는 무엇인가요?
  • 서버 설정: 환영 채널 ID, TTS 채널 ID, 기본 역할 ID, 금지어 목록 등 (Firestore 저장)
  • 명령어 로그: 명령어 이름, 서버 ID, 사용 시간 (관리 목적)
  • 퀴즈 곡 목록: 서버별 커스텀 곡 제목/아티스트 (Firestore 저장)
수집하지 않는 데이터는?
  • 유저의 DM(개인 메시지) 내용
  • 채팅 메시지 본문 (실시간 처리 후 폐기)
  • 유저의 이메일, 전화번호 등 개인정보
  • 음성 채널 녹음 데이터
데이터는 어디에 저장되나요?

Google Cloud Firestore의 asia-northeast3(서울) 리전 데이터베이스에 저장됩니다. 봇 서버는 같은 리전의 GCP Compute Engine VM에서 Docker 컨테이너로 운영됩니다.

데이터 삭제 정책은?

봇이 서버에서 추방되면 해당 서버의 설정 데이터는 자동으로 삭제됩니다. 유저가 요청하면 관련 데이터를 수동으로 삭제할 수 있습니다.

문의사항이 있으시면 [email protected]으로 연락해 주세요.