Alarm Email and SMS

Summary

This sample demonstrates how to configure the system to send email and SMS messages with alarm details using the "NotificationMethod" feature. When a conditional event alarm is triggered, a message is automatically sent containing key alarm information.

Technical Information

The method AlarmEvents(AlarmEventInfo[] events) is automatically called whenever a conditional alarm event occurs. It receives an array of events and processes the first one to send a notification.

 OAuth2 Authentication Update (Gmail/Outlook)

Important:
This version uses OAuth2 instead of Basic Authentication for email sending. Username/password authentication is no longer supported for providers like Gmail and Outlook.

 Required Dependencies

The necessary libraries are included by default in the software package.

public void AlarmEvents(AlarmEventInfo[] events)
{
	if (events == null)
		return;
	@Info.Trace("Alarms, count = "+events.Length.ToString());

	AlarmEventInfo test = events[0];
	@Info.Trace("Alarms, State = " + test.State.ToString());
	
	if (test.State != 1)
		return;

	string body = "Time: " + test.ActiveLocalTime.ToString() + "\n" +
	"Message = " + 	test.Message + "\n" +
	"Area = " + test.Area + "\n" +
	"Group = " + test.Group + "\n" +
	"Tag = " + 	test.TagName + "\n"	 ;
	
	OAuth2EmailSender mySender = new OAuth2EmailSender();

	mySender.SendEmailAsync(@Tag.fromEmail, @Tag.toEmail, "Alarm beeped!", body);
	
}

Credentials Required

Depending on your provider, you’ll need to configure OAuth2 credentials instead of using a regular email and password. Here's some examples on how you can do that:

For Gmail

To authenticate with Gmail via OAuth2, you’ll need to generate a Client ID and a Client Secret through the Google Cloud Console:

• Go to Google Cloud Console

• Create or select a project

• In the APIs & Services > Library, search for and enable the Gmail API

• Then go to OAuth consent screen and choose the External option. Set your app name, support email, and developer contact info (all can be your own Gmail).

• After configuring the consent screen, go to Credentials, click Create Credentials > OAuth Client ID, and choose Desktop App

• Name it something like "DesktopMailer" and click Create — you'll receive your Client ID and Client Secret

• As a final step, go back to the OAuth consent screen, scroll to Test users, and add your own Gmail to be able to test sending emails
  
  

You'll use the credentials like this:

GmailClientId = "your-client-id.apps.googleusercontent.com"; 
GmailClientSecret = "your-secret";

For Outlook

To authenticate with Outlook using OAuth2, you’ll need a Client ID and Tenant ID, obtained through the Azure portal.
You must register an application, define redirect URIs, and configure Microsoft Graph API permissions (e.g., Mail.Send).

Reference Information

→ See Alarms for more information.

In this section: