Discord
Anyy는 공식 Gateway 연결 프로필과 Discord 봇 토큰을 사용합니다. 어댑터는 다이렉트 메시지, 서버 채널, Discord 스레드, 수신 첨부 파일, 페어링, 실시간 상태 확인을 지원합니다.
1. Discord 애플리케이션 만들기
Discord Developer Portal에서 다음을 수행합니다.
- 애플리케이션을 만들고 봇 사용자를 추가합니다.
- 봇 토큰을 안전한 비밀번호 관리자에 복사합니다.
- 활성화할 대화에 맞는 Gateway 인텐트를 구성합니다.
- 메시지 조회·전송 권한으로 원하는 서버에 봇을 설치합니다.
Anyy는 정책에서 필요한 인텐트를 계산합니다. 다이렉트 메시지에는 다이렉트 메시지 인텐트가, 활성화된 서버 메시지에는 서버 메시지 인텐트가 필요합니다. 그룹 정책이 open 또는 allowlist이면 Message Content 인텐트도 필요합니다. Dashboard에 해당 외부 사전 요건이 표시됩니다.
2. Anyy에 Discord 추가
Dashboard → Channel → Add → Discord를 엽니다. 기본 항목은 Bot Gateway를 사용합니다. 봇 토큰을 추가하세요. DM/그룹 정책은 CLI 마법사에서 설정합니다. 이 Dashboard 양식에는 해당 입력이 없습니다.
CLI 설정:
anyy setup channel
봇 토큰은 프로필 비밀정보로 저장됩니다. 활성화하면 Anyy는 연결을 수락하기 전에 인증된 봇 정체성과 앱 정체성을 모두 확인합니다.
3. 정책 설정
Discord의 기본값은 다이렉트 메시지 pairing, 그룹 mention입니다. 제공되는 설정 선택지는 다음과 같습니다.
| 정책 | DM | 그룹 |
|---|---|---|
pairing | 지원 | — |
allowlist | 지원 | 지원 |
open | 지원 | 지원 |
mention | — | 지원 |
disabled | 지원 | 지원 |
CLI 마법사에서 Discord를 선택해 정책을 편집하세요. 기존 허용 목록은 Discord 사용자/채널 식별자를 사용합니다. 현재 설정은 목록 항목 편집을 제공하지 않습니다. 메시징 플랫폼을 참조하세요.
4. 연결 확인
anyy channel reload
anyy channel doctor discord
다이렉트 메시지를 보내거나 허용된 서버 채널에서 봇을 멘션하세요. 페어링이 활성화되어 있으면 새 DM 발신자를 승인합니다.
anyy channel pairing list --channel discord
anyy channel pairing approve --request REQUEST_ID
스레드와 첨부 파일
Discord 스레드 식별자는 대화 경로에 유지되므로 응답이 같은 스레드로 돌아갑니다. 수신 첨부 파일은 미디어 제한을 통과하면 범위가 지정된 Anyy 세션으로 다운로드됩니다.
봇에 필요한 것보다 넓은 Discord 권한을 부여하지 마세요. 도구와 모델 권한은 Anyy가 제어하지만 봇이 읽고 게시할 수 있는 위치는 Discord 권한이 결정합니다.
그룹 정책을 넓히면 해당 Discord Gateway 인텐트도 업데이트하고 Anyy를 다시 로드하세요. 유효한 토큰만으로 메시지 이벤트 전달이 보장되지는 않습니다.
문제 해결
| 증상 | 확인 사항 |
|---|---|
| 봇은 인증되지만 서버 메시지를 받지 못함 | 서버/메시지 인텐트, 봇 설치, 채널 권한, 그룹 정책 검토 |
| 멘션만 작동함 | 기본 mention 정책에서는 정상 동작 |
| DM이 발신자 페어링을 기다림 | 페어링 요청 승인 후 새 DM 전송 |
| 응답이 잘못된 위치로 감 | 이벤트에 의도한 채널/스레드 식별자가 있는지 확인 |
| 첨부 파일 누락 | Discord URL 접근, 파일 크기, 미디어 제한, 진단 출력 확인 |
공통 페어링 및 다시 로드 동작은 메시징 플랫폼을 참조하세요.