QQ Integration

Required config

{
  "services": {
    "chat": {
      "channels": {
        "qq": {
          "enabled": true,
          "appId": "${QQ_APP_ID}",
          "appSecret": "${QQ_APP_SECRET}",
          "sandbox": false
        }
      }
    }
  }
}

Start runtime

sma agent on

Verify channel status

sma service status chat

Voice messages (voice/audio)

When extensions.voice.enabled=true, QQ inbound voice/audio attachments are transcribed in best-effort mode and the transcript is appended to the user instruction.

Recommended setup:

sma voice on SenseVoiceSmall
sma voice status

Notes:

• Transcription failures do not break the main chat flow.
• QQ voice attachment delivery depends on gateway AUDIO_ACTION capability. If your bot app does not have that permission, audio payload fields may be missing.