QQ 공식 봇 연동

현재 작업

QQ 공식 봇 연동

검증 방법

공식 봇 계정으로 승인된 메시지를 수신하고 답장합니다.

사전 조건

AppID/AppSecret으로 access_token을 받고 서버에서 QQBot 인증을 사용하세요. 기존 Token 방식은 폐기되었습니다.

API 키

AppID/AppSecret으로 access_token을 받고 서버에서 QQBot 인증을 사용하세요. 기존 Token 방식은 폐기되었습니다.

모델 / 서비스

로컬 모델 설계에는 구체적인 모델 선택과 도구 기능 검증이 필요합니다. 기기 연결 자체에는 대형 언어 모델이 필요하지 않습니다.

에이전트 / 실행 환경

검토한 도구만 나열합니다. 공식 지원이 명시되지 않은 AI 연결 계층과 자율 계획 기능은 아직 구현과 검증이 필요합니다.

하드웨어

하드웨어 요구사항은 소프트웨어, 모델, 양자화, 작업에 따라 달라집니다. 최소 사양이나 원활한 성능에 대한 실측은 하지 않았습니다.

권한과 위험

로컬 모델도 Tencent를 통해 송수신합니다. 승인된 맥락만 처리하고 그룹 대화를 대량 반출하지 마세요.

API 키

AppID/AppSecret으로 access_token을 받고 서버에서 QQBot 인증을 사용하세요. 기존 Token 방식은 폐기되었습니다.

플랫폼 정책

공식 봇은 개인 QQ 계정을 제어하지 않습니다. 심사와 권한을 준수하고 스팸, 괴롭힘, 차단 우회를 하지 마세요.

실행 환경 선호

백엔드는 로컬 또는 호스팅 방식이 가능합니다. 콜백 네트워크는 별도로 확인하고 기존 봇과 Tunnel은 변경하지 마세요.

검증 방법

계획: 로컬 합성 응답으로 오류 코드와 만료를 확인하고 별도 테스트 자격 증명 확보 후 허용 메시지 한 건과 철회를 시험합니다. 미실행입니다.

검증 방법

공식 문서를 검토했지만, 이 사이트는 해당 조합을 실행하거나 기기를 실측하지 않았습니다.

제한과 적용 범위

현재 그룹 엔드포인트와 이벤트 서명 문서를 완전히 확보하지 못했습니다. 추측하지 마세요. 네트워크, 비용, 자격은 미확인입니다.

대안

전제조건을 충족하지 못하면 읽기 전용 또는 수동 절차를 먼저 사용하고, 아래 대안을 다시 검증하세요. 현재의 호환성 상태를 그대로 적용하지 마세요.

대안

telegram-bot

line

discord

비용

미확인

가격은 아직 검증하지 않았습니다. 소프트웨어, 모델, API, 하드웨어, 호스팅 비용을 각각 확인하세요.

구현 단계

1. 01
   공식 v2 문서로 별도 테스트 봇을 등록하고 필요한 플랫폼 심사를 완료하세요.
2. 02
   서버에서 비밀을 보호하고 HTTP 상태뿐 아니라 접근 자격 증명과 업무 오류 코드를 확인하세요.
3. 03
   허용된 합성 메시지만 시험하고 모델 추가 전 신원, msg_id, 만료, 중지 동작을 확인하세요.

연결 방식

BlueFish에서 직접 테스트하지 않음

POST https://api.bot.qq.com/app/getAppAccessToken

POST https://api.bot.qq.com/v2/users/{user_openid}/messages

제한과 적용 범위

• 현재 그룹 엔드포인트와 이벤트 서명 문서를 완전히 확보하지 못했습니다. 추측하지 마세요. 네트워크, 비용, 자격은 미확인입니다.
• 공식 문서를 검토했지만, 이 사이트는 해당 조합을 실행하거나 기기를 실측하지 않았습니다.

원본 출처

1. Tencent QQ 공식 문서 · src-qq-v2-start ↗

   bot.q.qq.com · 2026-10-16 · 공식 문서

2. Tencent QQ 공식 문서 · src-qq-v2-token ↗

   bot.q.qq.com · 2026-10-16 · 공식 문서

3. Tencent QQ 공식 문서 · src-qq-v2-call-guide ↗

   bot.q.qq.com · 2026-10-16 · 공식 문서

4. Tencent QQ 공식 문서 · src-qq-v2-changelog ↗

   bot.q.qq.com · 2026-10-16 · 공식 문서