Configuration¶
The following settings can be configured in the module's configuration file (main.conf):
Email settings¶
| Setting | Default value | Description |
|---|---|---|
emailServer |
The SMTP server address and port. E. g. server-address:587. |
|
emailAuthUser |
The username for SMTP authentication. | |
emailAuthPassword |
The password for SMTP authentication. | |
emailFromName |
Default sender name, used when not specified in the RPC call. | |
emailFromAddress |
Default sender e-mail address, used when not specified in the RPC call. |
SMS settings¶
| Setting | Default value | Description |
|---|---|---|
smsApiUrl |
The SMS gateway API URL. | |
smsApiKey |
The SMS API authentication key. | |
smsFrom |
Default sender ID (max 11 alphanumeric or 16 numeric chars), used when not specified in the RPC call. |
Retry settings¶
| Setting | Default value | Description |
|---|---|---|
messageResendBaseInterval |
180 | The base retry interval in seconds for resending failed messages. |
Retry mechanism¶
When sending an e-mail or SMS fails, the message is stored in the database for later retry. The retry uses exponential backoff with the formula:
next retry after = 2^retryCount × messageResendBaseInterval seconds
With the default messageResendBaseInterval of 180 seconds, the retry intervals are:
| Retry | Delay |
|---|---|
| 1 | 360 seconds |
| 2 | 720 seconds |
| 3 | 1440 seconds |
| 4 | 2880 seconds |
The maximum number of retries is 12. After that, the message is moved to the notification log with a "failed" status.