跳至主要內容

QQ 機器人

QQ Bot 使用官方 WebSocket Gateway 收事件,透過 REST 傳送回覆,不需要公用網路入站 Webhook。常駐 Gateway 要能主動連線 QQ 平台。

先建立應用程式,再填認證資料​

準備 QQ Bot App ID、App Secret,並啟用 C2C 與群組對話 @ 訊息所需 Intent。平台設定入口以官方事件訂閱文件為準。

在 Dashboard 通訊管道 → 新增 → QQ Bot 的預設 WebSocket 接入填寫 app_id 與 client_secret。預設帳號 ID 是 bot;bot_user_id 為可選的機器人身分匹配欄位,不是要發訊息的聯絡人號碼。

私訊和群組對話分別放行​

預設 DM 為 pairing,Group 為 mention。CLI 互動精靈 anyy setup channel 可修改策略:私訊 pairing/open/allowlist/disabled,群組對話 mention/open/allowlist/disabled。Dashboard 認證資料表單沒有這些策略輸入,名單條目也不是此平台目前公開設定欄位。

anyy channel pairing list --channel qqbot
anyy channel pairing approve --request REQUEST_ID

核對傳送者身分後批准,再傳送新訊息。QQ Bot 的群組對話路徑要求按所選策略提及機器人,不應將私訊成功當成群組對話也已驗證。

看實際收發,不只看身分探測​

anyy channel reload
anyy channel doctor qqbot

分別測試一則 C2C 訊息和一則群組 @ 訊息。身分檢查成功而沒有事件時,優先檢查 Intent、訂閱和應用程式可用狀態,不必先輪換 App Secret。

回覆綁定目前入站訊息的上下文,不可將舊對話記錄當作任意主動傳送權限。平台拒發時檢查身分、上下文、發信授權和目前診斷;未知/部分成功的結果先看平台記錄,再決定是否需要另一則回覆。存取控制和投遞狀態的通用說明見訊息平台。