QQ 公式ボット API の使用（Webhook 方式を使用）

この記事では、テストボットのデプロイのみを提供します。ボットの正式な起動については、リリースプロセスに従ってください。

WARNING

QQ 公式は、AIGC 機能への不正アクセスを禁止する発表を行いました。注意して使用してください。

QQ ボットの登録（テストボット）

基本ボット情報の設定

QQ Open Platformにアクセスし、下部の「アプリケーション管理」を見つけ、ボットを作成をクリックし、基本情報を入力して、ボットページに入ります。以下のように：

「ホーム」オプションの「リリースプロセス」は、ボットを起動する手順です。テストバージョンのボットをデプロイしているため、「情報」と「サンドボックス設定」セクションを完了するだけで済みます。

まず情報を入力し、次にサンドボックス設定をクリックします。

サンドボックス設定の構成

「サンドボックス設定」をクリックします。 QQ グループにデプロイする場合は、「QQ グループ ID」の下の要件に従ってグループチャットを選択し、メッセージリスト設定でプライベートチャット権限を持つユーザーを追加します。
QQ チャンネルにデプロイする場合は、「チャンネル ID」の下の要件に従ってチャンネル ID を選択します。ボットタイプは 0 です。

開発管理の構成

「開発管理」をクリックします。

「AppID」、「Token」、「AppSecret」を記録し、LangBot が配置されているサーバーの IP アドレスを IP ホワイトリストに追加します。

LangBot に接続

次に、LangBot 設定ページを開きます

Bots をクリックし、次に Add をクリックします

Platform/Adapter Selection で QQ Official API を選択します

コールバックアドレスの設定

LangBot は、パブリック IP アドレスを持つサーバーにデプロイする必要があり、HTTPS が正常に有効になっている必要があります。ドキュメント HTTP リバースプロキシと SSL の設定に従って設定してください。

後続の設定

Caddy の起動に失敗した場合は、Caddy ドキュメントを読むか、LangBot コミュニティグループに参加してヘルプを求めてください。

以下は、考えられる問題の一部です：

• ポート 443 が開いていない
• ドメインがマシンに解決されていない
• Caddyfile が正常に保存されなかった

管理ポータルのコールバックアドレスの設定

まず LangBot を起動します。

ボット管理ポータルの「コールバック設定」をクリックし、「イベントを追加」の下のすべてのイベントをチェックします。

LangBot 設定ページに移動し、対応する QQ ボットを有効にして選択し、対応するボット設定ページから Webhook コールバックアドレスをコピーし、IP アドレスとポートを Caddy で設定したドメイン名に置き換えて、リクエストアドレスに入力します。

画像に示されているように：

たとえば、ドメインが testlb.com の場合、リクエストアドレスに testlb.com/bots/xxxxxx-xxxxxx を入力し、設定の確認をクリックします。コールバックアドレスが正常に保存された場合、デプロイは成功です。「検証失敗」が表示された場合は、上記の設定項目が正しく入力されているかどうかを注意深く確認してください。

公開方法

「ホーム」のリリースプロセスに入り、プロセスに従ってボットを公開して起動します。