Connect QQ Mail with your email address and authorization code so agents can access mail over IMAP/SMTP.
Once QQ Mail is connected, agents can access your mailbox over the IMAP/SMTP protocols and work with mail data.
Connecting requires no auth config. The connection dialog has only two fields: Email address and Authorization code.
The authorization code is not your QQ password — it is a credential QQ Mail issues separately for third-party clients. To get one:
A set of mail-related tools is generated once the connection succeeds. View them in the Available tools section of the App details page. Refer to the page for the actual tool list.
You can create multiple connectors under the same QQ Mail App, each for one mailbox account and its authorization code. To connect several mailboxes, generate a code for each and create a connector per mailbox, telling them apart by connector name.
For how to manage them, see Connected accounts.
Before you connect
The authorization code is not your QQ password — it is a credential QQ Mail issues separately for third-party clients. To get one:
- Sign in to QQ Mail on the web, and go to Settings → Account and Security → Security Settings.
- Enable the IMAP/SMTP service.
- Click Generate authorization code, complete the QR-code or password verification as prompted, and copy the generated code.
Steps to connect
- Open the connection dialog: In the left-hand navigation of the console, click Apps, find the QQ Mail card, and click Connect. The dialog is titled Connect App, with a QQ Mail authentication section noting that the email address and authorization code are stored encrypted and used only to establish the mail connection.
- Enter the email address: Provide the full QQ Mail address, in the form
yourname@qq.com. Required. - Enter the authorization code: Provide the code generated in QQ Mail settings above. This is a password field, so your input is not echoed. Required.
- Submit: Click Submit. Note the button is Submit, not the Confirm used by Apps that need an auth config.
Automatically generated tools
A set of mail-related tools is generated once the connection succeeds. View them in the Available tools section of the App details page. Refer to the page for the actual tool list.
Multiple accounts
You can create multiple connectors under the same QQ Mail App, each for one mailbox account and its authorization code. To connect several mailboxes, generate a code for each and create a connector per mailbox, telling them apart by connector name.
For how to manage them, see Connected accounts.
Credential security
- The authorization code and email address are stored encrypted by the platform and used only to establish the mail connection.
- Do not paste the authorization code into chat groups, code repositories, or tickets.
- If the code leaks, generate a new one in QQ Mail Security Settings, then rebuild the connection with it.
Troubleshooting
| Symptom | Common cause |
|---|---|
| Authentication fails after submitting | The code is wrong, has extra whitespace, or has expired (changing the QQ password invalidates old codes). Generate a new one and retry |
| The email address is rejected | The address is incomplete — it must include the @qq.com suffix |
| Connection succeeds but no mail is readable | The IMAP/SMTP service is not enabled or was turned off in QQ Mail. Check the service state in Security Settings |
| A previously working connection suddenly fails | The code was regenerated or the QQ password changed. Rebuild the connection with the current valid code |