This functionality allows your users to send certain commands to quickSMTP and these commands will be executed as soon as the email is received, as well as during queue runs. To have this functionality running, you must have properly set the Service Account of your server.
In order to trigger this functionality, your user has to send an email with subject:
Emails with subject different than Commands will be ignored.
Next step is to authenticate. Authentication is performing by specifying the email account and its password. It is not necessary that the sender of the message and the email account specified inside the message are the same. This way one user can manage mailboxes of others.
You can decide individually for each account if Automated Commands are allowed for this particular account. There is a check-box in the account editor that let's you control permission for this activity.
Each command consists of two words - command itself and the value. Each command has to be terminated by semicolon character ( ; ). New lines do not matter - you can write everything on a single line, as long as everything is divided by semicolon. Leading and trailing spaces are also removed automatically.
In order to authenticate, the mesage has to start in the following way:
User firstname.lastname@example.org ; Pass mypassword ;
In the example above email@example.com has to be replaced with the actual mailbox address and mypassword with the password for this box. If authentication is not successful or the particular mailbox does not allow Automated Commands, quickSMTP will reply with general message for failed authentication.
Note, that all replies will be sent back to the sender of the message, not to the mailbox being managed!
Currently supported commands
As of version 0.3b1, quickSMTP supports the following commands. Remember that each command has to be terminated with semicolon ( ; )
Allows to change the password. Password change would be immediate, so if you are changing the password on your own account as soon as this request is processed you need to update your email client with the new password in order to be able to connect to POP3 and SMTP.
User firstname.lastname@example.org ; Pass mypassword ; NewPass mynewpassword ;