QQ Bot
QQ Bot 채널은 공식 WebSocket Gateway에서 이벤트를 수신하고 플랫폼 API로 응답을 보냅니다. 상주 Gateway가 프로토콜 세션을 사용 가능한 상태로 유지합니다.
필요한 항목
- QQ Bot 애플리케이션.
- App ID.
- App Secret(Anyy에서는
client_secret으로 입력). - 선택적 Bot User ID.
- C2C 및 그룹
@메시지용 Gateway 인텐트.
최신 QQ Bot 이벤트 구독 문서를 참조하세요.
Dashboard에서 연결
- Dashboard → Channel → Add를 엽니다.
- QQ Bot을 선택합니다. 기본 항목은 WebSocket Gateway를 사용합니다.
- App ID와 App Secret을 입력합니다.
- 일치하는 플랫폼 정체성이 있을 때만 Bot User ID를 추가합니다.
- 계정 자격 증명을 저장한 뒤 CLI 마법사로 정책을 변경합니다.
- QQ Bot 콘솔에서 필요한 C2C/그룹
@메시지 인텐트를 활성화합니다.
기본 계정 ID는 bot입니다. 이 프로필에는 공개 수신 웹훅이 필요하지 않습니다.
접근 정책
다이렉트 메시지 기본값은 pairing, 그룹 기본값은 mention입니다. 지원 정책은 다음과 같습니다.
- DM:
pairing,open,allowlist,disabled. - 그룹:
mention,open,allowlist,disabled.
anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID
연결 확인
anyy channel doctor qqbot
anyy channel reload
대화형 anyy setup channel 마법사에서 QQ Bot을 선택해 정책을 편집하세요. Dashboard에는 정책 입력이나 페어링 승인 목록이 없고 현재 설정 작업은 QQ 허용 목록 항목을 편집하지 않습니다. 응답에는 원래 수신 메시지 컨텍스트가 필요합니다. 과거 대화가 임의의 선제 발신 권한을 주지는 않습니다.
C2C 메시지 하나와 그룹 멘션 하나를 테스트하세요. 서로 다른 이벤트 경로와 정책에 의존하므로 별도로 확인하세요.
자격 증명보다 인텐트 문제를 먼저 진단하세요
신원 점검은 성공하지만 메시지가 오지 않으면 App Secret을 교체하기 전에 Gateway 인텐트와 이벤트 구독을 확인하세요.
문제 해결
| 문제 | 확인 사항 |
|---|---|
| Gateway 인증 실패 | App ID와 App Secret |
| 연결되지만 이벤트가 오지 않음 | C2C/그룹 @ 메시지 인텐트와 앱 가용성 |
| 다이렉트 메시지 무시 | DM 정책과 페어링/허용 목록 |
| 그룹 메시지 무시 | 그룹 정책과 명시적 봇 멘션 |
| 수신은 되지만 발신 실패 | 봇 정체성과 플랫폼 발신 권한 |