QQ公式Bot接続

今回の目的

QQ公式Bot接続

検証方法

公式Botとして許可されたメッセージを受信・返信します。

前提条件

AppID/AppSecretでaccess_tokenを取得し、サーバー側でQQBot認証を使います。旧Tokenは非推奨です。

API キー

AppID/AppSecretでaccess_tokenを取得し、サーバー側でQQBot認証を使います。旧Tokenは非推奨です。

モデル / サービス

ローカルモデル設計では具体的なモデルとツール能力の確認が必要です。機器接続自体にはLLMは不要です。

エージェント / 実行環境

確認済みツールのみ掲載しています。公式対応の明記がないAI橋渡し・自律計画は実装と検証が必要です。

ハードウェア

機器要件はソフトウェア・モデル・量子化・作業によって変わります。最低構成や快適動作は実測していません。

権限とリスク

ローカルモデルでもTencent経由で送受信します。許可された文脈だけを処理し、グループ履歴を一括取得しません。

API キー

AppID/AppSecretでaccess_tokenを取得し、サーバー側でQQBot認証を使います。旧Tokenは非推奨です。

プラットフォーム規約

公式Botは個人QQアカウントの乗っ取りではありません。審査と権限を守り、迷惑送信、嫌がらせ、停止回避を行いません。

実行環境

バックエンドはローカル・ホスト型を選べます。コールバック通信は別途確認し、既存BotやTunnelは変更しません。

検証方法

計画：ローカルの合成応答でエラーと期限を確認し、独立した試験用認証情報の取得後に許可済み1件と取消を試験します。未実行です。

検証方法

公式資料を確認済みです。当サイトでは組み合わせや実機の動作を検証していません。

制限と境界

現在のグループAPIとイベント署名資料は未取得部分があります。推測せず、接続、費用、資格は不明として扱います。

代替案

条件を満たさない場合は読取・手動フローを使い、下記の代案を再確認します。現在の互換表示は引き継ぎません。

代替案

telegram-bot

line

discord

費用

要確認

価格は未確認です。ソフトウェア、モデル、API、機器、ホスティングの費用を個別に確認してください。

実装手順

1. 01
   公式v2資料で独立したテストBotを登録し、必要なプラットフォーム審査を受けます。
2. 02
   秘密情報をサーバー側で保護し、HTTP状態だけでなく認証情報と業務エラーコードを確認します。
3. 03
   許可された合成メッセージだけを試験し、モデル追加前にID、msg_id、有効期限、停止を確認します。

接続方式

当サイトでは未実測

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

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

制限と境界

• 現在のグループAPIとイベント署名資料は未取得部分があります。推測せず、接続、費用、資格は不明として扱います。
• 公式資料を確認済みです。当サイトでは組み合わせや実機の動作を検証していません。

元の出典

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 · 公式ドキュメント