Everything Joya sends — password resets, expiry reminders, crew notifications,
job alerts — goes through these two screens.
Where: Admin → Email settings / SMS settings
Tabs Provider, Templates and Reports. A badge at the top says
whether Joya is Using saved settings, Falling back to environment or Not
configured.
SMTP host, port and Encryption — Auto from port, SSL (implicit
TLS), STARTTLS or None. Leave it on Auto unless you have a reason;
it picks correctly for the standard ports.
Then the username and password (masked — leaving it blank keeps the existing
one), whether to reject self-signed certificates, the sender block (From
address and name, Reply-to, Archive BCC), and delivery timeouts and
pooling.
Two buttons at the bottom, and the difference matters:
| Button | Uses |
|---|---|
| Verify connection | The values currently on screen, unsaved |
| Send test email | The values already saved |
So verify first, save, then send a test.
Seven events, each with a Subject, an HTML body, a plain-text body
and an Active switch, plus read-only chips listing the variables available:
passwordReset · newUserPassword · tripNotification · inboxMessage ·
endorsementExpiry · handlingApprovalExpiry · jobAlert
Templates use Handlebars — {{variable}}.
Tabs Provider, Templates, Rules and Reports.
Choose Disabled, Magfa or Kavenegar, then the credentials (masked),
the sender number and a timeout. Send Test SMS and Check Balance appear
once a provider is selected.
SMS templates use single braces — {variable} — not the double braces used
by email. Kavenegar adds a sending method (lookup / send / sendarray), a
template name and a token mapping.
The Rules tab is not connected. Sending hours, daily limit, retries,
anti-duplicate and the low-credit alarm are saved and displayed but nothing
reads them. Do not rely on them to restrict sending.
{{double braces}}; SMS templates use {single braces}.jobAlert template is what| Symptom | Cause | Fix |
|---|---|---|
| Verify succeeds but the test email fails | Verify uses on-screen values, the test uses saved ones | Save, then test |
| Reset emails never arrive | Email not configured, or the user has no work email | Check the badge and the user record |
| SMS silently not sent | Provider set to Disabled, or no sender number | Check the Provider tab |
| A template edit disappeared | Another administrator saved over it | Re-apply and coordinate |
| Sending-hour limits ignored | The Rules tab is not connected | Not available yet |