Configure QQ Mail

Let an agent handle email through a specified QQ mailbox. Use a mailbox client authorization code, not the QQ login password.

Obtain an authorization code

  1. Sign in to QQ Mail and open Settings at the top.

  2. Find the POP3/IMAP/SMTP/Exchange/CardDAV services section. Enable the required IMAP/SMTP services if needed, then select Generate authorization code.

  3. Complete the account verification and copy the code. Enter it only in MOI’s authorization-code field.

Menus vary by mailbox version. If necessary, open account/security settings and find third-party client services, or search official help for authorization codes.

You need permission to create or edit tool configuration in the current MOI workspace. If the entry is missing or access is denied, contact the workspace administrator rather than using another person’s account.

Configure MOI

  1. Prepare a test mailbox and enable the required client services.

  2. Open Resource Center → Tools → QQ Mail and create an instance.

  3. Enter the name, complete email address, and authorization code.

  4. Save and test the connection.

  5. Select the mailbox instance in the agent’s tool configuration. If a code expires or is revoked, generate a new one, update, and retest.

Field

Requirement

Value

Instance name

Required

A name such as “Test QQ mailbox”

Email address

Required

The complete address; test-user@qq.com is only an example

Authorization code

Required

The client code generated by this same mailbox, not its login password

Timeout

As offered by the form

Usually retain the default; longer timeouts do not fix authentication

Validate agent use

After saving, reopen the configuration to confirm it persists and run Test connection. Then bind the capability to the target agent, selecting the intended connection wherever an instance selector is provided. Inspect an actual tool call and compare its result with the target platform. A configured badge or a plausible answer alone is insufficient.

First query a known test message in the mailbox. For sending, specify your own recipient address and explicit test content, then check actual receipt. A connection test does not establish delivery.

Troubleshoot

Symptom

Check

Authentication failed

Correct code rather than login password, matching mailbox, and enabled services

Connection timeout

MOI server outbound access to mailbox services

Message not received

Send result, recipient, spam folder, and bounces before repeating the send
Last updated on