| Enabled |
| 
| Awaiting payment |
| 
| Disabled |
| 
| Blocked |
| Enabled |
| | Awaiting payment |
| | Disabled |
| | Blocked |
| Enabled |
| | Pending verification |
| | Invalid DKIM |
| | Disabled |
| | Blocked |
If Spam sending attempts are repeated over time, the email account will be prevented from sending further messages through an SMTP block. Your first task will be to scan the user’s PC to make sure there are no viruses or malware, and then change the password of the blocked account. Once these procedures have been completed, you can unblock SMTP by following the procedure described in the [documentation](https://docs.qboxmail.com/it/caratteristiche/smtp-policy#sblocco-dell-smtp).
### Anomalous sending notification [#anomalous-sending-notification]
Qboxmail accounts are protected by a system that detects when an account performs anomalous email sending through our SMTP servers.
This usually happens after the login credentials for the email account have been stolen, with the aim of using that account to send spam or phishing emails. When this anomalous activity is detected, an email is sent to the mailbox under attack and to the owner of the Qboxmail account to which that mailbox is linked. In addition, as a precaution, the sending of further emails via SMTP is temporarily suspended.
Once the cause has been identified, including by analyzing sending logs through the Tracemail tool, and the problem has been resolved, including by using Antivirus on the user’s computer, a password change must be performed.
Once these procedures have been completed, you can unblock SMTP by following the procedure described in the [documentation](https://docs.qboxmail.com/it/caratteristiche/smtp-policy#sblocco-dell-smtp).
#### Spam from a compromised SMTP account analyzed by Tracemail [#spam-from-a-compromised-smtp-account-analyzed-by-tracemail]
The SMTP service analyzes outgoing emails to detect the presence of viruses or spam. If these messages contain material that is harmful to recipient users or to the reputation of Qboxmail servers, sending is not allowed.
### Sending limits during the Free Trial period [#sending-limits-during-the-free-trial-period]
During the free trial period, the number of messages you can send is reduced to 25 per email account within 24 hours in order to prevent abuse. When you exceed this limit, the SMTP server returns the error “Quota exceeded (number of mails in total)” during sending. The counter is automatically reset 24 hours after the first send. The limit is removed once you complete an order from the Control Panel.
# Checking the settings (/en/guides/whmcs/check-settings)
## 7.1 [#71]
To check whether the installation was successful and whether the choices made when creating products and their configurable options are in line with your sales strategy, you should place an order by simulating the experience your customers will have.
Log in from the client area and place an order. If everything went as expected, you are ready to start expanding your offer with Qboxmail services!
### Place a test order [#place-a-test-order]
### Check the DNS record [#check-the-dns-record]
### Create a test email mailbox [#create-a-test-email-mailbox]
### Create a test email alias [#create-a-test-email-alias]
Remember that the Qboxmail module for WHMCS is free and tested on WHMCS version 8.6. In case of technical issues or suggestions, please open a ticket from your Qboxmail client area available at [qboxmail.it/manager](https://www.qboxmail.it/manager/) .
# WHMCS Configuration (/en/guides/whmcs/configuration)
## 4.1 Generating the API token in the Control Panel [#41-generating-the-api-token-in-the-control-panel]
For the next step, you need to generate a Qboxmail API token.
Log in to the Qboxmail [Control Panel](https://panel.qboxmail.com). Click the avatar in the top right and select “**Settings**”. Scroll to the bottom of the settings page to find “**API Access**”. Copy the token by clicking the “**Copy**” button.
## 4.2 Adding a new server in WHMCS [#42-adding-a-new-server-in-whmcs]
Go back to the WHMCS page.
From the selection menu in the top right, click the setup button and select System Setting. On the System Setting page, select “**Servers**” and click “**Add new server**”.
## 4.3 Server details [#43-server-details]
On the “Servers” page, go to the “**Module**” section and select "**Qboxmail**".
For “**Hostname**”, enter **panel.emailpnl.com**. Leave the “Username” and “Password” fields empty.
In the “**Access Hash**” window, paste the API token generated in the Qboxmail Control Panel and click the “**Test Connection**” button.
## 4.4 Server name [#44-server-name]
Once the connection to the Server has been confirmed, you will land on the settings page where you must choose and enter a name for the newly connected server. In this example, the name “Qboxmail” was chosen. Once the operation is complete, click the “**Save Changes**” button at the bottom of the page.
## 4.5 Creating a server group [#45-creating-a-server-group]
After connecting the Qboxmail server, you need to create a new server group and assign it to the Qboxmail server you just connected.
Click setup > System Setting > Servers > **+Create a new group**. You can choose any name for the server group; in the example, the name “Qboxmail – Group” was chosen.
**IMPORTANT:** Once you have chosen the name, you must select the server created in step **4.3** and move it to the right-hand column using the “**Add**” button. Save the changes by clicking "**Save Changes**".
# Creating a Qboxmail account (/en/guides/whmcs/create-account)
Before installing the WHMCS module, you need an active Qboxmail account.
The full activation flow is documented in [Email Hosting > Activation](/en/guides/email-hosting/activation).
After activation, continue with the WHMCS module installation:
Now return to “**Product Setting**”. The available options refer to the 3 different plans into which the Qboxmail service is divided. You must therefore choose which of the 3 plans (Basic, Professional, Enterprise) will regulate your product.
In the example, a product regulated by the “Professional” plan was chosen.
After choosing the plan, click “**Create Configurable Options**”.
Here you can choose the configurable options linked to the product in question. **The configurable options refer to the mailbox sizes that can be activated through Qboxmail services.**
When you click "Confirm", you are automatically redirected to the "**Configurable Options**" tab. Verify that the row for the Product created in step 6.2 is selected, then click "**Save Changes**".
### 6.2.2 [#622]
Now move to the “**Details**” tab, where you need to check the “**Require Domain**” option:
Continue creating the product by entering a **description** that highlights the benefits the user would get from choosing this product.
### 6.2.3 [#623]
Move to the “**Pricing**” tab, where you can choose the billing cycle linked to the product that best suits your sales strategy.
Under “**Payment Type**”, select “**Recurring**” and choose your preferred billing cycle. You can select different billing cycles for the same product if necessary; this choice also depends on your sales strategies. To enable different billing cycles for the same product, you must click “**Enable**” for each billing cycle you want to accept.
At this stage, you do not need to specify the product price because all services provided by Qboxmail are configurable. The price will be entered later, when choosing the configurable options. Check “**No**” for “**Allow Multiple Quantities**”.
The rest of the options can be adjusted according to your sales strategy.
## 6.3 Configurable options [#63-configurable-options]
Click Setup > System Settings > **Configurable Options**
On this page, you can configure products according to the Qboxmail service plan variables described in step **6.2.3**.
Click the “**Edit**” button to edit the *configurable option* of the desired product.
For each product, you can adjust the available configurable options, which depend on the plan that regulates the product. Let’s take as an example a product regulated by the “Enterprise” plan. You will therefore be able to adjust all possible options, because the “Enterprise” plan allows you to activate mailboxes of all sizes available in the Qboxmail service.
Once you have chosen the product whose *configurable options* you want to edit, proceed to configuring the options.
Click the “**Edit**” button for the option you want to configure.
The configurations concern:
* The minimum number of mailboxes that can be ordered for a given product (depends on your sales strategies);
* The price of mailboxes for different billing cycles (depends on your sales strategies).
For “**Option Type**”, choose “**Quantity**”.
Set the prices for each billing cycle chosen in step **6.2.2**.
Set a minimum orderable quantity. The choice depends on your sales strategies.
## 6.4 Show the product [#64-show-the-product]
Once all configurable options have been set and the product is ready to be shown to customers, return to the “**Products/Services**” section and edit the product in question by unchecking "hidden".
# Setting up the domain registrar (/en/guides/whmcs/domain-registrar-settings)
### 3.1 [#31]
From the selection menu at the top right, click the setup button 
### 3.3 [#33]
If not already set up, enter an accepted payment method using the “**Activate Your First Payment Gateway**” option (if you have already set up a Payment Gateway, go to step 4.1).
# Module Transfer via FTP (/en/guides/whmcs/ftp-module-transfer)
### 2.1 [#21]
Unzip the **Qboxmail\_WHMCS\_v2.x.y.zip** file and, using your FTP client, transfer the Qboxmail folder (you can find it
inside **/modules/servers/Qboxmail/**) to your WHMCS server by following the path **\[WHMCS\_installdir] /modules/servers/**.
From here:
**Local package**
Hello from Qboxmail Delivery.
", }, ], }), }); const payload = (await response.json()) as SendResponse | { message?: string; request_id?: string }; if (!response.ok) { throw new Error(`Send failed: ${response.status} ${JSON.stringify(payload)}`); } return payload as SendResponse; } sendTransactionalEmail() .then((result) => { console.log({ requestId: result.request_id, queuedMessages: result.queued_messages, messageIds: result.messages.map((message) => message.message_id), }); }) .catch((error) => { console.error(error); process.exit(1); }); ``` ## Run it [#run-it] Save the code above as `send-transactional-email.ts`, then run: ```sh export QBOXMAIL_SEND_API_TOKEN="Hello {{first_name}}
" }, "recipients": [ { "email": "john@example.com", "substitutions": { "first_name": "John" } } ] } ``` Bulk templates use Handlebars-style variables such as `{{first_name}}`. The special `{{email}}` variable is always available. By default, `strict_substitutions` is enabled: each recipient must provide every variable used by the template. Set `options.strict_substitutions` to `false` only when missing variables may safely render as empty strings. ## Response shape [#response-shape] Successful Send API responses look like this: ```json { "error_code": 0, "message": "OK", "request_id": "f43eb659-beb4-4f8a-a737-2d403998f4cf", "queued_messages": 1, "messages": [ { "error_code": 0, "message": "OK", "request_id": "f43eb659-beb4-4f8a-a737-2d403998f4cf", "message_id": "8a16f3df-7f5f-4e53-a7e7-3e665ef57c51@example.test", "submitted_at": "2026-04-16T08:41:13.225Z", "to": "john@example.com" } ], "suppression_summary": { "status": "checked", "checked_recipients": 1, "accepted_recipients": 1, "suppressed_recipients": 0, "suppressed_emails": [] } } ``` Store `request_id` and `message_id`. They are the fastest way to correlate application logs with TraceMail and support investigations. # Activation and access (/en/guides/email-hosting/archive/activation-and-access) ## How to activate Email Archive [#how-to-activate-email-archive] To activate the archive on one or more email accounts, follow the steps below: 1. Make sure your plan already includes the archive option: if you have the *monthly plan*, you can proceed independently; if you have the *annual plan*, please contact us to request a quote for adding archives. 2. Log in to the Control Panel and check/set, in the [domain limits](https://docs.qboxmail.com/it/panel/gestione/domini#impostazioni-del-dominio), the maximum number of archives that can be activated (set -1 if you want an unlimited number of archives). 3. Log in to the Control Panel and follow the [archive activation](https://docs.qboxmail.com/it/archivio/gestione/aggiunta-archivio) procedure. 4. Once the archive has been activated, if you want to copy the messages currently in your mailbox to the archive, you need to perform a [message import](https://docs.qboxmail.com/it/archivio/gestione/importazione-messaggi). When the import is complete, you will receive an email message. 5. Access the Archive and check that the message import completed successfully. 6. Now, if you want, you can delete some messages from your email account to free up space. These messages, if they are not older than the configured number of years, will remain in the archive in read-only mode. ## Accessing Email Archive [#accessing-email-archive] To access Email Archive, the service must be activated on at least one domain and one email account.
| Updating |
| 
| Active |
| 
| Disabled |
### List of email accounts with archive [#list-of-email-accounts-with-archive]
The list of email accounts with archive includes all email accounts belonging to a domain on which the archiving service is active,
with their related detailed information. To access the list of email accounts with archive enabled, click the name of the domain the
account belongs to in the list of domains with archive.
Information included in the list of email accounts with archive:
* Status
* Email account address with archive
* Number of archiving years
* Number of active delegates
| Status | Description |
| ------------------------------------------ | ----------- |
| | Updating |
| | Active |
| | Disabled |
# Archive settings (/en/guides/email-hosting/archive/archive-settings)
### Domain archive settings [#domain-archive-settings]
To change archive settings, click the name of the domain you want to modify, where the archive is active, in the list of domains with archive, and select *Settings* from the available tabs.
#### Domain archiving [#domain-archiving]
Choose the default retention period for messages received and sent by the accounts in the domain.
| Updating |
| | Active |
| | Disabled |
# Delegate settings (/en/guides/email-hosting/archive/delegate-settings)
To change a delegate’s settings, click the name of the manager you want to edit in the delegates list and select *Settings* from the available tabs.
### Password [#password]
Change the delegate’s password for accessing the archive.
### Time limits [#time-limits]
Change the delegate’s archive access limits set during creation.
### Content access [#content-access]
Change the domains and accounts that the delegate can view.
# Delegate (/en/guides/email-hosting/archive/delegate)
### Who is the Delegate? [#who-is-the-delegate]
The Delegate is a user authorized to access the email archive of one or more accounts within specific limits. The delegate’s account is personal and must be treated as such.
### Who can appoint a Delegate? [#who-can-appoint-a-delegate]
The delegate can be appointed by an Admin, a Team member, or a Manager authorized to enable archives.
| Updating |
| | Active |
| | Disabled |
### List of email accounts with archive [#list-of-email-accounts-with-archive]
The list of email accounts with archive includes all email accounts belonging to a domain on which the archiving service is active,
with their detailed information. To access the list of email accounts with active archive, click the name of the domain the
account belongs to in the list of domains with archive.
Information shown in the list of email accounts with archive:
* Status
* Email account address with archive
* Number of archive years
* Number of active delegates
| Status | Description |
| ------------------------------------------ | ----------- |
| | Updating |
| | Active |
| | Disabled |
### Add archive to a domain [#add-archive-to-a-domain]
To add the archive service to a domain, click *Archive* in the Control Panel sidebar,
click the `Archive` button, and complete the activation procedure steps. Once the procedure is completed, the archive will be active
on the email accounts of the domain you selected and all new messages received and sent by those accounts will be archived automatically.
#### Step 1 - New archive [#step-1---new-archive]
Choose the domain and the email accounts belonging to it on which to enable the archive.
1. Select the domain on which you want to enable the archive.
2. Select the email accounts you want to archive.
| Updating |
| | Active |
| | Disabled |
### Add a delegate [#add-a-delegate]
To add a Delegate, click *Delegates* in the Control Panel sidebar, click the `+ Delegate` button, and complete the creation steps. Once complete, the Delegate will be visible in your Delegate list.
#### Step 1 - New delegate [#step-1---new-delegate]
Enter the user's details.
1. Enter the user's first name.
2. Enter the user's last name.
3. Enter the user's company name.
4. Enter the user's email address.
#### Step 2 - Time limits [#step-2---time-limits]
Set the time limits for the user's access to the archive.
1. Set an expiration date for the user's account.
2. Set a time range for the user to view content.
### Step 3 - Content access [#step-3---content-access]
Set the user's archive content access limits.
1. Select the domain for the accounts the user can view.
2. Select the email accounts the user can view and choose which content to make visible:
| | |
| ----------- | ----------------------------------------------------------------------------------------------- |
| **Subject** | The delegate can only see sender / recipient, subject, and date of the messages in the account. |
| **All** | The delegate can see the full content of the messages in the account. |
| **Ignore** | The delegate is not authorized to view the content of the account. |
| Updating |
| | Active |
| | Disabled |
### Add a domain alias [#add-a-domain-alias]
To add a domain alias, click *Domains* in the Control Panel sidebar and open the details of the domain you want to associate
the alias with by clicking its name. Select *Domain aliases* from the available tabs, click the `+ Domain alias` button, and enter the name of the domain alias
you want to add.
Once the procedure is complete, the domain alias will be visible in the list of domain aliases associated with your domain and you will only need to verify its ownership to make it fully operational.
### Domain alias ownership verification [#domain-alias-ownership-verification]
Before you can use a domain alias, as with real domains, you must prove that you own it or are authorized to
manage it by following the same [verification methods](/en/guides/email-hosting/control-panel/domains#domain-ownership-verification) used for real domains.
### Delete a domain alias [#delete-a-domain-alias]
To **delete** a domain alias from the domain aliases list, click the Trash button | Updating |
| 
| Waiting for ownership verification |
| | Active |
| 
| Active with MX records to update or verify |
| | Disabled |
| 
| With errors (contact our technical support team) |
### Add a domain [#add-a-domain]
To add a domain, click *Domains* in the Control Panel sidebar, then click the `+ Domain` button and complete the steps in the
creation wizard. Once the wizard is complete, the domain will be visible in your domain list.
#### Step 1 - Select plan [#step-1---select-plan]
[Choose the plan](/en/guides/email-hosting/available-plans) (Basic, Professional, or Enterprise) you want to assign to the domain you are creating from the available options, according to your needs.
| Updating |
| | Active |
| | Inactive |
### Add an email account [#add-an-email-account]
To add an email account, click *Domains* in the Control Panel sidebar and open the details of the domain you want to add
the email account to by clicking its name. Select *Email account* from the available tabs, click the `+ Email account` button and
complete the steps in the creation process. Once the process is complete, the email account will be visible in your email account list.
#### Step 1 - New Account [#step-1---new-account]
Enter the details of the user who will use the email account and choose a name for the account you are creating.
1. Enter the name / description of the user who will use the account.
2. Enter the surname of the user who will use the account.
3. Choose an email address for the account.
4. Choose a password to access the account\*. \*You can generate a password automatically and randomly.
| Updating |
| | Active |
| | Inactive |
### Add an email alias [#add-an-email-alias]
To add an email alias, click *Domains* in the Control Panel sidebar and open the details of the domain you want to associate
the email alias with by clicking its name. Select *Email alias* from the available tabs, click the *+ Email alias* button, and fill in the required fields:
1. Enter the name of the email alias you want to create.
2. Enter one or more addresses to which messages received by the email alias should be forwarded by clicking the *Add* button.
| Validating |
| | Valid import |
| | Invalid import |
### Delete an import [#delete-an-import]
To **delete** an import from the imports list, click the Trash button | Updating |
| | Active |
| | Inactive |
### Add a manager [#add-a-manager]
To add a Manager, click *Multi-level* and then *Manager* in the Control Panel sidebar, click the `+ Manager` button, and complete the creation steps. Once complete, the Manager will be visible in your Manager list.
#### New manager [#new-manager]
Enter the user's details, assign the domains they can manage, and set the related limits.
1. Enter the user's first name.
2. Enter the user's last name.
3. Enter the user's company name.
4. Enter the user's email address.
5. Choose a password to access the account (you can generate a random password automatically).
6. Set the maximum number of domains the manager can activate.
7. Set the maximum total number of 8 GB and 25 GB accounts the manager can activate.
8. Set the maximum total number of archives the manager can activate.
9. Select the domains the manager will be able to manage.
To complete the procedure, click the `Create` button. Once the Manager has been created, they will be visible in your Manager list.
### Manager settings [#manager-settings]
To edit a manager’s settings, click the name of the manager you want to edit in the manager list.
#### General [#general]
Settings and limits for the Manager’s service management.
### Security [#security]
Change the Manager’s Control Panel password.
### Deactivate / reactivate a manager [#deactivate--reactivate-a-manager]
To **deactivate** a manager, in the manager list click the More button | Validating |
| | Valid migration |
| | Invalid migration |
By accessing the migration resource list, you can view all details of the accounts in the migration CSV file and their related outcomes or errors.
### Delete a migration [#delete-a-migration]
To **delete** a migration from the migration list, click the Trash button | Updating |
| | Active |
| | Inactive |
### Postmaster settings [#postmaster-settings]
To edit a postmaster’s settings, click the postmaster address in the postmaster list that you want to modify.
### Personal details [#personal-details]
This section contains information about the user assigned to the Postmaster account.
#### Account information [#account-information]
Enter the details of the user assigned to the Postmaster account. The available fields vary depending on the plan selected for the domain.
#### Language and time zone [#language-and-time-zone]
Set the default language (Italian or English) and time zone for the postmaster.
### General [#general]
Settings and limits for the Postmaster account.
#### Sending limits [#sending-limits]
Change the maximum number of email messages that can be sent daily by the postmaster.
| Updating |
| | Active |
| | Disabled |
### Add a Team member [#add-a-team-member]
To add a Team member, click *Multi-level* and then *Team* in the Control Panel sidebar, click the `+ Team member` button, and complete the creation steps. Once complete, the Team member will be visible in your Team member list.
#### Step 1 - New Team member [#step-1---new-team-member]
Enter the user's details.
1. Enter the user's first name.
2. Enter the user's last name.
3. Enter the user's email address.
4. Choose a password to access the account\*.
\*You can generate a random password automatically.
#### Step 2 - Domain management [#step-2---domain-management]
Set the domain management permissions for the Team member.
1. Authorize the team member to view domains.
2. Authorize the team member to create new domains.
3. Authorize the team member to disable / reactivate domains.
4. Authorize the team member to delete domains.
5. Authorize the team member to manage managers.
#### Step 3 - Account management [#step-3---account-management]
Set the account management permissions for the Team member.
1. Authorize the team member to edit accounts.
2. Authorize the team member to create new accounts.
3. Authorize the team member to disable / reactivate accounts.
4. Authorize the team member to delete accounts.
5. Authorize the team member to change account passwords.
### Step 4 - Archive management [#step-4---archive-management]
Set the archive management permissions for the Team member.
1. Authorize the team member to view archives.
2. Authorize the team member to activate new archives.
3. Authorize the team member to disable / reactivate archives.
4. Authorize the team member to delete archives.
5. Authorize the team member to manage delegates.
#### Step 5 - Analytics and security tools [#step-5---analytics-and-security-tools]
Set the analytics tool permissions for the Team member.
1. Authorize the team member to view Tracemail.
2. Authorize the team member to view the Log.
3. Authorize API access for the Team member.
To complete the procedure, click the `Create` button. Once the Team member has been created, they will be visible in your Team member list.
### Team member settings [#team-member-settings]
To edit a team member’s settings, click the name of the team member you want to edit in the team member list.
#### General [#general]
Settings and limits for the Team member’s service management.
#### Domain management [#domain-management]
Set domain management permissions for the team member.
* Authorize the team member to view domains.
* Authorize the team member to create new domains.
* Authorize the team member to disable / reactivate domains.
* Authorize the team member to delete domains.
* Authorize the team member to manage managers.
#### Account management [#account-management]
Set account management permissions for the team member.
* Authorize the team member to edit accounts.
* Authorize the team member to create new accounts.
* Authorize the team member to disable / reactivate accounts.
* Authorize the team member to delete accounts.
* Authorize the team member to change account passwords.
#### Archive management [#archive-management]
Set archive management permissions for the team member.
* Authorize the team member to view archives.
* Authorize the team member to activate new archives.
* Authorize the team member to disable / reactivate archives.
* Authorize the team member to delete archives.
* Authorize the team member to manage delegates.
#### Analytics tools [#analytics-tools]
Set access to analytics tools for the team member.
* Authorize the team member to view Tracemail.
* Authorize the team member to view the Log.
#### API access [#api-access]
Authorize API access for the Team member.
#### Security [#security]
Change the team member’s Control Panel access password.
### Disable / reactivate a Team member [#disable--reactivate-a-team-member]
To **disable** a team member, in the team member list click the More button 
#### How to choose the toolbar [#how-to-choose-the-toolbar]
Each toolbar includes:
* a selection **radio button**
* the **name**
* a **short description**
* a **preview**
Select the desired toolbar using the radio button and confirm your choice by clicking `Save` at the top right.
The selected toolbar will **automatically replace the one currently in use** in the message composition window.
### Email templates [#email-templates]
Email templates make it easier to compose recurring emails by saving templates that you can choose when composing a message.
#### Create an email template [#create-an-email-template]
Go to *Email templates*. By clicking the New `email` template button, you can set up a new message to save as a default template.
You need to specify:
* Name: useful for identifying the message among the other saved messages. It will not be part of the email when sent.
* Identity: select from the proposed list the address from which you want the template to be sent. If a signature has been configured for the selected identity, it will automatically be added at the end of the message.
* The message subject.
* The message text.
* You can also add attachments.
After saving at least one template, when composing a new email message you can click
Email templates 
### **Write and send a new email message** [#write-and-send-a-new-email-message]
To open the composition window for a new email message, click the `New message` button or