How to set up and run SMTP email with Chintaro

Use this solution if you would prefer to email from SMTP in Chintaro instead of Outlook Email. This solution details:

• Set up the parameters in System Maintenance
• Set up the user email settings in Chintaro Security

NOTE: If you are hosting Chintaro on Microsoft Azure servers, there are additional steps that you will need to take.  Please follow the instructions in the section: 

• Additional Configuration Required for using SMTP with Microsoft Azure

  (If you are using Chintaro Cloud, or host Chintaro locally, these additional steps are not needed).

Set up the parameters in System Maintenance

Before emailing using SMTP, you will need to ensure that the applicable parameters are set up in Chintaro. NOTE: Setting the parameters in this screen only needs to be done once for the whole database for one user. 

To do this, from the Home Screen, click System Maintenance > Reference Tables > Parameters and the following screen will open:

Click anywhere in the Parameters table and scroll down until you see EmailClient in the Parm column.

In the Parm Text column for EmailClient change text to SMTP

In the Parm Text column for Email From, Email Password, EmailSMTPServer and EmailUserName enter the credentials for your email.

In the Parm Number column for EmailSMTPServerPort enter the number of your SMTP server port (not the Parm Text field).

Set up the user email settings in Chintaro Security

To ensure that each user has the applicable email reply address and display name, these settings must be configured in the Chintaro security settings. 

To do this, from the Home Screen, click System Maintenance > Security > User Maintenance

1. Click the User name to highlight it
2. Enter the Reply to email address in the Email field for this user
3. Enter the Display Name you wish for this user

Repeat these steps for each user

Additional Configuration Required for using SMTP with Microsoft Azure

This section outlines steps needed to configure email through SMTP if Chintaro is hosted on a Microsoft Azure server.  This solution can be disregarded if you are using Chintaro Cloud, or running it on a local network in your organisation.

Step 1: Unblock SMTP Traffic

SMTP traffic is BLOCKED by Microsoft for VM’s running in certain configurations – which include ALL PAYG subscriptions and therefore also not-for-profit. You must log a job with Azure Support to have SMTP enabled on port 25. This takes 2-3 business days to be actioned.

 

Step 2: Make Changes take effect

After the change is made, the server will require a shutdown and deallocation at MS’s end to pickup the new routes. It is important that the VM is left off for a few minutes and actually shows a deallocated status before being turned back on.   Otherwise, the changes will not action. Once completed, SMTP will be able to flow directly from that server. When configuring SMTP services, users should use the Office 365 MX for that domain – not smtp.office365.com as it will cause errors.  You will require a licensed Office 365 account to be able to send email to domains outside of your own. This generally isn’t an issue for Not For Profit’s as they are allocated 50 free E1 licenses with their NFP status.

 

Step 3: Test Connectivity

You can test credentials and connectivity from the server by using PowerShell to test email. 

Send-MailMessage –From xyz@business.com.au –To abc@business.com.au –Subject "Test Email" –Body "Test SMTP Service from Powershell on Port 25" -smtpServer business-com-au.mail.protection.com.au -Credential $creds -Port 25

 

Step 4: Chintaro Setup

Chintaro setup – you will need to substitute the relevant info in, but the fields below are what is used to connect directly to Exchange Online:

 

Email Client: SMTP

EmailFrom: xyz@business.com.au

Email Password: <password>

Email SMTP Server: business-com-au.mail.protection.com.au

Email SMTP Server Port: 25

Email Username: xyz@business.com.au