All notifications can be templated and sent via JamarGig, however it is advised to connect JamarGig to your own email service if you would like all emails to come from your own email address instead of JamarGig's email address.
To do this go to the global settings cog in the top right and selecting the integration tab
There are two options for Email integration.
Standard SMTP - Mail Server
Microsoft 365 - Send Mail
SMTP Setup
Once selected, go to Add integration and select Mail Server -> SMTP-Mail Server.
A dialog box will then be displayed.
From here you enter the details for your mail server. For example below are the details are if you are using Gmail for your main email service
Host: This is the smtp hostname of your mailserver: e.g.smtp.gmail.com
Username: This is the username to login to your email. Typically this is your email address. e.g. sam@gmail.com
From name: This is what is displayed in the From of email and is typically is just the clear text of the name e.g. Sam Smith
From address: This is the email address of the email being used e.g. sam@gmail.com
Password: This is the password for the email service. Note if 2FA is being used an app password maybe required. Here is an example of how this is done for Gmail https://support.google.com/mail/answer/185833?hl=en
Port: port number for TLS. Set to 587 for TLS
Encryption: The encryption algorithm used for the email. Strongly suggest to use TLS
Throttle Emails per Minute: This is the maximum number of emails that will be sent per minute. It is important to set this based on the limits set by your email service. This ensures all emails are sent. If the throttle limit is exceeded the emails will be queued until the next available time-slot.
Throttle Emails per Day: This is the maximum number of emails that will be sent per day. It is important to set this based on the limits set by your email service. This ensures all emails are sent. If the throttle limit is exceeded the emails will be queued until the next available time-slot.
Once the details are completed the system will attempt to connect and validate the credentials. Once validated the email service will be added and all emails except for login validations will be sent via the email server.
Microsoft 365 Setup
Microsoft 365 requires some different settings than normal SMTP.
These include:
Microsoft Tenant ID
Sender Email Address
Client ID
Client Secret
Throttle Emails per Minute: This is the maximum number of emails that will be sent per minute. It is important to set this based on the limits set by your email service. This ensures all emails are sent. If the throttle limit is exceeded the emails will be queued until the next available time-slot.
Throttle Emails per Day: This is the maximum number of emails that will be sent per day. It is important to set this based on the limits set by your email service. This ensures all emails are sent. If the throttle limit is exceeded the emails will be queued until the next available time-slot
To setup the Microsoft 365 specific settings follow the below steps:
Tenant ID
Step 1: Log in to the Azure Portal.
Step 2: Navigate to Microsoft Entra ID.
Step 3: Under Overview, you’ll find your Tenant ID listed under the Tenant information section.
Image Note: The Tenant ID is a unique identifier for your Microsoft 365 organization. This ID is crucial for ensuring that your application communicates correctly with Microsoft’s services.
Client ID
Step 1: In the Azure Portal, navigate to Microsoft Entra ID.
Step 2: Go to App registrations and select your application if it already exists. If not, click on New registration to create a new application.
Step 3: Once your application is registered, Give a name that represents the application this will be used for example JamarGig Talent Management.
Step 4: Once your application is registered, the Client ID will be displayed on the application's Overview page
Image Note: The Client ID is essentially your application’s unique identifier within the Azure Active Directory. It allows Microsoft 365 to identify and authorize your application for API access.
Client Secret & Application API Permissions
Step 1: In the Azure Portal, go to Microsoft Entra ID > App registrations > select your application.
Step 2: Navigate to Certificates & secrets.
Step 3: Under Client secrets, click on New client secret.
Step 4: Provide a description and set an expiration period that is appropriate for your organisation, note when secret expires you will need to create a new secret and re-add it to JamarGig
Step 5: Once created, the client secret value will be shown. Important: Make sure to copy and save this secret immediately, as it will not be displayed again.
Image Note: The Client Secret acts like a password that your application uses to prove its identity when calling the Microsoft Graph API. Keep it secure and ensure it's updated in the platform when it expires.
Step 6: Need to ensure the correct permissions are granted to the Application API
Remove User.Read permission
Add Send Mail Permission
4. Granting Admin Consent
After setting up your application and configuring the necessary permissions, you'll need to grant admin consent for your organization. This step authorizes your application to use the permissions you've configured.
Image Note: Admin consent is required to allow your application to perform actions on behalf of the users in your organization, such as sending email.
Sending Email Address
The sending email address is the email you want to use for sending emails through Microsoft 365. This address must be within your Microsoft 365 domain and should be correctly configured in your Microsoft 365 account.
When emails are sent, the Name that is associated with this email address will sender name.